wenext-web-mono 接入与旧能力映射
本轮范围
首版提供可执行基础,不在原 wenext-test-toolkit-web 上迭代,不改 Pi 或业务依赖/脚本。业务旧规则是迁移需求输入,不是新工具应继承的流程引擎。
| 旧流程需求 | 新归属 | 当前状态 |
|---|---|---|
| 包发现、变更映射、共享包反向依赖 | test-tool discovery | 已实现 npm/pnpm workspaces;未知范围保守全选 |
| Vue2/Jest、Vue3/Vitest 测试执行 | test-tool runner | 已实现并验证真实报告;业务依赖需项目安装 |
| FLT/E2E 必需、缺场景不得通过 | 业务 rules + test-tool | minPassed/requiredTests/必需 script 已实现;需把领域要求声明成规则 |
| 指定测试文件与实际文件归属 | test-tool testFiles | 已支持 Jest/Vitest/Playwright;漏文件/无来源阻断,额外文件按实际结果判断,每文件须有通过用例;Vitest 原生模糊匹配不保证仅执行指定文件 |
| typecheck/lint | test-tool exit runner | 已实现;仅承诺命令退出状态 |
| E2E smoke runner、失败和 artifacts | test-tool Playwright adapter | 已实现报告解析、trace等输出保留;未做业务 UI/真实账号验收 |
| smoke 未 mock 的浏览器 XHR/fetch 拦截 | 可复制 Playwright recipe | 已用 Chromium 验证兜底拦截与失败断言;不是完整网络沙箱,不审计 route.fetch/continue 等绕过;业务 adoption 待验证 |
| carrier、协作者、精确场景/覆盖点识别 | 业务 skill/rules + 后续领域 adapter | 待落地;用例名称数量不能替代语义覆盖审查 |
| 覆盖率百分比/分支阈值 | test-tool 显式 coverage 规则 | 已实现 Jest/Vitest 新鲜 json-summary、精确文件、逐文件阈值;changed-line 暂缓 |
| 测试基础设施 bootstrap、Vue2/3 模板、用例生成 | 可复用 recipe/skill,项目原生配置 | 模板尚待真实包提炼;不规划自动安装/升级引擎,缺失入口仍明确 blocked |
| 登录 fixture、mock、数据准备、服务 readiness | 业务 fixtures/rules、runner 原生配置 | 优先原生 webServer/fixture 与普通 check;不移植 readiness receipt 状态机,尚待真实业务验证 |
| WebView/App 人工验收 | 业务 skill/rules + Pi 阶段证据 | 仍需实际终端验收,runner通过不能替代 |
| 远程 Debug、Nous/Lark、上传/回归报告 | 后续独立领域能力 | 本版不实现,不将上传嵌入普通测试 |
| 工具自动升级 | 优先评估仓库依赖维护流程 | 用户确认的重要待办;方案/工具待定,尚未实现。保留自动升级目标,不继承测试前 require-latest 与现场安装回滚 |
| 独立重试循环、任务归档 | Pi | 新工具不继承重复实现;Pi 管授权/预算/完成 |
| stdout与细分测试报告、执行诊断 | test-tool | 本地报告保留,不上传,不重复采集 Pi 指标 |
| 生命周期、会话、并行、通用指标 | Pi | 沿用既有能力,新工具无私有耦合 |
接入步骤
- 在隔离安装环境确认使用新包 binary,避免旧
wenext-test命令冲突。 - 业务
.agents/rules/test-tool.json声明 FLT/E2E 必需性与场景名;.agents/rules/workflow.json声明一个公开 check/verify 命令。按目录族使用 override,避免逐包维护大表。 - 为 Vue2/Jest、Vue3/Vitest 各选一个真实业务包,先 plan,再准备依赖/环境,执行实际 FLT/E2E。普通测试、runner配置和业务 fixtures 属于业务源码,不属于待清理的通用工作流脚本。
- 补齐 carrier/场景覆盖、bootstrap、登录/readiness 等迁移缺口,再逐项移除对应旧通用脚本;未验证替代能力前保持旧流程可用。
- 最终清理工作流资产至 AGENTS.md、skills、rules。该目标不意味着删除正常产品脚本、测试文件或构建配置。
本版不把“支持另一个 runner adapter”表述为“所有端已验收”;可通过 JSON runner 或 typed adapter 扩展,只有真实场景验证后才声明具体平台支持。
2026-10-20 的取舍、旧源码依据、优先级和逐项验收条件见 精简迁移评估。后续不以补齐旧包所有命令为目标。