跳转至

全新用户首屏被告知「自定义配置(不匹配任何预设)」

症状(推断自代码,未在真实扩展里复现)

装上扩展、什么都没动,打开设置页:

  • 顶部橙色 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 新增两条:

  1. DefaultSettings 必须与某一档预设逐字段全等 —— 失败信息会逐字段列出 「预设=X 默认=Y」,不是只说「对不上」。
  2. 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 非空再跑测试。 「测试没红」有两种解释:断言没牙,或者我根本没改成功。 不先排除第二种,就会把自己的手滑记成断言的失败。