Skip to content

旧 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,复用 evidenceP0;实际 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,必要时普通声明式 checkP1;准备成功不能代替业务通过。暂不设计另一套 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 路径等实现测试按能力同步;测试应能证伪新门禁,而不是维持旧状态机

本轮落地:最小覆盖率门禁 ​

json
{
  "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 或测试现场安装回滚机制。

  1. Vue2/Jest、Vue3/Vitest 各选一个已存在真实测试的包,验证 carrier 覆盖与报告。优先复用现有测试配置,确有缺项再提炼小模板。
  2. 在真实业务 fixture 验证 smoke 请求隔离、integration 登录与 Playwright readiness;能用 runner 原生功能表达的要求不增加核心抽象。
  3. 大仓共享变更保留完整选包;源码快照已改为分块摘要,去掉累计 512 MiB/50000 路径拒绝条件。后续执行耗时、业务缺入口及完整验收继续逐项确认,不能偷偷缩小范围来换取成功;分批与汇总契约尚未实现。
  4. 只有对应能力通过真实业务验证,才清理那部分旧工作流脚本。当前不会整体替换旧 Toolkit;设备、真实登录、远端服务和业务语义尚未完成等价验收。

新增核心能力的门槛:跨项目可复用、存在实际用例、输入输出明确、失败可确定判断、可以脱离 Pi 独立测试。否则放在项目规则、普通 runner 配置、领域 fixture 或说明中。后续不默认建设 bootstrap 引擎、readiness 引擎、模板升级器或插件注册层。