跳转至

SPEC-024 照这个再建一个

✅ 已实现(v0.16.6)。最终形态与本文第三节的「combos 方案」不同 —— 因为 SPEC-025 的组合表先落地了,「任意子集表达不了」这个拦路石不复存在: 组合存表、调度器 combosToRun() 表优先,MapTask 不需要 combos 字段。

落地的是:任务详情页每行勾选 + 「再加几个词」+ 建新任务(Tony 选的 A 方案)。 二审那六条必补项里,①②④⑤ 随 combos 字段一起作废(不走那条路了), ③(详情页读组合表)由 ISSUE-0189 单独补上,⑥(空输入)在 createFollowUpTask 里拒绝。

一、诉求

Tony 原话:

已经创建的地图任务 能继续新增关键词和地区吗?对抗给我一个合理的建议,而不是一个半瓶子的 尤其是从用户使用的角度,新手能快速上手 通俗易懂 不会造成额外的认知成本

二、核验过的事实基础

⚠️ 本节每一条都查过源码并标了行号。方案里的每个判断都只许建立在本节之上。

# 事实 出处
F1 笛卡尔积是运行时算的,循环顺序是「关键词外层、地区内层」 task-store.ts:141
F2 调度器用数组下标游标 nextIndex++ 取下一条 batch-controller.ts:339
F3 urls 快照持久化,SW 重启从存储恢复,不重算 batch-controller.ts:1200
F4 进度有两个分母:running 时用 batch 的 urls.length,否则用创建时写死的 task.total task-view.tsx:405
F5 onBatchDone 写的是 finished: t.total(写死赋值,不是累加) task-manager.ts:130
F6 resultCount = 全局商家数差值,注释自承是估算 task-manager.ts:126
F7 🔴 去重默认是开的:advParms: ['deleteRepeat'] storage-data.ts:210
F8 🔴 「搜过哪些组合、各采了多少」已经精确记录在 local:taskProgress:${taskId} task-progress.ts
F9 这份记录只在删除任务时清(完成 / 停止都保留) task-manager.ts:389
F10 TaskProgressEntry.keyword 是拼接字符串("dentist, Bonner, Australia"),不是结构化 task-progress.ts:16
F11 🔴 组合匹配已重写过一次修三个 bug,现在仍靠 includes 模糊兜底 task-detail-dialog.tsx:85
F12 SelectionMap → locationEntries 是有损展开:mode:'all' 调 API 展开成几百个州,深度被消费 task-create-dialog.tsx:161
F13 地区输入框只显示摘要(N 国 · X 区域),不渲染列表 locations-picker-input.tsx:25
F14 picker 是三级下钻(国家 → 州 → 城市),任何时刻 DOM 只有几十到两百行 location-picker-dialog.tsx:654/903/1051
F15 advParms(筛选条件)是全局 settings,不是任务级 batch-controller.ts:459
F16 🔴 已被三审推翻:任务列表只有分页(PAGE_SIZE=20),没有搜索。原写「分页 + 搜索」错 task-view.tsx:378;grep -ci 搜索 = 0
F17 详情页已按「关键词 × 地区」列出每个组合采到多少家,5000 行截断显示(非虚拟滚动) task-detail-dialog.tsx:401/451
F18 🆕 详情页的 Combo { category, location, done, count } 是结构化对象,不是拼接串 task-detail-dialog.tsx:45-51
F19 🆕 组合匹配是分层的:progressMap.get(expected) 精确优先,includes 只是兜底 task-detail-dialog.tsx:131 + 143-158
F20 🆕 兜底命中后 break 但不从 progressMap 删除 ⇒ 同一条 progress 可被多个组合重复认领 task-detail-dialog.tsx:146-158
F21 🆕 buildSources() 从 locationEntries 取值时丢了 countryCode(只取 location + countryName) task-detail-dialog.tsx:119-129
F22 🆕 老任务无 locationEntries,走 task.locations 单国路径 task-store.ts:18 注释
F23 🆕 searchDepth 默认 'state',只存 localStorage,MapTask 里没有这个字段 task-create-dialog.tsx:106-116
F24 🆕 stateOnly = csel.paths.filter(p => !p.includes(',+')) —— state 深度会把城市级路径全丢 task-create-dialog.tsx:192-196
F25 🆕 TaskFilterPicker.onChange(taskId, name) 只传一个 id ⇒ 数据页任务筛选是单选 task-filter-picker.tsx:161-164
F26 🆕 导出走 exportRun({...saveParams}),saveParams 含 filterTaskId ⇒ 选了任务就导该任务 local-data-view.tsx:677
F27 🆕 recordTaskProgress 是 fire-and-forget(.catch() 不 await)⇒ SW 休眠/崩溃会丢条目 batch-controller.ts:488

