设置导入导出¶
为什么做¶
66 个可改字段、三档预设、十个自定义黑名单 —— 换台机器或重装扩展,这些全要手打一遍。
🔴 一个与「日志导出」相反的取舍¶
仓库里已有一个 JSON 导出:log-view.tsx 的日志导出。它会脱敏
cloudSyncBaseUrl 和各种自定义黑名单,替换成 <redacted:38chars>。
设置导出不能照抄它。
| 日志导出 | 设置导出 | |
|---|---|---|
| 用途 | 发给开发者排障 | 给自己换机器还原 |
| 私人字段 | 脱敏 | 原样带走 |
| 理由 | 私人信息不该跟着排障材料走 | 脱敏之后导入方拿到一堆占位符 = 功能作废 |
| 代价怎么办 | —— | 转移到告知:点名哪些私人字段跟着走了 |
⚠️ 同一个动作在不同用途下的正确做法相反 —— 不能照抄另一处的实现。 导出时 toast 会列出实际带走的私人字段(只列真有内容的,空字段不制造无谓警告), 并提醒「别随便发给别人」。
导入的三道判据¶
判据写在 src/utils/settings-transfer.ts(纯逻辑、零副作用,可直接跑行为测试)。
- 认
kind:不是laifaxin-settings直接拒。防止把日志导出、别的扩展的 JSON 硬塞进来。 - 认
version:文件版本比当前扩展新 ⇒ 拒绝,而不是尽力而为。 结构可能已经变了,硬读会写进一堆半对的值。 - 只收已知键 + 类型匹配,其余丢弃并记 warning:
- 未知键:可能来自更新版本,也可能是手改坏的 —— 静默塞进 storage 会污染数据结构
- 类型不符:
maxConcurrentTasks: "3"这种(手改 JSON 最常见)会让下游算术变成字符串拼接 - 缺字段:用默认值补(老版本导出的文件照样能用)
🔴 数值区间不在这里校验¶
区间定义在设置页的 yup schema 里,那是它的单一事实源。 导入后的值会进表单,yup 当场标红。
在这里再写一份区间就是第二个真相源 —— 而这一天为这类分叉栽过整整一天 (0153-max-concurrent-fallback-fork 一个默认值四处分叉、 0162-dead-param-and-wiki-lied-for-12-versions wiki 说了十几个版本的错话)。
导入必须确认¶
它覆盖全部设置,其中包含「跳过无邮箱商家」这类会删数据的开关 —— 不确认就写,等于替用户改了一个不可逆开关。
确认框里除了警告,还摆出 warning 数量与前 6 条: 让用户在点确认之前就知道有多少项没对上。
验证¶
tests/settings-transfer.test.ts13 条行为测试(mock 不到的纯函数,跑真值): 导出结构 / 私人字段点名 / 空字段不点名 / 类型不符 / 未知键 / 缺字段 / 数组按数组比 / 坏 JSON / 错 kind / 未来版本 / round-trip 不丢字段不变值settings-copy-guards⑫ 三条 UI 断言 + 2 条定向变异打红
⚠️ 写断言时踩的两个坑¶
① 窗口开小了会在基线上就红:第一版写
/<ConfirmDialog[\s\S]{0,600}onConfirm=\{applyImport\}/,
而中间那段 message 是个几百字的三元表达式 ⇒ 基线直接红,
且红的理由和它要守的东西无关。改为两件事各自断言。
② 折叠区体量闸被新增内容误伤:导入确认框加在 </Card> 之后,
而 ⑪ 的最后一块边界用的是「文件末尾」⇒ 最后一个折叠区凭空「长成抽屉」而实际一行没加。
改为用它自己的 </AdvancedSection> 当边界。
🔴 terra 在 v0.10.191 那轮就点过这条(「把内容挪到最后一个折叠区之后会怎样?」),
我当时没处理 —— 三个版本之后自己撞上了。