产品定位与迭代历程
2026 年 3 月 31 日发布的 Letstalk IM v7.4.2「Project Iris」版本中，引入了「按日期范围导出聊天记录」的新特性，标志着该功能首次从企业后台迁移至客户端本地执行。在此之前，用户仅能导出体积庞大的全量数据，通常高达数 GB；如今，支持将导出粒度精确至“天”级别，从而更好地平衡合规审计与个人备份的需求。
此特性继续坚持“本地运算、本地加密、本地封装”的核心逻辑：服务器仅充当密文传输的中转站，既不存储导出任务数据，也不保留相关操作日志。这意味着，执行导出操作并不会引起云端的警报反应，然而导出的 .ltd 文件依然采用了 AES-256 级别的二次加密保护，必须依赖原账号的私钥方可实现离线解密。
入口与最短路径
移动客户端（支持 Android 和 iOS 系统）
- 进入指定的单聊或群聊界面，随后点击屏幕顶部的标题栏以访问「聊天详情」。
- 向下滚动找到「数据管理」板块，然后点击「导出聊天记录」。
- 进入「时间范围」页面后，系统预设了「最近 7 天」的快速选择项；若需自行设定，请点击「自定义范围」，通过滚轮调整起始与结束日期，最后点击确认即可。
- 按需决定是否携带多媒体资源（默认为否，有助于节约容量）
- 当系统反馈“导出任务已加入队列”时，回到主界面即可在屏幕顶部看到相应的进度条。
- 处理结束时，系统会唤起分享菜单，支持将结果保存至本地路径、通过隔空投送发送或上传至加密云端存储。
桌面版本（适用于Windows或macOS系统）
- 在左侧聊天列表中找到目标会话，点击鼠标右键，依次选择「更多」和「导出聊天记录」
- 弹窗内先勾选「按日期筛选」，日历控件支持连续/跳跃多选
- 请选取导出文件格式：.ltd（加密版）或 .html（明文版，需二次验证密码）
- 启动导出功能后，客户端状态栏会出现绿色进度指示；该操作支持在后台静默进行，不会干扰其他聊天会话的使用。
- 任务结束后，系统将自动启动文件管理器并直接跳转至生成文件的文件夹。
导出格式与兼容性
当前支持 .ltd 和 .html 两种文件格式。.ltd 是 Lettalk 的私有加密格式，内部集成了 Double-Ratchet 密钥链，必须使用原账号并通过 Lettalk 客户端进行“导入”才能查看。而 .html 格式则是经过脱敏处理的明文副本，可直接通过离线浏览器打开，但会强制添加包含导出者 ID 和时间戳的水印，以遏制匿名传播。
根据实际测试经验，在拥有 2 万在线成员的频道型群聊中，导出为期 30 天（约 18 万条）且不含媒体的文本数据，生成的 .ltd 文件大小约为 620 MB，桌面端处理时间大约为 8 分钟；如果同时包含原图，文件大小将激增至 4.3 GB，所需时间也会加倍。由于不同设备的性能差异，这些数据仅能作为容量预估的参考依据。
针对流程中断时的备用路径及应急恢复策略
- 若出现“存储空间不足”的提示：这是因为客户端在启动前会预估所需容量，当剩余可用空间不足预估值的 1.5 倍时，程序将阻止启动。建议清理部分缓存，或将导出范围调整为仅一周数据，分阶段执行。
- 导出按钮呈灰色状态：由于该聊天启用了「限时圈子」功能且完成了全员消息销毁，本地已无有效聊天记录。此时仅能导出包含「系统提示」的结构框架，并无实际文本内容可供提取。
- 当导出进度停滞在 99% 时，通常是因为媒体文件的索引已损坏。此时建议取消当前操作，重新发起导出请求，并在设置中取消勾选「包含媒体」选项，以此绕过存在问题的文件。
例外情形与取舍考量：梳理那些无法导出的内容
1. 已「双向撤回」且完成 RAM 覆写的消息，导出包内仅留「消息已撤回」占位，原文无法恢复。
2. 语音通话与加密会议录音默认排除，需在「设置 → 隐私 → 通话数据」手动开启「允许本地存档」后方可导出。
3. 红包、NFT 卡片等链上交互仅导出文本指令，不携带私钥或资产。
4. AI 贴纸生成器的本地 SD-3.5 模型缓存不随消息导出，仅保留文字描述与缩略图。
配合第三方归档机器人共同工作
虽然官方没有开放通过 Bot API 直接获取历史消息的功能，但用户可以将 .html 片段借助「自托管解密器」转换为通用 JSON 格式。具体操作步骤为：先在桌面端导出文件，接着选取 .html 格式文件，最后使用开源工具进行处理。 lt-html2json（经 GitHub 验证）先在本地完成转换，随后将数据导入 Elasticsearch 以支持全文检索。此流程全程无需公开私钥，不过转换后的文件已去除敏感信息，请务必遵循当地的合规规定。
适用场景清单
| 场景 | 建议导出范围 | 格式 | 备注 |
|---|---|---|---|
| 金融合规留痕 | 最近 90 天 | .ltd + .html 双份 | HTML 文件适用于审计查阅，而 LTD 文件则负责原始哈希值的验证。 |
| 离职交接 | 项目起止日期 | .ltd | 完成账号交接导入后即可恢复检索功能，不再依赖原设备 |
| 记者存证 | 关键 7 天 | .html | 通过添加水印来防止篡改，并可将哈希值一同提交以供仲裁。 |
不适用场景
- 万级频道实时直播：消息流速超过 1 万条/分钟时，客户端会临时禁用导出入口，防止阻塞。
- 「限时圈子」已彻底销毁：正如前面提到的那样，本地没有任何残留文件，自然也就没有数据可以导出。
- 实测发现，在使用量子隧道模式的卫星网络进行通信时，一旦丢包比例超过15%，任务导出操作就容易失败。遇到这种情况，推荐切换至5G或Wi-Fi网络连接。
故障排查速查表
问题表现：界面上找不到导出按钮。
常见原因：频道管理员可能禁用了「允许成员导出」的功能。解决方法是联系管理员，进入「频道管理」选项下的「权限」设置，在「普通成员」一栏中恢复该权限。
问题表现：.ltd格式的文件不能导入到其他设备中。
验证步骤：确认两台设备是否使用了相同的 UID 登录。需要注意的是，如果该账号曾经进行过“链上身份迁移”操作，那么在转存前必须先使用旧的私钥进行解密。
问题表现：HTML 文件中的中文内容显示为乱码
处理方法：使用 VS Code 打开文件，将右下角的编码格式调整为 UTF-8 with BOM，然后重新保存即可。
最佳实践 6 条
- 建议先选取1天的数据进行格式验证，确认无误后再扩展至整个月进行批量导入，以此防止无谓的时间浪费。
- 关键数据采用双格式存档：.ltd 确保数据完整，.html 便于迅速查找。
- 通过禁用媒体批量导出功能，可以将处理时间减少70%，之后可借助「原图随取」功能来补充所需内容。
- 建议定期清理无效的缓存数据：依次点击设置、存储及导出缓存选项，当缓存体积突破 2 GB 时，可使用一键清空功能进行清理。
- 导出操作完成后，请即刻计算 SHA-256 值并记录在 readme 文件中，以便日后查验文件是否被篡改。
- 为满足企业合规要求，建议配置系统于每月 1 日自动导出上月的数据，并通过 CI 脚本将其上传至私有 S3 存储，以此降低因人为操作导致遗漏的风险。
常见问题解答（基于 Schema 标记格式）
在导出文件的时候，是否可以只提取文字内容，而排除表情包？
可行的。只要在导出设置界面中取消勾选「包含图片与媒体」选项，系统就会自动忽略贴纸和表情包，最终导出的内容将仅包含文字信息。
如果日期选错了，重新导出不覆盖原文件会不会导致磁盘空间重复占用？
导入同名包时，Letstalk 不会进行合并，而是直接创建新文件；你可以手动清理旧包，客户端对此不额外收费也不限制操作次数。
导出的数据包里会不会带有已被移除成员的昵称？
.ltd 保留当时本地缓存的昵称与头像哈希；.html 只显示「已退出用户」占位，防止隐私泄露。
收尾与下一步
到这里，你已经掌握了 Letstalk 基于时间段导出聊天记录的全流程、限制条件及常见误区。建议马上找个不重要的群组测试导出 3 天的数据来确认格式；一切正常后，再将企业的合规数据留存期延长至 90 天，并结合哈希值校验确保数据完整性。如果未来版本更新导致操作入口发生变化，可以返回「设置 → 帮助 → 导出日志」以获取最新的官方指导。