被核验推翻的四条(曾经写进建议里)

曾经的说法 实际 影响
「去重默认不开,会产生重复数据」 F7:默认开着,同商家不重复入库 重复的代价只是时间,不是脏数据 —— 整个方案的风险等级下调
「搜过什么只能靠 categories 推断」 F8/F9:早有精确记录且长期保留 标记可以精确到组合,还能给出数量
「预填上千个地区可能卡」 F13/F14:输入框只显示摘要,picker 三级下钻 纯臆想,方向还是反的(见决定 5)
「筛选条件带不进去,所以该新建」 F15:新建也一样带不进去 这条不成立,从理由里撤回
🆕「任务列表有分页 + 搜索」(F16) 只有分页,没有搜索(两路独立命中) 决定 4「任务行菜单入口」的理由要撤:20 条一页、无搜索,任务一多这个入口几乎不可达
🆕「ISSUE-0036 证明系统跑过 11 万地区」 引反了 —— 那是「11 万地区撑爆 chrome.storage 配额、任务根本没建成」,修复是加地区数上限 拿事故当性能佐证。「不卡」的结论靠 F13/F14 仍成立,但这条证据必须删
🆕「按词标记就够了」 标记单位是组合,操作单位是词;且跑到一半时数字是部分和 🔴 方案主体被推翻,见第三节

三、🔴 三审裁决(2026-09-21)—— 方案主体被推翻一次

三路独立对抗审(同一份任务书,body sha256 相同):

执行方 厂商 / 模型 结论
dshf deepseek / deepseek-v4-flash GO-WITH-CHANGES
mimo-pro xiaomi / mimo-v2.5-pro GO-WITH-CHANGES
glm53 zai / glm-5.3 GO-WITH-CHANGES

三路一致 GO-WITH-CHANGES,无 NO-GO。但发现的洞差异极大,且有两处实质分歧。

分歧裁决(不投票,回源码逐项裁)

分歧 dshf mimo glm53 裁决(我实查)
F16 列表有没有搜索 不符 已核实 不符 🔴 没有搜索。mimo 引的是 :377「分页 + 勾选」注释,把「勾选」读成了「搜索」。grep -ci 搜索 = 0,唯一 TextField 是重命名框
导出会不会坑人 会(必须 Excel 合并) 不会 可接受但最该升格 glm53 最准:exportRun({...saveParams}) 的 saveParams 含 filterTaskId,选了任务就导该任务;但 TaskFilterPicker 的 onChange(taskId, name) 只传一个 id ⇒ 单选,链上两任务无法一起筛。是真摩擦,不是死路

🔴 被推翻的方案主体:「按词标记」粒度错了

两路从不同角度指向同一件事:

  • glm53:标记单位是组合(F8 一条一组合),用户操作单位是词(界面上的 chips)。 一个词 1000 个组合只搜过 30 个,按词删 ⇒ 必然漏采 970 个或重搜 30 个。 而「组合 → 词」的聚合规则(求和?取 min?未搜的怎么标?)原方案全文未定义。
  • dshf:同一件事的另一面 —— 数字是部分和。任务跑到一半时「餐厅 1240 家」 其实是「只搜了 3 个州的 1240 家」,而原方案教用户「1240 → 别重搜」 ⇒ 方案自己制造了它要消灭的那类静默漏采。

⇒ 不是把聚合规则补上就行 —— 是「在词这个粒度上做任何自动判断」本身就错。

新方案:在组合粒度上操作(dshf 提出,三路证据支持)

详情页已经按「关键词 × 地区」列出每个组合和采集量(F17),而它内部的 Combo 本来就是结构化对象(F18)—— 不是需要解析的拼接串。

⇒ 每行加一个勾选框,底部「用勾中的组合再建一个任务」。

