用途:episodic-memory 提供对所有项目历史 pi 对话的可搜索索引,帮助在需要过往上下文时找回信息。
适用时机:用户说“像之前那样”“记得当时”“X 是怎么解决的”“我们试过什么”,或引用过去的会话、项目、决策;遇到可能已处理过的错误或模式;开始与以往相似的功能;询问项目历史或过去决策。
主要能力:通过 episodic_memory_search 工具检索。支持语义搜索(按含义而非仅关键词),如 {"query": "authentication middleware implementation"};多概念 AND 搜索,结果须匹配全部概念,如 {"query": ["React Router", "authentication", "JWT"]};按日期过滤,如 {"query": "database migration", "after": "2025-01-01"};精确短语文本搜索,如 {"query": "useAuth hook", "mode": "text"}。
使用建议:查询用描述性短语而非单个关键词;尝试描述问题而非只写解决方案;首次未找到可换措辞或放宽范围;查找特定主题交集时用多概念搜索。若结果片段上下文不足,可用 episodic_memory_show 并传入搜索结果中的会话文件路径查看完整对话。
限制与注意:搜索结果是片段(约 4 轮对话的块),只显示相关部分而非完整对话;结果含相关性分数,越高越好;结果中的项目名表示会话所在目录;不必对每个查询都搜索,仅当过往上下文确实有帮助时使用。