跳转至

设置导入导出

为什么做

66 个可改字段、三档预设、十个自定义黑名单 —— 换台机器或重装扩展,这些全要手打一遍。

🔴 一个与「日志导出」相反的取舍

仓库里已有一个 JSON 导出:log-view.tsx 的日志导出。它会脱敏 cloudSyncBaseUrl 和各种自定义黑名单,替换成 <redacted:38chars>。

设置导出不能照抄它。

日志导出 设置导出
用途 发给开发者排障 给自己换机器还原
私人字段 脱敏 原样带走
理由 私人信息不该跟着排障材料走 脱敏之后导入方拿到一堆占位符 = 功能作废
代价怎么办 —— 转移到告知:点名哪些私人字段跟着走了

⚠️ 同一个动作在不同用途下的正确做法相反 —— 不能照抄另一处的实现。 导出时 toast 会列出实际带走的私人字段(只列真有内容的,空字段不制造无谓警告), 并提醒「别随便发给别人」。

导入的三道判据

判据写在 src/utils/settings-transfer.ts(纯逻辑、零副作用,可直接跑行为测试)。

  1. 认 kind:不是 laifaxin-settings 直接拒。防止把日志导出、别的扩展的 JSON 硬塞进来。
  2. 认 version:文件版本比当前扩展新 ⇒ 拒绝,而不是尽力而为。 结构可能已经变了,硬读会写进一堆半对的值。
  3. 只收已知键 + 类型匹配,其余丢弃并记 warning:
  4. 未知键:可能来自更新版本,也可能是手改坏的 —— 静默塞进 storage 会污染数据结构
  5. 类型不符:maxConcurrentTasks: "3" 这种(手改 JSON 最常见)会让下游算术变成字符串拼接
  6. 缺字段:用默认值补(老版本导出的文件照样能用)

🔴 数值区间不在这里校验

区间定义在设置页的 yup schema 里,那是它的单一事实源。 导入后的值会进表单,yup 当场标红。

在这里再写一份区间就是第二个真相源 —— 而这一天为这类分叉栽过整整一天 (0153-max-concurrent-fallback-fork 一个默认值四处分叉、 0162-dead-param-and-wiki-lied-for-12-versions wiki 说了十几个版本的错话)。

导入必须确认

它覆盖全部设置,其中包含「跳过无邮箱商家」这类会删数据的开关 —— 不确认就写,等于替用户改了一个不可逆开关。

确认框里除了警告,还摆出 warning 数量与前 6 条: 让用户在点确认之前就知道有多少项没对上。

验证

  • tests/settings-transfer.test.ts 13 条行为测试(mock 不到的纯函数,跑真值): 导出结构 / 私人字段点名 / 空字段不点名 / 类型不符 / 未知键 / 缺字段 / 数组按数组比 / 坏 JSON / 错 kind / 未来版本 / round-trip 不丢字段不变值
  • settings-copy-guards ⑫ 三条 UI 断言 + 2 条定向变异打红

⚠️ 写断言时踩的两个坑

① 窗口开小了会在基线上就红:第一版写 /<ConfirmDialog[\s\S]{0,600}onConfirm=\{applyImport\}/, 而中间那段 message 是个几百字的三元表达式 ⇒ 基线直接红, 且红的理由和它要守的东西无关。改为两件事各自断言。

② 折叠区体量闸被新增内容误伤:导入确认框加在 </Card> 之后, 而 ⑪ 的最后一块边界用的是「文件末尾」⇒ 最后一个折叠区凭空「长成抽屉」而实际一行没加。 改为用它自己的 </AdvancedSection> 当边界。 🔴 terra 在 v0.10.191 那轮就点过这条(「把内容挪到最后一个折叠区之后会怎样?」), 我当时没处理 —— 三个版本之后自己撞上了。