跳转至

ISSUE-0233 L3 导出流式化

来源

Tony 四轮「干完」授权收官(方案定案=raw 二轮文档 L3:分批 Blob 起步,FS Access 留 spike)。病根:apiLocalDataExport cap=min(selectTotal, 50_000)(ISSUE-0056

2 内存保险丝)+ exCsvValues += 整串拼接(2× 峰值)——42w 库导「全部」静默

丢 37w 行。

修法

  1. 流式核心(src/utils/idb/export-stream.ts,新):原生游标按序分批 (4000/批,SAFE 注释)→ 批内 hasEmailOnly 过滤+CSV 片段 → parts 数组 → 游标耗尽后 new Blob + saveAs;进度 toast 按批更新+取消检查点(AbortError, 不落盘);文件名 N=实际命中数(hasEmailOnly 下精确)。
  2. 资格面(cursor-eligibility.ts,新):从 cursor-page 抽共享判定(显式 id desc + taskId/scrape_status/sync 等值)——覆盖全选/按任务/hasEmailOnly 三大场景;keyword/regex/computed/rows 路径保持旧 5 万 cap+「仍上限 5 万」 banner(诚实边界)。
  3. 🔴 对账总数与流同源(双审 NO-GO 后拍板:精确计数,不搞 actual≥expected 放行):流式路径 expectedTotal=确认时刻原生游标精确 count(hasEmailOnly 对 status=2 子集逐行判 emails 非空;taskId 用 countByTaskId 索引精确)—— 修掉「列表窗口截断值 vs 流式精确值必炸」(hasEmailOnly>5 万原死循环)与 taskId>20 万的 200k 窗口同构病。对账失败→触发数据刷新(重试可收敛)。
  4. 取消链闭环:loading 态 ESC/遮罩关闭也走 onCancel(原绕过取消、导出 照常落盘);取消措辞「已取消导出」+清理进度 toast。
  5. 红线(与列表方向相反):对账不匹配/游标异常/取消/Blob 构造失败 → 整体失败不落半截文件——导出宁失败不许静默少给。
  6. ISSUE-0204 同源:hasEmailOnly 收窄抽 buildHasEmailOnlyQuery 单源, 列表/旧导出窗口/流式资格三消费方共用(0205 家族纪律)。

审查记录

T2 双审(luna+glm-flash 同卷并行)首轮双 NO-GO:对账总数与流不同源 (hasEmailOnly>5 万确定性死循环+taskId 200k 窗口同构)/ESC 绕过取消/收窄构造 三处手抄/Blob 失败无负断言/fake cursor 对 direction 不敏感/失败后重试不收敛 ——七处方回环整改(R1-R7)后双席轻验放行。主控独立复跑:compile 0、全量 测试绿、scan-unbounded 0 新增。mutation:精确计数去掉→主用例红;onCancel 接线去掉→ESC 用例红。

已知边界(真机验收项)

  • 内存:parts≈1×CSV,new Blob(parts) 构造瞬时可能 ~2×(42w×800B≈300MB 级)——sidepanel 大 Blob 实测待 Tony 真机验收;FS Access 流式写盘(真· 常量内存)留 spike 后续。
  • 非 eligible 路径(keyword/regex/computed 排序)导出仍 5 万上限(banner 已明示)——「根除」结论仅对 eligible 路径成立。
  • 真实 IDB 42w 行全量游标耗时与只读长事务稳定性——真机验收。

audit_grep 说明

EXPORT_STREAM_BATCH/buildHasEmailOnlyQuery 两 pattern 已入 frontmatter (闸真跑通 present 全中)。