flowchart TD
  A[任务详情<br/>关键词 × 地区 × 采到多少家] --> B[勾选想再搜的组合]
  B --> C[底部:用勾中的 N 个组合再建一个任务]
  C --> D[新任务直接排队<br/>不经过创建界面的反推]

这一换绕开了五组洞(每组都是三审实锤的)

原方案的洞 谁发现 新方案为什么没有
searchDepth 往返有损:stateOnly=paths.filter(p=>!p.includes(',+')) 把城市级全丢,而 depth 默认 'state' 且只存 localStorage、MapTask 无此字段 dshf + glm53 独立命中 不走 SelectionMap 反推,直接由组合构造 locationEntries
数字是部分和 / 组合→词聚合未定义 dshf + glm53 组合级 done 是二值,不聚合
老任务无 locationEntries(task-store.ts:18 注释明说)⇒ 反推得到空地区 glm53 详情页 buildSources() 已有老任务回退
fromTaskId 链、悬空指针、「降级到无标记」做不到 dshf + glm53 不需要这个字段
reset() 清预填 / note 字段根本不存在(我凭空写的) dshf 不走创建界面预填

🔴 新方案第一稿也被推翻了一次(2026-09-21 自查,三审没审过它)

⚠️ 先认一件事:三路审的是旧方案。「详情页勾选组合」只是 dshf 的一句 X_SIMPLER 建议, 没有任何一路审过它。上一版 spec 说「三路达成一致」是偷换。

自查打出三个洞,两个致命:

# 洞 证据
🔴 1 MapTask 表达不了「任意组合子集」 —— 勾中 (餐厅,上海)+(咖啡馆,北京) 两个组合,存进去变成 categories=[餐厅,咖啡馆] × locations=[上海,北京] ⇒ 实际搜 4 个。勾对角线上的 N 个 ⇒ 矩形化成 N²,平方级爆炸 total: categories.length * locations.length(task-manager.ts:318)+ buildTaskUrls 双层循环
🔴 2 不能加新关键词 —— 用户原话是「继续新增关键词和地区」,而详情页只能勾已存在的组合,新词根本没有那一行。答非所问 详情页 combos = categories × sources 笛卡尔积
3 详情页显示的地区名是 URL 形式(Nagoya,+Aichi Ken),直接渲染 e.location 未经 norm task-detail-dialog.tsx:418;norm() 只用于匹配

⚠️ 洞 1 还让上一版的判据 1 自相矛盾:我写「勾中 N 个,构造出的 locationEntries 恰好 N 条」—— 在当前数据模型下根本不可能通过。写了个自己都实现不了的判据。

次要四条:④ 勾选状态会被 pollingInterval: 2000 的 useMemo 重算冲掉(须用 category|location 字符串 key); ⑤ 5000 行截断下「全选」语义两难(选 filtered 全量则含看不见的行,选可见 5000 则用户以为全选了); ⑥ 重搜已采组合时去重让 added≈0,新任务显示「0 家」会被误读成「没搜到」; ⑦ 矩形化扩张后可能撞 ISSUE-0036 修复加的地区数上限。

🔴 修正:加 combos 字段(Tony 2026-09-21 拍板走 A)

// MapTask 新增,只加不删(本仓 storage 规则)
combos?: { category: string; location: string; countryCode: string }[];
  • buildTaskUrls 加一个分支:combos 存在就用它,否则走原来的双层循环
  • total = combos.length
  • ⇒ 洞 1 消失(能表达任意子集),洞 2 也顺带解了(新词就是新组合)

🔴 这动了核心数据模型,风险必须写明: buildTaskUrls 是全仓唯一的 URL 生成点,加分支时老任务路径一个字都不能动, 并用判据固定「无 combos 的任务,生成结果与改动前逐条相同」。

形态(Tony 选 A:同一个界面里勾选 + 加新词)

任务详情 · 上海餐饮采集
┌──────────────────────────────────────────────┐
│ [全部] [已采集] [待采集]          🔍 筛选      │
├──────────────────────────────────────────────┤
│ ☐ 餐厅    · 上海   已采集 1240   3 天前       │
│ ☑ 咖啡馆  · 上海   已采集 3      3 天前       │
│ ☑ 奶茶    · 上海   待采集 —                   │
├──────────────────────────────────────────────┤
│ 再加几个词(会和勾中的地区组合):            │
│ [奶茶店 ×] [甜品店 ×] [+ 添加]                │
├──────────────────────────────────────────────┤
│        用勾中的 2 个组合 + 2 个新词 再建一个任务 │
└──────────────────────────────────────────────┘
  • 勾中的组合 → 直接进 combos
  • 新词 × 勾中组合涉及的地区集合 → 也进 combos
  • 按钮文案自带两个数量,用户不用猜范围

