功能定位：为什么官方只给“聊天归档”而不直接给“一键PDF”
在 Letstalk IM 的加密架构里，所有单聊默认走 Signal 双棘轮，本地数据库额外再上 AES-256-CTR 层。官方出于“可验证前向保密”承诺，客户端仅提供“聊天归档（Export Chat）”原始 JSON，而不内置 PDF 渲染器——避免在本地留下二次明文缓存。换句话说，导出 PDF 是“官方给数据 + 用户侧转格式”的协作模型，不是隐藏开关。理解这条边界后，就能明白为何流程里会出现“��三方转码”这一步，以及为何 iOS 与 Android 的入口文字略有差异。
先决条件检查：版本、存储与合规
- 客户端 ≥ v7.4（截至当前的最新版本已全平台覆盖）。
- 手机剩余空间 ≥ 聊天体积 ×2（JSON 中间文件 + 最终 PDF）。
- 若聊天含自毁消息，需确认倒计时已结束；否则导出时会被主动跳过，导致缺字。
- 跨境团队如需归档合规，请提前征得对端“可导出同意”，Letstalk 本地校验不会替你判断 GDPR/PIPL 是否适用。
以上四项缺一不可，建议在 Wi-Fi 环境下先跑一次“假导出”测试，确认空间与权限无误后再正式生成文件，避免卡在 99% 再回头清理缓存。
决策树：三种主流路线对比
| 路线 | 依赖 | 优点 | 缺点 |
|---|---|---|---|
| A. 手机端纯离线 | 系统打印引擎 | 无云端、无额外 App | 大群聊易 OOM；图片分辨率被压 |
| B. 桌面端原生导出 | Letstalk 桌面版 | 直接输出 PDF，保留emoji 颜色 | Windows 版需手动勾选“包含媒体” |
| C. 第三方 JSON→PDF | 开源脚本 / 网页工具 | 可批量、可自定义页眉页脚 | 需上传明文，存在合规风险 |
经验性观察：100 MB 以上超媒聊天，路线 B 的崩溃率明显低于 A；若你对图片像素无要求，路线 A 在 iOS 17 上可在数十秒内完成。
路线 A：iOS／Android 纯离线打印法
操作步骤
- 进入单聊 → 右上角“⋯”More → 导出聊天 → 选“附加媒体文件”或“仅文字”。
- 在分享面板长按“保存到文件”，选择本地任意目录，生成
.zip（内含 JSON + 媒体）。 - 解压后，对 JSON 执行“快速查看”→ 右上角分享 → 打印 → 双指缩放预览 → 右上角继续分享 → 存储为 PDF。
边界与回退
若系统提示“文件过大无法渲染”，可回到第 1 步改选“仅文字”，或把 JSON 拆分为多段后再合并 PDF。Android 13 以下缺少原生打印渲染器，需手动安装“Microsoft Print PDF”插件，否则导出按钮呈灰色。
路线 B：桌面端（Windows / macOS）直接导出 PDF
操作步骤
- 登录 Letstalk 桌面版 → 左侧栏找到单聊 → 顶部菜单 文件 → 导出聊天记录。
- 在弹出窗口勾选“包含媒体缩略图”→ 格式下拉选“PDF”→ 设定保存路径。
- 点击“导出”后，客户端会先生成临时 HTML 再调用系统 Chromium 内核打印，耗时与消息量成正比；经验性观察：1 万条约 3 分钟。
失败分支
若导出进度条卡在 99%，99% 是因为磁盘剩余空间不足渲染缓存；清理系统盘或把保存路径改到 D 盘即可。macOS 版在 14.x 曾出现“空白页”Bug，回退到 7.4.1 旧版可解，官方已在 7.4.2 修复。
路线 C：第三方 JSON→PDF 转码（适合批量）
可复现工具链
- Node 脚本：
lets-talk-export-parser（MIT 协议，GitHub 可检索）。 - Web 工具：搜索“Letstalk JSON to PDF”，选择可浏览器本地完成的页面（SSL 证书有效、开源仓库可查）。
最小权限原则
上传前，把 JSON 里 "walletAddress"、"location" 等敏感字段手动置空；转码完立即删除服务端副本，并校验返回 PDF 的 SHA-256 与本地一致。对合规要求高的企业，建议用离线脚本，全程断网。
例外与副作用：什么时候不该导出
- 对端启用“禁止转发”+“自毁消息”时，导出按钮会被灰掉，这是服务端强制策略，无法破解。
- 频道式付费内容若含 NFT 门禁，导出后 PDF 里的媒体文件默认打水印“Archival Copy”，二次传播可能触发平台版权申诉。
- 后量子加密（KYBER）开启后，导出速度会慢约 1 倍；若仅做临时备份，可先关闭开关再导出，完事再打开。
验证与观测：如何确认 PDF 完整性
- 用 Adobe Acrobat 的“文件属性”→“字体”页查看是否缺字；若出现“仿宋_embedded”即正常。
- 随机抽 5 张缩略图，与原图做感知哈希（pHash）对比，差距 < 5 可认为未被压缩掉关键信息。
- 回导测试：把 PDF 上传到开源工具
pdf2json，检查消息条数与原始 JSON 是否一致。
适用／不适用场景清单
| 场景 | 是否推荐 | 原因 |
|---|---|---|
| 情侣备份纪念日对话 | ✅ | 数据量小，情感价值高 |
| 2000 人技术群全量归档 | ❌ | 文件超 2 GB，手机易 OOM |
| 律师取证（含语音） | ⚠️ | 需公证处见证哈希，建议路线 B + 时间戳证书 |
| OTC 纠纷举证 | ✅ | PDF 只读，防篡改 |
最佳实践 6 条（检查表）
- 导出前先“在聊天内搜索”关键词，确认无敏感个人数据外泄。
- >500 MB 聊天优先用桌面端，避免手机后台被系统杀进程。
- 打开 PDF 后用密码加密（Acrobat 256-bit AES），再上传云端。
- 定期清理 Letstalk 设置→存储→临时导出缓存，防止重复占用。
- 若需长期保存，把 PDF 与对应 SHA-256 文本放同一目录，方便未来哈希校验。
- 对端若删除消息，本地导出不会同步删除，复核时以时间戳为准，避免证据链错位。
常见疑问（FAQ Schema）
导出 PDF 会连带语音吗？
桌面端若勾选“包含媒体”，语音会生成 32 kbps Opus 文件并嵌入 PDF 附件；手机端打印法仅保留文字转写，不含音频流。
对方会收到“已导出”提示吗？
不会。导出属于本地操作，服务端只做密钥解密，无广播事件。
PDF 里的时间戳用哪个时区？
默认 UTC+0，可在桌面端导出窗口手动切换为本地时区；手机端打印法无法调整。
如何一次性合并多段导出？
使用 PDFsam 等开源合并工具，按“文件创建时间”排序，合并后重新计算一次哈希即可。
收尾：下一步行动
Letstalk 的“单聊记录导出成 PDF”并非单按钮功能，而是一条“数据释放 + 本地转码”的协作链。先根据数据量级、合规要求选好路线，再按对应入口操作，并在导出后做完整性校验，就能在不影响前向保密的前提下，把重要对话锁进只读文件。现在就打开桌面端，挑一个工作量适中的单聊走一遍路线 B，亲手验证耗时与文件体积，下次真正需要举证或备份时，你会感谢自己提前跑通的这份“导出 SOP”。