跳转至

点内置视图被静默踢到完整模式 —— 而且我在提交说明里声称修好了一个其实没交付的 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')), 逐个确认它们是否还成立。三路设计审查没追到这一层,是因为它们审的是方案,不是实现后的调用图。