perf: 并行化前端单测并缩短 CI 关键路径 (#690)

tests/config/frontend-workflow.spec.ts

@@ -11,7 +11,8 @@ describe('前端测试 workflow', () => {
   it('在 PR 与 v3 push 上运行，并将变更文件格式检查限制为 PR', () => {
     const workflow = readFileSync(workflowPath, 'utf8')
     const formatJob = workflow.match(/\n {2}format:\n(?<job>[\s\S]*?)(?=\n {2}[\w-]+:\n|$)/)?.groups?.job
-    const qualityJob = workflow.match(/\n {2}typecheck-and-tests:\n(?<job>[\s\S]*?)(?=\n {2}[\w-]+:\n|$)/)?.groups?.job
+    const lintJob = workflow.match(/\n {2}lint:\n(?<job>[\s\S]*?)(?=\n {2}[\w-]+:\n|$)/)?.groups?.job
+    const testJob = workflow.match(/\n {2}typecheck-and-tests:\n(?<job>[\s\S]*?)(?=\n {2}[\w-]+:\n|$)/)?.groups?.job
 
     expect(workflow).toContain('permissions:\n  contents: read')
     expect(workflow).toContain('pull_request:\n    branches:\n      - v3')
@@ -26,10 +27,16 @@ describe('前端测试 workflow', () => {
     expect(formatJob).toContain('HEAD_SHA: ${{ github.event.pull_request.head.sha }}')
     expect(formatJob).toContain('run: yarn format:check --base "$BASE_SHA" --head "$HEAD_SHA"')
     expect(formatJob).not.toContain('--write')
-    expect(qualityJob).toBeDefined()
-    expect(qualityJob).toContain('run: yarn typecheck')
-    expect(qualityJob).toContain('run: yarn test:run')
-    expect(qualityJob).not.toContain('test:coverage')
+    expect(lintJob).toBeDefined()
+    expect(lintJob).toContain('run: yarn lint')
+    expect(lintJob).toContain('run: yarn typecheck')
+    expect(testJob).toBeDefined()
+    expect(testJob).toContain('shard:')
+    expect(testJob).toContain('- 1/2')
+    expect(testJob).toContain('- 2/2')
+    expect(testJob).toContain('run: yarn test:run --shard=${{ matrix.shard }} --silent=passed-only')
+    expect(testJob).not.toContain('run: yarn typecheck')
+    expect(testJob).not.toContain('test:coverage')
     expect(workflow).not.toContain('\n  unit-tests:\n')
   })
 
@@ -37,10 +44,13 @@ describe('前端测试 workflow', () => {
     const testingGuide = readFileSync(testingGuidePath, 'utf8')
     const codeQualityGuide = readFileSync(codeQualityGuidePath, 'utf8')
 
-    expect(testingGuide).toContain('`typecheck-and-tests` job')
+    expect(testingGuide).toContain('`yarn test:run` 默认并行执行两个 Vitest shard')
+    expect(testingGuide).toContain('`yarn test:run --serial`')
+    expect(testingGuide).toContain('传入测试文件或名称过滤条件时自动使用单进程')
     expect(testingGuide).toContain('推送到 `v3`')
     expect(testingGuide).toContain('只在 Pull Request 事件运行')
-    expect(codeQualityGuide).toContain('lint 与 `typecheck-and-tests` 使用不同 job')
+    expect(codeQualityGuide).toContain('`lint` job 集中执行 ESLint 与 typecheck')
+    expect(codeQualityGuide).toContain('本地默认并行执行两个 Vitest shard')
     expect(testingGuide).not.toContain('`unit-tests`')
     expect(codeQualityGuide).not.toContain('`unit-tests`')
   })

tests/config/test-runner.spec.ts

@@ -0,0 +1,44 @@
+import { execFileSync } from 'node:child_process'
+import { readFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { describe, expect, it } from 'vitest'
+
+const packageJsonPath = resolve(process.cwd(), 'package.json')
+
+function planTestRuns(args: string[]): string[][] {
+  const script = [
+    "import { planTestRuns } from './scripts/run-tests.mjs'",
+    `process.stdout.write(JSON.stringify(planTestRuns(${JSON.stringify(args)})))`,
+  ].join(';')
+
+  return JSON.parse(
+    execFileSync(process.execPath, ['--input-type=module', '--eval', script], {
+      cwd: process.cwd(),
+      encoding: 'utf8',
+    }),
+  )
+}
+
+describe('前端测试统一入口', () => {
+  it('由项目脚本接管 test:run', () => {
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'))
+
+    expect(packageJson.scripts['test:run']).toBe('node scripts/run-tests.mjs')
+  })
+
+  it('全量测试默认拆成两个并行 shard', () => {
+    expect(planTestRuns([])).toEqual([['--shard=1/2'], ['--shard=2/2']])
+    expect(planTestRuns(['--silent=passed-only'])).toEqual([
+      ['--silent=passed-only', '--shard=1/2'],
+      ['--silent=passed-only', '--shard=2/2'],
+    ])
+  })
+
+  it('显式 shard、串行模式和聚焦过滤只启动一个 Vitest 进程', () => {
+    expect(planTestRuns(['--shard=2/2', '--silent=passed-only'])).toEqual([['--shard=2/2', '--silent=passed-only']])
+    expect(planTestRuns(['--serial', '--silent=passed-only'])).toEqual([['--silent=passed-only']])
+    expect(planTestRuns(['tests/config/frontend-workflow.spec.ts'])).toEqual([
+      ['tests/config/frontend-workflow.spec.ts'],
+    ])
+  })
+})