diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml index 6b19c5d..ad62f61 100644 --- a/.github/workflows/test.yml +++ b/.github/workflows/test.yml @@ -14,8 +14,11 @@ permissions: jobs: check: - name: Check - runs-on: ubuntu-latest + name: Check (${{ matrix.os }}) + runs-on: ${{ matrix.os }} + strategy: + matrix: + os: [ubuntu-latest, macos-latest, windows-latest] steps: - name: Checkout @@ -23,6 +26,10 @@ jobs: with: lfs: true + - name: Install Linux system dependencies + if: runner.os == 'Linux' + run: sudo apt-get update && sudo apt-get install -y libayatana-appindicator3-dev + - name: Setup Go uses: actions/setup-go@v6 with: diff --git a/openspec/specs/ci-test-gate/spec.md b/openspec/specs/ci-test-gate/spec.md index 7555ee4..caa21d1 100644 --- a/openspec/specs/ci-test-gate/spec.md +++ b/openspec/specs/ci-test-gate/spec.md @@ -33,15 +33,38 @@ 测试 workflow SHALL 将测试步骤拆分为 `check`、`mysql`、`e2e` 三个独立 job,通过 `full` 参数和 `needs` 依赖控制执行。 -#### Scenario: check job(始终执行) +#### Scenario: check job(始终执行,三平台 matrix) - **WHEN** 测试 workflow 被调用(无论 `full` 值) - **THEN** `check` job SHALL 始终执行 -- **THEN** SHALL 在 `check` job 内按顺序执行:checkout(含 LFS)→ setup Go → setup Bun → `make lint` → `make test` +- **THEN** `check` job SHALL 使用 `strategy.matrix.os` 在 `ubuntu-latest`、`macos-latest`、`windows-latest` 三个平台并行运行 +- **THEN** 每个平台 SHALL 按顺序执行:checkout(含 LFS)→ setup Go → setup Bun → `make lint` → `make test` +- **THEN** 在 Linux 平台上,lint/test 之前 SHALL 执行 `sudo apt-get install -y libayatana-appindicator3-dev` 安装系统依赖 +- **THEN** macOS 和 Windows 平台 SHALL NOT 安装额外系统依赖 - **THEN** `make lint` SHALL 覆盖 backend golangci-lint、frontend typecheck + eslint + prettier、versionctl golangci-lint - **THEN** `make test` SHALL 覆盖 backend 核心测试、frontend Vitest 单元/组件测试、desktop 测试和 versionctl 测试 - **THEN** `make test` SHALL NOT 覆盖 MySQL 专项测试或 frontend E2E 测试 - **THEN** lint 或测试失败时 SHALL 阻止后续步骤执行 +- **THEN** 任一平台失败 SHALL 导致 `check` job 整体失败 + +#### Scenario: check job 平台特定依赖安装 + +- **WHEN** `check` job 在 Linux 平台运行 +- **THEN** SHALL 在 lint 步骤之前执行系统依赖安装步骤 +- **THEN** 该步骤 SHALL 使用 `if: runner.os == 'Linux'` 条件控制 +- **THEN** 该步骤 SHALL 安装 `libayatana-appindicator3-dev` + +#### Scenario: check job macOS 平台 + +- **WHEN** `check` job 在 macOS 平台运行 +- **THEN** SHALL NOT 安装额外系统依赖 +- **THEN** `make lint` 和 `make test` SHALL 正常执行 + +#### Scenario: check job Windows 平台 + +- **WHEN** `check` job 在 Windows 平台运行 +- **THEN** SHALL NOT 安装额外系统依赖 +- **THEN** `make lint` 和 `make test` SHALL 正常执行 #### Scenario: mysql job(仅 full=true) @@ -129,14 +152,14 @@ ### Requirement: 测试 workflow 工具链依赖 -测试 workflow SHALL 在单个 ubuntu runner 上准备完整的工具链环境。 +测试 workflow SHALL 在各平台 runner 上准备完整的工具链环境。 -#### Scenario: 工具链安装 +#### Scenario: 工具链安装(三平台) - **WHEN** 测试 workflow 开始执行 -- **THEN** SHALL checkout 仓库代码并拉取 Git LFS 文件 -- **THEN** SHALL 安装 Go 工具链(使用 `go.work` 文件指定版本) -- **THEN** SHALL 安装 Bun 运行时 +- **THEN** 每个平台 SHALL checkout 仓库代码并拉取 Git LFS 文件 +- **THEN** 每个平台 SHALL 安装 Go 工具链(使用 `go.work` 文件指定版本) +- **THEN** 每个平台 SHALL 安装 Bun 运行时 - **THEN** Go 模块缓存 SHALL 覆盖 `backend/go.sum` 和 `versionctl/go.sum` ### Requirement: 测试 workflow 资源隔离