跳转至

[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)

select where {taskId, status:'done'}   // 没有 limit

详情页 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)

  1. 老任务在详情页是死路 —— 补搜区藏在 fromTable 里,而「补全历史记录」 只在创建页、还得先勾一个不相关的开关才出现。 ⇒ 把出路放在他卡住的地方:详情页直接给「补全记录,让它能补搜」。
  2. 「约 N 次搜索」高报 —— 按钮算去重前的上界,勾「餐厅·上海」再加「餐厅」 显示 2 次实际 1 个。⇒ 扣掉与已勾组合同名的新词。
  3. (P2)任务卡片上没有任何文字说这里能补搜,提示只在 hover Tooltip 里 ⇒ 更多菜单加「补搜(加关键词 / 重搜地区)…」。

架构侧(mimo-pro,登记不修)

taskProgress 和组合表是两套「搜过什么」的记录,永远不会同步,谁也不退休。 未来任何只读其中一条的代码都会漏掉另一条的数据。⇒ 见第九节登记项。