断言体检:三种绕过¶
起因¶
对抗审 terra-dsh 在 X_FAKEGREEN 里留了一条泛指没展开:
多个 settings/manifest 测试是可被无关字符串或行内块注释绕过的源码断言
泛指不能直接修 —— 得先把它变成具体构造。体检实测确认了三种,每一种都能让一批断言 在功能已经坏掉的情况下全绿:
| # | 构造 | 实测效果 |
|---|---|---|
| B | 用户可见文案删成死亡短语,补一个行内块注释 /* Tab */ |
18 条全绿 |
| A1 | 真正的使用处换成常量,只留 import { isCloudBaseUrlRejected } |
18 条全绿 |
| A3 | 兜底写成 \|\| (1);或另加一句 void DefaultSettings.maxConcurrentTasks; |
该条不红 |
B:块注释 —— codeOnly 只剥了两种注释里的两种¶
codeOnly 的演进史本身就是这个坑的三次迭代:
v0.10.177 直接 src.includes() ⇒ 把测试自己注释里的引用算成违规(自己抓自己)
v0.10.178 剥整行 // ⇒ 行内 `code(); // Bearer` 照样喂给断言
v0.10.184 补剥行内 // ⇒ 块注释 /* */ 没管 ← 本次
三次的共同形态:要守的是「用户看得见的字符串」,量的却是「文件里有没有这个串」。 而写得越认真、注释里越会复述那个串 —— 注释质量越高,断言越容易失效。
⇒ 补 stripBlockComments(引号状态机,保护 'https://…' 与 '/* 不是注释 */')。
A1:只 import 不调用 —— 与 v0.10.187 的 getBaseUrl 漏抓是同一个病¶
而 import { isCloudBaseUrlRejected } from './…' 那一行也含这个名字
⇒ 把真正的使用处换成 const cloudSyncUrlRejected = false;,断言照样绿。
v0.10.187 刚在 getBaseUrl 上踩过一模一样的(当时变异首打没抓住,收紧到函数体才抓)。
⇒ 判据落到调用处:/const cloudSyncUrlRejected[\s\S]{0,200}isCloudBaseUrlRejected\(/。
A3:括号绕过字面量正则¶
/maxConcurrentTasks\s*\|\|\s*\d+/ 匹配不到 || (1)。
⚠️ terra 在 v0.10.181 那一轮的 X_FAKEGREEN 里就写过这个构造,我当时没处理 ——
审查方给了具体构造而没被落地,等于这轮审查在这一条上白做了。
⇒ 正则容忍括号与空白;「必须引真相源」那条也从「文件里有没有」改成
「兜底表达式本身紧跟真相源」,堵掉 void DefaultSettings.x; 凑数。
连带:codeOnly 有四份拷贝¶
settings-copy-guards / settings-field-ui-coverage / settings-default-single-source /
manifest-war-and-preload 各存一份。
🔴 四份拷贝 = 四个会各自分叉的真相源 —— 补块注释剥离时只改一份,另外三份继续漏。 而这一天已经为「同一个事实出现在多处、只改了一处」栽过三次 (0156-mutation-restore-wiped-a-real-edit 记了前两次)。
⇒ 抽到 tests/_helpers/code-only.ts,并加元闸:测试文件里不许再本地定义
codeOnly / stripInlineComment / stripBlockComments。
另一个顺带发现:锚点用错了标识符¶
catch 断言原先用 code.indexOf('maxConcurrentTasks || DefaultSettings.maxConcurrentTasks')
当锚点 —— 表达式一改动,断言会因为「找不到锚点」而红,
红的理由却和它要守的东西无关(体检时 || (1) 那次就是这样撞上的)。
改用函数名当锚点后又撞到第二层:两个文件里的函数名不一样
(getMaxConcurrentTasks vs getGlobalConcurrency),第一版用同名假设当场报「找不到」。
⚠️ 「两处叫同一个名字」本身就是一个未经核实的事实。
验证¶
新增 tests/assert-quality-guards.test.ts 5 条(元闸 + 三种绕过的行为测试)。
三种绕过构造全部复打被抓。vitest 1620 全绿(74 文件)。
元教训¶
审查方给出的具体构造,没落地就等于没审。
A3 这条在 v0.10.181 的报告里白纸黑字写着,我当时只处理了它报的 P0/P1,
把 X_FAKEGREEN 当成了「参考信息」。而 X_FAKEGREEN 恰恰是最该落地的部分 ——
P0/P1 说的是「现在坏了什么」,假绿构造说的是「下次坏了你也不会知道」。
⚠️ 写这份 issue 时又踩了第四次同款¶
第一版给它挂了一条 audit_grep,paths 指向 tests/settings-default-single-source.test.ts
—— 门禁当场报 audit_grep 路径契约解析失败:paths 超出默认扫描根。
scan:issue-coverage 的扫描根是 src / scripts / wxt.config.ts / package.json,够不着 tests/。
🔴 这件事我在 0154-default-settings-match-no-preset 里逐字写过一遍 (那条也是想把测试文件挂进 audit_grep 被拦),然后这次又写了一次。
⇒ 本 issue 的三条判据只能由 vitest 守住:tests/assert-quality-guards.test.ts
与三个被收紧的断言本身。删了它们,没有任何静态闸会响。