快速开始

以下安装与快速开始直接引用项目 README。不经过站点渲染、只浏览 Markdown 时，可阅读该源文件。

安装

需要 Node.js >=22.18.0。

pnpm add -D @xova/matrix

精简 Linux 镜像还需要系统 ps 命令。平台要求见进程关闭。

快速开始

在工作区根目录创建 matrix.config.ts：

import { defineMatrixConfig } from '@xova/matrix'

export default defineMatrixConfig({
  projects: {
    web: {
      root: './apps/web',
      targets: {
        dev: 'vite',
        build: { command: 'vite build', artifacts: { mode: 'archive' } },
        preview: 'vite preview',
      },
    },
  },
  products: {
    app: {
      version: '1.0.0',
      variants: { web: 'web' },
    },
  },
})

在包含配置文件的目录中运行：

pnpm exec matrix dev app
pnpm exec matrix build app --env staging
pnpm exec matrix plan app --target preview --env production
pnpm exec matrix doctor

以上假设 Web 项目已安装 Vite 并能独立构建。显式产品版本让归档不依赖项目 package.json 的版本；archive 保留 Web 输出，便于后续 preview。dev 是持续服务，使用 Ctrl+C 停止后再执行其他命令。运行 pnpm exec matrix 可进入交互向导，完整命令则直接执行。

接下来阅读配置参考，或运行无框架入门示例。