跳转至

ISSUE-0229 L2 派生三 tab 分页化 + 聚合缓存

来源

Tony 三轮指令(raw:2026-10-03-storage-architecture-cloud-vs-local 三轮): 「官网列表 邮箱列表 手机列表 要和商家列表一样,加上翻页等功能」——同时拍掉二轮 L4 前置决策题:保持现有列/行语义(派生函数零改动)+ 游标聚合缓存 + 复用 ClientDataTable 分页。

病根(改造前)

派生 tab 数据链:fetchRowsSnapshot 拉 3×50k 窗整行快照(~150k 行/88-160MB 上限)常驻 → 三个 useMemo 全量派生 → 平铺渲染无分页;且派生 tab 打开时 30s 轮询 + 每条 maps-data-updated 事件立即重拉全快照重派生(采集期常驻重算, 42w 定案第三真凶的存量大头)。

修法

  1. 游标聚合缓存(src/utils/idb/derived-aggregate.ts,新):
  2. 全量 scope:scrape_status 索引倒序游标三窗严格 [2,0,3] 序(🔴 拼接序= 首遇语义——邮箱/手机首遇保留、官网同分先到者胜,fetch-rows-snapshot 明文警告的语义红线),每窗 ≤ROWS_WINDOW_CAP(50000,本刀不动)。
  3. 任务 scope:taskId 索引倒序游标单窗(混合状态、id desc、≤5 万命中 行)——与旧 fetchRowsSnapshot(taskId) 逐字同语义。🔴 首版曾做成「全局 status 窗后过滤 taskId」:其他任务占满 50k 步时目标任务行永远读不到 (ISSUE-0074 挤窗病在新路径复活),双审首轮 NO-GO 后改索引游标。
  4. 拉到的 rows 直接喂现有 deriveWebsites/deriveEmails/derivePhones (派生函数零改动,SHA-256 与基线一致);瞬态 rows 派生完即弃。
  5. 缓存:per-scope(task/'all')LRU 上限 8 条(淘汰连 generation/build 元数据一起清);状态机 idle/building/ready/error; 失效=保旧数据+标 building+后台重建原子替换(不闪空);在途 build coalescing(不叠塔);generation 闸护缓存写回。
  6. 失效信号:复用 L1 的 countCacheEpoch 跨上下文广播 (total-count-cache.ts 加 subscribeCountCacheEpoch,不新增 storage key, L1 语义零改动);本地 maps-data-updated 30s 防抖。
  7. hook(src/sections/data/use-derived-aggregate.ts,新):只订阅缓存 状态(不直接消费 build Promise——旧 Promise 不复活);error 态托管 snapshot fallback(request token 守卫,不被 effect cleanup 竞态丢弃)。
  8. UI(data-view.tsx):三派生 tab 数据源换聚合 hook,复用 ClientDataTable(分页/快速过滤/导出/勾选/页码控件沿用商家 tab 同款); task/status 切换 key 重挂重置页码;quickSnapshotRequested 离开商家 tab 即复位(不再白拉 150k 快照);rowsSnapshot 拉取条件收窄到商家 tab。
  9. 失败红线(0215):原生 IDB 异常 → error 态 → snapshot fallback → 派生出数(hook 级行为测试钉住)。

效果

  • 派生 tab 打开/切换:聚合缓存命中即显(毫秒级),不再每次重拉 150k 快照; 采集期事件不再触发全量重派生(30s 防抖+epoch 合并)。
  • 常驻内存:150k 整行快照 → MB 级派生实体缓存(构建期瞬态峰值保留为已知 边界,slim 投影归 L4 账本)。
  • 派生三 tab 获得与商家列表一致的分页/页码/快速过滤。

审查记录

T2 双审(luna+glm-flash 同卷并行)首轮双 NO-GO:任务范围窗口饥饿(且 等价测试 fixture 无 taskId 属假绿)/ 旧 build Promise 经 fallback 复活 / error 态 fallback 被 cleanup 竞态丢弃 / epoch 失效闪空+无界并发叠塔 / per-task 缓存无界 / 重复用例——七处方回环整改后双开方席轻验:双双 GO-WITH-WARNINGS(全处方 PASS,余项 P3)。主控独立复跑:compile 0 错、 198 files / 2985 tests 绿、scan-unbounded 0 新增。mutation 自证两处 (三窗序换序 / score 严格大于改 >=)exit_code=1 真红后恢复。

尾巴(P3,随下次触碰顺手收)

  • derived-aggregate.test.ts :80 一处无 taskId 的空对空等价用例(真实任务 语义已由 :108/:179 覆盖,此条冗余非误导,删除即可)。
  • LRU 淘汰×在途 build 的秒级「ready 但陈旧」窗口(glm WARN-1:淘汰时删了 在途 builds 条目,窄竞态最终一致自愈)。
  • hook 订阅 passive effect 一帧旧任务数据闪现(WARN-2,改 useLayoutEffect 可消)。
  • error 态无用户可见提示(F6:静默降级与旧路径一致,但叙事上应有提示)。
  • ui/data-table.tsx 尾页越界 clamp(🔴 T3 文件,本刀明避不动,单独小刀处理)。
  • LRU 元数据清理的行为级断言补强(实现有清理,测试只断言状态位)。