Files
Ncurator/doc/testing

NCurator-Desktop 测试文档入口

doc/testing/** 只负责测试规则、治理规则、阶段推进与历史记录,不再手工维护当前有效测试清单。

当前测试真相链:

  1. tests/main/**、tests/renderer/**、tests/e2e/**
  2. tests/catalog/current-cases.json
  3. tests/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. 阅读顺序

  1. architecture.md
  2. case-governance.md
  3. 当前 case 清单:
  4. phased-plan.md
  5. upgrade-journal.md

3. 文档分工

  • architecture.md
    • 测试分层、目录放置、catalog 生成、报告消费顺序与执行入口。
  • case-governance.md
    • metadata 契约、保留层级、生命周期、运行策略、准入/降级/归档规则。
  • phased-plan.md
    • AI 测试阶段顺序、门禁、阶段产物与推进条件。
  • upgrade-journal.md
    • 每轮测试执行历史、风险、阶段结论与推进决策。

4. 维护规则

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