⚠️ 「再加几个词」这一块是洞 2 的解药,但它把一个界面变成了两种操作 —— 这是 Tony 明确选的 A(B 是「加新词退回创建界面」,会把 searchDepth 那组洞带回来)。 代价记在这里,实测后如果新手在这一块卡住,退路是 B。

入口:列表也要有(Tony 2026-09-21)

入口 做什么
任务详情页底部 就地勾选
任务行「更多」菜单 → 「补搜…」 直接打开详情页并进入勾选模式

🔴 两个入口指向同一个界面,不是两套流程 —— 这同时解掉了三审对决定 4 的质疑 (F16:列表无搜索 + 20 条一页,独立入口几乎不可达):它不是独立入口,是详情页的快捷方式。

🔴 第二轮三审(2026-09-21)—— combos 方案又被补了六个洞

执行方 厂商 / 模型 结论
dshf deepseek-v4-flash GO-WITH-CHANGES
mimo-pro xiaomi mimo-v2.5-pro GO-WITH-CHANGES
glm53 zai glm-5.3 GO-WITH-CHANGES

同一份任务书(body sha256 664c268262e90253),三路一致 GO-WITH-CHANGES。 但四个洞是多路独立命中 —— 全部实查坐实。

🔴 必补一:combos 缺 countryName(dshf + glm53,glm53 判「杀伤力第一」)

settingParams.searchCountry 默认是 'name'(storage-data.ts:193), 而 buildTaskUrls 按它选 countryCode 还是 countryName 拼进 URL。 ⇒ 只存 countryCode 在默认配置下根本复现不出 URL,也无法精确匹配 progress。

combos?: { category: string; location: string; countryCode: string; countryName: string }[];

🔴 必补二:combos 分支必须放最前(dshf + glm53 + mimo)

buildTaskUrls 现有两个分支(locationEntries 优先,否则单国路径)。 ⚠️ 若 combos 判断写在 locationEntries 之后,同时有两者的任务会走进笛卡尔积 ⇒ 洞 1 原样复发。 这不是风格问题,是正确性问题,要写进判据。

🔴 必补三:详情页也要读 combos(三路全部独立命中)

task-detail-dialog.tsx:135-136 的期望集合是 categories × buildSources() 笛卡尔积。 combos 任务的组合不是笛卡尔积 ⇒ 详情页会显示错的组合(或空白)。

🔴 后果用 glm53 的话说是「功能自断二环」: 补搜出来的任务,自己没法再被补搜 —— 打开它的详情页,看到的是矩形化还原的错误列表。

⇒ 步骤表必须加一步:详情页 combos 构造也走 task.combos 分支。

🔴 必补四:combos 要纳入 50k 守门(dshf + glm53)

const locCount = isMulti ? locationEntries.length : locations.length;   // task-manager.ts:286

完全不数 combos ⇒ combos 任务的 locations 为空时 locCount = 0 ⇒ 守门被整个绕过。

⚠️ 我在洞 ⑦ 写的是「矩形化后可能撞上限」—— 实际是「根本不检查」,方向反了。

🔴 必补五:构造时按三元组去重,total 不能直接等于 combos.length(三路命中)

buildTaskUrls 末尾有 Array.from(new Set(urls)) ⇒ urls.length ≤ combos.length。

重复来源三种,全是真实路径: 1. 用户把新词加成与已勾组合同名的词(已勾 (餐厅,上海),又在新词区输「餐厅」) 2. locationSource === 'custom' 时 URL 不拼国家 ⇒ 不同 countryCode 的同名地区撞成同一 URL 3. 同地区不同写法经 cleanLocationSegment 归一后撞车

后果:running 时分母是真值 urls.length,done 后 onBatchDone 写 finished = t.total ⇒ 完成那一瞬间分子分母一起跳,进度条虚高,finished 大于实际搜索次数。

