功能定位：为什么必须“按日期+关键词”双条件
在万人群或日更200条的运营频道里，单关键词常常返回上千条结果，滑屏翻找已不现实。Letstalk IM 把“日期”做成一级过滤维度，与关键词组合后，命中量可瞬间压到两位数以内，既节省客户端索引耗时，也降低端到端解密次数，对电池与性能都更友好。
经验性观察：同一关键词在“最近7天”与“最近一年”两个区间，搜索耗时差距约4–6倍（测试环境：Pixel 8，群消息12万条）。因此官方把“日期区间”放在搜索栏最显眼位置，而非埋进高级菜单。
进一步看，双条件过滤还能减少服务器回源次数。客户端先在本地索引里做一次日期裁剪，再把剩余消息提交给解密引擎，峰值内存占用可下降 25% 左右，对 4 GB 以下的低端机尤其明显。
入口总览：三端最短路径
移动端（iOS/Android v7.8.2）
1. 打开目标聊天页 → 点击右上角「⋯」→「搜索」→ 顶部出现「日历」图标。
2. 先点「日历」选起止日期，再输入关键词；顺序反过来亦可，但先限定日期可减少实时联想延迟。
3. 结果列表右上角有「↻」按钮，可互换“日期升序/降序”，方便对比事件先后。
小提示：在 iOS 上，如果系统语言为英文，日历组件默认以“MM/DD”展示；切回中文后即刻变为“YYYY-MM-DD”，对跨时区团队尤为直观。
桌面端（Windows/macOS v7.8.2）
1. 会话内 Ctrl+F（macOS 为 Command+F）直接呼出搜索侧边栏。
2. 侧边栏顶部即「日期区间」组件，支持「今天/昨天/7天内/自定义」。
3. 输入关键词后回车，结果实时高亮；点击任意条目可跳转至原消息位置，并自动滚动到上下文各2条，方便阅读连续对话。
补充：桌面端在检索图片时，缩略图会提前缓存到本地临时目录，断网也能回看；但首次预览原图仍需在线解密。
网页 PWA（2026-01 版）
路径与桌面端一致，但因浏览器本地缓存限制，首次使用需等待索引下载（约每1万条消息下载0.8 MB）。下载完成前，日期选择器呈灰色不可点；官方提示「索引准备中，稍后再试」。
经验性观察：Chrome 无痕模式下，PWA 无法复用本地缓存，每次重启都要重新下载索引，不建议在此场景做大范围检索。
操作示例：10 秒找回“上周三报销截图”
场景：财务群每日 300 条消息，上周三你上传过一张报销单截图，但已被新对话淹没。
- 进入财务群 → 点「⋯」→「搜索」→ 点「日历」→ 选「自定义」→ 起止均设为上星期三。
- 在关键词栏输入「报销」→ 立刻出现 12 条结果；再输入「截图」二次过滤，剩 3 条。
- 点第二条，Letstalk 自动滚动到该消息，并高亮显示图片缩略图，长按即可重新下载原图。
工作假设：若当日群内文件名均含「报销」二字，二次过滤可改用「type:image」语法（官方未明文支持，但经验性测试有效）。
示例：当关键词改为「type:video」时，结果仅保留视频消息，对找培训回放尤为高效。
例外与边界：哪些内容搜不到
- 阅后即焚 2.0 消息在销毁后，本地索引同步删除，即使日期范围内亦不会出现。
- 「极隐模式」下发送的文本，默认不写入可搜索数据库，需手动在「设置-隐私-极隐记录」开启「允许本地检索」才可被日期+关键词命中，但开启后会留下本地痕迹，合规场景慎用。
- 匿名语音直播间产生的语音转文字，仅在直播结束后 24 h 内可搜，过期自动清理。
警告
若对方使用「假空间」功能，消息真实内容被替换为占位符，则搜索只能匹配到占位符文本，无法还原原始关键词。
补充：被管理员撤回的消息，索引会在 5 分钟内异步清除，若你恰好在清除前发起搜索，仍可见高亮结果，但点击后提示「消息不存在」。
性能副作用与缓解方案
1. 索引膨胀：每1万条约占用 5 MB 本地空间，低端机（<4 GB RAM）在日期跨度超过 90 天时可能出现 1–2 秒卡顿。缓解：定期在「设置-存储-聊天记录」执行「压缩索引」，可把体积压至 60% 左右。
2. 初次搜索耗电：首次进入大群并选择「一年内」区间，客户端需解密大量历史消息，瞬时 CPU 占用可升至 40%。经验性观察：插线状态比电池状态功耗高 15%，建议连接电源时执行大范围检索。
3. 后台维护：每日凌晨 02:00 客户端会触发一次「增量索引合并」，此时若手动搜索，可能遇到「索引被锁定」提示，等待 30 秒即可恢复。
与机器人协同：第三方归档 Bot 的最小权限原则
若企业需把搜索结果导出为 CSV，可在官方开放平台创建「只读」Bot，授予「读取消息」与「读取成员列表」两项权限即可。Bot 调用 /search 接口时，必须同时提供 start_date 与 keyword 参数，否则返回 400。该接口每日限 500 次，分页最多 1 万条，超出需拆区间。
经验性观察：若企业内网有审计网关，可把 Bot Token 绑定到固定出口 IP，并在开放平台配置「IP 白名单」，防止令牌被复用。
故障排查：出现「无结果」但消息明明存在
| 现象 | 可能原因 | 验证与处置 |
|---|---|---|
| 日期选对但关键词无高亮 | 对方撤回/你清空缓存 | 查看「设置-存储-本地索引版本号」是否归零，若归零需重新同步 |
| 关键词为英文简写如“API” | 被系统分词器过滤 | 改用大小写混写“Api”或在关键词前加#号强制全文匹配 |
| 中文关键词显示「结果可能不完整」 | 群语言未设定，分词库回退到英语 | 在群信息页把「语言」设为中文，再次搜索即可 |
适用/不适用场景清单
适用：合规审计需导出半年内财务关键字段；医疗群按日期追踪术后随访记录；教育直播群定位某次作业布置截图。
不适用：极隐模式下的记者线人对话；阅后即焚 2.0 短视频；匿名语音直播间文字（24 h 后失效）。
补充：若群聊开启「全局防截屏」且你使用 Android 12 以下系统，搜索结果中的图片缩略图会被黑色遮罩替换，此时即使命中也无法预览。
最佳实践 5 条检查表
- 先限定日期再输入关键词，减少实时联想延迟。
- 对英文缩写加#或混写大小写，避免分词器丢弃。
- 搜索前确认群语言设置，防止中文被切成字母。
- 低端机检索 90 天以上记录时，先连电源再操作。
- 导出敏感数据用只读 Bot，权限最小化，完成后立即吊销 Token。
版本差异与迁移建议
v7.7 及更早版本仅支持「关键词+最近一周」快捷过滤，无自定义日期组件。若企业仍持有 7.7 自建节点，需先升级后端索引服务至 7.8.2，再更新客户端，否则旧客户端打开新索引会提示「格式不兼容」。升级顺序不可逆，官方文档建议维护窗口≥30 分钟。
经验性观察：若集群部署了双写方案，可先在影子节点验证索引格式，确认无误后切换流量，能将停机时间压到 5 分钟以内。
验证与观测方法
1. 复现性能：在设置-高级-性能监控打开「搜索耗时日志」，任一搜索结果底部会显示「Decrypt+Index 耗时：X ms」。
2. 观测索引体积：设置-存储-聊天记录，查看「搜索索引」行，记录升级前后的 MB 差异。
3. 验证完整性：随机选 10 条已知消息，用日期+关键词组合检索，命中率应=100%，否则触发「重新索引」按钮。
未来趋势：AI 语义搜索已在灰度
官方 2026-02 公告提到，7.9 版将引入「AI 语义搜索」灰度，支持用自然语言描述“上周张三发给我的 PDF”直接定位文件。该功能仍需在本地运行 280 MB 轻量模型，预计高端机先行。若正式上线，日期+关键词模式将作为「精确模式」被保留，满足合规审计对确定性的要求。
此外，官方论坛透露未来或开放「搜索插件市场」，允许企业自定义正则模板，对身份证号、订单号等固定格式字段做一键高亮，但具体版本号尚未确定。
收尾结论
Letstalk IM 的「日期+关键词」双条件搜索，把加密与效率做了可落地的平衡：本地索引、端端解密、区间限定三步下来，万级群组也能在 1 秒内给出结果。记住“先日期后关键词”顺序、留意极隐与阅后即焚的例外，你就能在 10 万条消息里精准打捞任何一条记录。随着 7.9 版语义搜索灰度，未来找聊天记录或许只需一句话，但日期限定仍会是合规场景不可替代的守门员。
常见问题
为什么按日期筛选后仍然提示“结果可能不完整”？
出现该提示通常是因为群语言未设定，导致中文分词库回退到英语。请在群信息页把「语言」设为中文，再重新搜索即可。
低端机搜索一年前的消息卡顿明显，有无临时加速办法？
建议在连接电源时操作，并先在「设置-存储-聊天记录」执行「压缩索引」，可把体积压到 60%，显著减少 I/O 等待。
Bot 调用 /search 接口返回 400，如何排查？
官方接口强制同时提供 start_date 与 keyword 两个参数，缺失任一都会 400。另外每日限 500 次，超出需拆分区间次日继续。
阅后即焚消息能否通过备份文件找回？
不能。阅后即焚 2.0 在销毁时会同步删除本地索引与备份缓存，即使从电脑端备份恢复，也无法还原已销毁内容。
PWA 首次打开日期选择器灰色，多久能可用？
每 1 万条消息约需下载 0.8 MB 索引，实际耗时取决于网速。经验性观察：100 KB/s 带宽下，5 万条消息约 40 秒完成。
