跳转至

ISSUE-0228 L1 主表分页查询游标化 + count 缓存分家

来源

Tony 拍板「先处理本地优化的不卡顿」(raw:2026-10-03-storage-architecture-cloud-vs-local 二轮)→ 五层方案 L1 头刀。病根:getListByQuery(search-data.ts)走 jsstore skip/limit+order,而 jsstore 的 order 实现先收集整个 where 子集再排序切片—— 42w 库每翻一页 = 全子集扫描(M1 家族,与 ISSUE-0227 P1 同根)。

修法

  1. 游标分页(cursor-page.ts,新):原生 IDB 倒序游标, openCursor(range,'prev') + advance(pageSize×(page-1)) 跳位(跳过的位置 不物化行),再连续读 pageSize 行。适用门(三重):调用方显式传 [{by:'id',type:'desc'}](空 sort/undefined = jsstore 默认序语义 ≠ id desc, NOT_ELIGIBLE)+ where 空或仅 taskId/scrape_status/sync 等值(有索引列)+ 值为原始类型。双条件 = 第一列索引 + 游标行上第二条件等值过滤、按有效匹配 行计 offset(防索引位跳与过滤后跳错位)。任何原生异常 → CursorPageError → console.warn + fallback jsstore(红线:列表必须出数);db.close() 于 finally。
  2. count 缓存分家(total-count-cache.ts,新):白名单原始值 where 才缓存 (RegExp/对象/数组绕过直接 live count——防不同 keyword 的 where 序列化互撞 返回对方 total);50 条 FIFO 上限;null 不缓存(吞 0 禁令);失效钩子挂 base 层五个写删 helper(insertOne/insertMany/removeByQuery/updateByQuery/ clearData,MapTaskData 守卫);跨上下文 epoch 广播(SW 写/sidepanel 读 双拓扑:storage.local 广播 debounce 400ms + onChanged 监听清本地缓存, 无 chrome.storage 环境优雅降级)。🔴 不做事务性增量计数器——jsstore 不暴露 事务,跨连接原子性做不到,定案见 raw 二轮文档 L1。
  3. 共享 util 抽取:openNativeDb(data-counts.ts → idb/native-db.ts,与 ISSUE-0227 P1 解耦);normalizeDbSort(api/search.ts → api/db-sort.ts, 游标模块与测试共用真实现,消灭 mock 分叉假绿)。
  4. 回退路径行为保真:fallback 把原始 sort 原样透传给 jsstore(本刀 v1 曾静默把空 sort 归一成 id desc——会改导出路径取行窗口,双审 glm F5 点名后修正);fallback 行也过 sanitizeRows(入口净化双侧一致,ISSUE-0202)。
  5. 顺手修(b58be1d 遗留,luna P1):DataBar 游标 onsuccess 回调体无 try/catch——聚合回调抛错 Promise 永不 settle、fallback 永不触发。现整体 try/catch,reject 后走 jsstore fallback。

效果与口径

  • 游标路径只物化当前页 pageSize 行(M1 的整子集物化消失);跳页步进不物化。
  • 翻页不再每页重 count(缓存命中 O(1);全表 count 实测 332ms 是小头,本刀 省的是「每页一次」的叠加)。性能量化归验收探针(见尾巴)。
  • keyword regex/视图 regex/computed 排序/hasEmailOnly 窗口路径全部保持 jsstore 现状(覆盖面声明见 raw 二轮文档 L1——regex 求值游标做不了, 归 L4 投影)。

审查记录

T2 双审(luna + glm-flash 同卷并行)首轮双 NO-GO:缓存键 RegExp 坍缩互撞、 跨上下文缓存冻结、失效钩子漏 insertOne/updateByQuery、fallback sort 归一改导出 行为、DataBar 回调挂起、双条件 offset>0 零测试——六处方回环整改(coder-gpt), 开方席轻验 6/6 PASS,终判 GO(两条 P3 尾巴记账不开新轮)。主控独立复跑: compile 0 错、196 files / 2971 tests 绿、scan-unbounded 0 新增。

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

  • total-count-cache.ts broadcastEpoch 的 storage.local.set promise reject (quota 超限类)会成为 unhandled rejection——补 .catch(() => {})。
  • 非数组对象形态 sort 在回退路径落 order undefined:当前全部调用方传数组无 触发面,契约已被测试钉死;未来出现对象形态调用方先补测试。
  • 真机 42w 性能探针未挂(游标分页 vs jsstore 分页端到端对照)——验收口径 见 raw 二轮文档五节,归 L1 验收时补测。
  • keyset 分页(连续翻页 O(页宽))未做——v1 偏移游标已消灭物化大头,深页 步数成本留给探针数据说话再决定。