🔴 这让上一版的判据 3(两个分母对齐)在 total = combos.length 下数学上不可能成立。 ⚠️ 这是我第三次写出一个自己都实现不了的判据(前两次见上文洞 1、判据 2)。 ⇒ 修法:建任务时 total = buildTaskUrls(task, settings).length,或存 combos 前先按三元组去重。

🔴 必补六:空 combos 的语义必须写死(dshf)

combos: [] 是「0 次搜索」还是「回退到笛卡尔积整片搜」? ⇒ 两条方向完全相反的故障共用同一个入口。必须显式拒绝空数组,不给回退。

次要四条(单路命中,已核实)

  • task-view.tsx:707-714 渲染「X 个地区 · 共 N 项」—— combos 任务 locations 为空会显示 「0 个地区 · 共 120 项」,自相矛盾(glm53)
  • controlTask('resume') 在 batch 不在内存时重调 buildTaskUrls 并 startBatch ⇒ nextIndex 归 0, 停止后再继续会从头跑(已有行为,非 combos 引入,但补搜场景更痛)(mimo)
  • 补搜任务的 resultCount 常态 ≈ 0 —— deleteRepeat 默认开,重搜已采组合 added≈0, 用户第一眼看到「0 家」会误读成「没搜到」(glm53)
  • 新词区的 M 个词 × R 个地区是隐式展开,按钮文案必须把最终搜索次数写出来, 不能只写「2 个组合 + 2 个新词」(glm53)

新方案仍要解决的四件事

四、逐条对抗(原方案,部分已作废)

🔴 读这一节前先读第三节。 三审之后,下面 8 个决定里:

决定 三审后的状态
1 不追加 ✅ 三路一致站得住(追加地区打乱游标,要改四处),新方案继承
2 只标记不移除 ⚠️ 结论保留、论证有两处跳步:① 匹配是分层的(F19),只信精确层就能安全移除 —— 我把「匹配不准」当成了全有全无;② 更致命的是粒度错了(见第三节)⇒ 新方案改为在组合上勾选
3 显示数字 ❌ 作废:数字是部分和(dshf)+ 组合→词聚合规则未定义(glm53)
4 入口两处 ⚠️ 「任务行菜单」的理由被 F16 推翻(列表无搜索)⇒ 新方案只保留详情页入口
5 地区反推 ❌ 作废:searchDepth 往返有损(F23/F24),两路独立命中;且 ISSUE-0036 引用引反
6 不碰 advParms ✅ 站得住(F15)
7 fromTaskId 链 ❌ 作废:新方案不需要这个字段
8 范围闸 ✅ 继承

保留原文是因为推理过程本身是资产 —— 哪一步跳了、为什么跳,比结论更值得留。

决定 1 · 做「再建一个」,不做「往原任务追加」

反方(最强版本):Tony 问的是「继续新增」。追加的好处是实打实的 —— 数据留在一个任务里, 「这批客户从哪来的」不用跨任务合并看;进度是一个数字。我换了他的问题。

裁决:不追加。 依据 F1 + F2:

for (关键词) { for (地区) { push(url) } }   ← F1
const url = task.urls[task.nextIndex++];    ← F2
  • 追加关键词 → 新 URL 全落在数组末尾 → 游标不受影响 ✅
  • 追加地区 → 新 URL 插在每个关键词组的末尾,散落在数组中间 → 游标全乱 🔴

打乱之后的后果是静默的:已跑的重跑、没跑的被跳过,不报任何错。 而要做对,得同时改四处(F2 游标插入位置、F4 两个分母、F5 写死赋值、F6 估算口径)。

🔴 追加唯一的独占优势是「系统知道搜过什么」,而这个优势已经被决定 2 的「标记」吃掉了。 剩下的只有「数据在一个任务里」—— 用 fromTaskId(决定 7)缓解。

⚠️ 代价必须明说:数据确实分在两个任务里。这是本方案唯一没解决的问题。

决定 2 · 已搜过的只标记,不移除

反方:既然 F8 精确知道搜过什么,为什么不直接帮用户移除? 让他自己删,等于没帮他 —— 他大概率记不清上次搜了什么,尤其跑完好几天以后。

裁决:只标记。 依据 F11 —— 组合匹配本身就不保证准(已重写过一次修三个 bug,现在仍靠 includes 模糊兜底)。在这样一个匹配上做自动移除,失败方向是致命的:

