全新用户首屏被告知「自定义配置(不匹配任何预设)」¶
症状(推断自代码,未在真实扩展里复现)¶
装上扩展、什么都没动,打开设置页:
- 顶部橙色 warning:「自定义配置(不匹配任何预设)」
- 保守 / 平衡 / 激进 三张卡 一张都不高亮
更刺眼的是「重置为默认值」按钮 —— onReset 写回的正是 DefaultSettings,
所以点完重置,界面照样说「不匹配任何预设」。
⚠️ 置信度:链路是逐行读出来的(下面「链路」一节每步都有落点), 但没有在真实浏览器里加载扩展复现。修之前应先跑一次实测确认。
实测数据¶
DefaultSettings(src/utils/storage-data.ts)vs 三档预设(settings-view.tsx PRESETS),
12 个预设字段逐个比:
| 与哪档比 | 不同字段数 | 具体 |
|---|---|---|
| 保守 | 8 | maxConcurrentTasks / 四个 delay / timeout / 两个 gap |
| 平衡 | 1 | deepScrapeConcurrency:默认 1,平衡 2 |
| 激进 | 11 | — |
⇒ 默认值不是独立的第四套参数,它就是「平衡」档 —— 只是有一个字段没跟上。
链路(每步都可验)¶
storage-data.ts:257 defaultValue: DefaultSettings
↓ 首次启动 storage 没存过 ⇒ getValue() 返回它
settings-view.tsx:621 getInitValue() → applyValues(settings)
↓ form values = DefaultSettings
settings-view.tsx:172 matchPreset():Object.keys(preset).every(全等)
↓ deepScrapeConcurrency 1 ≠ 2 ⇒ balanced 不匹配;另两档差更多
settings-view.tsx:540 currentPreset = 'custom'
↓
settings-view.tsx:706 「自定义配置(不匹配任何预设)」(warning.main)
settings-view.tsx:976 active={currentPreset === key} ⇒ 三张卡全灭
根因:与 0153-max-concurrent-fallback-fork 同族¶
默认值和推荐档是两套独立维护的数字,没有任何东西保证它们一致 —— 它们只是曾经相等过,某次单独调了一个就分叉了,而且分叉不会报错。
matchPreset 用的是全等判据,所以「差一个字段」和「差十一个字段」对用户是同一句话。
🔴 待 Tony 拍:改哪个值¶
两个方向都只改一个数字,但产品含义相反:
| 方案 | 动作 | 后果 |
|---|---|---|
| A | DefaultSettings.deepScrapeConcurrency 1 → 2 |
首次用户的官网抓取 worker 数从 1 变 2 —— 更快,封号风险略升 |
| B | PRESETS.balanced.deepScrapeConcurrency 2 → 1 |
推荐档降到和默认一样 —— 不提高任何人的风险,但「平衡」在这个字段上与「保守」相同 |
主控倾向 B:它不改变任何现有用户的实际抓取强度,只是让「推荐档」这个标签 对齐已经在跑的默认值。A 会在用户毫不知情的情况下把首次抓取强度翻倍, 而封号风险正是本产品最不能静默调整的维度。
修完要补的闸¶
不论选哪个值,都要加一条断言:DefaultSettings 必须与 PRESETS 中的某一档逐字段全等。
🔴 这条断言现在是红的 —— 所以不能先加。它得和值一起改,否则等于往 main 里塞一个已知失败的测试。
🔴 v0.10.182 修完:Tony 拍 B 案¶
PRESETS.balanced.values.deepScrapeConcurrency 2 → 1,对齐 DefaultSettings。
选 B 不选 A 的理由(Tony 拍板):A 会在用户毫不知情的情况下把首次抓取强度翻倍, 而封号风险是本产品最不能静默调整的维度。B 不提高任何人的实际风险, 只是让「推荐档」这个标签对齐已经在跑的默认值。
改完实测:默认 vs 平衡 0 个字段不同(vs 保守差 8、vs 激进差 11)。
钉上的断言¶
tests/settings-default-single-source.test.ts 新增两条:
DefaultSettings必须与某一档预设逐字段全等 —— 失败信息会逐字段列出 「预设=X 默认=Y」,不是只说「对不上」。matchPreset仍用全等判据 —— 上面那条断言的前提。 判据换成部分匹配的话,断言还绿而界面行为已经变了。
⚠️ audit_grep 只挂得住第 2 条:scan:issue-coverage 的扫描根是
src / scripts / wxt.config.ts / package.json,够不着 tests/
(试着把 paths 指向测试文件,门禁直接报「paths 超出默认扫描根」)。
⇒ 第 1 条只能由 vitest 本身守住 —— 删了那条断言,没有任何静态闸会响。
3 条定向变异全部打红:退回 deepScrapeConcurrency: 2 / 改真相源另一个字段 /
把 matchPreset 的 .every 改成 .some。
⚠️ 变异首打失手一次,如实记¶
第一条变异(退回 2)首打测试仍绿。查下来是变异本身没写进文件 ——
替换模式跨了 balanced 块的边界,一次都没匹配上。
⇒ 从这次起,每条变异先看 git diff --numstat 非空再跑测试。
「测试没红」有两种解释:断言没牙,或者我根本没改成功。
不先排除第二种,就会把自己的手滑记成断言的失败。