设计初衷：为何要提供“全量聊天记录导出”这一功能
凭借端到端加密技术，Letstalk IM 确保服务器端无明文数据，这使得本地备份成为了用户端唯一可靠的保存途径。自2026年2月发布的版本开始，官方将原本独立的"单聊导出"与"群聊导出"功能整合成了一键全部导出，同时增加了 AES-256 双重加密功能，以应对设备迁移、合规审计及存档留存这三大需求。文中首次提及“Letstalk聊天记录导出”，后续均简称为“导出”。
不同终端入口对比：移动端与桌面端的最优访问路径
适用于 Android 和 iOS 系统，版本需为 v6.4.2 或以上
- 请依次点击首页右上角的更多选项（⋮），进入设置，随后选择隐私与安全中的聊天记录管理，最后执行导出全部聊天记录的操作。
- 进入该界面后，你会看到“包含媒体文件”和“包含已销毁消息的残留索引”这两个选项，它们默认处于关闭状态。
- 当你点击‘生成加密包’后，程序将提示你进行输入操作。离线密码密码长度需至少为8位，且必须包含大写和小写字母。请放心，该密码绝不会上传至服务器。
- 待加载进度条走完，即可发现文件已存入
Letstalk/Backups/FullExport_[日期].ltd，借助系统自带的分享功能即可轻松保存或通过 AirDrop 传输。
建议：初次使用请先取消勾选“包含媒体”，这样能在1分钟内导出5万条纯文本记录，从而迅速测试整个流程是否运行正常。
适用于Windows和macOS系统的桌面版应用
- 请点击位于左上角菜单栏中的“File”选项，依次选择“Export”和“Full Chat History”。
- 弹窗提供了两种格式选项：JSON（采用明文结构，利于二次开发）和 LTD（加密数据包，支持与移动端数据互通）。
- 如果选择JSON格式，相关的媒体文件将会同步生成
assets若选择文件夹，则默认单文件打包模式，解密时须通过手机扫描验证码并输入密码。 - 当显示“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 剖析”功能，随后进行记录。 导出服务 统计进程的耗时；数据表明，媒体文件尺寸增加时，加密操作所占比例会下降，此时的性能瓶颈主要出现在磁盘读写上。
划定边界与处理例外：识别那些无法导出的数据
- 那些阅后即焚的资讯在时效届满之后已经物理擦除此时，导出的包中只会呈现“已销毁”的占位符。
- 当匿名群启用假名模式后，成员ID会被随机生成的令牌取代；即便后续导出数据，其中仍为令牌格式，无法追溯至真实的DID。
- 由于 AI 分身产生的临时会话缓存仅驻留在内存中而未进行持久化存储，因此不属于本讨论范围。
- 链上保险箱只存储文件的哈希值，原始二进制文件需要通过“L-Vault 导出”功能单独获取，不会直接出现在聊天记录中。
适用场景参考：判断何时进行完全数据导出是有必要的
| 场景 | 推荐格式 | 理由 |
|---|---|---|
| 记者更换设备时，必须对信源数据实施离线归档保护 | LTD 加密包 | 支持单文件加密持久化保存，有效抵御司法扣押。 |
| 针对上市公司的合规审查，必须采用明文方式进行数据检索。 | JSON文件与静态资源 | 利用 jq 工具进行关键词检索是完全可行的 |
| 群聊设定为毕业即销毁，只为在期末时留存一份记忆。 | JSON格式（不包含媒体文件） | 设备紧凑便携，便于进行光盘刻录操作 |
禁用情形：在什么情况下应避免使用全量导出功能
若单日消息突破万条（例如大型NFT公告群），加之使用三年前发布的中端芯片设备，导出操作可能会因设备发热触发温控降频，进而造成前台收发消息出现卡顿。此时推荐采用“单群导出”功能，将数据分批次进行处理。
手机剩余空间 小于两倍聊天数据量 在此期间，若加密包无法生成，系统不会给出具体报错，只会笼统地提示“未知错误”。根据实际经验判断，确保存储空间翻倍是必要的硬性条件，这是因为临时缓存文件必须进行写入操作。 /cache/export_tmp。
针对故障排除：绝大多数（90%）的问题只需执行以下三个步骤即可迎刃而解。
- 现象现象：进度条停滞在 99% 时应用突然崩溃退出。 原因当电量过低时，系统会自动终止后台应用。 处置：当电量高于30%时再次登录，无需从头开始，可支持断点续算。
- 现象提示：桌面客户端不支持解密LTD格式的数据包。→ 原因原因：桌面端的旧版渲染引擎尚未进行更新。→ 验证进入设置界面，依次选择“关于”选项，确保引擎版本号不低于 6.4.x。 处置：升级后重试。
- 现象导出版本按钮呈现灰色状态，导致无法点击。→ 原因系统正在执行自动备份操作。→ 验证随后，通知栏中将显示“加密云备份正在进行”的提示。→ 处置您可以选择等待备份自动结束，或者手动将其暂停。
第三方协作指南：利用脚本实现 JSON 解析
Letstalk 的 JSON 数据格式遵循开放 Schema 规范，其结构以顶层节点为基础。 chats[] → 每条消息含 包括消息ID (msgId)、发送者 (from)、时间戳 (timestamp)、消息类型 (type) 以及数据载荷 (payload)。。媒体文件以 file://assets/SHA256.ext 相对路径引用。
基于实际测试经验发现：在配备 M1 芯片的 Mac 设备上，使用 jq 工具解析 30 MB 大小的 JSON 文件耗时约为 1.8 秒；如果事先将该文件进行压缩处理， .jsonl，从而进一步减少 30%。
十项最佳实践快速查阅指南
- 建议每月初设置日历提醒，用于执行“导出”和“校验”操作，从而落实 321 备份原则，即保留 3 份数据副本、使用 2 种不同存储介质，并确保持有 1 份离线备份。
- 加密文件密码需至少包含12个字符且含有特殊符号，切记不要与登录 Letstalk 的密码相同。
- 在导出操作之前，清除超过30天的缓存视频能够将总耗时减少40%。
- 在桌面端进行审计时，如果只需要关注文本内容，取消勾选“包含媒体”选项，生成效率将提高五倍。
- 为满足公司合规中关于“可读性”与“防篡改”的双重标准，请务必同时存档JSON和LTD格式的文件。
- 适用于匿名群聊数据导出后、尚未在内部流转之前的场景
sed通过对随机令牌进行批量替换，有效阻断其被反向追踪溯源的路径。 - 若 Vision Pro 2 的空间通知数量过多，建议先关闭“3D 悬停”功能再进行导出操作，以防止因 GPU 资源竞争而造成导出速度缓慢。
- 常规导出功能不包含链上保险箱内的文件。如果希望将它们一起打包归档，请前往 L-Vault 模块，依次选择导出及合并存储功能。
- 如果在数据导出期间收到电话，iOS 系统会停止 IO 操作；因此推荐开启飞行模式并连接 Wi-Fi。
- 文件处理完毕后，立即执行 SHA-256 校验并将结果记录至 txt 文件中，确保十年后依然可以核对文件的完整性。
不同版本间的区别及迁移指南
对比 6.3 版本，当前最新版本（即 6.4.2）的旧格式 JSON 数据中缺失了 编辑时间 字段。如果需要进行跨版本的数据差异对比，请务必先将系统统一升级至 6.4.x 版本再进行导出操作，否则可能会遇到字段丢失的问题。
常见问题解答：用户最关心的五个问题
文件导出之后，是否还支持双向撤销操作？
没问题。因为导出功能仅生成本地缓存，不会干扰服务器或对方的状态；即便你在原对话中执行撤回操作，已导出的文件内容也保持不变。
加密后的数据包是否支持在其他移动设备上打开和解密？
没问题。您只需在新设备上安装 Lettalk，打开 LTD 文件并输入离线密码即可完成设置。该软件兼容 Android、iOS 以及桌面平台。
如果导出的文件体积过大导致无法发送，有什么解决办法？
建议切换至“分群导出”模式，或在电脑客户端勾选“不包含媒体”选项，以便优先导出纯文本内容，随后再通过 L-Vault 单独传输大型文件。
JSON 数据中的中文字符为何采用 Unicode 编码形式呈现？
为确保跨平台兼容性，官方强制要求使用 UTF-8 编码，目前支持此功能。 jq -r 直接转换为易于理解的中文内容，不必进行其他编码操作。
执行导出操作是否会占用额外的网络流量？
不会。全程本地计算，仅在你选择“转存到 iCloud/谷歌盘”时才会走上传流量。
总结：后续待办事项汇总
阅读完毕后，请执行以下三项操作：首先，立即确认 Lettalk 是否已升级至版本 6.4.2；其次，执行一次不包含媒体文件的导出测试，借此熟悉流程并记录所需时间；最后，针对加密包进行离线密码恢复演练，以保证十年后依然能够成功解密。只要完成这三步，你就掌握了具备审计、迁移及灾难恢复能力的完整聊天记录资产。
若后续更新支持增量导出或云端密钥托管，官方极有可能继续坚持本地优先原则；到那时，仅需在“隐私与安全”设置中启用新选项，现有脚本及备份机制即可无缝衔接，不必重新配置。
