[ISSUE-0190] 四路审查打出来的十条¶
四个独立故障域,四个不同角度,同一批代码(v0.16.0~0.16.6,42 文件约 4000 行):
| 执行方 | 角度 | 结论 |
|---|---|---|
| terra-dsh (openai) | 易用性 / 新手 | GO-WITH-CHANGES · P1×2 |
| dshf (deepseek) | 数据正确性 | GO-WITH-CHANGES · P1×2 P2×3 |
| mimo-pro (xiaomi) | 架构合理性 | GO-WITH-CHANGES · P1×2 P2×1 |
| glm53 (zai) | 回归 / 失败路径 | GO-WITH-CHANGES · P1×2 |
四路一致 GO-WITH-CHANGES,P0=0。 但 P1 里有两条是两路独立命中。
🔴 F1:全部被跳过时,功能完全反转(dshf + glm53)¶
writeCombosForTask: if (keep.length) putCombos(keep) // 全跳过 ⇒ keep 为空 ⇒ 不写表
combosToRun: 表 0 行 ⇒ 回退 buildTaskCombos() // ⇒ 全量照跑
dshf 写了行为复现:rows=0 started=2 total=0 skipped=2。
⇒ 用户明确要跳过的组合,恰好在最该跳过时全部照跑。
🔴 病根是我把「跳过」放在生产端(建任务时过滤掉、不写表), 而「表里没行就回退全量」这条安全网反过来咬了人。
修法(dshf 建议,采纳):跳过挪到消费端 ——
全量写表、被跳过的标 status: 'skipped',combosToRun 只取 pending/failed。
表永远不空,回退分支永远不会被误触发。
⚠️ 顺带给了用户可见性:详情页能列出「这些被跳过了」,而不是凭空少一批。
glm53 补的另一半:顺序反了会留僵尸任务¶
await addTask(task) 在前、写表 throw 在后 ⇒ handler 报「创建失败」,
而任务已经以 queued 落进 taskList ⇒ watchdog 把它自动起跑,且表里没行 ⇒ 回退全量。
用户重试再建一个 ⇒ 双跑。
⇒ 先写表,成功了才 addTask。
🔴 F2:ISSUE-0188 在统计路径原样复发(glm53)¶
详情页 pollingInterval: 2000 ⇒ 40 万组合的任务跑到中后期,
每 2 秒搬 20 万行回来只为求个和。
🔴 v0.16.2 我只把「详情列表」分页了,忘了统计也在拉全量 —— 同一个形态在同一个界面里复发。⇒ 改成分批累加(单批 5000)。
🔴 F3:iso2 用户一条都对不上(glm53)¶
expectedKeyword 硬编码 countryName,而 buildTaskCombos 在
searchCountry === 'iso2' 时拼的是 countryCode:
| 期望 keyword | dentist, bonner, australia |
| 真实 progress | dentist, bonner, au |
⇒ iso2 用户的老任务回填全部 unmatched,大任务详情页全部显示「待采集」。
v0.16.5 那个修复对 iso2 不完整(小任务被 includes 兜底救回,所以只在大任务暴露)。
🔴 F4/F5:两个判据地雷(dshf + glm53 独立命中)¶
| # | 变异 | 结果 |
|---|---|---|
| F5 | markComboForTab 整体 no-op |
143/143 全绿 |
| F4 | comboFor 多国分支丢 &gl= |
133 条全绿 |
⇒ P2 的招牌行为(跑完回写 done)既无行为判据也无源码判据。
⇒ comboFor 的对拍矩阵缺「多国 default」那一格。
changelog 里「N 个变异全被抓」,只对主控自己想到的那些变异成立。
🔴 dshf 的 F2:空结果永远标不上 done¶
if (!list.length) return; 在回写之前 ⇒ 「搜了但一个商家都没有」的组合
永远挂在待采集,进度永远到不了 100%,用户会以为任务卡住。
翻页循环也从不碰组合表(PagingJob 不带 urlIndex)。
🔴 易用性两条(terra-dsh)¶
- 老任务在详情页是死路 —— 补搜区藏在
fromTable里,而「补全历史记录」 只在创建页、还得先勾一个不相关的开关才出现。 ⇒ 把出路放在他卡住的地方:详情页直接给「补全记录,让它能补搜」。 - 「约 N 次搜索」高报 —— 按钮算去重前的上界,勾「餐厅·上海」再加「餐厅」 显示 2 次实际 1 个。⇒ 扣掉与已勾组合同名的新词。
- (P2)任务卡片上没有任何文字说这里能补搜,提示只在 hover Tooltip 里 ⇒ 更多菜单加「补搜(加关键词 / 重搜地区)…」。
架构侧(mimo-pro,登记不修)¶
taskProgress 和组合表是两套「搜过什么」的记录,永远不会同步,谁也不退休。
未来任何只读其中一条的代码都会漏掉另一条的数据。⇒ 见第九节登记项。