跳转至

设置页重排

为什么做

v0.10.177–182 清掉的地雷里,至少两个根因是布局,不是文案:

  • 「质量分门槛」与「数据过滤门槛」名字像、行为相反、隔着两张卡 ⇒ v0.10.177 只能靠互指文案止血
  • 一键配置会改「挖掘深度」,而那个输入框在另一个折叠区 ⇒ v0.10.177 只能加条件提示

🔴 用文案解释的,本该用结构解决。 文案是止血,重排才是治本。

现状(实测,v0.10.182)

Tab: 本地设置
  1. 显示比例        1 项    localStorage,纯外观
  2. 质量分          10 项   独立 storage key,只管排序不管采集
  3. 一键配置        3 档    批量写 12 个字段
  4. 基本设置        2 项
  5. 数据过滤        8 项
  6. ▸高级·地图抓取  6 项
  7. ▸高级·网站抓取  30+ 项  ← 垃圾抽屉
  8. ▸高级·健康巡检  7 项
Tab: 云端设置
  └ CloudSyncSettings(laifaxin 云备份)

字段覆盖率:SettingParams 53 个字段,页面上 52 个有入口。 唯一没有 UI 的是 requestConcurrency —— 那个「wiki 说废弃、task-manager 仍读、 读完传给从不使用的形参」的僵尸字段。

七个结构性问题

# 问题 阶段一是否处理
① 首屏被最不常用的两张卡(显示比例 / 质量分权重)占住,一键配置排第 3 ✅ v0.10.190
② 「高级·网站抓取」是垃圾抽屉:并发/策略/云功能/调试/爬取范围/内容提取六类混在一起 ✅ v0.10.191 切成四块
③ 两个「云」,一个在 Tab 上,一个埋在折叠区最深处 ✅ v0.10.183
④ 加分门槛与过滤门槛名字像、行为相反、隔两张卡 ✅ 双向对照条 + v0.10.190 排到相邻
⑤ 一键配置会改一个你看不见的字段(scrapeDepth) ⚠️ 仍是条件提示(挖掘深度现在在「高级 · 爬取范围」里)
⑥ 唯一不可逆的操作混在去重复选框里 ✅ 独立危险区
⑦ 「运行参数」标题名不副实 ✅ 改名「本地设置」

方案对比

排法 新手 老手 改动量
A 按使用频次分层 常用在上、高级折叠、罕用收到二级 ✅ ✅ 中
B 按流水线阶段 地图搜索 → 入库过滤 → 网站抓取 → 内容提取 → 巡检 ⚠️ ✅✅ 中
C 简单/专家双模式 一个开关切两套界面 ✅✅ ✅ 大

选 A 为骨架,借 B 的分组逻辑切折叠区。

理由:A 解决「用户找不到」,B 解决「用户理解不了」—— 而目标用户是外贸业务员,他不需要理解流水线,他需要三秒内找到那个让采集变慢一点的开关。 C 的成本不成比例:双模式意味着每加一个字段都要决定它属于哪一档,长期维护负担比现在还重。

目标排布

Tab: 采集设置
  ┌ 一键配置(推荐先点这里)          ← 首屏第一眼
  │   ⓘ 它会改这 12 项,含「挖掘深度」(在下方高级区)   ← ⑤ 从临时提示变成常驻说明
  ┌ 搜索方式
  ┌ 数据过滤(决定什么能入库)
  │   去重 / 必填 / 质量门槛 / 🔴 危险区
  ┌ 排序与评分(不影响采集)
  ▸ 高级 · 地图抓取
  ▸ 高级 · 网站抓取      并发 / 间隔 / 超时 / 域名黑名单 / 多阶段
  ▸ 高级 · 爬取范围      挖掘深度 / 子域跟随 / 跨域白名单 / 关键词 / 跳过资源
  ▸ 高级 · 内容提取      邮箱正则 / 手机三 Tier / 社媒正则 / 三套黑名单
  ▸ 诊断与稳定性         健康巡检 + 响应快照
  ▸ 界面                 显示比例
