跳转至

ISSUE-0211 任务跑完就不能继续

现象(Tony 实测 v0.16.27)

「任务完成 为啥不能继续???新增了不能继续?你不会是扯淡?而且你还增加新任务的认知难度!!!!」 「补搜应该是就设置一个关键词,然后这个任务里详情增加更多的组合吧?而且是只能加 不能删?」

补搜(SPEC-024)的实现是 createFollowUpTask —— 每次都新建一个任务。 用户的任务有 29,594 个地区,他要的是「这个任务一直长下去」,不是攒出一堆任务。

根因:一段自己推翻了自己的注释

task-manager.ts 的 createFollowUpTask 函数头注释:

「为什么是新建而不是往原任务加:笛卡尔积是关键词外层、地区内层,而调度器用数组下标游标。 往原任务追加地区,新 URL 会插进数组中间 ⇒ 游标全乱,已跑的重跑、没跑的被跳过,而且不报任何错。」

同一段注释往下第 7 行:

「为什么现在做得了「任意子集」:因为有了组合表……调度器 combosToRun() 从表取,这个限制就不存在了。」

实查 combosToRun:表优先 —— countCombosOfTask 判有没有表 → combosOfTask(id, ['pending','failed']) 取待跑集 → startBatch 据此重建 urls/combos 且 nextIndex = 0。根本没有跨轮次存活的数组下标游标。

两路独立对抗审(terra-dsh / dshf)各自用变异验证坐实:把 ['pending','failed'] 加上 'done' ⇒ tests/combo-task-wiring.test.tsx 的「done/skipped 不许重跑」变红 ⇒ 「续跑不会重复采集」是有真判据的真行为。

真正的拦路石(都不是架构性的)

  1. 根本没有 append 这条代码路径 —— 只有「新建任务」。
  2. putCombos 的 upsert:true 映射到 IDB put(),主键是 autoIncrement id,comboKey 没有唯一约束 ⇒ 追加重复 comboKey 会插重复行,而 markComboDone 只更新 rows[0] ⇒ 必须先按 comboKey 自去重。
  3. pumpOnce 重置 startCount / finished / startTime / pausedTotal,不清 endTime ⇒ 第二轮结算时 onBatchDone 用 now − 新 startCount 覆盖 resultCount ⇒ 第一轮的采集结果在账上蒸发;同时 UI 拿到「新 startTime 配旧 endTime」的乱计时。

⇒ 整个产品的数字(进度 / 百分比 / 剩余时间 / 净增)都建立在 「一个任务跑一轮就结束」这个从未被写下来的假设上。

修法(v0.16.28):引入轮次基线

MapTask 新增三个只加不删的字段 roundFinished / roundResultCount / roundElapsedMs, 让累计量跨轮相加而不是被覆盖:

字段 新语义
resultCount 任务一生累计净增。结算时 = roundResultCount + 本轮净增,累加不覆盖
finished 累计完成组合数。起跑从 roundFinished(表中 done 行数的真值)续起,不清零
startTime 本轮起跑点 − roundElapsedMs,让旧公式「已耗时 = now − startTime − pausedTotal」天然跨轮连续
pausedTotal 只记本轮暂停(历史暂停已折进 roundElapsedMs)
endTime 仅在「整轮收尾且表内无新增 pending」时落盘;追加与续轮一律清空
total 组合表该任务的真实行数(count 而来,不盲加)

新增 appendCombosToTask:按 comboKey 分块 in 查询对表中已有行去重 → 新行 pending 且 url 必填 → total 取真实行数 → status 转 queued 并清 endTime。 running 中追加不打断本轮,由 onBatchDone 发现表内还有 pending 自动续轮 (只数 pending 不数 failed,防无限续轮)。

UI:详情页主按钮从「再建一个任务」改成「在本任务继续」,另建新任务降为可选项; 已完成的任务卡上新增「继续」入口。

行为判据(新增)

tests/append-combos-resume.test.tsx 等 4 个文件、36 条行为断言。九组反向变异逐条验证:

变异 结果
去掉「与表中已有行去重」 2 红(重复行 / 诚实报错)
combosToRun 过滤加 'done' 1 红
onBatchDone 改回覆盖式 resultCount 2 红(跨两轮账本 / 续轮账本)
pumpOnce 还原旧行为 3 红
净增 0 文案去掉 done 状态门 1 红(running 不出现)
countAllByTaskIds 恒走窗口回退 2 红
删掉 appendToSource 路由 1 红(不建新任务)
删掉 done 卡「继续」按钮 1 红
liveProgress 去掉跨轮累计 1 红

教训

一条注释里同时写着「不能做 X,因为 Y」和「Y 已经不存在了」,说明架构演进时没有人回头重读那条约束。

这个限制在组合表落地(v0.16.2,SPEC-025)的那一刻就失效了,但实现和注释一起留在原地 —— 而且注释写得越详细、越有说服力,后来的人越不会去质疑它。

⇒ 凡是写「为什么不能做 X」的注释,都要带上失效条件:「当 Z 成立时这条不再适用」。 否则它会从「设计理由」腐烂成「不容置疑的事实」。

未做(明确的非目标)

  • 重搜已跑过的组合:追加按 comboKey 去重是「只能加」的自然结果;要重搜需另立「把 done 行翻回 pending」的功能。
  • 给任务新增此前没有的地区:详情页续跑目前是「新词 × 任务已有地区」(勾组合可圈定地区范围),加新地区需后续接地区选择器。
  • 旧任务(无组合表记录)续跑:维持现状,append 会诚实报错并指路「另建新任务」。