NCurator-Desktop 测试文档入口
doc/testing/** 只负责测试规则、治理规则、阶段推进与历史记录,不再手工维护当前有效测试清单。
当前测试真相链:
tests/main/**、tests/renderer/**、tests/e2e/**tests/catalog/current-cases.jsontests/report/**
说明:
tests/main/**、tests/renderer/**、tests/e2e/**是 managed case 与 metadata 的唯一源码真相源。tests/unit/**保存非 catalog 的普通单测,不属于 current active case 集。tests/catalog/current-cases.json是 AI、脚本与开发者读取当前 active case 集的统一入口。tests/catalog/current-cases.md是面向人工浏览的投影文件。tests/report/**只保存历史执行证据,不再定义当前 case inventory。
1. 什么时候读这里
- 调整测试架构、test harness、分析脚本或报告契约
- 新增、晋升、降级、归档测试用例
- 推进 AI 阶段测试、更新门禁或补充历史结论
2. 阅读顺序
3. 文档分工
architecture.md- 测试分层、目录放置、catalog 生成、报告消费顺序与执行入口。
case-governance.md- metadata 契约、保留层级、生命周期、运行策略、准入/降级/归档规则。
phased-plan.md- AI 测试阶段顺序、门禁、阶段产物与推进条件。
upgrade-journal.md- 每轮测试执行历史、风险、阶段结论与推进决策。
4. 维护规则
- 任何需要确认“当前有哪些测试 case”的场景,都先读
tests/catalog/current-cases.json或tests/catalog/current-cases.md。 - 日常主回归优先跑
pnpm test:cases:gating;普通单测单独跑pnpm test:unit。 - 不把
tests/report/**目录结构当成当前 case 集,也不在doc/testing/**手工抄写 case 列表。 - 若调整测试文档入口、catalog 路径或治理规则,必须同步更新:
5. 常用运行命令
- 主回归:
pnpm test:cases:gating - 分层检查:
pnpm test:cases:drift - 普通单测:
pnpm test:unit - Main 全量 managed:
pnpm test:main - Capability:
pnpm test:capability - Capability 汇总:
pnpm test:capability:analyze - Runtime:
pnpm test:runtime - Human:
pnpm test:human - Human 汇总:
pnpm test:human:analyze - Human 批次:
pnpm test:human:batch -- --runs 5 - Human 对比:
pnpm test:human:compare -- --before <batchId> --after <batchId> - Workspace service:
pnpm test:workspace:service - Workspace migration:
pnpm test:workspace:migration - Renderer:
pnpm test:renderer - E2E deterministic:
pnpm test:e2e - E2E ai-live:
pnpm test:e2e:ai-live