Tab: 云端
  ├ 云备份(laifaxin)
  └ 社区共享(实验)

阶段一:安全网 + 四处搬迁(v0.10.183 ✅)

安全网先于重排

重排 1900 行 JSX 最大的风险不是排得不好,是某个字段搬着搬着不见了 —— 不报错、不红类型、不红任何现有测试,只会让那个设置永远停在默认值。

⇒ tests/settings-field-ui-coverage.test.ts:每个 SettingParams 字段都必须有 name="..." 入口;豁免必须登记理由,且豁免表不许躺着已有 UI 或已删除的字段。

⚠️ 这条断言守的是「不丢」,不是「好找」 —— 一个被搬进永不展开的折叠区的字段,它照样绿。

四处搬迁

  1. 社区共享 + 云端 API 地址 → 云端 Tab(③) FormProvider 提到 Tab 判断之外(useForm 没开 shouldUnregister,切 Tab 不丢值)
  2. deleteNoEmail → 独立危险区(⑥)error 色边框 + 底纹 + 「不可恢复」标题
  3. 加分门槛 ↔ 过滤门槛双向对照条(④)各自当场显示对方的当前值 —— 没有真把控件搬到一起:质量分走独立 useState + qualityConfigItem, 拆开会打散「权重 + 门槛 + 分级」这套内在逻辑。用户困惑的是「我设的是哪个」, 给他当场看到两个值就够了。
  4. 「运行参数」→「本地设置」(⑦)冗余好过误导;去掉这层标题属于主体重排

结构断言(防下次重构搬回去)

  • 云端地址与社区共享开关必须在 tab === 'cloud' 分支内
  • FormProvider 必须在 Tab 判断之外
  • deleteNoEmail 前 2000 字符内必须有 error 色边框与底纹

6 条定向变异全部打红。

阶段二(待排期)

①②⑤ 三条 + 折叠区按职责切成四个。不碰字段语义、storage 结构、默认值、预设值。

风险

字段丢失 阶段一的覆盖断言已就位
老用户找不到东西 保持「高级区默认折叠」不变;搬走的地方留指路注释
产品文档烂掉 重排 PR 里同步改 docs/product/(阶段一已改 google-maps-collection.md)

🔴 渲染验证是这类改动的证据边界:本仓是 Chrome 扩展, 设置页依赖 chrome.storage,没法在普通浏览器里跑起来看。 tsc + 全量测试 + build 能证明「不会崩、字段没丢」,证明不了「长得对」。 每个阶段都需要人工加载 unpacked 看一眼。

阶段二·第一步:顺序重排(v0.10.190 ✅)

八张卡整块搬运,块内一个字符都没动:

重排前                          重排后
⓪  显示比例        ← 首屏      ①  一键配置(推荐新手)  ← 首屏
⓪′ 质量分(10 项)             ②  基本设置
①  一键配置                    ③  数据过滤
②  基本设置                    ④  质量分(排序与评分)
③  数据过滤                    ⑤  ▸高级 · 地图抓取
   ▸高级 · 地图抓取            ⑥  ▸高级 · 网站抓取
   ▸高级 · 网站抓取            ⑦  ▸高级 · 健康巡检
   ▸高级 · 健康巡检            ⑧  显示比例          ← 挪到最后

顺序原则:按「用户来这里要干什么」排,不按「字段属于哪个模块」排。

重排前首屏是「显示比例 + 质量分权重」—— 一个改一次一辈子不动、一个跟采集半点关系没有,而一键配置排在第三。 用户十有八九是为了调采集速度或过滤才进设置页的。

顺带解决了 ④ 的另一半:质量分现在紧跟数据过滤,两组「名字像、行为相反」的门槛 排到了相邻位置(原先隔着三张卡),hint 也改成「只影响列表排序,不改变采集什么」。

搬运的守恒证据

比行数、比 tsc、比测试都不够 —— 直接比行集合:

sorted(old.split('\n')) == sorted(new.split('\n'))   # ✓

排序后完全一致 ⇒ 没有任何一行被改动、丢失或重复。这是整块搬运最强的验证。

断言

