旧 Toolkit 的精简迁移评估
评估日期:2026-10-20。结论:保留测试约束、真实 runner 接入经验和少量领域模板;不移植旧工作流引擎。新工具保持 plan / run / verify 三个入口,无任务状态、依赖安装、升级事务和自动修复循环。
证据范围
阅读 wenext-test-toolkit-web 在 common-libs HEAD 3f7637e 的 12 个源文件,以及 2026-10-15 隔离 WIP 中 preparation、execution、evidence、quality/pi-* 等模块。HEAD 源码共 6,549 行,其中 commands.mjs 1,561 行、summary.mjs 1,126 行、e2e.mjs 1,008 行;新包本轮前的 11 个源文件共 603 行。行数只是职责分布的线索,不是等价能力或质量评分。
旧 HEAD 与隔离 WIP 是不同版本,不能叠加成一个已经发布的产品。WIP 虽拆了文件,但仍存在“执行器→安装状态→任务 receipt→Quality Run→Pi 私有状态”的依赖链。仅搬文件或重命名模块不能解决耦合。
逐项取舍
| 旧能力 / 源码 | 取舍与归属 | 优先级 / 验收条件 |
|---|---|---|
repo.mjs / impact.mjs 包发现、diff、反向依赖 | 保留能力,新包已有独立实现。页面/store/API 路径启发式只作为 skill 的候选提示 | 已有;未知范围必须保守处理,不能把候选当完整覆盖 |
commands.mjs FLT/E2E 命令与退出状态 | 新包已有 runner、超时、取消、原始报告;不迁移 CLI 巨型分支 | 已有;零用例、skip、缺报告不通过 |
changed-coverage.mjs 精确 carrier 范围、逐文件阈值、报告新鲜性 | 本轮迁移约束并重写。显式 coverage.files/thresholds,Jest/Vitest 原生 json-summary,复用 evidence | P0;实际 runner 正负案例、漏文件/旧报告/空统计不能通过 |
| 同文件的 changed-line 算法 | 暂缓。旧算法按 location 起始行筛选;函数体中间变更、无可执行计数、删除/重命名和 source map 均需独立验证 | P2;真实需求出现再设计;目前对明确文件执行全文件校验,不能宣称 changed-line 等价 |
flt.mjs Vue2 logic/SFC、Vue3 配置经验 | 迁移成可审阅 recipe/fixture,业务保留原生 Jest/Vitest 配置;不让核心识别 Vue 版本并决定阈值 | P1;Vue2 SFC 与 Vue3 各一真实包通过。Vue2 编译器须与实际 Vue 匹配 |
commands.mjs 的精确 test-file / target-scenario | 已重写最小文件范围门禁:显式 testFiles、runner 参数、实际报告文件归属和每文件通过数;requiredTests 保留 | 已通过三个真实 runner 验证;Vitest 原生子串多跑保留真实结果,不再仅因此 blocked,逐文件同名标题需独立 check;语义覆盖仍归业务 |
smoke-layer.mjs / e2e.mjs 请求隔离规则 | 已提取最小 Playwright recipe:context 兜底拦截、abort 后 teardown 断言、禁用 Service Worker;不带入静态正则扫描引擎 | Chromium + 本地 server 正负验证已完成;真实业务待验收。route.fetch/continue 可绕过,不可作为 mock;并非旧 smoke-layer 完整等价替换 |
e2e.mjs Playwright webServer、smoke/integration 分层 | 精简为原生配置示例与独立 scripts;不维护端口注册表、脚本语义推断和模板升级系统 | P1;服务启动、停止与请求策略在真实 fixture 验证,失败不被另一层成功掩盖 |
e2e.mjs realLoginFixture / bridgeFixture | 复用现有 @wenext/h5-test-login,领域 fixture 显式声明 app/locale/entry/bridge。核心不解析登录产品、不扫描 curl/env 文件 | P1;真实登录失败必须失败,禁止假 token;真实凭据只在环境/外部凭据设施中 |
| Activity Result Profile D / 双 webServer | 保留独立示例,按实际业务采用;不把包名、兄弟仓库路径、固定端口写入核心 | 按需;真实 host + activity ID 集成验证 |
| Readiness / harness / request-policy 校验 | 保留“同一环境与 fixture 先准备再验收”的要求。优先 Playwright webServer、project dependency、fixture,必要时普通声明式 check | P1;准备成功不能代替业务通过。暂不设计另一套 readiness receipt/消费状态机 |
summary.mjs carrier/collaborator/scenario matrix | 业务规则与评审材料;最小 test-tool 报告保留实际结果。覆盖率/用例名都不能证明业务语义充分 | P1;用真实变更审查场景映射,不能自动从文件名推断通过 |
platform-gate.mjs 真实 App/WebView 设备证据 | 设备与构建绑定的要求值得保留;归业务验收契约与 Pi 阶段证据。桌面自动化不代替终端验收 | 按需;明确设备、App/H5 版本、源码、场景、证据与确认人,当前新工具尚未实现此门禁 |
runtime.mjs require-latest / root wrapper | 旧强制最新版门禁不迁移;自动升级保留为重要功能,优先评估仓库依赖维护流程,锁文件固定执行版本 | P1 待设计/实现;明确版本发现、依赖更新、兼容性验证与失败处理;执行测试不访问 registry |
安装事务、transient restore、vue2-resolution.mjs pnpm hook 修复 | 不迁移到测试执行器。必要依赖修复是显式项目改动,可审阅并提交 | 不带入新包;避免执行后恢复 lockfile 却留下 node_modules 状态的隐性复杂度 |
quality/* prepare/run/recover/waiver/update/repair-loop、metrics/上传 | 不迁移。任务授权、重试、完成、归档与通用指标归 Pi,外部上报为独立消费者 | 新包不依赖 Pi;公开命令协议接入 |
隔离 WIP quality/pi-context.mjs / pi-store / pi-run | 不迁移。其读取 task.json、quality/change-scope 等私有布局,与新边界冲突 | 已有公开 request/result/verify 替代,不恢复旧桥 |
| 旧测试 | 迁移场景意图,按新 API 重写断言;不搬锁文件安装恢复、旧 receipt 路径等实现测试 | 按能力同步;测试应能证伪新门禁,而不是维持旧状态机 |
本轮落地:最小覆盖率门禁
{
"schemaVersion": 1,
"checks": [{
"id": "flt",
"script": "test",
"runner": "auto",
"coverage": {
"files": ["src/domain/order.ts"],
"thresholds": { "statements": 90, "branches": 80, "functions": 90, "lines": 90 }
}
}]
}这些阈值只是示例,由项目明确选择。files 相对选中包,必须是存在的普通源码文件;不接受 glob、重复、越界、符号链接或快照排除目录。不同包使用现有 overrides。--config 可选择项目内的变更专用规则,不需要长期维护逐任务的大表。
执行在本次 check 输出下采集 coverage/coverage-summary.json,逐文件检查四类计数,仅对声明的 metric 执行阈值。低于阈值 failed,报告缺失/非法/漏文件/无可执行行 blocked;函数或分支不存在时该项为 100%,但整个空文件不能因此通过。不读取历史 package/coverage,原始报告进入 evidence,verify 检查摘要及源码绑定。
计数和 source map 由 runner 负责,新包不重写 Istanbul 统计。使用原始 covered/total 比较,忽略 reporter 中已舍入的 pct。其他文件不进入本门禁分母;runner 配置中另有更严格的全局阈值时,仍保留其非零退出结果。
采集参数来自 Jest CLI、Jest coverageReporters 与 Vitest coverage。兼容性以本包固定开发版本的真实测试为准。项目自己安装与 runner 匹配的 coverage provider,并配置正确的 instrumentation/include;本工具不安装缺失 provider,也不扩大或缩小原生 runner 的采集配置。声明文件未被采集时会阻断。
后续最小路径
2026-10-20 后续切片已落地 testFiles 与 smoke fixture。新增测试文件范围模块,原有覆盖率、进程和 evidence 继续复用;fixture 随包分发,由项目复制采用。没有新增子命令、runtime 依赖或模板管理引擎。文件范围、coverage carrier、场景标题三者独立声明,不能互相替代。
自动升级是用户于2026-10-20明确补充的重要待办。优先评估由仓库依赖维护流程承接新版发现、manifest/锁文件更新、独立 CI 验证与合并;具体工具、频率、版本范围和自动合并策略待定,尚未实现或启用。它与测试执行分开,不恢复旧 require-latest 或测试现场安装回滚机制。
- Vue2/Jest、Vue3/Vitest 各选一个已存在真实测试的包,验证 carrier 覆盖与报告。优先复用现有测试配置,确有缺项再提炼小模板。
- 在真实业务 fixture 验证 smoke 请求隔离、integration 登录与 Playwright readiness;能用 runner 原生功能表达的要求不增加核心抽象。
- 大仓共享变更保留完整选包;源码快照已改为分块摘要,去掉累计 512 MiB/50000 路径拒绝条件。后续执行耗时、业务缺入口及完整验收继续逐项确认,不能偷偷缩小范围来换取成功;分批与汇总契约尚未实现。
- 只有对应能力通过真实业务验证,才清理那部分旧工作流脚本。当前不会整体替换旧 Toolkit;设备、真实登录、远端服务和业务语义尚未完成等价验收。
新增核心能力的门槛:跨项目可复用、存在实际用例、输入输出明确、失败可确定判断、可以脱离 Pi 独立测试。否则放在项目规则、普通 runner 配置、领域 fixture 或说明中。后续不默认建设 bootstrap 引擎、readiness 引擎、模板升级器或插件注册层。