设置页四处误导性文案¶
怎么发现的¶
用户看着设置页说「现在太乱了」,要求先摸底。派 glmflash 做全字段勘察(66 个可改字段), 它交出全景表的同时列了 4 个「必须在重排前清掉」的地雷 —— 理由是:地雷不清,换个布局只是把误导搬个位置。
四个地雷¶
① 校验消息用望文生义的死亡短语¶
maxConcurrentTasks num('同时跑几个任务') ← 实际是【浏览器 Tab】上限
deepScrapeConcurrency num('同时挖几个网站') ← 实际是官网抓取 worker 数
deepScrapeDomainConcurrency num('单网站同时拉几页') ← 实际是同域名并发 worker 数
本仓铁律逐字写着:望文生义命名设置项 = 死路一条
(docs/wiki/settings-field-semantics.md)。而这三条是校验消息 ——
数值越界时它会直接弹到用户眼前,和 label 一样是产品文案,此前没人把它当文案管。
② 过滤门槛没说「无值也删」(危害最大)¶
src/utils/jsstore/search-data.ts 的判据:
前半截就是「没有评分也删」,而 UI 只说「评分 < 此值的商家跳过」。
🔴 新开的店、小商户常常还没有评分。 用户想「只要 4 星以上的优质商家」,
设了 minRating: 4 ⇒ 连所有没评分的一起删光 ⇒ 而这是入库时就不保存,
用户有 2 万条数据、没有回收站,不可恢复。
③ 加分门槛与过滤门槛同名、反行为、不同屏¶
| 位置 | 行为 | |
|---|---|---|
| 质量分「评分门槛」 | 质量分卡片 | 只加分,一条不删 |
| 数据过滤「最低评分」 | 数据过滤区(另一屏) | 直接不入库 |
两个名字像到用户分不出,而且不在同一屏 —— 只看到一个就会以为它在过滤。
④ 一键配置静默改掉另一个折叠区的字段¶
applyPreset 覆盖 12 个字段,其中 scrapeDepth 三档全写死 1。
而挖掘深度的输入框在【高级 · 网站抓取】折叠区里,与那三张卡不同屏。
⇒ 用户在折叠区把深度调成 2/3,回头点一下「平衡」,深度静默回到 1,界面上没有任何提示。
修¶
①②③ 改文案(含校验消息);③ 让两组门槛互相指认。
④ 不改预设的值(那是产品取舍,要 Tony 拍),只把这件事说出来: 读改动前的深度,只在真被改动时给一条 notice 并指明该项在哪个折叠区。
🔴 条件提示不是无差别提示 —— 无差别提示会变成噪音,用户几次之后就不看了, 那时它和没有提示等价。
元教训¶
🔴 文案改动没有任何类型或逻辑能守住它。
这四处全是字符串。改回去不会有 tsc 报错、不会有测试变红、不会有 lint 命中 —— 它是整个仓库里最容易静默退化的一类改动,偏偏又直接决定用户会不会删掉自己要的数据。
⇒ 新增 tests/settings-copy-guards.test.ts,把四条逐个钉死。
⚠️ 写这道闸时自己踩了一次:第一版断言直接 src.includes(死亡短语) ⇒
把测试自己要求写在注释里的那句引用也算成了违规(自己抓自己)。
改为只扫代码行 —— 注释里出现被禁短语是必要的:不写清楚禁了哪三句,
下一个人根本不知道禁了什么。
这是「判据在量别的东西」的又一种形态:它量的是「文件里有没有这个串」, 而要守的是「用户看得见的字符串里有没有」。
🔴 地雷 ④ 的最终解决(v0.10.193,Tony 拍板)¶
v0.10.177 当时只做了止血:预设照样把 scrapeDepth 重置成 1,只是改动时给一条条件提示。
理由是「改预设的值是产品取舍,要 Tony 拍」。
Tony 拍了:预设根本不该碰它。
三档的差别是「快慢 / 风险」,而挖掘深度是「挖多深」—— 那是用户对目标站结构的判断,跟快慢档位不是一个维度。 把一个不属于该维度的字段塞进预设,等于让「选快慢」这个动作 顺手改掉一个语义无关的设置。
⇒ 三档 values 里移除 scrapeDepth;深度提示那段逻辑随之删除
(预设不碰它,提示永远不触发 = 死代码)。
断言也从「改了要提示」翻转成「根本不许出现在预设里」。