claude-historian

Claude Historian

开始新对话前，先搜索历史记录。你可能已经找到答案了。

何时使用

使用 WebSearch 之前 → search(query: "...", scope: "similar") 或 search(query: "...", scope: "conversations")。过去的解决方案比网页搜索结果更有参考价值。

遇到错误后卡住 → search(query: "<error message>", scope: "errors")。查找包含代码的过往修复方案。

进入熟悉的项目 → 使用 search(scope: "sessions") 查看近期工作。使用 search(query: "...", scope: "plans") 查看过去的决策。

处理熟悉的文件 → 使用 search(scope: "files", filepath: "src/index.ts")。查看以往的修改及其上下文。

快速参考

情况	工具调用
原因不明的错误	search(query: "<error>", scope: "errors")
“我以前做过这件事吗？”	search(query: "...", scope: "similar")
处理熟悉的文件	search(scope: "files", filepath: "...")
需要了解过去的设计思路	search(query: "...", scope: "plans")
上次会话做了什么？	search(scope: "sessions")
成功的工具工作流	search(scope: "tools")
常规搜索	search(query: "...", scope: "conversations")
深入查看某次会话	inspect(session_id: "...")
规则、技能、CLAUDE.md	search(query: "...", scope: "config")
任务管理历史	search(query: "...", scope: "tasks")
跨会话记忆	search(query: "...", scope: "memories")

关键参数

• scope：指定搜索范围 — conversations、errors、files、plans、config、tasks、similar、sessions、tools、memories 或 all（默认值）
• limit：结果数量（默认值为 10）
• project：按项目名称子串筛选（适用于 conversations、sessions）
• timeframe：today、yesterday、week、month

常见错误

错误	修正方法
直接使用 WebSearch	先查找历史记录 — 过去的解决方案更相关
查询内容太笼统	使用具体词语：错误消息、文件路径、工具名称
使用 scope: "all" 搜索错误	使用 scope: "errors" — 该范围专门提取修复方案
查询中堆砌过多关键词	使用 3-5 个具体词语，而不是 10 个以上的泛泛词语