SafeW跨平台同步加密文件冲突时如何手动合并？

冲突合并：SafeW 跨平台同步加密文件的手动解法

SafeW 的零知识 2FA 云端同步把私钥碎片拆散存放，却也带来“多端同时改同一文件”时的加密冲突。本文用运营者真实痛点视角，给出一条可复现、可回退、不泄露明文的手动合并路径。

1. 问题定义：为什么会冲突？

SafeW 把钱包配置、NFT 元数据、MPC 分片索引全部打包进 *.wlt 加密文件，文件名固定为 walletID_timestampsync.wlt。当两台设备在“同一秒”各自离线新增地址标签，云端会保留两份时间戳相近的密文，客户端弹窗“Conflict: Multiple encrypted versions detected”。此时若点“自动解决”，SafeW 默认“后上传覆盖先上传”，可能丢标签，也可能丢 MPC 分片引用。

2. 最短可达路径：四步手动合并

2.1 定位冲突文件

• iOS：Settings → Sync & Backup → Conflict Center，列表顶部红色角标即为冲突组。
• Android：侧滑菜单 → 工具 → 冲突管理器（v6.3.0 起更名为 Conflict Manager）。
• 桌面端（macOS/Win）：菜单栏 SafeW → Sync → View Conflicts。

选中冲突组后，点击“Export for Manual Merge”会生成三份文件到本地 Download/safew-mergetool/：

1. local.wlt —— 本机离线版本
2. remote.wlt —— 云端版本
3. base.wlt —— 共同祖先（上一次同步成功时的快照）

2.2 本地解密比对（不触网）

SafeW 内置“Offline Decrypt Tool”在设置→实验室→离线工具中，默认关闭，需手动启用。打开后拖入三份文件，输入钱包解锁密码，工具会在内存中解密成临时 JSON，30 分钟后自动擦除。

2.3 三方合并（三路 diff）

离线工具提供“三路合并”面板，左侧 local，右侧 remote，中间为结果。SafeW 用 JSON 数组存储地址标签，冲突行高亮黄色。操作顺序建议：

1. 先点“Auto-merge non-conflicted”一键合并无冲突字段；
2. 对黄色冲突行，逐条选“Use Left”或“Use Right”；
3. 若两边都需保留（例如各新增 3 个标签），点“Edit”手动拼接数组，确保无重复 ID。

2.4 回写签名并上传

合并完点“Save & Re-encrypt”，工具会调用本地私钥对合并后内容做 Ed25519 签名，生成 merged.wlt。回到冲突中心，选“Import Merged File”，上传后云端原子替换，旧版本移入 /history 目录，30 天自动清理。

3. 例外与副作用

3.1 MPC 分片索引冲突

若冲突文件内含 mpc_shards 字段，手动合并可能导致分片引用错位。经验性观察：当两边同时“新建恢复组”时，索引会重复。建议优先采用 remote 版本，然后在本机重新执行“Add Backup Share”补回缺失分片。

3.2 隐身模式地址簿冲突

隐身地址采用一次性密钥，冲突合并会暴露跳板路径。官方文档明确：隐身地址簿不参与三路合并，若检测到 stealth_meta 字段冲突，自动回退为“本地覆盖云端”。此时不建议手动干预，直接放弃 remote 即可。

3.3 合规报税模板冲突

税务模板文件（*.tax）若出现冲突，合并后需重新走“合规签名”流程，否则导出 CSV 会带“未校验”水印。验证方法：合并完成后进入“报税→导出”，若弹出“Re-sign required”，点“立即签名”即可，全程约数十秒。

4. 验证与回退方案

4.1 快速验证

上传 merged 文件后，在任意第二台设备执行“同步→立即拉取”，检查地址标签数量是否等于 local+remote 去重和。若数量不符，可立即在 Conflict Center 点“Revert to base”一键回到祖先版本，30 天内不限次数。

4.2 冷备份兜底

合并前，SafeW 会自动把 local.wlt 复制到 /Internal/safew.cold/local_backup_timestamp.wlt，并提示“冷备份已创建”。若合并后发现资产丢失，卸载 App 后重装，选“从冷备份恢复”即可回滚到冲突前状态。

5. 何时不该手动合并

• 团队共管钱包 ≥5 人同时在线修改，建议改用“企业策略中心”的“强制串行锁”功能，避免冲突产生。
• 正在进行 ICO 抢购或 NFT 白名单 Mint，手动合并需重启签名进程，可能错过窗口。此时优先用“覆盖本地”模式，事后再补标签。
• 设备剩余存储 <200 MB，解密过程会因临时缓存不足而失败，需先清理大文件。

6. 与第三方协同的最小权限原则

部分用户习惯把 *.wlt 丢进 GitHub 私有仓做版本管理。SafeW 官方明确：只要文件含 mpc_shards 或 stealth_meta，即使用 LFS 加密，也禁止上传至任何第三方。可复现验证：在设置打开“合规扫描”，上传前会弹“敏感字段检测”并阻断。

7. 故障排查速查表

现象	最可能原因	验证动作	处置
Export 按钮灰色	设备离线	看顶部状态栏是否显示「Offline」	切网后下拉刷新
Decrypt 报「wrong password」	base.wlt 用旧密码加密	试历史常用密码	放弃 base，仅合并 local+remote
上传 merged 后仍提示冲突	云端又被新设备写入	看冲突时间戳是否更新	重走一遍合并流程

8. 适用/不适用场景清单

适用：个人多设备、2–3 人小团队、标签/地址备注频繁变更、需保留历史签名。

不适用：大额 MPC 财库实时共管、隐身模式地址簿、存储空间告急、网络时延 >500 ms 的远程场景。

9. 最佳实践 5 条

1. 开启「设置→实验室→冲突提前通知」，SafeW 会在检测到时间差 <30 秒时弹窗提醒，降低冲突概率。
2. 给每台设备命名「办公-Mac」「手机-iOS」，在合并面板可一眼识别来源。
3. 每周手动导出一次「完整备份」到加密 U 盘，防止云端历史被误清。
4. 合并完立即用第二台设备拉取验证，确保资产视图一致再退出冲突中心。
5. 若团队 ≥3 人，改用「企业策略中心」的「串行锁」+「变更摘要」功能，彻底告别手动合并。

10. 版本差异与迁移建议

截至当前的最新版本（v6.3.0）起，冲突中心才支持「Export for Manual Merge」。若仍停留在 v6.2.9，只能看到「覆盖本地」「覆盖云端」二选一，建议先升级再操作。Android 14 闪退用户可清除缓存或回退到 6.2.9 等待 6.3.1 补丁。

11. FAQ（结构化数据）

收尾：下一步行动

SafeW 跨平台同步加密文件冲突时，手动合并是“最后 1 公里”技能：先定位、再离线解密、三路 diff、签名回写，四步走完即可兼顾安全与协作。建议你立即打开冲突中心，按本文路径试走一遍，并用第二台设备验证同步结果。确认无误后，把“串行锁”或“企业策略中心”提上日程，让冲突不再发生。