跳转至

断言体检:三种绕过

起因

对抗审 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 漏抓是同一个病

expect(code, '…').toContain('isCloudBaseUrlRejected');   // 扫【整个文件】

而 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 与三个被收紧的断言本身。删了它们,没有任何静态闸会响。