JianFeeeee
4babc96f8b
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）。
179 lines
8.7 KiB
JavaScript
179 lines
8.7 KiB
JavaScript
/**
|
||
* 判据总入口 —— **全部跑完再算退出码**。
|
||
*
|
||
* 为什么不再用 `&&` 串起来：
|
||
*
|
||
* 原先 `npm test` 是 `a && b && c …`。这种行为有个不起眼但很贵的后果 ——
|
||
* **前面红一条，后面全部不跑**。于是"只红了一条"看起来像"只有一个问题"，
|
||
* 实际上后面那些判据连跑都没跑（这次就真发生了：`background` 红着，
|
||
* `packaging` 从来没跑到过，而它正是能发现"界面改了没重打包"的那条）。
|
||
* 换句话说：`&&` 链下的"全绿"是可信的，**"红"是不可信的**。
|
||
*
|
||
* 现在：每条判据都跑，红的收集起来，最后一起报、一起退出。
|
||
*
|
||
* 另外两条防"判据自己不会跑"的自检（与 process.exit 之后写判据是同一族问题）：
|
||
* 1. 清单里的文件必须存在（名字写错 = 静默跳过一条判据）；
|
||
* 2. `test/` 下的每个 `*.test.mjs` 都必须在清单里
|
||
* —— 这次 `cross-client-theme.test.mjs` 就是"写好了但没接进套件"，
|
||
* 在它进套件之前一直是隐身状态。加了这条，**新增判据忘了接线会直接红**。
|
||
* 3. 判据规范 `test/CRITERIA.md` 要在、且要点到那几条规则
|
||
* —— 写判据的规矩本身也会被"忘了带"（形状记在某个人的脑子里等于没有）。
|
||
*
|
||
* 写判据之前先读 `test/CRITERIA.md`（判结构与行为，不判字面与邻接）。
|
||
*/
|
||
import { spawnSync } from 'node:child_process';
|
||
import { existsSync, readFileSync, readdirSync } from 'node:fs';
|
||
import { dirname, join } from 'node:path';
|
||
import { fileURLToPath } from 'node:url';
|
||
|
||
const HERE = dirname(fileURLToPath(import.meta.url));
|
||
const ROOT = join(HERE, '..');
|
||
|
||
/**
|
||
* 判据清单：[文件, 额外 node 参数]。
|
||
*
|
||
* `--test` 给用 node:test 写的判据；鸿蒙那条要 `--experimental-strip-types`
|
||
* 才能直接执行 `client/harmony/.../MailGrouping.ts`（判据跑的是客户端真正引用的那份逻辑）。
|
||
*/
|
||
/*
|
||
* 自检 3：判据规范在不在、有没有写到那几条关键规则。
|
||
*
|
||
* 为什么把"文档"也判：`CRITERIA.md` 里的每条都是踩出来的（窗口式判据、邻接式判据、
|
||
* 生成的清单被侵蚀、剥注释读不到理由……）。规则只在某个人的脑子里时，下一个人会重踩一遍；
|
||
* 文件被删/被搬走却没人发现，等于规则也没了。这里只断"还在 + 关键条目还在"，
|
||
* 不断它的措辞 —— 那是笔记，不是接口。
|
||
*/
|
||
const CRITERIA_DOC = join(HERE, 'CRITERIA.md');
|
||
if (!existsSync(CRITERIA_DOC)) {
|
||
console.error('✗ 判据规范 test/CRITERIA.md 不见了（写判据的规矩不能只活在脑子里）');
|
||
process.exit(1);
|
||
}
|
||
const criteriaDoc = readFileSync(CRITERIA_DOC, 'utf8');
|
||
for (const must of ['配对/解析', 'allow-list', '变异验证', '剥掉注释', '按行']) {
|
||
if (!criteriaDoc.includes(must)) {
|
||
console.error(`✗ 判据规范里少了「${must}」这条 —— 规则被删掉了还是搬走了？`);
|
||
process.exit(1);
|
||
}
|
||
}
|
||
|
||
const SUITE = [
|
||
['test/markdown-xss.test.mjs', []],
|
||
['test/narrow-layout.test.mjs', []],
|
||
['test/nav-merge.test.mjs', []],
|
||
['test/theme.test.mjs', []],
|
||
['test/background.test.mjs', []],
|
||
['test/cross-client-theme.test.mjs', []],
|
||
['test/harmony-logic.test.mjs', ['--experimental-strip-types', '--no-warnings']],
|
||
['test/harmony-system-api.test.mjs', []],
|
||
// P4 外观同步：跑 model/Appearance.ts（纯逻辑），所以也要 strip-types
|
||
['test/harmony-appearance.test.mjs', ['--experimental-strip-types', '--no-warnings']],
|
||
['test/build-stamp.test.mjs', []],
|
||
['test/packaging.test.mjs', []],
|
||
['test/commit-hygiene.test.mjs', ['--experimental-strip-types', '--no-warnings']]
|
||
];
|
||
|
||
// 自检 1：清单里的文件必须真的存在（写错名字 = 那条判据永远不跑）
|
||
const ghosts = SUITE.map(([f]) => f).filter((f) => !existsSync(join(ROOT, f)));
|
||
// 自检 2：test/ 下每个 *.test.mjs 都要在清单里（防"写好了没接线"）
|
||
const onDisk = readdirSync(join(ROOT, 'test'))
|
||
.filter((f) => f.endsWith('.test.mjs'))
|
||
.map((f) => `test/${f}`);
|
||
const unwired = onDisk.filter((f) => !SUITE.some(([s]) => s === f));
|
||
|
||
if (ghosts.length || unwired.length) {
|
||
if (ghosts.length) console.error(`清单里的判据文件不存在：${ghosts.join('、')}`);
|
||
if (unwired.length) {
|
||
console.error(`这些判据文件没接进套件（写了却不会跑）：${unwired.join('、')}`);
|
||
}
|
||
process.exit(1);
|
||
}
|
||
|
||
/*
|
||
* 自检 3：判据不得写在 `process.exit()` **之后**（pi 提议，2026-09-14）。
|
||
*
|
||
* 自检 1/2 管的是"文件没接线"，管不到"检查写在了退出之后" —— 而那正是实际发生过的
|
||
* 第 4 例：4 条玻璃判据被并发写入落到了文件末尾、`process.exit()` 后面，
|
||
* 于是**一条都不执行、也不计入通过/失败**，输出看起来完全正常。
|
||
* 这种事的成因是结构性的（并发写入总是往文件末尾追加），所以它一定会再发生，
|
||
* 而它下一次仍然不报错 —— 静态扫一遍最省事。
|
||
*/
|
||
const buried = [];
|
||
for (const [file, flags] of SUITE) {
|
||
if (flags.includes('--test')) {
|
||
continue; // node:test 那几条没有 process.exit，结构上不会踩这个
|
||
}
|
||
const src = readFileSync(join(ROOT, file), 'utf8');
|
||
const exitAt = src.lastIndexOf('process.exit(');
|
||
if (exitAt >= 0 && /(^|\n)\s*check\(/.test(src.slice(exitAt))) {
|
||
buried.push(file);
|
||
}
|
||
}
|
||
if (buried.length) {
|
||
console.error(`判据写在 process.exit() 之后，永远不会跑（挪到汇总之前）：${buried.join('、')}`);
|
||
process.exit(1);
|
||
}
|
||
|
||
/*
|
||
* 自检 4（pi 2026-09-14 提的家族，第 6 例）：**"判据自己不会跑"**。
|
||
* 第 6 例的宿主是 runner 自己：清单里的 flag 与判据写法如果配错，症状是"看起来全绿"。
|
||
*
|
||
* ⚠️ 落地前先实测了两条真实样本，结论与 pi 的猜测**不同**，记在这里免得后人重猜：
|
||
* - `node --test <自定义 check() 的判据>`：**退出码照样传出来**（文件 exit 1 → 命令行 exit 1），
|
||
* 并没有被 runner 吞掉；
|
||
* - 但 `node --test <什么都不做的文件>` 会报 `# tests 1 / # pass 1` ——
|
||
* **计数不是"检查跑过"的证据**。所以"解析 pass 计数、0 就判红"这条路既
|
||
* 抓不到空判据（它报 1），又会在 `narrow-layout`（汇总行"全部通过"里没有数字）上误报。
|
||
*
|
||
* 换成**结构证据**：每条判据文件里必须存在"能红"的路径 ——
|
||
* node:test 的 `test(`、自定义 `check(`、或显式 `process.exit(1)`。
|
||
* 一个都没有 = 它永远不会红，与"全通过"长得一模一样。
|
||
* 再加一条"跑完必须有输出"（12 条判据现在都有输出），静默成功同样可疑。
|
||
*/
|
||
function shapeOf(file) {
|
||
const src = readFileSync(join(ROOT, file), 'utf8');
|
||
const usesNodeTest = /from 'node:test'/.test(src);
|
||
const canFail = usesNodeTest
|
||
|| /(^|[^.\w])check\(/.test(src)
|
||
|| /process\.exit\(\s*1\s*\)/.test(src);
|
||
return { usesNodeTest, canFail };
|
||
}
|
||
|
||
const shapeless = [];
|
||
for (const [file, flags] of SUITE) {
|
||
if (flags.includes('--test')) {
|
||
console.error(`清单里不要手写 --test（它由文件内容推导）：${file}`);
|
||
process.exit(1);
|
||
}
|
||
if (!existsSync(join(ROOT, file))) continue; // 自检 1 已经报过了
|
||
if (!shapeOf(file).canFail) shapeless.push(file);
|
||
}
|
||
if (shapeless.length) {
|
||
console.error('这些判据文件里找不到任何"能红"的路径（test( / check( / process.exit(1)）：'
|
||
+ `${shapeless.join('、')} —— 它们永远不会红，与"全通过"看起来一样`);
|
||
process.exit(1);
|
||
}
|
||
|
||
const reds = [];
|
||
for (const [file, flags] of SUITE) {
|
||
console.log(`\n========== ${file} ==========`);
|
||
const shape = shapeOf(file);
|
||
const all = shape.usesNodeTest ? [...flags, '--test'] : flags;
|
||
// 收集输出再自己打回去：观感不变（stdio:'inherit' 的等价物），但能顺手做"跑了吗"的检查
|
||
const r = spawnSync(process.execPath, [...all, join(ROOT, file)], { encoding: 'utf8' });
|
||
const out = (r.stdout || '') + (r.stderr || '');
|
||
process.stdout.write(r.stdout || '');
|
||
process.stderr.write(r.stderr || '');
|
||
// 不 break：后面每条都要跑出来，否则"红了几条"这个信息本身是假的
|
||
if (r.status !== 0) reds.push(`${file}（退出码 ${r.status}）`);
|
||
else if (out.trim().length === 0) reds.push(`${file}（跑完没有任何输出 —— 判据没跑起来的典型症状）`);
|
||
}
|
||
|
||
console.log(`\n========== 判据汇总 ==========`);
|
||
if (reds.length === 0) {
|
||
console.log(`全部通过（${SUITE.length} 个判据文件：${SUITE.map(([f]) => f.replace('test/', '').replace('.test.mjs', '')).join('、')}）`);
|
||
process.exit(0);
|
||
}
|
||
console.error(`红的判据（${reds.length}/${SUITE.length}）：`);
|
||
for (const r of reds) console.error(` - ${r}`);
|
||
process.exit(1);
|