匹配出错的方向 后果 用户能发现吗
假阴性(搜过的没认出来) 多搜一遍,浪费时间(F7:不产生脏数据) ✅ 看得见
假阳性(没搜过的判成搜过) 静默漏采 ❌ 永远不知道

🔴 用一个会静默漏采的机制,去解决「漏采」这个问题 —— 自相矛盾。

⇒ 同一份不完美的匹配,用在提示上最坏是数字显示错了;用在过滤上就是真的少搜了。 采集工具的默认必须偏向多采。

反方的反方:那为什么不把匹配做准?

依据 F10 —— keyword 是拼接字符串,而地区名本身可能含逗号/加号("City,+State")。 要做准得改存储结构(存 {category, location} 而不是拼好的串)。 那是对的一刀,但不是这一刀 ⇒ 登记为后续(见七、登记项)。

决定 3 · 标记显示「上次采到多少家」,不是「搜过 / 没搜过」

反方:数字会让新手纠结 ——「3 家是多是少?」布尔值一眼就懂。

裁决:显示数字。 正因为会纠结,他才会去想「是不是这个词不对路」。 布尔值只会让他跳过这一行。

依据 F8:TaskProgressEntry.count 本来就有,显示它是零成本。

  • 「餐厅 · 1240 家」→ 别重搜了
  • 「咖啡馆 · 3 家」→ 要么这地方真没有,要么词不对路,值得换个词

后者正是新手最需要的提示,而且它只能从这份数据来。

反方的反方:要不要替他标出「异常低」的?

不要。 那是替用户做判断,而且在词少时没有参照(中位数无意义)。 把 1240 和 3 并排放着,数字自己会说话。

决定 4 · 入口放两处

反方:详情页入口太深(得先点进度文字),很多人不知道有详情页; 但只放任务行菜单,又错过了「看完数据的那一刻」。

裁决:两处都放,指向同一个动作。

  • 详情页底部(F17:那里已经在列每个组合采到多少)—— 他看到「咖啡馆 3 家」的下一秒, 正是产生这个念头的时刻
  • 任务行更多菜单(紧挨「重命名」)—— 他在列表上想起来的时刻

两个入口 = 同一个 handler,一行调用,不增加任何概念。

决定 5 · 地区预填成 mode:'specific' + 展开后的 paths

反方:依据 F12,这是有损的 —— 用户当初勾的「整个美国」变成了「手选 50 个州」, 和他的记忆不一致;以后想改成「整国 + 城市级」还得重勾。

裁决:接受,而且显示反而更准。

输入框显示(F13 的算法)
原任务(勾「整国」) 1 国 · **1** 区域 ← mode:'all' 被算成 1
复制出来(展开后) 1 国 · **1250** 区域

1250 才是真实会搜的数量,原来那个「1 区域」是误导性显示。

⚠️ 但要在界面上说一句:「地区按上次实际搜的 1250 个预填」—— 不让他以为丢了什么。一句话,不是表格。

性能:依据 F13/F14 不存在问题 —— 输入框只显示摘要不渲染列表, picker 三级下钻任何时刻只有几十到两百行 DOM,paths 再长也只是内存数组。 (而且这系统跑过 11 万个地区的任务,见 ISSUE-0036。)

决定 6 · 不碰筛选条件(advParms)

反方:用户可能就是想换个筛选条件(评分下限、必须有邮箱)重采。

裁决:不碰。 依据 F15 —— 它是全局 settings,新建和复制一样带不进去。 本功能不负责它。

🔴 但核验暴露了一个已存在的真问题:同一个任务的前后两段, 如果用户中途改了全局设置,就是按不同条件采的,而任务本身不记录这件事。 ⇒ 登记为后续(见七)。

决定 7 · 加 fromTaskId?: string 串起复制链

反方:新字段 = 新复杂度。不加行不行?

裁决:加。 不加的话第二次复制只看得见它复制的那一个任务, 看不到更早的 —— 标记会越来越失真,而失真的标记比没有标记更坏。

storage 字段只加不删是本仓既有规则,加一个可选字段成本极低。

反方的反方:链断了怎么办(原任务被删)?

