raiyanyahya/recall

它解决了什么问题

Recall 为 AI 编码代理（特别是 Claude Code 和 OpenCode）提供了一个完全本地的自动会话记忆，解决了用户在每次新会话中必须重新解释项目上下文、目标和进展的‘冷启动’问题。它通过用紧凑的本地生成摘要替代长篇对话记录，减少了 token 使用量和成本。

它如何工作

Recall 将会话活动（提示、回复、涉及的文件和运行的命令）记录到一个只能追加的 history.md 文件中。当用户保存上下文时，本地的 Python 摘要生成器使用 TF-IDF 和 TextRank 算法从历史记录中提取最核心的句子，生成一个 context.md 文件。该摘要包含项目目标、涉及的文件以及 git diff，随后在下一个会话中加载，以恢复工作。

适合谁使用

使用 Claude Code 或 OpenCode 的开发者，希望在不将会话记录发送到外部 API 或产生额外 LLM 摘要成本的情况下，维持持久的项目记忆。

特色亮点

• 完全本地化：无需 API 密钥或外部模型；摘要生成通过经典的 Python 算法完成。
• token 高效：从一个紧凑的摘要（约 1–2K token）恢复会话，而非重放完整对话记录。
• 隐私优先：会话记录和敏感信息保留在本地机器上，并内置敏感数据脱敏功能。
• 与工具无关：虽然专为 Claude Code 构建，但使用纯 Markdown 文件，可跨不同编码代理共享。
• 零依赖：摘要生成器已内嵌，仅依赖 Python 标准库，NumPy 为可选加速器。