|
|
2d8f5424b5
|
test(criteria): 规范补两条 + 还原纪律改写成"先固化基线再破坏"
pi 三条增量的第三条（纠正我的写法）与配套文档：
## 1 还原纪律：禁令 → 操作顺序（pi 纠正）
我原来写的是"变异后不要用 `git checkout` 还原"——**治症不治因**。真因是
**被还原到的那个状态还没提交**（我丢的是一个刚加、尚未提交的 marker）。
可执行的形状：
> **任何破坏性还原，都要求"将被还原到的那个状态已经在某个提交里"。**
所以：**变异前先把基线提交掉**；更稳就 `git worktree add` 一个干净副本去变异。
`cp` 备份仍然可用，但它依赖"人记得备份"，顺序改对了则不依赖记性 ——
与"记得打 marker"改成"计数写在 `check()` 内部"是同一招。
本提交自身就是这条纪律的示范：先提交 `ec90cba`（helper + 移植 + 错误信息）作为基线，
再在已提交的基线上做 marker 变异验证。
## 2 共享 helper 与"失败信息自带修法"写进 §6.6
- `test/lib/checks.mjs` 的存在理由与用法（计数只可能在该模块内发生 →
漏 marker / 计数写错位置在新判据上不可能发生）；
- **失败信息要自带修法**：red 是那个人一定会看到的东西，文档不一定被打开。
验证方式也记了：真删掉一条判据的 marker 行跑一遍，确认错误信息能照抄执行
（已验：输出里给了 helper 用法与样板文件路径，且 `node:test` 的判据不用管）。
## 3 规范自检关键词 7 → 9
新增 '已经在某个提交里'、'自带修法'，防止这两条被删掉还不报错。
## 验证
`npm test` 退出码 0（12 个判据文件全绿 + vitest 258/258）。
|
2026-09-14 15:12:19 +08:00 |
|
|
|
a8ac2fc28b
|
test(criteria): 闭环——判据自报条数 + 每文件期望条数（只增不减的棘轮）
pi 指出的残余缺口：我上一轮加的自检 4 是**文本证据**（文件里有 `test(` / `check(` /
`process.exit(1)`），只能证明"**有能红的路径**"，不能证明"**它跑过**"。反例很短：
```js
const check = () => {}; // 实现被换空（现实形态：合并冲突改坏实现）
check('a', false); // 存在、也执行了，但什么都不会红
console.log('主题：通过'); // 有输出
```
## 落地（pi 给的闭环形状）
1. 自定义 `check()` 的判据结尾打一行机器可读汇总 `RESULT pass=<条数> fail=<失败数>`
（`node:test` 的判据不用改，已有 `# pass N`）；
2. `run-all.mjs` **只解析这个固定 marker**（不猜口语汇总——「窄屏布局：全部通过」里没有数字，
按数字猜会误报，这一点我上轮已经实测过）；
3. 与清单里登记的**期望条数**比对，**低于 → 红**。
关键细节：**计数写在 `check()` 内部**（theme/background 原本就在内部 ++；
narrow-layout 只有 failed 计数，补了 passed；markdown-xss 按 payload 条数算）。
写在调用点或靠扫源码的话，"实现被换空"就看不见了。
棘轮"只增不减"：加判据**不用**改那个数，只有"条数掉了"才红。期望值按**实测**回填
（9/52/8/30/42/15/28/5/23/5/3/2）。
附带的可见性收益：这几轮我一直用"13→14""19→28""34→42"当信号，现在它成了判据 ——
某次改动顺手删掉两条判据、或某条被跳过，会立刻红。
## 变异
- pi 那个反例（`check` 换成空函数）→ 红（`自报 0 条 < 登记的 30 条`）；
- 删掉 5 条 `check(` 调用 → 红（`自报 47 条 < 登记的 52 条`）。
## 规范
§6.5 新增"涉及运行时行为的结论必须实测过才能写进规范/判据"——同一个错这轮犯了两次
（我从"报告 0 个测试、退出 0"推断"退出码被吞"，实测是照传；pi 拿我这个结论又建了一个洞）。
规则：**一次观察只支撑你看到的那一层**。
§6.6 记闭环形状与代价（故意删判据要同步改数字，属于一次可复核的显式编辑）。
⚠️ 并且如实记下一次**我自己违反规范**的事：写 §3 那条"变异后别用 `git checkout` 还原"的人
（就是我）在这次变异验证里又用了 `git checkout -- <文件>`，把刚加、尚未提交的 marker 抹掉了。
规矩写下来不等于会遵守 —— 已把这条实例写进规范，让人知道它是活人踩的坑。
## 验证
`npm test` 退出码 0（12 个判据文件全绿 + vitest 258/258）；`run-all` 单独跑也 exit 0。
|
2026-09-14 15:06:14 +08:00 |
|
|
|
4babc96f8b
|
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）。
|
2026-09-14 15:00:26 +08:00 |
|
|
|
0ce8b29546
|
test(criteria): 判据规范 CRITERIA.md（邻接不是结构·第三次露头）+ 废弃 API allow-list 结构化 + 扫描范围自检
pi 的两条增量，都不需要他再确认。
## 1（pi 建议）：生成清单 + 空 allow-list 的结构性风险
他的推演：SDK 升版会往清单里加新条目 → 某天早上套件**突然红**，且红在与本次改动无关的
代码上；这时人的第一反应是把名字塞进 allow-list —— 而 allow-list 一旦这么用，
就不再是"研究过的例外"，只是"红的止痛药"。所以条目结构化：
```js
const ALLOW = [ /* { name, replacement, why } */ ];
```
`replacement` 非空是硬断言（"暂时不想改"不是放行理由，"替代品要求的 API level 高于基线"才是）。
**刻意不断言"名单必须为空"** —— 那会挡住合理放行；断言的是"有名字、没替代品 → 红"，
于是侵蚀发生时红的是**放行这件事本身**，而不是某天的新 SDK。
变异：塞一条 `{ name:'px2vp', replacement:'', why:'暂时不想改' }` → 红。
## 2（pi 建议）：扫目录的判据要防"空判据"
他问废弃 API 判据扫哪些目录（怕只扫 `pages/`，`common/` 里的旧写法逃掉）。
答案：扫的是**整个 ets 目录递归**（实测 25 个文件，含 `pages/ common/ model/ api/ entryability/`）。
顺手加了防退化的自检：文件数 ≥ 20，且 `pages/ common/ model/ api/` 四个目录都必须扫到
—— 目录改名/只扫一个子目录会让这条变成空判据而依然全绿。
变异：把扫描范围改成只扫 `pages/` → 红。
## 3（pi 建议）：把"邻接不是结构"写进判据规范
同一个坑在本仓露头三次：① 窗口式正则被一行注释挤爆（原注释自嘲过）；
② 括号配对取代窗口；③ 链式修饰符让"看前一个字符是不是 `}`"静默失效。
共同形式值得升格成规则，于是新建 `client/electron/test/CRITERIA.md`（七条），
并在 `run-all.mjs` 加**自检 3**：规范文件必须在、且必须点到关键条目。
WebUI 侧 `background.test.mjs` 的窗口式存量按 pi 的说明**记着不动**（那是他的地盘）。
规范里另外两条是本仓自己踩出来的：剥注释读代码 vs 读原文读理由（混用必红）；
以及**验证要按真实入口跑** —— 我用 `node --test test/run-all.mjs` 验自检 3 时它"依然绿"，
其实是 runner 把内部的 `process.exit(1)` 吞了；换成 `npm test` 走的那一行就红对了。
变异：删掉规范里的一条关键规则 → `npm test` 那条路 exit 1。
## 验证
`npm test` 退出码 0（11 个判据文件全绿 + vitest 258/258）；`hvigorw assembleHap` 未受影响。
|
2026-09-14 14:51:30 +08:00 |
|
