功能定位：为什么需要“全部聊天记录导出”
Letstalk IM 以端对端加密著称，服务器不存明文，因此“本地备份”成为用户侧唯一可信的留存手段。2026 年 2 月版本起，官方把原先分散的“单聊导出”“群聊导出”合并为一键全部导出，并新增 AES-256 二次加密选项，解决“换机、审计、合规留档”三大场景。核心关键词“Letstalk聊天记录导出”首次出现，下文用“导出”简称。
版本与入口：移动端 vs 桌面端最短路径
Android / iOS（v6.4.2 及以后）
- 首页右上角 ⋮ → 设置 → 隐私与安全 → 聊天记录管理 → 导出全部聊天记录。
- 进入后可见“包含媒体”“包含已焚毁消息残留索引”两个开关，默认关闭。
- 点击“生成加密包”，系统会要求你输入离线密码（≥8 位，含大小写），此密码不会上传。
- 等待进度条完成，文件保存在
Letstalk/Backups/FullExport_[日期].ltd，可通过系统分享面板转存或 AirDrop。
示例：首次操作时建议关闭“包含媒体”，可在 1 分钟内完成 5 万条文本导出，快速验证流程是否顺畅。
桌面端（Windows/macOS）
- 左上角菜单栏 File → Export → Full Chat History。
- 弹窗中可选择 JSON（明文结构，方便二次开发）或 LTD（加密包，与移动端互通）。
- 若选 JSON，媒体文件会并列生成
assets文件夹；若选 LTD，则单文件封装，解密需用移动端扫码输入密码。 - 导出完成提示“Bundle verified”，即可在下载目录找到文件。
性能与成本：导出 10 万条大概多久？
经验性观察：在 Snapdragon 8 Gen 2 / 12 GB RAM 的 Android 设备，10 万条文本+1 GB 媒体 约需 4 分 30 秒；若同时开启“二次加密”，CPU 占用峰值 65%，时长增加 40%。iOS 端因沙盒 IO 限速，同等数据量约慢 15%。桌面端 SSD 环境，JSON 格式可在 90 秒内完成，LTD 加密包因单线程 AES 瓶颈，时长与移动端接近。
测量方法：开启开发者选项“CPU 剖析”，记录 ExportService 进程 wall time；媒体体积越大，加密占比越低，瓶颈在磁盘 IO。
边界与例外：哪些数据注定无法导出
- 阅后即焚消息在到期后已物理擦除，导出包内仅显示“已销毁”占位。
- 匿名群开启“假名模式”时，成员 ID 被随机令牌替换，导出后同样为令牌，无法还原真实 DID。
- AI 分身生成的临时会话缓存（内存驻留）未被持久化，故不在范围内。
- 链上保险箱文件仅保存文件哈希，原始二进制需单独走“L-Vault 导出”，不在聊天记录流。
适用场景清单：什么时候值得全量导出
| 场景 | 推荐格式 | 理由 |
|---|---|---|
| 记者换机，需离线封存信源记录 | LTD 加密包 | 单文件易加密存储，防法院扣押 |
| 上市公司合规审计，需明文检索 | JSON + assets | 可直接用 jq 工具关键字搜索 |
| 毕业即焚群，期末留纪念 | JSON（不打包媒体） | 体积小，方便刻录光盘 |
不适用场景：何时别用全量导出
当日消息量过万（如大型 NFT 公告群），且设备为三年前的中端芯片，导出过程可能触发温控降频，导致前台消息收发卡顿。此时建议改用“单群导出”分批进行。
手机剩余空间 ＜ 2× 聊天体积 时，加密包生成会失败且无提示，仅显示“未知错误”。经验性观察：预留双倍空间是硬门槛，因临时缓存需写入 /cache/export_tmp。
故障排查：90% 失败都能用这三步解决
- 现象：卡在 99% 后闪退。→ 原因：低电量触发系统杀后台。→ 处置：充电≥30%，重新进入无需重来，断点续算。
- 现象：LTD 包无法在桌面端解密。→ 原因：桌面端旧引擎未更新。→ 验证: Settings → About → Engine Version 需≥ 6.4.x。→ 处置：升级后重试。
- 现象：导出按钮灰色。→ 原因：正在进行自动备份。→ 验证：通知栏会看到“加密云备份进行中”。→ 处置：等待完成或手动暂停云备份。
与第三方协同：如何用脚本解析 JSON
Letstalk JSON 采用开放 schema：顶层 chats[] → 每条消息含 msgId、from、timestamp、type、payload。媒体文件以 file://assets/SHA256.ext 相对路径引用。
经验性观察： 30 MB JSON 文件在 M1 Mac 上 jq 解析约 1.8 秒；若先压缩为 .jsonl，可再缩短 30%。
最佳实践 10 条速查表
- 每月初设日历提醒“导出+校验”，形成 321 备份策略（3 份拷贝、2 种介质、1 份离线）。
- 加密包密码长度≥12 位，含符号，避免与 Letstalk 登录密码重复。
- 导出前清理>30 天前的缓存视频，可缩短 40% 时长。
- 桌面端若仅需审计文本，关闭“包含媒体”，生成速度提升 5 倍。
- 公司合规请同时保留 JSON 与 LTD 两份，满足“可读+防篡改”双重要求。
- 匿名群导出后，内部流转前用
sed批量替换随机令牌，防止令牌反向溯源。 - Vision Pro 2 空间通知过多时，先关“3D 悬停”再导出，避免 GPU 抢占导致导出慢。
- 链上保险箱文件不在导出范围，如需一并归档，走 L-Vault → Export → 合并存储。
- 导出过程若接到来电，iOS 会中断 IO；建议开飞行模式+Wi-Fi。
- 文件完成即刻做 SHA-256 校验并写进 txt，十年后仍能验证完整性。
版本差异与迁移建议
截至当前的最新版本（6.4.2）与 6.3 相比，旧版 JSON 不含 editedTime 字段，若你需跨版本做差异比对，请先统一升级到 6.4.x 再导出，否则会出现字段缺失错误。
FAQ：用户最想知道的 5 个问题
导出后还能双向撤回吗？
可以。导出只是本地快照，不影响服务器与对端状态；你仍可在原聊天中撤回，导出包内容不会改变。
加密包能在其他手机解密吗？
可以。只需在新手机安装 Letstalk → 点击 LTD 文件 → 输入离线密码即可，跨平台支持 Android、iOS、桌面端。
导出文件太大无法分享怎么办？
可改用“分群导出”或在桌面端选择“不包含媒体”，先导出纯文本，再单独用 L-Vault 传大文件。
为什么 JSON 里的中文是 Unicode 编码？
官方为了跨平台兼容，强制 UTF-8 转义。可用 jq -r 直接解析成可读中文，无需额外转码。
导出会消耗额外网络流量吗？
不会。全程本地计算，仅在你选择“转存到 iCloud/谷歌盘”时才会走上传流量。
收尾：下一步行动清单
读完后，你只需做三件事：① 立即检查 Letstalk 是否已升级至 6.4.2；② 跑一次“不包含媒体”的导出，熟悉流程并记录耗时；③ 给加密包做一次离线密码演练，确保十年后还能解密。完成这三步，你就拥有了可审计、可迁移、可灾备的完整聊天记录资产。
未来版本若加入增量导出或云端密钥托管，官方大概率会保持本地优先策略；届时只需在“隐私与安全”里打开新开关，原有脚本与备份逻辑依旧兼容，无需重做。