依据 F9 —— 删除任务会 clearTaskProgress,记录一起没了。 ⇒ 找不到就不显示标记,绝不显示错的。这条要写成判据。

决定 8 · 不做的事(范围闸)

不做 为什么
合并两个任务 新概念,且涉及数据归属重写
任务分组 新概念
改导出 fromTaskId 只用于复制时聚合记录,不进导出
改 resultCount 算法 F6 它是估算,但这是已存在的问题(两个任务并发就有),不由本刀引入,也不由本刀修
自动帮用户挑词 决定 2/3 的同一条理由:替用户判断,而判断依据不保证准

五、新手走查(零说明验证 · 按新方案)

检验标准:不读任何文档,能不能用对?

  1. 任务跑完,点进度文字 → 详情页(这个界面他本来就会看)
  2. 看到一行行「咖啡馆 · 上海 · 已采集 3」「餐厅 · 上海 · 已采集 1240」「奶茶 · 上海 · 待采集」
  3. 勾上想再搜的那几行
  4. 底部:「用勾中的 12 个组合再建一个任务」
  5. 点一下,新任务排队

🔴 比原方案更零成本的三点(三审之后才看清): - 他逐行看得见每个组合搜过没有、采到多少 —— 不用相信任何聚合数字 - 勾选是他自己的决定,系统不替他删也不替他留 - 没有「地区变成 1250 个」这个困惑点 —— 因为根本不经过地区选择器

⚠️ 仍需一句话说明的:新任务的数据和原任务是分开的(第八节限制 1)。

命名

候选 判断
「复制」 ❌ 会被理解成复制数据
「追加 / 补充采集」 ❌ 新名词
「照这个再建一个」 ⚠️ 原方案用的。三审指出「这个」指代不清(照这组词?照这个任务含数据?)
「用勾中的 N 个组合再建一个任务」 ✅ 按钮文案自带数量,动作和范围都不用猜

六、实现拆解(combos 方案 · 含二审六条必补)

# 内容 风险
1 MapTask 加 combos?: {category, location, countryCode, **countryName**}[](必补一) 低
2 🔴 buildTaskUrls 加分支,放在最前面(必补二) 高 —— 全仓唯一 URL 生成点
3 🔴 建任务时 total = buildTaskUrls(task, settings).length,不是 combos.length(必补五) 中
4 🔴 构造 combos 时按 (category, location, countryCode) 三元组去重(必补五) 低
5 🔴 locCount 计入 combos:isMulti ? locationEntries.length : (combos?.length ?? locations.length)(必补四) 中 —— 这是 ISSUE-0036 的防线
6 🔴 空 combos 显式拒绝,不回退笛卡尔积(必补六) 低
7 🔴 详情页 combos 构造走 task.combos 分支(必补三,三路命中) 中 —— 不改匹配逻辑,只改期望集合来源
8 buildSources() 补 countryCode(F21 现在丢了),Combo 加该字段 低
9 task-view.tsx:707-714 的「X 个地区」对 combos 任务改文案 低
10 详情页每行勾选框(字符串 key)+ 「全选当前筛选结果」 中(洞 ④⑤)
11 「再加几个词」输入区:新词 × 勾中组合的地区集合(去重后) 中
12 底部按钮文案写出最终搜索次数,不只写组合数与词数 低
13 任务行「更多」→「补搜…」→ 打开详情页并进入勾选模式 低

🔴 不改 task-detail-dialog 的匹配逻辑(F11/F19/F20 那段修过三个 bug)—— 步骤 7 改的是期望集合的来源,不是匹配算法。