settings-copy-guards ⑩ 三条:八张卡的相对顺序(钉顺序不钉行号)、 一键配置必须第一、质量分必须声明「不影响采集」。2 条定向变异打红。

阶段二·第二步(待做)

切分 440 行的「高级 · 网站抓取」:

▸ 高级 · 网站抓取    并发 / 间隔 / 超时 / 域名黑名单 / 多阶段
▸ 高级 · 爬取范围    挖掘深度 / 子域跟随 / 跨域白名单 / 关键词 / 跳过资源
▸ 高级 · 内容提取    邮箱正则 / 手机三 Tier / 社媒正则 / 三套黑名单
▸ 诊断与稳定性       健康巡检 + 响应快照

阶段二·第二步:切分(v0.10.191 ✅)

446 行的「高级 · 网站抓取」切成四块:

切分前                            切分后
▸ 高级 · 网站抓取  446 行         ▸ 高级 · 网站抓取      并发 / 间隔 / 超时 / 域名黑名单 / 多阶段
  ├ 子区 A  进站策略              ▸ 高级 · 爬取范围      挖掘深度 / 子域跟随 / 关键词 / 跳过资源
  ├ 子区 A2 多阶段 + 响应快照     ▸ 高级 · 内容提取      邮箱 / 手机 / 社媒的正则与黑名单
  ├ 子区 B  内页跟随              ▸ 高级 · 诊断与稳定性  健康巡检 + 响应快照
  └ 子区 C  解析规则

折叠区不是抽屉 —— 它的意义是「按主题收起」,一旦没有主题,它只是把乱藏起来。 切分前那一个折叠区比前面五张卡加起来还长。

响应快照并进「诊断与稳定性」的理由:它是调试功能(抓不到东西时留一份响应原文好排查), 和抓取参数放在一起时用户会以为它影响抓取结果 —— 它不影响。 与健康巡检同属「出问题时才来看的东西」。

守恒证据(两步各一次)

步骤 判据 结果
切出 B/C 逐行 Counter 差集 丢失 0 条,新增 30 条全是外壳 / import
并入响应快照 按内容(strip 缩进)比 丢失 2 条 = 改名的 title/hint,新增 6 条 = 新 title/hint + 注释

第二次必须按内容比:响应快照的缩进从 24 降到 20,逐行比会把同一行算成「丢失 + 新增」。 判据要跟着改动的性质走 —— 纯搬运比原文,变缩进的搬运比内容。

断言

  • ⑩ 十张卡的相对顺序(钉顺序不钉行号)
  • ⑪ 折叠区体量闸:没有任何折叠区超过 250 行

⚠️ ⑪ 的判据是行数,不是「主题纯不纯」—— 后者机器判不了。 行数只是代理指标:超了不一定是坏事,但值得停下来看一眼该不该拆。

3 条定向变异打红:合回一块(顺序红)、诊断块改回旧名(顺序红)、 三块全合成 446 行抽屉(体量闸红)。

全部完成后的最终排布

Tab: 本地设置
  ① 一键配置(推荐新手)      ← 首屏第一眼
  ② 基本设置
  ③ 数据过滤(含 🔴 危险区)
  ④ 质量分(排序与评分,不影响采集)
  ⑤ ▸ 高级 · 地图抓取
  ⑥ ▸ 高级 · 网站抓取
  ⑦ ▸ 高级 · 爬取范围
  ⑧ ▸ 高级 · 内容提取
  ⑨ ▸ 高级 · 诊断与稳定性
  ⑩ 显示比例                  ← 挪到最后
Tab: 云端设置
  ├ 云备份(laifaxin)
  └ 社区共享(实验)

未做(留给后续)

  • ⑤ 一键配置改看不见的字段:挖掘深度现在在「高级 · 爬取范围」里, 仍靠 v0.10.177 的条件提示告知。要彻底解决得让预设不碰它、或把它提到一键配置卡内。
  • requestConcurrency 僵尸字段:wiki 说废弃、task-manager.ts:42 仍读、 读完传给从不使用的形参。已在字段覆盖断言里显式豁免并写明理由。