raiyanyahya/recall

解决的问题

Recall 解决了 Claude Code 等 AI 编码代理的「冷启动」问题，即每次新会话开始时都缺乏对之前工作的记忆。它消除了每次会话开始时手动重新解释项目目标、当前进展和待办事项的需要，同时避免了将会话历史发送到外部 LLM 进行摘要所带来的高 token 成本和隐私风险。

工作原理

Recall 在 .recall/ 目录中维护两个本地 Markdown 文件：

• history.md：一个仅追加的日志，记录会话期间发生的每个提示、回复、文件变更和命令执行。
• context.md：项目当前状态的精炼摘要，包括目标、涉及的文件和下一步行动。

Recall 不使用 LLM，而是使用基于 TF-IDF 和 TextRank 的经典本地 Python 摘要算法，从历史记录中提取最核心的句子并生成摘要。此过程完全在用户机器上本地执行，无需 API 密钥或网络调用。

适用人群

使用 Claude Code 或 OpenCode 的开发者，希望在多个会话之间以持久、隐私保护且成本低廉的方式维护项目记忆。

特点

• 零 token 成本：摘要由本地算法完成，而非 LLM 调用，节省使用额度。
• 完全本地且私密：数据不会离开机器；转录和摘要均本地存储，从不发送至外部 API。
• 零摩擦：无需复杂安装或本地模型设置；摘要器已打包，使用标准 Python 库。
• 与代理无关：虽然专为 Claude Code 构建，但也可集成到 OpenCode 等其他代理中，因为它将记忆存储为普通 Markdown 文件。