测试运行指南

本项目的测试入口已收缩为三层：

• pnpm test 只跑单元测试，适合日常开发的快速反馈。
• pnpm test:gate 运行 core/ui 的门禁测试，不含 Playwright E2E，适合 pre-commit。
• pnpm test:gate:full 在 test:gate 基础上追加关键 E2E 白名单，适合提交前或 CI。

常用命令

# 日常开发：快速反馈
pnpm test

# pre-commit：core/ui 门禁，不含 E2E
pnpm test:gate

# 提交前 / CI：门禁 + 关键 E2E
pnpm test:gate:full

# 关键 E2E 白名单
pnpm test:e2e:gate

# 扩展 E2E（analysis / optimize / compare 等长链路）
pnpm test:e2e:extended

# 显式跑完整 Playwright 套件（较重）
pnpm test:e2e

# 重新录制指定 fixture（必须显式传 spec 或 grep）
pnpm test:e2e:record -- tests/e2e/test/image-image2image-generate.spec.ts

VCR

• E2E VCR 入口：tests/e2e/fixtures.ts
• 说明文档：tests/e2e/e2e-vcr-guide.md
• pnpm test:e2e:record 不再默认录整套测试，避免无意义地重录大量 fixtures。

UI 错误门禁

• Vitest（UI 包）：packages/ui/tests/utils/error-detection.ts
• Playwright（E2E）：tests/e2e/fixtures.ts