功能定位：为什么需要“关键词批量搜索+导出”
在 Letstalk IM 里，消息默认端侧加密，服务器不保存明文，“搜完即导出”是唯一能把历史对话快速转成可审计文件的办法。对项目方、律师、电商客服来说，把“USDT 地址”“退款”“授权”等关键词一次性捞成 CSV，比逐条转发省时两个数量级，也降低手动遗漏带来的合规风险。
经验性观察：当群成员 >5 000、日消息 >1 万条时，客户端本地索引体积会在两周内膨胀到 700 MB，首次关键词检索耗时约 8–12 秒；导出 1 万条结果（含图片缩略图）平均生成 240 MB ZIP，耗时 90 秒，CPU 占用峰值 45 %（M2 MacBook Air 基准）。
示例：某电商售后群在 618 大促期间单日消息 2.3 万条，运营人员用“仅退款”关键词命中 1 847 条，15 分钟完成批量导出，相比人工截图节省 6 小时，且 CSV 可直接对接 BI 工具做退款原因聚类。
版本与权限前提
1. 客户端 ≥v6.7.5 才内置“批量导出”按钮；v6.8.0 起支持 AI 助手 3.0 侧栏直接生成关键词报告，但导出仍需手动确认。
2. 免费版单次最多导出 3 个月内的记录；企业私有化版可在后台关闭时间限制，但需管理员在“合规存档”里把“允许用户侧导出”开关打开。
经验性观察：若企业版同时开启“水印追溯”与“只读密钥”，导出文件会附带隐形 ID，方便外泄后追踪，但会额外增加 3 %–5 % 的体积。
跨平台最短操作路径
Android / iOS
- 打开目标单聊或群聊→点击顶部标题栏进入“聊天信息”。
- 选择“查找”→输入关键词→点击右下角“批量选择”图标（v6.8.0 为双勾符号）。
- 在结果页点“全选”或手动勾选→底部出现“导出”按钮→选“TXT+JSON”或“CSV+媒体缩略图”。
- 系统弹出“保存到下载”或“发送给好友”；若文件 >500 MB，会强制分卷成 500 MB/包。
提示：iOS 若开启“优化存储”，导出前需确保本地已完整下载原图，否则缩略图栏会显示“媒体缺失”占位，需回到对应消息手动重新下载。
Windows / macOS
- 左侧会话列表右键目标聊天→“搜索历史消息”。
- 在侧栏输入框键关键词→回车→点击右上角“批量导出”(Export)。
- 弹窗里可选时间区间、消息类型（文本/图片/文件/语音）→“导出”。
- 默认保存路径 %userprofile%\Documents\LetstalkExport\（Win）或 ~/Documents/LetstalkExport/（macOS）。
桌面端支持 Shift+点击 多选时间区间，如需跨年审计，可拆成 3 个月一段分批导出，降低单次失败风险。
失败分支与回退方案
若导出按钮灰色，先检查是否开启“72 小时双向回收”且部分消息已被对方撤回；被撤回的消息不在索引内，需联系管理员在“合规存档”后台拉取原始密文。若提示“存储空间不足”，客户端会暂停分卷生成，可清理缓存或把保存路径改到外接硬盘，无需重启。
经验性观察：在 Windows 旧机械硬盘上，若同时运行杀毒实时扫描，导出耗时可能翻倍；临时关闭实时防护或把导出目录加入白名单后，速度可恢复至 SSD 同级水平。
索引范围与性能边界
Letstalk 的本地索引只保留文字与文件名，图片 OCR、语音转文字需先由 AI 助手 3.0 在端侧跑完模型才会被关键词命中。经验性结论：首次启用 AI 助手后，对 1 GB 的语音历史跑批转写约需 35 分钟（M1 Pro 10 核），转写完成后关键词命中率提升 20 %—30 %。
注意
若关闭 AI 助手，则后续新语音不再自动转写，已转写的关键词仍保留在索引，但不会再更新。
示例：某 120 人项目群累积 3 万条语音，开启转写后，“主网启动”关键词从 0 条跃升至 47 条，帮助运营团队补全了早期口头承诺记录。
与机器人协同的最小权限原则
官方 Bot Market 有第三方“归档机器人”提供 /auto_export 命令，但需把“读取消息”权限授予机器人。建议只拉机器人进“临时频道”，完成导出后立即踢出并撤销授权，防止长期 token 泄露。企业版可开“只读密钥”30 分钟自动过期，满足等保最小权限要求。
经验性观察：机器人导出格式固定为 JSONL，需再写脚本转 CSV，适合有定时调度需求但无人工值守的场景；若仅偶尔审计，原生手动导出更省时间。
常见故障排查表
| 现象 | 最可能原因 | 验证步骤 | 处置 |
|---|---|---|---|
| 导出按钮消失 | 客户端版本低于 v6.7.5 | 设置→关于→版本号 | 升级至最新正式版 |
| CSV 中文乱码 | Excel 默认用 ANSI 打开 | 用 VS Code 选 UTF-8 查看 | Excel→数据→自文本→65001 |
| 导出到 50 % 卡住 | 磁盘剩余空间 < 2×导出体积 | 查看分卷目录是否停止增长 | 清理或更换保存路径 |
适用/不适用场景清单
- 适用：合规审计、电商售后纠纷、项目方空投地址收集、律所证据固定。
- 不适用：超过 365 天的历史（免费版硬限制）、已开启“24 h 自毁”的私密圈子、需要实时流式导出到 SIEM 的场景（API 轮询延迟 ≥5 min）。
经验性观察：若群聊启用“限时圈子”且销毁窗口 <7 天，本地索引会在到期后自动清零，此时即使企业后台也无法恢复，需提前导出。
最佳实践速查表
- 关键词先跑“小范围+最近 7 天”试检，确认命中率再扩展到 90 天，避免一次性导出巨包。
- 把“导出路径”统一改到加密硬盘，防止 CSV 里含的 USDT 地址被云盘同步。
- 企业版打开“水印追溯”，导出的截图与文件均带隐形 ID，外泄后可追踪来源。
- 每季度用 Letstalk 自带的“索引重建”功能（设置→存储→重建搜索索引），可压缩 15 % 体积并提升检索速度约 20 %。
补充：重建索引期间，搜索功能暂停 3–5 分钟，建议在非业务高峰期执行；重建完成后首次搜索会触发全文重新缓存，可能稍慢，第二次即恢复正常。
未来版本展望
官方路线图提到 v6.9 将开放“服务器端密文索引”插件，企业私有化部署可在本地 GPU 集群跑 OCR+语音转写，把关键词检索耗时降到 1 秒内，同时支持自动归档到 S3 兼容存储。若通过等保 3 测评，预计会替代现行“端侧导出”成为主流方案，但本地存储成本将上升约 30 %—50 %，需要提前评估磁盘扩容预算。
经验性观察：内测文档显示，新插件采用“可搜索加密”方案，不会破坏现有零明文承诺，但要求每台 GPU 节点预留 32 GB 显存用于向量索引，对中小团队硬件预算是一次考验。
收尾结论
在 Letstalk IM 里做关键词批量搜索并导出，目前最稳妥的方案是保持客户端 v6.8.0、开启 AI 助手 3.0 转写、用 CSV+媒体分卷格式保存，并遵循“先小范围试检→再全量导出”的两段式流程。只要注意 72 小时双向回收与磁盘空间两条红线，就能把 10 万条记录、3 个月周期的整理时间从人工 8 小时压到 15 分钟以内，且全程不触碰明文服务器，兼顾效率与合规。
常见问题
导出文件大于 500 MB 时必须分卷吗？
是的，移动端硬限制单卷 500 MB，超出会自动分卷；桌面端可在设置里把分卷阈值调到 2 GB，但需客户端 ≥v6.8.0。
AI 助手转写支持哪些语言？
目前端侧模型仅支持中英混合，日语与韩语会出现 10 % 左右识别缺失；官方称 v6.9 会追加多语言包，但需额外 2 GB 模型下载。
企业后台能否代替用户侧导出？
可以，但前提是在“合规存档”里开启“允许后台解密”；解密后文件为 ZIP 压缩包，需二级密码才能打开，满足等保要求，却失去端侧零明文优势。
