From 6908b9653be03966447863fd38bd5313524a5056 Mon Sep 17 00:00:00 2001
From: lanyuanxiaoyao <lanyuanxiaoyao@gmail.com>
Date: Thu, 7 May 2026 17:07:55 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20CI=20check=20job=20=E6=89=A9=E5=B1=95?=
 =?UTF-8?q?=E4=B8=BA=E4=B8=89=E5=B9=B3=E5=8F=B0=20matrix=20=E5=B9=B6?=
 =?UTF-8?q?=E8=A1=8C=20lint/test?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

将 test.yml 的 check job 从单平台 ubuntu 改为 ubuntu/macos/windows 三平台并行，
Linux 额外安装 libayatana-appindicator3-dev 以支持 systray CGo 编译。
---
 .github/workflows/test.yml          | 11 +++++++--
 openspec/specs/ci-test-gate/spec.md | 37 +++++++++++++++++++++++------
 2 files changed, 39 insertions(+), 9 deletions(-)

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 资源隔离