跳转至

吸顶从未生效 + truncated 返工

怎么发现的

v0.10.181–186 六刀送 terra-dsh + dshf 双路对抗审。 dshf 报了 5 条 P1,全部坐实。

(terra 那一路连着两轮停在第一步:第一轮抓出我把范围写成 29f56be..85a0a43 而 git 的 A..B 不含 A ⇒ v0.10.181 根本没进送审;第二轮抓出我只改了任务书里 三处范围表述中的一处、三处自相矛盾。两次都对,见文末。)

P1-1 🔴 v0.10.184 的「Tab 吸顶」从未生效

Tony 提的需求,我加了 position:'sticky' + top:0 + 底色,测试绿,他也看了截图。 但它根本没吸顶。

  • MUI Card root 自带 overflow: 'hidden'(Card.js:31)
  • 本仓主题 theme/overrides/components/card.tsx 只覆盖 position/boxShadow/radius/zIndex, 没动 overflow —— 那行 zIndex: 0, // Fix Safari overflow: hidden with border radius 正说明作者知道这个 overflow 存在

而 overflow:hidden 的元素就是一个滚动容器(只是不能用户滚)。 position:sticky 的定位参照是最近的滚动容器 ⇒ 它相对这张永不滚动的 Card 吸顶 ⇒ 永远不触发。真正在滚的是外层 main-layout 的 overflow:'auto' Box,被 Card 挡住了。

🔴 而我 v0.10.184 写的注释「Card 自己不 overflow」是错的: v0.10.21 去掉的是 CardContent 的 overflow:auto,Card 的 hidden 从来没动过。

🔴 断言也没守住:它只 grep 了 sticky / top:0 / bgcolor 三条属性, 祖先链在它视野之外 ⇒ 功能坏了照样绿。 这是「判据只覆盖了你写下的那几行,没覆盖让它生效的前提」。

⇒ <Card sx={{ width: 1, overflow: 'visible' }}> + 断言扩到 Card 的 sx。

P1-2 🔴 v0.10.186 的新判据在边界值误报

truncated = sampleDone.length >= ROWS_CAP   // 窗口 limit 正好 ROWS_CAP

库里恰好 5 万条已完成、一条都没被截,sampleDone.length === 50000 ⇒ 报截断 ⇒ 弹出「当前 50,000 条已超出采样覆盖(上限 100,000 条)」——同一句里自相矛盾。 旧判据 50000 > 50000 = false,不出这个横幅 ⇒ 这是 v0.10.186 引入的边界回归。

⚠️ 同仓 manual-rescrape.ts:90-101 早就踩过并修好了,注释逐字写着 「多取 1 行做截断判据;旧版 >= SCAN_CAP 会在边界值误报」,还配了 「恰好 100000 条 = 窗口刚好装满,不误报」的边界用例。我又踩了一次。

⇒ limit: ROWS_CAP + 1 + > ROWS_CAP(照搬同仓范式),并把多取的探测行从统计里剔除。

P1-3 🔴 v0.10.186 丢掉了一个真实信号

我当时的诊断说旧判据「量错了东西」—— 只对了一半。

旧判据 total > sampleDone + samplePending 量的不是「窗口撞墙」, 而是「有多少行没进样本」。那是一个真实且有用的量, 错的是它被安上了 truncated 这个名字、配上了「采样上限」的文案。

v0.10.186 把它整个换掉,于是这个场景信号彻底消失:

20 万行:15 万条 status=3(失败终态)+ 4.9999 万条 status=2
⇒ 两个窗口都没撞顶 ⇒ truncated=false ⇒ 什么都不提示
⇒ 用户看到的「有邮箱 / 有网址 / 高评分」只覆盖了 1/4 的数据

⇒ 拆成两个独立信号,各自说各自的话:

信号 含义 表达方式
truncated 窗口真撞墙,统计只覆盖最近 N 条 Alert(少见,值得打断)
failedCount 失败终态的行数,它们不进任何窗口 caption(常态,不打断)

🔴 用 caption 而不是 Alert 是刻意的:抓取失败是常态(网站打不开、反爬、超时), 用警告级组件表达常态,几天之后它就变成新的背景噪音 —— 而这一天已经修过两次「噪音把真信号盖住」(36 条 preload 警告、truncated 恒真)。

