test(criteria): runner 不再手写 --test(由内容推导)+ 自检 4「这条判据能不能红」;规范补两档

pi 提的三条,第一条落地前先按他的要求**贴真实样本实测**,结论与他的猜测不同(记在代码里)。

## 1 runner 内部那个"配错 flag = 绿" —— 实测后换了个形状

pi 的猜测:给自定义 `check()` 的判据传 `--test`,runner 会报"0 个测试"并以 0 退出。
实测(node v22.22.2,两条真实样本):

- `node --test <自定义 check() 判据>`:**退出码照样传出来**(文件 exit 1 → 命令行 exit 1),
  没有被吞;
- 但 `node --test <什么都不做的文件>` 报 `# tests 1 / # pass 1` ——
  **pass 计数不是"检查跑过"的证据**。

所以"解析 pass 计数、0 就判红"这条路两头不讨好:抓不到空判据(它报 1),
还会在 `narrow-layout` 上误报(它的汇总行是"窄屏布局:全部通过",里面没有数字)——
正是 pi 提醒的"别照抄我的正则,先贴样本"。

换成两条**结构证据**:

- **`--test` 不再手写**:由文件内容推导(源码里 `from 'node:test'` 就走 node:test),
  清单里出现手写 `--test` 直接红 —— 配对错误不再靠记性维护;
- **自检 4**:每条判据文件里必须存在"能红"的路径(`test(` / `check(` / `process.exit(1)`),
  外加"跑完必须有输出"。一个都没有 = 它永远不会红,与"全通过"长得一模一样
  (这是"判据自己不会跑"家族的第 6 个宿主,家族表和六种宿主都写进规范了)。

变异:清单手写 `--test` → 红;加一条"什么都不做、退出 0"的判据 → 红;
静默成功(有能红路径但一行不输出)→ 红。

## 2 规范 §3 补一档:变异红了还要看**红在哪**(pi)

"只报红了不算,要能指名红的是哪几条";**红在解析/加载失败上不算红**(先让变异
"语法正确、语义错");变异作用于被剥掉的注释也不算。

## 3 `CRITERIA.md` 的可见性(pi 提的位置问题)

它管两个客户端的判据,却躺在 electron 的测试目录里。已在
`docs/HARMONY-ALIGN-PLAN.md` §四(验收纪律)加指针,并顺手把 pi 点名过的两条口径写死在那儿:
**"未验"只能用于"步骤做过、结果没看",功能不存在必须写"没做"**;
**"机制上确定不同"要判、不许记成"未验"**(深色档预设那次)。

## 验证

`npm test` 退出码 0(12 个判据文件全绿 + vitest 258/258)。
This commit is contained in:
2026-09-14 15:00:26 +08:00
parent 22c9be7181
commit 4babc96f8b
3 changed files with 101 additions and 9 deletions

View File

@ -88,7 +88,15 @@ WebUI 侧踩过这个坑,见 `gateway/handler/permission.go` 的 Note 传递
1. 每个页面都要有**点它**的判据WebUI 侧就是因为只验结构没验点击
漏掉了"侧栏点了不翻页")。
2. 判据不许只看截图要量几何/对比度/命中区
3. 无法验证的要**如实标注**例如"编译通过视觉未验"不能写成"已完成"。
3. 无法验证的要**如实标注**例如"编译通过视觉未验"不能写成"已完成"
两条口径这轮各踩过一次pi 复核时点名
- **"未验"只能用于"步骤做过结果没看"**功能不存在必须写"**没做**"
"没做"写成"没验"会让人以为只剩观感风险实际那里什么都没有
- **"机制上确定不同"要判不许记成"未验"**深色档预设那次就是)。
4. **判据怎么写** `client/electron/test/CRITERIA.md` —— 那份规范管**两个客户端**的判据
判结构与行为不判字面与邻接清单与 allow-list 的形状变异要红在预期位置
"判据自己不会跑"那个家族的六种宿主)。**写在 electron 的测试目录下只是因为
`run-all.mjs` 在那儿强制它存在**鸿蒙侧改判据前先读它
---