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 不许重跑」变红 ⇒ 「续跑不会重复采集」是有真判据的真行为。
真正的拦路石(都不是架构性的)¶
- 根本没有 append 这条代码路径 —— 只有「新建任务」。
putCombos的upsert:true映射到 IDBput(),主键是 autoIncrementid,comboKey没有唯一约束 ⇒ 追加重复 comboKey 会插重复行,而markComboDone只更新rows[0]⇒ 必须先按 comboKey 自去重。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会诚实报错并指路「另建新任务」。