「挖掘中」(status=1) 不进这两个信号:它是瞬态,几秒后就变 2 或 3, 为它弹提示就是 v0.10.186 之前那种「只要在采集就报警」。

P1-4 采样提示里的量级仍是假的

sampleLimit: ROWS_CAP * 2 ⇒ UI 说「最近 100,000 条的采样数」。 而实际是两个各 5 万的窗口,pending=0 时样本只有 5 万 —— 不存在一个 10 万条的窗口。

⇒ sampleLimit 语义订正为「每个窗口的上限」,另加 sampleSize(本次实际扫到的行数), UI 说真话:「最近 N 条的采样数(每个扫描窗口上限 5 万,共两个窗口)」。

P1-5 v0.10.186 的「订正错误注释」只做了一半

local-data-view.tsx:862-866 仍在叙述 total > sampleSize 这个已被删除的判据。 注释在描述一个不存在的东西,比没有注释更坏 —— 照它理解的人会去找一个找不到的分支。

🔴 元教训:同一个事实出现在多处,我只改一处

这一天里同一个模式犯了三次:

# 事实 改了 漏了
1 「填 0 = 过滤关闭」(v0.10.181) wiki UI 的两处 helper
2 truncated 判据(v0.10.186) merchant-stats + 一段注释 同一 Alert 里的第二段注释
3 送审范围(审查任务书) 「送审对象」那行 取证命令 + 第一步核验,共两处

第 3 次是被审查方当场抓住的 —— 它按「对不上就停」的纪律拒绝往下审,做得对。

⇒ 工序:改一处「事实」之前先 grep -c 数清楚它出现在几个地方, 改完再 grep 一次确认残留为 0。这一天的三次里,只要做了这一步就都不会发生。

验证

tests/merchant-stats-truncated.test.ts 扩到 9 条(补边界、off-by-one、失败行、sampleLimit 语义), settings-copy-guards 补 Card overflow 断言。 4 条定向变异全部打红(退回 >= / 去掉 failedCount / sampleLimit 变回两窗之和 / Card 去掉 overflow)。 vitest 1610 全绿(73 文件)。

⚠️ P1-1 的渲染验证仍是证据边界:CSS 机制上有把握,但扩展页面跑不进普通浏览器, 需要加载 unpacked 滚一下确认。

🔴 v0.10.188 追修:第三路 terra 独立发现的两条

terra-dsh(第三次派,范围统一后)独立命中了 dshf 的边界误报(两路独立发现同一条 = 高置信), 另外多报两条 dshf 没看到的:

A. taskId 路径也有同样的边界病,而且后果更怪

truncated: allRows.length >= ROWS_CAP    // 撞的是【全表】窗口

它撞的是全表窗口,报的却是当前任务截断。 构造:全库恰好 50,000 行、当前任务只有 1 行 ⇒ 报「该任务的统计可能没覆盖全部数据」, 而那 1 行明明完完整整在样本里。

⇒ 与无 taskId 路径同样处理:limit: ROWS_CAP + 1 + >,探测行不进统计。

B. 失败留痕里的 error 没限长 —— 同一个坑的第三种形态

v0.10.181 把 ids: dropIds 换成 count + sampleIds,漏了 error: String(e)。 一条带堆栈或带整段 SQL 的 error 照样能把 detail 顶过 2048, 于是 count / sampleIds / error 三个一起被换成预览串 —— 而排障时最需要的恰恰是 error 的开头。

⇒ String(e).slice(0, ERROR_MAX_CHARS),常量带注释说明「限的不是这一个字段, 是整条记录能不能活下来」。

⚠️ 注意这两条的来源:它们都不是「dshf 漏了」,而是两路的搜索角度不同 —— dshf 深挖了 UI/CSS 与信号语义,terra 深挖了两条路径的对称性与字段级边界。 这正是双路的价值:不是互相复核同一份清单,是覆盖对方看不到的角度。

4 条定向变异全部打红(含这两条各一条)。vitest 1615 全绿(73 文件)。