消息过滤
在海量对话中快速找到你需要的内容，像使用搜索引擎一样轻松。
为什么需要消息过滤？
和 AI 结对编程一整天后，对话记录可能有几百条消息。想找到某个特定的讨论？逐条翻阅既费时又费力。
消息过滤 就是 Mantra 提供的"精准定位"能力：
- 按类型筛选：只看 AI 回复，或只看代码相关的消息
- 关键词搜索：输入关键词，瞬间定位到相关对话
- 结果高亮：搜索结果一目了然，不再大海捞针
简单理解
如果说时光旅行是"视频进度条"，那消息过滤就是"章节目录"——帮你快速跳到想看的部分。
常见使用场景
| 场景 | 过滤方式 |
|---|---|
| 只想看 AI 写了什么代码 | 类型过滤：只显示 AI 回复 |
| 找到讨论某个函数的对话 | 搜索函数名称 |
| 查看所有工具调用记录 | 类型过滤：只显示工具调用 |
| 回顾自己提出的所有问题 | 类型过滤：只显示用户消息 |
按类型过滤
支持的消息类型
Mantra 可以区分多种消息类型，让你按需筛选：
| 图标 | 类型 | 说明 |
|---|---|---|
| 👤 | 用户消息 | 你发送给 AI 的内容 |
| 🤖 | AI 回复 | AI 的响应和生成的代码 |
| 🔧 | 工具调用 | AI 使用的工具和执行结果 |
| ⚙️ | 系统消息 | 系统提示和状态信息 |
如何使用类型过滤
- 在对话面板上方找到过滤按钮
- 点击展开过滤选项
- 选择你想查看的消息类型
- 对话列表会立即更新，只显示符合条件的消息
快速切换
过滤按钮通常会显示当前选中的类型数量，方便你知道是否有过滤条件生效。
组合过滤
你可以同时选择多种消息类型，实现更精准的筛选：
- 用户消息 + AI 回复：只看对话内容，隐藏工具调用
- AI 回复 + 工具调用：专注于 AI 的操作和输出
- 只看工具调用：快速浏览所有执行的命令和结果
注意
过滤只影响显示，不会删除或修改任何消息记录。取消过滤后，所有消息都会恢复显示。
搜索功能
关键词搜索
当你知道要找什么，但不知道在哪里时，搜索是最快的方式：
- 点击搜索图标或使用快捷键
Cmd/Ctrl + F - 在搜索框中输入关键词
- 匹配的消息会立即显示
- 关键词在消息中会高亮标记
搜索结果导航
找到搜索结果后，你可以：
- 查看匹配数量：搜索框旁会显示"N 个结果"
- 逐个跳转：使用上/下箭头在结果之间切换
- 直接点击：点击任意搜索结果跳转到该消息
搜索技巧
搜索小技巧
大小写不敏感 搜索 function 和 Function 会得到相同的结果。
支持部分匹配 输入 auth 可以找到 authentication、authorize、OAuth 等。
可以搜索代码内容 函数名、变量名、甚至报错信息都可以搜索。
组合使用效果更好 先用类型过滤缩小范围，再用搜索精确定位。
搜索范围
搜索会查找消息的全部内容，包括代码块、工具输出、系统信息等。
结合时光旅行使用
消息过滤和 时光旅行 配合使用，效果更强大。
过滤后跳转代码
典型的组合使用流程：
- 过滤关键消息：比如只显示 AI 回复
- 搜索特定内容：比如搜索某个函数名
- 点击目标消息：触发时光旅行
- 查看代码变化：右侧面板显示该时间点的代码
快速定位关键节点
当对话很长时，过滤能帮你跳过无关内容：
| 目标 | 方法 |
|---|---|
| 找到 AI 第一次实现某功能的地方 | 搜索功能名 → 点击最早的匹配结果 |
| 查看所有代码修改 | 过滤只看 AI 回复 → 逐个点击查看变化 |
| 找到报错讨论 | 搜索错误关键词 → 跳转到相关对话 |
高效浏览技巧
- 先用类型过滤隐藏工具调用（通常很多）
- 在精简后的列表中使用时光旅行
- 这样可以专注于对话内容，忽略技术细节
组合使用场景示例
场景：想知道 handleSubmit 函数是怎么演变的
- 打开消息过滤，只显示 AI 回复
- 搜索
handleSubmit - 从第一个结果开始，逐个点击
- 观察右侧代码面板中函数的变化过程
- 就像看纪录片一样，了解函数的"成长历程"
快捷键
使用快捷键可以更高效地过滤和搜索：
| 快捷键 | 功能 |
|---|---|
Cmd/Ctrl + F | 打开搜索框 |
Esc | 关闭搜索 / 清除过滤 |
Enter | 跳转到下一个搜索结果 |
Shift + Enter | 跳转到上一个搜索结果 |
快捷键说明
以上快捷键遵循常见的浏览器和应用程序标准。实际行为可能因 Mantra 版本而略有差异，请以应用内提示为准。
连续操作
按 Cmd/Ctrl + F 打开搜索后，可以直接输入关键词。按 Enter 快速在结果之间跳转，配合时光旅行效率更高。
更多快捷键请参考 快捷键参考。
最佳实践
高效使用建议
先过滤，后搜索
- 类型过滤可以大幅减少候选消息
- 在较少的消息中搜索更快更准确
善用组合过滤
- 只看 AI 回复：专注于 AI 的实际产出
- 隐藏系统消息：减少干扰信息
搜索时用关键词
- 函数名、变量名比描述性词汇更精确
- 错误代码比错误描述更容易找到
常用工作流
代码审查工作流：
- 过滤只看 AI 回复
- 从头开始点击，逐个查看代码变化
- 发现问题时，搜索相关函数名深入了解
问题排查工作流：
- 搜索错误信息或相关关键词
- 跳转到首次出现的位置
- 查看上下文对话了解原因
常见问题
搜索没有结果？
可能的原因：
关键词拼写错误
- 检查拼写，尤其是代码中的函数名和变量名
- 尝试更短的关键词（部分匹配）
被类型过滤隐藏了
- 先清除类型过滤，再重新搜索
- 检查目标消息的类型是否在过滤范围内
内容在折叠区域
- 某些长消息可能被折叠
- 搜索时会包含折叠内容，但可能不直观
解决方法： 按 Esc 清除所有过滤条件，确认消息存在后再重新筛选。
如何重置过滤条件？
快速重置：
- 按
Esc键关闭搜索并清除过滤 - 点击过滤按钮，选择"全部"或"重置"
手动重置：
- 在类型过滤中重新选择所有类型
- 清空搜索框内容
重置后，所有消息都会恢复显示。
过滤和搜索的区别？
类型过滤：
- 按消息的"身份"筛选（谁发的）
- 可以持续生效
- 适合长时间浏览
关键词搜索：
- 按消息的"内容"查找（说了什么）
- 通常用于快速定位
- 找到后一般会关闭
最佳实践： 两者结合使用效果最好。先用类型过滤缩小范围，再用搜索精确定位。
过滤会影响时光旅行吗？
不会。
过滤只改变显示的消息列表，不影响时光旅行的功能：
- 隐藏的消息仍然存在于时间线上
- 点击任何可见消息都能正常触发时光旅行
- 代码快照包含所有文件，不受过滤影响
过滤的好处是让你更容易找到想点击的消息。
下一步
掌握了消息过滤后，探索更多功能：