mcncarl/agent-memory-vault

它解决了什么问题

AI 编码代理在不同会话或不同工具之间常常缺乏持久且共享的长期记忆。该项目提供了一个以本地优先的系统，使 Claude Code 和 Codex 等代理能够共享一个单一、可验证的记忆库，从而防止在会话之间丢失项目状态、决策和经验教训。

它如何工作

该系统使用 Markdown 文件作为主要的真相来源，这些文件存储在私有的 Git 支持的目录中。为了实现高效的检索，它维护一个 SQLite 数据库，用于结构化和全文搜索，并可选地使用 EmbeddingGemma 和 Zvec 添加本地语义搜索层。

为了确保数据完整性并防止代理相互覆盖对方的工作，系统实现了“声明”机制：代理必须在“收尾”过程中提交前声明文件。它还具有两阶段写入工作流（读取目标 $\rightarrow$ 准备 $\rightarrow$ 应用），以提供安全边界，防止意外误用。

适合谁使用

使用 AI 编码代理（特别是 Claude Code 和 Codex）的开发者，希望为其 AI 助手提供持久、可审计且私有的长期记忆系统。

主要特点

• 以本地优先且私有：记忆存储在私有的本地记忆库中，与公共代码仓库分离。
• 基于 Git：使用 Git 进行版本控制、历史记录和记忆文件的回滚。
• 混合搜索：结合关键词搜索（SQLite/FTS）与可选的本地向量语义搜索。
• 会话范围的声明：通过确保只有已声明的文件在收尾过程中被处理，防止会话冲突。
• 可验证的写入：包含源检查、内容绑定意图和不可变收据，用于高影响变更。