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 分支必须放最前(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)¶
完全不数 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:
- 追加关键词 → 新 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 的同一条理由:替用户判断,而判断依据不保证准 |
五、新手走查(零说明验证 · 按新方案)¶
检验标准:不读任何文档,能不能用对?
- 任务跑完,点进度文字 → 详情页(这个界面他本来就会看)
- 看到一行行「咖啡馆 · 上海 · 已采集 3」「餐厅 · 上海 · 已采集 1240」「奶茶 · 上海 · 待采集」
- 勾上想再搜的那几行
- 底部:「用勾中的 12 个组合再建一个任务」
- 点一下,新任务排队
🔴 比原方案更零成本的三点(三审之后才看清): - 他逐行看得见每个组合搜过没有、采到多少 —— 不用相信任何聚合数字 - 勾选是他自己的决定,系统不替他删也不替他留 - 没有「地区变成 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 改的是期望集合的来源,不是匹配算法。
七、判据清单(实现时必须写)¶
- 🔴 老任务路径零回归:无
combos的任务,buildTaskUrls输出与改动前逐条相同 - 🔴 分支顺序:同时有
combos和locationEntries的任务必须走 combos —— 构造这样一个任务作为判据输入(必补二) - 🔴 任意子集:勾中 N 个不成矩形的组合(对角线构造),生成的 URL 是 N 条不是 N²
- 🔴 两个分母对齐:
task.total==buildTaskUrls().length—— ⚠️ 判据要构造一个会触发去重的 combos(同名新词 / custom 源同名地区), 验证total取的是去重之后的数(必补五) - 🔴 50k 守门对 combos 生效:50001 个 combos 必须被拒,报错信息与现有一致(必补四)
- 🔴 空
combos被拒,且不回退到笛卡尔积(必补六) - 🔴 详情页对 combos 任务显示正确:N 个组合就显示 N 行,不是 N²(必补三)
- 🔴
countryName在默认searchCountry:'name'下能复现 URL(必补一) - 勾选不受匹配影响:组合无论
done真假,勾中就一定进combos - 新词的地区来源:新词 × 勾中组合的地区集合(去重),不是 × 全部地区
- 勾选状态用
category|location字符串 key,polling 重算后不丢(洞 ④) - 全选只选当前筛选后的行,截断时明确告知实际条数(F17 + 洞 ⑤)
- 新任务与源任务不同名(F16 列表无搜索 + 20 条一页)
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 个地区。按钮文案必须写出最终搜索次数。
- 🔴 数据分在两个任务里,而数据页的任务筛选是单选(F25/F26)—— 要把原任务 + 补搜任务的商家一起导出,只能分两次导,或清掉筛选导全库(混入其他任务)。 ⚠️ 三审里这一条被 dshf 判为「会坑死」、mimo 判为「不坑」,实查裁决为 真摩擦但非死路 ⇒ 见第九节,已升格为登记项。
- 筛选条件是全局的(F15)—— 两个任务可能按不同条件采。已存在的问题。
resultCount是估算(F6)—— 两个任务并发时互相污染。已存在的问题。 ⚠️ 顺带订正:原 spec 写「注释自承是估算」,实查该注释在task-store.ts:41, 不在task-manager.ts:126(glm53 指出)。- 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 行除外)。