ISSUE-0215 「快速模式」把整个库搬进内存¶
🔴🔴 v0.16.34 的修法已回滚(v0.16.35)—— 它造成了比原问题更严重的回归¶
Tony 实测 v0.16.34:
- 顶部数据条整个消失(大库下跳过 merchantStats 采样,而顶部数据条依赖它)
- 商家列表空白(不再转圈,但数据出不来)
- 邮箱列表显示 15、点进去「没有数据」 —— 官网/邮箱/手机三个派生列表全靠
rowsSnapshot,执行方声称「进入派生列表时按需执行」,实际没生效
- 速度仍然慢
原话:「你有病???顶部数据呢?」「速度还慢成狗!!!」「没问题的也改出问题?」
主控的失职¶
任务书里写了「不许阉割」,而执行方用「大库完整模式不需要 50k+50k 采样」的名义 把统计整个跳过了 —— 主控在收活时读到 X_INVARIANT 里那句 「大库完整模式同时跳过 getMerchantTabStats 的另一条 50k+50k 隐藏采样」, 没有意识到顶部数据条就靠那个统计,也没有验证派生列表还能不能用就发版了。
⇒ 判据缺口是根本原因:那一刀的行为判据只覆盖了「首屏不拉全表」, 没有一条断言「顶部数据条仍有数据」或「派生列表仍能出数」。 测试全绿、verify 全绿、build 全绿 —— 然后用户界面坏了三处。
回滚决定¶
v0.16.34 相比 v0.16.33 是净劣化(原问题没解决,又坏了三处)⇒ 直接 revert 代码,
保留本文档记录。v0.16.35 = v0.16.33 的代码(git diff 2bd0c96 -- src/ tests/ 为空)。
重做这件事的前置条件¶
再动这条链之前,必须先有这些行为判据(缺一条都不许动): 1. 大库下顶部数据条仍有数据 2. 大库下官网/邮箱/手机三个派生列表仍能出数 3. 大库下商家列表首屏能出数(不是「不转圈但空白」) 4. 上述每条都有破坏构造
51 MB 那个测量结论仍然成立(改前 87,563 行 / 51,225,406 bytes),问题不在诊断, 在于修法动了太多依赖方而判据没跟上。
现象(Tony 实测 v0.16.33,商家 87,563 行)¶
顶部统计与左侧导航的数都正常了(前几刀修的),但商家列表一直转圈,标题显示「商家列表 0」。 原话:「到底改了啥 这边卡了好久了!!!」
⚠️ 这条与前几刀修的统计不是同一条链。主控连续几个版本都在修统计, 列表这条从没碰过 —— 所以用户看到「版本一直升、列表照样卡」。
根因:客户端模式 = 全库进内存¶
local-data-view.tsx 的注释自述两种模式:
- client(默认):复用 rowsSnapshot 50k,纯 in-memory paginate/filter/sort,瞬开
- server:jsstore server-pagination,看完整 22w,但每次操作慢
而 fetchRowsSnapshot 扛着 ISSUE-0074 的不变量:三个 scrape_status 各占独立 50k 窗口
⇒ 最多 15 万行整行数据(logo URL、地址、emails 数组、全部字段)。
真实 Chrome + IndexedDB 实测(87,563 行):
| 改前 | 改后 | |
|---|---|---|
fetchRowsSnapshot() |
691.3ms | 首屏不调用 |
| 返回数据 | 87,563 行 / 51,225,406 bytes(51 MB) | 20 行 / 12,065 bytes |
structuredClone |
91.5ms | — |
| 下一帧可交互 | 789.1ms | 570.7ms(上界 1500ms) |
⇒ 每 30 秒把 51 MB 搬进浏览器内存,还要结构化克隆、进 React state。 那句「瞬开」是小数据量时代写的。
📌 执行方留了对照证据:直接调用三窗口仍返回 87,563 行 / 51,225,406 bytes, 证明改后是「不再首屏调用」,不是伪造了轻量数据。
修法(v0.16.34)¶
超过 50,000 行自动切完整模式(本地 IndexedDB 服务端分页),并在标题行明说:
数据量 N 条,已自动使用完整模式,避免一次加载全库;筛选和排序仍可用
- 能力没被删:筛选/排序仍然可用,只是不再是纯内存瞬时操作
- 用户仍可主动点「快速」,此时才加载快照(显式选择,不是被静默决定)
- 小库继续默认快速模式,体验不变
⚠️ 这里特意避开了 v0.16.19 的覆辙:那次「强制切完整模式」导致用户在快速模式点视图
被静默踢走(local-data-view.tsx:240-252 记着这条教训)。
本次切换用户可见、给出原因、且可手动覆盖。
ISSUE-0074 的不变量怎么处理的¶
[2, 0, 3] 三窗口、每窗独享 50,000、窗内 id desc、跨窗拼接顺序全部保留,
只是改为按需执行:小库、用户显式选快速模式、或进入官网/邮箱/手机派生列表时才跑。
⇒ 不变量没有被悄悄废掉(那是另一个家族 bug 的防线)。
顺带发现:大库下还有一条隐藏采样¶
大库完整模式同时跳过了 getMerchantTabStats 的另一条 50k+50k 隐藏采样
(ISSUE-0212 修的是清空对话框那条路径,这条是商家列表 tab 的统计)。
判据¶
tests/fetch-rows-snapshot.test.ts 新增策略/能力/隐藏采样断言;
真实浏览器基准加了 1,500ms 硬上界。
全量 167 files / 2,655 tests rc=0。
教训¶
「瞬开」是一句会过期的注释。
client(默认):复用 rowsSnapshot 50k,纯 in-memory,瞬开 —— 这句话在 5,000 行时是真的,
在 87,563 行时是 51 MB。注释记录了当时的结论,却没记录它成立的前提。
⇒ 凡是注释里写「快」「瞬间」「很便宜」的地方,都该问:在多少数据量下?
本仓已有的同族:merchant-stats.ts 的「4 个 count + 两次 5 万行采样」、
data-counts.ts 的 // SAFE: count-window-ok —— 三处都是当年成立、后来成了掩护。
✅ 根治(v0.16.68,2026-09-24)¶
count-first + 大库 server 分页 + 派生 tab/显式快速才快照 + scope 竞态绑定 + 快速切回完整即停。v0.16.34 revert 的三个根因(数据条消失/派生空白/首屏空白) 逐一避开,四条前置判据以 tests/data-view-count-gates.test.tsx 三场景 + 定向 94 用例钉死。87563 行实测首屏零快照请求。尾巴:>20 万行任务 count 徽标精度 受既有 TASK_SCAN_LIMIT 截断(阈值判定不受影响)——✅ 已于 v0.16.71 索引 count 化收口。