Recall — Claude Code 本地项目记忆插件

这个 Agent 能做什么，适合哪些场景？

Recall 是一个为 Claude Code 设计的完全本地化插件，解决每次会话冷启动、需反复解释项目背景的问题。它通过 SessionStart、Stop 和 SessionEnd 钩子把会话活动增量追加到项目内 .recall/history.md，再用本地 TF-IDF + TextRank 摘要器生成约 1–2K 令牌的 context.md，供下次会话恢复上下文。整个过程无任何 LLM 调用、无网络请求、无 API 密钥，摘要算法（含 numpy 加速路径与纯 Python 路径）全部内置在 scripts/summarizer.py。除了 Claude Code 插件形式，还可通过安装脚本以选择性方式接入 opencode，两个工具可共享同一份 .recall/ 记忆。项目还内置脱敏、受限写入与 git 配置加固等安全机制，遵循 MIT 许可证。

会话进行中，Stop/SessionEnd 钩子运行 capture.py，把你的提示词、Claude 回复、触碰的文件和执行的命令增量追加到 .recall/history.md；会话开始时 session_start.py 加载 context.md 并询问是否恢复、是否继续记录。收尾时运行 /recall:save，make_context.py 调用 scripts/summarizer.py（TF-IDF 句向量 → 余弦相似度图 → TextRank PageRank 幂迭代 → 取前 N 句），并结合首条请求、文件、命令、git diff --stat 等确定性事实覆盖写入 context.md。也可配置 auto_save_context: "on_end" 在会话结束自动生成。命令包括 /recall:save、/recall:show、/recall:log。支持 opencode 的项目可运行 python3 ~/recall/scripts/install.py --opencode --project <路径> 生成捕获 shim、/recall-save 命令和 opencode.json 配置。

1. 在订阅计划下长期使用 Claude Code 的开发者，希望省下重复解释项目的令牌开支
2. 跨多天、多会话推进同一项目的工程师，需要快速恢复上次进度和待办事项
3. 对隐私敏感、代码和路径不能发送到外部 API 的团队或个人
4. 同一仓库混用 Claude Code 和 opencode 的开发者，希望共享同一份会话记忆
5. 希望把 .recall/ 提交为团队共享记忆、供成员互相接续工作的小型团队（需信任仓库写入者）

如何安装或部署这个 Agent？

从 marketplace 安装（在 Claude Code 中执行）：

/plugin marketplace add raiyanyahya/recall
/plugin install recall@recall

本地开发方式（无需安装步骤）：

claude --plugin-dir /path/to/recall

opencode（每项目一次性）：

git clone https://github.com/raiyanyahya/recall ~/recall
python3 ~/recall/scripts/install.py --opencode --project /path/to/your/project

无需 pip install：摘要器内置，仅标准库（numpy 为可选加速）。在订阅登录下运行即可；若 claude 报 "Invalid API key"，用 unset ANTHROPIC_API_KEY 清除干扰变量。

如何使用这个 Agent？

1. 正常开始一个 Claude Code 会话，Recall 会展示 context.md 并询问是否恢复及是否记录。
2. 正常工作，Stop/SessionEnd 钩子自动追加会话活动到 .recall/history.md。
3. 结束前运行 /recall:save 生成/覆盖 context.md（或在 recall.config.json 中设置 auto_save_context: "on_end" 自动生成）。
4. 新开会话即可从紧凑摘要恢复，无需重新解释项目。

其他命令：/recall:show 打印 context.md，/recall:log 查看 history.md。可选在项目根放置 recall.config.json 覆盖默认值（输出目录、摘要句数、脱敏、git 集成等）；创建 .recall/.capture-paused 可暂停记录。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v0.4.0 Recall 0.4.0 — OpenCode support (opt-in) 2026-07-18
   发布说明摘录

   Recall now works with [opencode](https://opencode.ai) — the same fully-local memory (.recall/history.md + context.md), captured from opencode sessions instead of (or alongside) Claude Code. Requested in #10. Claude Code users: nothing changes. Claude Code remains the first-class harness. The hooks, commands, and manifest are untouched, and the opencode path activates only if you explicitly run the installer. Update as usual via the marketplace. OpenCode support — one-time, per-project, reversible …

   在 GitHub 查看 ↗
2. v0.3.6 Recall 0.3.6 2026-06-25
   发布说明摘录

   Recall now works on a standard Windows install. Previously the plugin would install and the slash commands would appear, but **nothing was ever captured or surfaced** — every failure was swallowed by the defensive handling that keeps Recall from crashing a Claude Code session. Three independent Windows-specific bugs were responsible, all reported in #6 by @driano1221. 🪟 Fixed - python3 not found. The hooks and /recall:save invoked python3, which a standard Windows install doesn't provide, so capture and the session recap …

   在 GitHub 查看 ↗
3. v0.3.5 Recall 0.3.5 2026-06-22
   发布说明摘录

   Notes: Documentation release: adds a privacy policy. Added - Privacy policy (PRIVACY.md), linked from the README. Documents that Recall runs fully locally — no network access, telemetry, accounts, or third-party/model calls, and all output stays under .recall/ — and that the built-in secret redaction is a best-effort safety net, not a guarantee. No code changes — behavior is identical to 0.3.4. Full Changelog: https://github.com/raiyanyahya/recall/compare/v0.3.4...v0.3.5

   在 GitHub 查看 ↗

常见问题