重排把响应快照变成了死控件¶
怎么发现的¶
v0.10.189–191 送 terra-dsh + dshf 双路。两路都 GO-WITH-CHANGES、P0=0,共 6 条 P1。
两路独立命中同一族(codeOnly 的注释绕过)⇒ 高置信。
P1-1 🔴 响应快照成了死控件¶
v0.10.191 把响应快照从「⚡ 多阶段抓取」的 Stack 搬进「高级 · 诊断与稳定性」。
而快照只由多阶段 pipeline 写:
website-scrape-pipeline.ts:256/270/319 maybeWriteFetchSnapshot(...) ← 全仓唯一调用方
↑ 这条 pipeline 只在
scraper-executor.ts:261 if (enableMultiStageScrape === true)
↑ 而默认值是
storage-data.ts:247-248 enableMultiStageScrape: false · enableFetchSnapshot: true
⇒ 开箱即用状态下,这个开关是死的:它开着,但永远不会记录任何东西。 用户采一整轮,「日志 → 响应快照」永远为空,两条开关的 helper 都没提这个前提。
🔴 耦合早于 v0.10.191,但 191 恰好拆掉了唯一能看出因果的同屏关系 —— 原先两个开关挨在一起,用户还能从同屏推出依赖;分到两个折叠区后,这条线索没了。
更糟的是我在 commit 里把快照归因成「调试功能、不影响抓取」—— 那个归因让耦合更隐蔽:它暗示这个开关是独立的,而它恰恰完全依赖另一个开关。
修:分类没错,错在把依赖一起藏掉了¶
它确实属于「诊断」,不搬回去。把依赖当场说出来: 多阶段关着而快照开着时,在快照区显示一条警示 「⚠️ 这个开关现在不会记录任何东西 —— 快照只在「高级 · 网站抓取 → ⚡ 多阶段抓取」开启时才会写入」。
🔴 只在真的不会记录时出声 —— 无差别提示会变噪音(v0.10.177 立的规矩)。
P1-2 hint 没跟着切分改¶
hint="进站策略 / 内页跟随 / 解析规则" —— 而内页跟随已成「爬取范围」、
解析规则已成「内容提取」,两块都搬走了。hint 在承诺它们还在里面,用户按它去找会找不到。
⇒ 改为「进站策略 / 域名黑名单 / 多阶段」。 ⚠️ 这是「同一个事实出现在多处、只改了一处」的第四次(前三次见 0159-sticky-eaten-by-card-overflow-and-truncated-rework)—— 切分时改了 title、改了内容,漏了 hint。
P1-3 🔴 codeOnly 的同族绕过(两路独立命中)¶
v0.10.189 刚补了块注释剥离并声称「堵住」,实测仍有两个同族:
// don't ← 行注释里的撇号污染了块注释那一遍的引号状态机
/* Bearer token */ ← 于是这一行没被剥,断言照样命中 Bearer
const s = `x${/* Bearer token */ 1}y`; ← 模板插值内部是代码上下文,没被当代码处理
🔴 病根不是漏了某个形态,是把它拆成了两遍: 注释、字符串、模板嵌套是同一套词法,分两遍扫,每一遍都只知道自己那一半,必然互相污染。
⇒ 重写成单遍状态机(模板嵌套用栈跟踪 ${} 切回代码上下文)。
⚠️ 新写的断言当场抓到了我自己的实现¶
补测试时写了一条「模板字符串的文本部分不许被当成代码动」,
第一版实现立刻红了 —— `看这个地址 https://a.com/b 和 /* 这不是注释 */`
里的内容被剥掉了。修法是把模板文本段前置到注释判断之前。
这正是断言该做的事:它守的不是我以为对的东西,是我实际写出来的东西。
P1-4 顺序断言的锚点可被伪造(terra)¶
⑩/⑪ 用 code.indexOf('title="…"') 定位。
在代码任意角落写一句 const fake = 'title="高级 · 爬取范围"'; 就能伪造锚点 ——
它量的是「字符串在文件里的位置」,而不是「那张卡在页面上的位置」。
⇒ 加锚点唯一性断言:命中必须恰好 1 次。
P1-5 唯一实现元闸漏了箭头函数(terra)¶
元闸只认 function codeOnly(,漏掉 const codeOnly = (t) => … 和 const codeOnly = function(。
⇒ 判据要覆盖声明的所有形态,不是你当时恰好用的那一种。
⚠️ 修的过程里我又用了一次 git checkout¶
还原变异时用 git checkout tests/settings-copy-guards.test.ts,
把本轮刚加的 P1-4 断言一起还原了 —— 今天第二次(第一次见 0156-mutation-restore-wiped-a-real-edit,
当时已写进铁律第七章)。这次立刻发现(grep -c "锚点不唯一" = 0)并重做。
🔴 知道一条规则,和在手快的那一刻遵守它,是两件事。 这也是为什么那条要变成工序(备份 + diff 确认),而不只是一条记住的规则。
验证¶
- 两个绕过构造复打被堵,另加一条「模板文本不许被动」
- 伪造锚点变异打红 · 箭头函数形态元闸打红
- vitest 1628 全绿(74 文件)