设置页重排¶
为什么做¶
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 或已删除的字段。
⚠️ 这条断言守的是「不丢」,不是「好找」 —— 一个被搬进永不展开的折叠区的字段,它照样绿。
四处搬迁¶
- 社区共享 + 云端 API 地址 → 云端 Tab(③)
FormProvider提到 Tab 判断之外(useForm没开shouldUnregister,切 Tab 不丢值) deleteNoEmail→ 独立危险区(⑥)error 色边框 + 底纹 + 「不可恢复」标题- 加分门槛 ↔ 过滤门槛双向对照条(④)各自当场显示对方的当前值
—— 没有真把控件搬到一起:质量分走独立
useState+qualityConfigItem, 拆开会打散「权重 + 门槛 + 分级」这套内在逻辑。用户困惑的是「我设的是哪个」, 给他当场看到两个值就够了。 - 「运行参数」→「本地设置」(⑦)冗余好过误导;去掉这层标题属于主体重排
结构断言(防下次重构搬回去)¶
- 云端地址与社区共享开关必须在
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、比测试都不够 —— 直接比行集合:
排序后完全一致 ⇒ 没有任何一行被改动、丢失或重复。这是整块搬运最强的验证。
断言¶
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仍读、 读完传给从不使用的形参。已在字段覆盖断言里显式豁免并写明理由。