功能定位：为什么必须“扫码”才能把电脑记录搬到手机
Letstalk 的端侧密钥架构决定——每台设备独立生成 AES-256 密钥，服务器只转发加密信封，无法代管明文。因此“聊天记录同步”本质是把电脑端的本地加密库，通过一次性的 QR 密钥交换隧道，完整迁移到手机端，而非传统意义上的“云合并”。理解这一点，就能明白为什么流程里必须出现扫码动作：它用摄像头在离线通道完成 ECDH 握手，避免任何预共享密钥在网路中传输。
前置检查清单：版本、网络与存储
- 电脑端与手机端均需v6.4.2 或更新（截至当前的最新版本）。旧版无“迁移模式”入口，会强制提示升级。
- 两端需处于同一局域网或电脑开启“允许局域网探测”开关；若公司网络隔离，可临时用手机热点。
- 手机剩余空间 ≥ 电脑端聊天记录大小的 1.5 倍（迁移过程会生成临时校验副本）。
提示：在电脑端「设置-存储管理」可一键计算「聊天+附件」总量；若发现附件占比过高，可先执行「清理缓存」再迁移，节省约 30% 时间（经验性观察）。
操作路径：Windows / macOS → iOS / Android
Step 1 电脑端发起迁移
顶部菜单「Tools → Transfer Chat History → 生成迁移二维码」。此时电脑会暂停写入新消息，防止迁移过程出现增量缺口；同时在本地随机生成 32 byte 的 Migration Key，并通过 QR 码可视化。
Step 2 手机端扫码接入
手机打开「我 → 设置-聊天-迁移与备份 → 从电脑导入 → 扫描二维码」。摄像头识别后，手机会用自身 DID 私钥与二维码里的公钥做 ECDH，协商出一次性 Tunnel Key，随后向电脑回传加密 Hello。整个握手在本地广播层完成，不经过服务器。
Step 3 选择会话范围并等待校验
默认勾选「全部私聊+最近 30 天群聊」；若群数量>200，可手动取消不相关群组。确认后电脑端开始分卷打包（每卷 256 MB），边打包边通过 TLS-T 混淆隧道推送至手机。完成后两端各做一次 Blake3 哈希比对，不一致会自动重传差异卷。
平台差异与回退方案
| 平台组合 | 是否支持断点续传 | 失败回退 |
|---|---|---|
| Windows → iOS | ✔ 支持 | 自动回滚至迁移前快照，重启 App 即可 |
| macOS → Android | ✔ 支持 | 同上 |
| Windows → HarmonyOS | ✘ 暂不支持（截至当前的最新版本） | 提示“系统接口差异”，需手动导出加密备份到 U 盘再导入 |
常见失败原因与排查
- 二维码刷新过快：电脑生成后 90 秒未扫即失效，需重新点击“生成”。
- 局域网广播被隔离：部分公司 Guest Wi-Fi 禁止 UDP 5353，可切换至手机热点再试。
- 剩余空间虚高：Android 11 以上「存储统计」含「垃圾块」，实际可用可能低于显示值；建议预留 2 倍冗余。
- 文件名超长导致写入失败：Windows 端 NTFS 允许 32 k 路径，而 iOS 端 APFS 只支持 4 k，迁移日志若出现「PathTooLong」提示，需先在电脑端对超长文件名群聊执行「重命名缩短」。
适用场景与性能预期
以 5 GB 聊天记录（含 1.2 GB 附件）为例，在 Wi-Fi 6 局域网内耗时约 8–12 分钟，峰值速度 90 MB/s；若改用 5 GHz 手机热点，速度降至 40 MB/s，总时长约 20 分钟（经验性观察）。
适合：
① 更换主力手机，需完整保留历史证据链的记者；
② 项目结束后把电脑端资料归档到个人手机，再执行电脑端“本地销毁”。
① 群数量>1000 的超大型社群，迁移 UI 在加载群列表时可能出现明显卡顿；
② 需要“增量实时同步”——Letstalk 暂无合并模式，每次迁移均为全量覆盖。
最佳实践 6 条
- 迁移前先在电脑端「设置-实验室-生成校验报告」，导出 CSV 留档，方便事后审计。
- 若含敏感文件，勾选「迁移后电脑端自动清理」，可节省手动擦除步骤。
- 迁移完成 24 小时内，在手机端「设置-隐私-安全自检」运行一次「重复文件扫描」，可合并相同 SHA-256 的群文件，节省约 15% 空间。
- 对同一手机重复做“二次迁移”会完全覆盖前次数据，务必提前用 L-Vault 做一次加密备份。
- 公司电脑若已启用 DLP 管控，请先退出加密代理软件，防止代理改写 TLS 证书导致校验失败。
- 迁移后若发现个别群“消息断档”，多为超长文件名导致，可在「设置-存储-异常日志」检索「SkippedFiles」列表，手动补传即可。
FAQ（结构化数据）
扫码迁移是否消耗 Stars？
不消耗。迁移流量走本地隧道，不经过官方中继，故无需支付 Stars 或流量代币。
迁移后电脑端还能看记录吗？
若未勾选「自动清理」，原记录仍保留；一旦勾选，电脑端会在校验完成后执行 NIST-800.88 级擦除，不可恢复。
可以只迁移部分会话吗？
可以。在「选择会话」页取消勾选不需要的群或联系人即可，但私聊默认全选且不可拆单条。
iOS 切换到 Android 后，之前的 iOS 记录会怎样？
Letstalk 的多设备密钥独立，iOS 端记录不受影响；若不再需要，可在 iOS 端「设置-隐私-销毁本机数据」单独清除。
迁移过程能否接听语音通话？
电脑端会暂停写入，但通话模块独立，可正常接听；手机端因摄像头被扫码占用，建议改用蓝牙耳机接听，避免中断隧道。
收尾：什么时候该用、什么时候该停
扫码同步是 Letstalk 在“零信任”架构下给出的一次性全量搬家方案，优势是不泄露给云端、不依赖手机号，代价是无法增量合并、群多易卡顿。若你正在做设备换代或项目结案，这种“搬完即焚”的流程能提供最高级别的本地擦除确定性；但若日常想在手机与电脑间“无缝接力”，官方目前尚未支持，仍需借助加密云保险箱手动导出。
下一步行动：打开 Letstalk 电脑端，按本文路径先生成校验报告，评估数据量后再决定是否迁移；若群文件过大，可先清理冗余，再用夜间宽带执行迁移，全程保持扫码页常亮即可。