七、判据清单(实现时必须写)

  1. 🔴 老任务路径零回归:无 combos 的任务,buildTaskUrls 输出与改动前逐条相同
  2. 🔴 分支顺序:同时有 combos 和 locationEntries 的任务必须走 combos —— 构造这样一个任务作为判据输入(必补二)
  3. 🔴 任意子集:勾中 N 个不成矩形的组合(对角线构造),生成的 URL 是 N 条不是 N²
  4. 🔴 两个分母对齐:task.total == buildTaskUrls().length —— ⚠️ 判据要构造一个会触发去重的 combos(同名新词 / custom 源同名地区), 验证 total 取的是去重之后的数(必补五)
  5. 🔴 50k 守门对 combos 生效:50001 个 combos 必须被拒,报错信息与现有一致(必补四)
  6. 🔴 空 combos 被拒,且不回退到笛卡尔积(必补六)
  7. 🔴 详情页对 combos 任务显示正确:N 个组合就显示 N 行,不是 N²(必补三)
  8. 🔴 countryName 在默认 searchCountry:'name' 下能复现 URL(必补一)
  9. 勾选不受匹配影响:组合无论 done 真假,勾中就一定进 combos
  10. 新词的地区来源:新词 × 勾中组合的地区集合(去重),不是 × 全部地区
  11. 勾选状态用 category|location 字符串 key,polling 重算后不丢(洞 ④)
  12. 全选只选当前筛选后的行,截断时明确告知实际条数(F17 + 洞 ⑤)
  13. 新任务与源任务不同名(F16 列表无搜索 + 20 条一页)
  14. searchDepth 完全不参与这条路径(F23/F24)

八、已知限制(必须写进产品文档)

🆕 二审补的三条:

0a. 停止后再继续会从头跑(mimo)—— controlTask('resume') 在 batch 不在内存时 重调 buildTaskUrls 并 startBatch,nextIndex 归 0。这是已有行为,非 combos 引入, 但补搜场景更痛(勾了 100 个跑到 80 个停掉,再继续从第 1 个开始)。去重保数据不脏,浪费的是时间。 0b. 补搜任务的「采集数」常态接近 0 —— deleteRepeat 默认开(F7), 重搜已采过的组合 added ≈ 0。用户第一眼看到「0 家」会误读成「没搜到」, 产品文档必须解释这个 0 的含义。 0c. 新词是隐式展开的 —— M 个新词 × R 个地区。按钮文案必须写出最终搜索次数。

  1. 🔴 数据分在两个任务里,而数据页的任务筛选是单选(F25/F26)—— 要把原任务 + 补搜任务的商家一起导出,只能分两次导,或清掉筛选导全库(混入其他任务)。 ⚠️ 三审里这一条被 dshf 判为「会坑死」、mimo 判为「不坑」,实查裁决为 真摩擦但非死路 ⇒ 见第九节,已升格为登记项。
  2. 筛选条件是全局的(F15)—— 两个任务可能按不同条件采。已存在的问题。
  3. resultCount 是估算(F6)—— 两个任务并发时互相污染。已存在的问题。 ⚠️ 顺带订正:原 spec 写「注释自承是估算」,实查该注释在 task-store.ts:41, 不在 task-manager.ts:126(glm53 指出)。
  4. progress 写入是 fire-and-forget(F27)—— SW 休眠会丢条目 ⇒ 详情页的 「已采集」标记天然可能不全。方向安全(少标不多标),但要在产品文档说一句。

九、登记项(本刀不做,另开)

  • 🔴 数据页任务筛选改多选(F25)—— 三审共同指出,补搜场景每次都固化一道手工合并工序。 这条优先级已升格:没有它,本方案的「数据分两个任务」就一直是真痛点
  • 🔴 buildExpectedKey 与 buildSearchUrl 是双实现(glm53 X_OPEN①)—— 后者的拼接规则一改,前者的精确匹配层整体失效、全跌进 includes 兜底,且无任何测试拦截。 抽共享函数时必须连 key 构造一起抽
  • TaskProgressEntry 改存结构化 {category, location} 而不是拼接串(F10)—— F11/F19/F20 那一堆的根治
  • 兜底命中不消费 progressMap(F20)⇒ 同一条记录被多个组合重复认领 —— 独立 bug,该开 issue
  • 任务记录自己跑时的筛选条件快照(F15)
  • resultCount 改成按 taskId 精确计数(F6;商家表已存 taskId)
  • 任务完成时给「哪些地区一家都没采到」的提示
  • CategorySelect 的 unknownWords 白名单(glm53 X_OPEN②):如果将来真做创建界面预填, 预填的自造词会被标「未知类别」劝退新手 —— 本方案不走那条路,但记一笔

十、三审产出存档

执行方 产出
dshf ~/.claude/tools/briefs/auditSpec024Dshf.txt
mimo-pro ~/.claude/tools/briefs/auditSpec024Mimo.txt
glm53 ~/.claude/tools/briefs/auditSpec024Glm.txt

任务书 body sha256 三份相同:ef269a6402a8a5f0…(label 行除外)。