功能定位：为什么用二维码做离线同步
SafeW 3.2.0 把“加密数据库离线同步”做成一项独立模块，解决的是零信任网络下、无公网或公网不可信时的配置与密钥搬运。相比传统云端同步，它把传输面压缩到一次性的二维码视觉通道，避免任何中间服务器落地，天然满足 GDPR 第 49 条“必要传输例外”与我国《个人信息出境标准合同》中对“不可控境外节点”的回避要求。
二维码在这里只是载体，核心是一个一次性、短寿命的量子前向安全密钥包（Kyber768 封装）。扫码即完成 ECDH+Kyber 混合密钥交换，后续数据库流通过 AES-256-GCM 进行块级加密，并通过本地 Wi-Fi Direct 或蓝牙完成传输。整个过程不依赖任何“加速节点”，也不产生日志。
边界与取舍：哪些数据能同步、哪些不能
可同步内容
- 账号主密钥的加密分片（不含明文）
- 自研节点列表、分流规则、应用级白名单
- WarpWire 配置文件（WireGuard-Q 格式）
- AI 恶意域名模型指纹（<20 MB）
上述数据均经过二次加密，二维码仅搬运密文，即使被截屏也无法逆向明文。
默认排除内容
- 临时邮箱历史、安全浏览器 Cookie
- ZT-LinkProof 区块链哈希（需单独手动备份）
- 客户端日志与崩溃报告
经验性观察：若数据库>200 MB（例如你导入了超大自定义规则），二维码将自动拆分为 6 秒一轮的动态幻灯片，需保持屏幕常亮，否则校验失败需重来。
前置条件与版本要求
| 平台 | 最低版本 | 额外权限 |
|---|---|---|
| Windows | 3.2.0 | 摄像头 + 附近设备 |
| macOS | 3.2.0 | 相机 + 本地网络 |
| Android | 3.2.0 | 相机 + 位置（BLE 扫描） |
| iOS | 3.2.0 | 相机 + 本地网络 |
若任一设备版本低于 3.2.0，菜单将隐藏“离线同步”入口，需先升级。官方在 3.1.8 阶段曾提供实验性 QR 备份，但加密格式不兼容，切勿混用。
操作路径：分平台最短入口
Windows / macOS（桌面端）
- 主界面右上角 ⚙️ → 数据库管理 → 离线同步 → 生成二维码。
- 选择同步范围（全量/仅节点/仅配置），点击下一步，屏幕出现动态二维码幻灯片。
- 在另一台设备选择扫描二维码，对准屏幕，等待提示“密钥交换完成”。
- 选择传输通道：推荐“本地 Wi-Fi Direct”，若电脑无无线网卡可切“蓝牙 5.2 LE”。
- 传输完毕后会弹出校验和，双方一致即自动重启客户端生效。
Android / iOS（移动端）
- 底栏 我的 → 设置 → 数据库 → 离线同步。
- 若作发送方，点我要发送；接收方则点我要接收。
- 后续步骤与桌面端相同，但移动端默认启用“隐私沙盒”时，需临时允许相机悬浮窗权限。
提示：iOS 版在“本地网络”权限关闭时，会 fallback 到蓝牙，速率为 2 Mbps 左右，同步 50 MB 配置约需 3-4 分钟，可接受。
失败分支与回退方案
现象：二维码扫后卡在“等待首包”
可能原因：发送方防火墙拦截了 UDP 5353（mDNS）。验证方法：在接收端打开浏览器访问 http://safew.local:5353，若无法解析即证明广播被拦。处置：临时关闭“私有防火墙”或在“高级安全”里放行 mDNS 规则，再点“重试”。
现象：提示“哈希校验不一致”
原因多为二维码幻灯片中途锁屏，导致最后一块数据缺失。回退：删除接收端半成品数据库 %APPDATA%\SafeW\temp\partial_sync.db（路径因版本而异），重新扫码即可，无需卸载客户端。
性能与耗时：可复现的观测方法
在发送端日志中搜索关键词 QR_PAYLOAD_CHUNK，可看到每块大小默认 1 280 字节；用块数 ×1 280 即可估算总数据量。经验性观察：100 KB 节点列表在 Wi-Fi Direct 下 8-12 秒完成；若切蓝牙，时间翻倍。
如需极限压缩，可在生成二维码前勾选“精简模式”，此时会剔除节点城市名称与延迟历史，数据库体积可缩小约 35%，但接收端需自行测速更新延迟，首次启动节点列表会显示“未知延迟”。
适用/不适用场景清单
| 场景 | 是否推荐 | 理由 |
|---|---|---|
| 跨国团队出差，酒店 Wi-Fi 不可信 | ✅ 强烈推荐 | 零云落地，合规简单 |
| 节点列表 >500 MB | ❌ 不推荐 | 二维码拆帧过多，失败率高 |
| MIUI 15 隐私沙盒被系统强制休眠 | ⚠️ 需关闭沙盒 | 否则相机权限会被回收 |
| 需要审计日志留存 | ❌ 不适用 | 离线同步无日志，无法审计 |
与第三方自动化工具协同
SafeW 并未开放二维码生成的 API，因此无法通过脚本自动轮换密钥。若企业需要批量下发配置，建议走“加密文件+可移动 U 盘”通道，再手动扫码做一次密钥注入，其余设备用蓝牙接力复制。该流程在 50 台以内可接受；超过 50 台请等待官方 2026-Q3 计划中的“团队版离线推送器”。
最佳实践 10 条速查表
- 同步前双方均升级至“截至当前的最新版本”，避免格式不兼容。
- 发送端先做一次“数据库压缩”清理废弃节点，减少体积。
- 选择全黑或全白桌面背景，防止二维码反光。
- 笔记本合盖角度调至 90°，摄像头对准距离 20-30 cm 成功率最高。
- 若用蓝牙，请关闭周围无线鼠标、键盘，避免 2.4 GHz 拥塞。
- 传输完毕立即在两端分别导出一次加密备份，文件名带时间戳。
- 企业场景下，把二维码幻灯片录屏后需用安全擦除工具删除，防止截屏残留。
- 接收端完成导入后，务必手动触发“节点延迟重测”，防止旧延迟误导分流。
- 若出现“区块链哈希不匹配”提示，与离线同步无关，应检查 ZT-LinkProof 备份。
- 每季度轮换一次主密钥，并重新扫码，形成密钥滚动机制。
故障排查 FAQ（FAQ Schema）
扫码后提示“密钥交换失败 0x05”怎么办？
0x05 表示 Kyber 封装校验未通过，99% 是因为二维码被截断。请调高屏幕亮度至 80% 以上，重新扫码即可。
iOS 隐私沙盒隐藏后无法调用相机？
进入系统设置 → 屏幕使用时间 → 内容与隐私访问限制 → 相机，把 SafeW 临时白名单即可，同步完再关闭。
可以一次性把 1 GB 自定义规则同步过去吗？
经验性观察：超过 200 MB 后二维码拆帧超过 1 500 张，手动保持常亮不现实。建议切“加密 U 盘”通道，再扫码只做密钥交换。
蓝牙传输中途掉线如何续传？
SafeW 采用块级校验，掉线后会在最近完成块续传，无需重新开始。若 5 分钟内未恢复，双方自动回退到二维码重扫。
离线同步后的数据库还能云端同步吗？
可以，两者不冲突。离线同步仅替代“首次密钥搬运”，后续增量仍走 ArcShield 云端加密通道，用户可在设置里随时关闭。
总结与下一步行动
SafeW 3.2.0 的二维码离线同步用“视觉通道+量子密钥”把零信任做到了物理隔离层面，适合出差、跨境、合规要求高且公网不可信的场景。它的核心取舍是体积与可靠性——200 MB 以内、设备数 50 以下，扫码最划算；再大就请等待官方后续“团队版离线推送器”。
读完本文，你可以：
- 立即检查两端版本，按表升级；
- 用“精简模式”把节点列表压到 100 MB 内，再执行扫码；
- 完成同步后，导出一份带时间戳的加密备份，形成双保险。
下一步，如果公司设备超过 50 台，建议先用手动 U 盘接力，同时向 SafeW 商务申请“团队版推送器”内测席位，等 2026-Q3 正式计费上线后再评估成本。这样，你既抓住了量子加密窗口期，又避免了二维码的体积天花板。