点内置视图被静默踢到完整模式 —— 而且我在提交说明里声称修好了一个其实没交付的 bug
怎么发现的¶
v0.16.18 修完空表之后,我起了一个 6 假设并行 + 对抗验证的 workflow 复查。 它验证了我的修复方向,但同时抓到一条我完全没发现的 P0。
病理¶
local-data-view.tsx 有一道旧闸:
// 高级 filter(filters 数组非空)涉及 jsstore where 表达式解析,留给 server 处理
useEffect(() => {
if (filters && filters.length > 0 && mode === 'client') setMode('server');
}, [filters, mode]);
它的前提是「客户端不会解析筛选条件」。
SPEC-026 把六个内置视图的条件塞进了 filters,而它们都非空。
⇒ 在快速模式下点任何内置视图(有邮箱/有网址/高评分/已挖掘/待挖掘),
模式会被静默踢到「完整」。而 v0.16.16 里这些还是 quickFilter 维度,
在快速模式下工作正常 —— 这是 v0.16.17 引入的行为回归。
🔴 更重的一条:我声称修好的东西没有交付¶
v0.16.17 的提交说明里我写:
实施中发现一条三路审查也没追到的既有 bug:快速模式的过滤完全不看视图的 filters…… ⇒ 新建 utils/filters-eval.ts 客户端求值器
但 applyViewFilters 在 client 路径上根本跑不到 —— filters 一非空就被上面那道闸切到 server 了。
新建的 filters-eval.ts 在 client 路径上是死代码。
⇒ 「声称即实存」:我把一个没有交付的修复写成了已交付。 这条不是靠我自己发现的,是对抗排查抓出来的。
同一批还有第二处没兑现的承诺:clientDegradedRef 只写不读,
而 filters-eval.ts 的头注明确写着「degraded 为真时调用方必须如实告诉用户,不能假装筛过了」。
修法¶
- 闸改成只拦客户端算不动的:
!canEvalClientSide(filters)才切完整模式。 新增canEvalClientSide()—— 只要有一条算子求值器不认识就返回 false (部分能算等于算不准,而「筛得不准」比「慢一点」坏得多:用户按它导出,少掉的行没有任何提示) - 降级信号接进
dataSource.clientFilterDegraded并在模式开关旁如实呈现
判据新增 5 条,含「六个内置视图必须都能留在快速模式」和
「CLIENT_EVALUABLE_OPERATORS 与 evalFilter 的实现不许分叉」。
判据本身在这一轮里踩了三次坑(都记下来)¶
| # | 坑 | 修法 |
|---|---|---|
| 1 | indexOf("setMode('server')") 撞上注释里的同名字符串 ⇒ 窗口串到别处(本仓第三次) |
按行定位那条语句 |
| 2 | 正则 if \([^)]*...\) 被条件里 canEvalClientSide(filters) 的括号截断 ⇒ 匹配失败 |
同上,不跨括号 |
| 3 | toMatch(/clientFilterDegraded:/) 匹配到了 interface 里的类型声明,于是把返回值那行改坏也不红 |
改成匹配实际接出的完整表达式 |
第 3 条尤其值得记:「标识符出现过」≠「真的被接出去」,而类型声明恰好会让这类判据恒真。
元教训¶
改动推翻了一个旧判断时,要去找「依赖那个判断的所有闸」。
这道闸的注释里明明白白写着它的前提(「客户端不会解析筛选条件」), 而 SPEC-026 干的正是推翻这个前提的事 —— 我读过这一行(它就在我改的 effect 隔壁), 但没有把「我推翻了什么」和「谁依赖那个前提」连起来。
⇒ 判据:改一个前提时,grep 那个前提的关键词(这里是 mode === 'client' / setMode('server')),
逐个确认它们是否还成立。三路设计审查没追到这一层,是因为它们审的是方案,不是实现后的调用图。