批次三-B 的四支验证台 —— 怎么跑、看什么

这四支是验收用的：不连库、不连上游、不发任何网络请求，也不需要登录凭据。它们直接编译真的 Vue SFC、跑 frontend/ 里那份真的 vue、驱动页面的真 setup()，只把 @/api 与上传子组件桩掉。

来源与搬迁经过见 .claude/plan/2026-09-23-lsy-onboarding-B-交付说明.md §四 4。 本 README 的每一条命令与读数都是 2026-09-23 在交付提交 20a222b 上实跑取的，不是转述。

0. 公共前提

Node：实测 v22.22.3。
工作目录：README 里的命令以仓库根 D:/project2/payment-platform 为 cwd 写。台子内部用的是绝对路径，换 cwd 不影响结果（已实测：从 D:\ 跑同样通过）。
依赖 frontend/node_modules：台子用 createRequire 指到 frontend/package.json 来加载 vue 与 @vue/compiler-sfc ⇒ 那个目录不存在时加载这一关就过不去，先 pnpm i。
跑之前 git status -- frontend/ 应当是干净的，跑完还应当是干净的（下面每支都不写生产文件， fe-update-mutate 的 restore 分支也一样）。

1. 两支要传页面路径的台子（不传会崩）

这两支把目标页面当命令行参数读（process.argv[2]）：

PG="D:/project2/payment-platform/frontend/src/views/module_payment/collection/onboarding/index.vue"

node .claude/plan/2026-09-23-lsy-onboarding-B-harness/task-9-fix1-harness.mjs "$PG"
node .claude/plan/2026-09-23-lsy-onboarding-B-harness/fe-update-harness.mjs "$PG"

忘了传参数会怎样：立刻崩，TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string ... Received undefined （栈顶是 compileSfc 里的 readFileSync），退出码 1。看到这个就是漏了页面路径，不是台子坏了。

判成败只看 `SUMMARY` 行

两支都会在最后打一行汇总。不要看退出码：台子故意不设 process.exitCode （fe-update-harness.mjs 第 14 行的注释就是这么写的），所以有 FAIL 也退 0；唯一会给出非 0 退出码的情况是上面那种「参数没传」的崩溃。

所以判据是这两行里的 fail=：

SUMMARY <页面路径>: pass=25 fail=0      ← task-9-fix1-harness.mjs
SUMMARY <页面路径>: pass=43 fail=0      ← fe-update-harness.mjs

有失败时同一行会追加失败用例名：... fail=2 -> <用例名> | <用例名>。

交付提交 20a222b 上的实测读数就是上面这两个（各 1 次，exit=0，frontend/ 跑完仍干净）。

★ 顺手可以把 stderr 丢掉，屏幕只剩 PASS 与 SUMMARY（实测：2>/dev/null 后 stdout 为 27 行且不含 [Vue warn]）—— 台子的告警与桩报错都在 stderr，stdout 是干净的判据流。

各自钉什么

task-9-fix1-harness.mjs（25 条）：进件页 Task 9 那处修复（商户号回显 / 警示）的判定逻辑，含两条正对照（G4「正常商户号 ⇒ 显示出来」、G5「正常商户号 ⇒ 不置警示」） —— 没有正对照的话「一律不显示」也会全绿。
fe-update-harness.mjs（43 条）：R-7c「建号 / 更新」两个模式各自的报文形状（U1/U1b 更新报文不含 merchant_name_business；Z5/Z6 更新集与建号集里都没有 category / tenant_id / rate_code）。

已知局限（别把它的绿读大）

模板不渲染 ⇒ 它证明的是函数判定逻辑，不证明浏览器里的表现。
stderr 上会出现一条 [Vue warn]: onMounted is called when there is no active component instance... —— 这是桩环境没有组件实例导致的，预期内，不是失败。
stderr 上还会有一段桩出来的报错（例如 级联数据加载失败： Error: 网络挂了），那是故意注入的网络失败用例在走错误分支，同样不是失败。（这两条都实测过只在 stderr：2>/dev/null 之后 stdout 里一个都没有。）

2. 静态键名核对台（不需要参数）

node .claude/plan/2026-09-23-lsy-onboarding-B-harness/fe-update-keycheck.mjs

退出码 0 + 末行 SUMMARY keycheck: 全绿。它比对前后端两侧的字段键名集合，确认没有拼错的键（跨端键名拼错在运行时只会表现为「字段悄悄没发出去」）。

★ 这支是四支里唯一搬过家时改过内容的一支：原先写死了兄弟台子的工作区绝对路径，搬完就成了一个已删除的文件 ⇒ 改成按自身位置相对定位（fileURLToPath(new URL("./fe-update-harness.mjs", import.meta.url))）。所以它必须与 fe-update-harness.mjs 待在同一个目录里。

3. 变异驱动（跑之前先看清楚）

node .claude/plan/2026-09-23-lsy-onboarding-B-harness/fe-update-mutate.mjs restore

restore：把备份 .mut-bak 还原回生产文件。没有备份时什么都不做，退出码 0。
传其它任何 id（M-U1 / M-U2 / M-U3 / M-U5 / M-T1 / M-T2）：会真的改生产前端文件 （frontend/src/views/module_payment/collection/onboarding/index.vue 与 frontend/src/api/module_payment/onboarding.ts），并在同目录留 .mut-bak。跑完必须用 restore 还原，再用 git status -- frontend/ 确认干净。

验收不需要跑变异。 想跑的话按「先 git status 干净 → 变异 → 跑第 1 节的两支台子看读数变化 → restore → 再 git status 干净」的顺序。

4. 核指纹时注意行尾

本仓 core.autocrlf = true 且没有 .gitattributes ⇒ 重新 checkout 会把工作区文件抹成 CRLF。两种形态都实测过，不是按行数推算的（LF 即当前工作区形态）：

文件	LF 字节	LF sha256
`task-9-fix1-harness.mjs`	10796	`7f07de4099c96a23c56c1238aeb002857ed8bc10c83458feab5b979cac5bc095`
`fe-update-harness.mjs`	12783	`5b91fa4b452d6aa6816ec523c2c057d28422a3a055d2e725c87af74b63984dad`
`fe-update-keycheck.mjs`	6874	`3d4033167ed8950cda71c3396d77fe4968f70aafef915f2616193a675eba1767`
`fe-update-mutate.mjs`	4197	`a3e68dff6d58fd86a6b219c2de50f98493434bc929c544d9f77bb1af9565a330`

CRLF 形态：11049 / 13057 / 7002 / 4294 字节，sha256 见交付说明 §四 4。 核出 CRLF 那组数不是文件被改过，是行尾。

README.md 6.3 KB Historia Raaka