消息过滤
在海量对话中快速找到你需要的内容，像使用搜索引擎一样轻松。
为什么需要消息过滤？
和 AI 结对编程一整天后，对话记录可能有几百条消息。想找到某个特定的讨论？逐条翻阅既费时又费力。
消息过滤 就是 Mantra 提供的"精准定位"能力：
- 按类型筛选：只看 AI 回复，或只看代码相关的消息
- 关键词搜索：输入关键词，瞬间定位到相关对话
- 结果高亮：搜索结果一目了然，不再大海捞针
简单理解
如果说时光旅行是"视频进度条"，那消息过滤就是"章节目录"——帮你快速跳到想看的部分。
常见使用场景
| 场景 | 过滤方式 |
|---|---|
| 只想看 AI 写了什么代码 | 类型过滤：只显示 AI 回复 |
| 找到讨论某个函数的对话 | 搜索函数名称 |
| 查看所有工具调用记录 | 类型过滤：只显示工具调用 |
| 回顾自己提出的所有问题 | 类型过滤：只显示用户消息 |
按类型过滤
支持的消息类型
Mantra 可以区分多种消息类型，让你按需筛选。新的过滤栏使用 Chips 样式，支持多选：
| 图标 | 类型 | 说明 |
|---|---|---|
| 💬 | 对话 | 普通文本对话（用户和 AI） |
| 🔧 | 工具 | 工具调用和执行结果 |
| 📄 | 文件 | 文件读写操作 |
| $ | 命令 | 终端命令执行 |
| 💭 | 思考 | AI 的思考过程（Thinking Block） |
| 🔍 | 搜索 | 搜索相关的工具调用 |
智能关联显示
为了保持上下文完整，Mantra 的过滤具有智能关联功能：
- 工具配对：当你选择查看"工具"时，系统会自动同时显示工具调用请求和工具执行结果。你不会看到孤立的请求或结果，它们总是成对出现。
如何使用类型过滤
- 在对话面板上方找到过滤栏
- 点击对应的 Chip（如"工具"、"文件"）
- Chip 变色表示选中，支持同时选中多个类型（OR 逻辑，即显示满足任一选中类型的消息）
- 再次点击可取消选中
统计信息
过滤栏右侧会实时显示统计信息，例如 匹配: 15/200 条，让你清楚当前过滤出了多少内容。
搜索功能
关键词搜索
当你知道要找什么，但不知道在哪里时，搜索是最快的方式：
- 点击过滤栏右侧的搜索图标，或使用快捷键
Cmd/Ctrl + F - 在搜索框中输入关键词
- 匹配的消息会立即显示
- 关键词在消息中会高亮标记
组合搜索
搜索框与类型过滤可以组合使用（AND 逻辑）：
例如，你可以选中"文件"类型，然后在搜索框输入 "auth"。 这样，Mantra 只会显示与文件操作相关且包含 "auth" 关键词的消息。
搜索技巧
搜索小技巧
大小写不敏感 搜索 function 和 Function 会得到相同的结果。
支持部分匹配 输入 auth 可以找到 authentication、authorize、OAuth 等。
智能防抖 输入时系统会短暂等待（300ms），避免频繁刷新列表。
清除搜索 按 Esc 键或点击搜索框右侧的 X 按钮可以快速清除搜索内容。
搜索结果导航 (v0.9.1+)
当全局搜索（侧边栏搜索）返回结果时，点击搜索结果可以精准定位到对应的消息，并在会话内导航多个匹配项。
精准消息定位
点击搜索结果后：
- 消息面板自动滚动至目标消息，居中对齐，带有平滑动画
- 焦点消息：显示蓝色左侧边框和脉冲背景光晕
- 同一会话其他匹配：显示淡蓝色标记
消息内关键词高亮
- 匹配的关键词在消息文本内以黄色高亮标记
- 大小写不敏感
- 代码块和思考块不参与高亮（避免视觉噪音）
多匹配项导航器
当一个会话内有 2 个或以上匹配项时，右上角出现浮动导航栏：
| 元素 | 功能 |
|---|---|
| 关键词显示 | 显示当前搜索词 |
| 计数器 | 如「2/5」，显示当前位置 |
| 上一个 / 下一个 | 在匹配项间跳转，支持循环 |
导航快捷键
| 快捷键 | 功能 |
|---|---|
Enter | 跳到下一个匹配项 |
Shift + Enter | 跳到上一个匹配项 |
Esc | 清除所有高亮 |
结合时光旅行使用
消息过滤和 时光旅行 配合使用，效果更强大。
过滤后跳转代码
典型的组合使用流程：
- 过滤关键消息：比如只显示"文件"类型
- 搜索特定文件：比如搜索
user_controller.ts - 点击目标消息：触发时光旅行
- 查看代码变化：右侧面板显示该时间点的代码
快捷键
使用快捷键可以更高效地过滤和搜索：
| 快捷键 | 功能 |
|---|---|
Cmd/Ctrl + F | 聚焦搜索框 |
Esc | 清除搜索内容 / 退出搜索 / 清除高亮 |
Enter | 跳到下一个搜索匹配项（搜索结果导航模式） |
Shift + Enter | 跳到上一个搜索匹配项（搜索结果导航模式） |
连续操作
按 Cmd/Ctrl + F 打开搜索后，可以直接输入关键词。配合 精简模式 下的快捷键，可以快速整理会话。
更多快捷键请参考 快捷键参考。
常见问题
搜索没有结果？
可能的原因：
被类型过滤隐藏了
- 检查你是否选中了某些类型 Chip。如果有选中，搜索只会在这些类型中进行。
- 点击"清除过滤"按钮重置所有条件。
内容在折叠区域
- 某些长消息或思考过程可能被折叠。
解决方法： 点击过滤栏最右侧的 清除过滤 按钮，重置所有条件后再试。
如何重置过滤条件？
快速重置：
- 点击过滤栏最右侧的 清除过滤 按钮（仅在有过滤条件时出现）。
- 或者手动取消选中的 Chip 并清空搜索框。
过滤会影响时光旅行吗？
不会。
过滤只改变显示的消息列表，不影响时光旅行的功能：
- 隐藏的消息仍然存在于时间线上
- 点击任何可见消息都能正常触发时光旅行
- 代码快照包含所有文件，不受过滤影响
下一步
掌握了消息过滤后，探索更多功能：