MemoryCustodian

MemoryCustodian 是什么？

MemoryCustodian 是一款开源、本地优先的工具，可为 Codex、Claude Code、Gemini 等编码代理提供持久的项目记忆，无需托管服务或让每次提示变得臃肿。它将决策、约束、已放弃的方案和项目上下文以纯 Markdown 文件的形式直接存储在仓库中。通过清单系统，仅加载与当前任务相关的记忆，确保代理会话保持专注和高效。MemoryCustodian 的设计使其像代码一样可审查、版本控制、共享和删除，自然融入任何开发工作流程。

适用人群

• 独立开发者：希望编码代理能跨会话记住项目上下文，无需手动将指令粘贴到每次提示中。
• 与 AI 代理协作的团队：需要共享、版本控制的项目记忆，让人类和代理都能访问和更新。
• 开源维护者：偏好本地优先、自托管解决方案，希望避免代理记忆的供应商锁定或重复服务费用。

主要功能

纯 Markdown 存储

记忆以标准 Markdown 文件形式存储在仓库中，人类可以像代码一样审查、编辑和版本控制。无专有格式，无外部数据库——只有与现有 Git 工作流兼容的文件。

清单驱动的上下文加载

manifest.md 文件引导代理仅加载与当前任务相关的记忆文件。代理不会加载所有内容，而是读取 brief.md 了解项目概况，decisions.md 和 constraints.md 用于规划，do-not-use.md 避免已放弃的路径——保持上下文最小化和聚焦。

跨代理兼容性

MemoryCustodian 兼容 Codex、Claude Code、Gemini 及其他编码代理。单个 init 命令即可为所选代理创建引导文件，同一记忆结构可跨不同工具和平台使用。

范围化与可选记忆

rules/、profiles/、areas/ 和 archive/ 等可选目录在明确相关之前不会进入默认上下文。这防止了记忆膨胀，确保代理仅加载当前任务所需的内容。

突出特点

"持久记忆，最小上下文。"

这句话概括了 MemoryCustodian 的核心理念：它赋予代理持久的项目知识，同时不使每次提示变得臃肿。通过将记忆以纯 Markdown 形式存储在仓库中，并仅加载每个任务所需的内容，它避免了记忆深度与提示效率之间的常见权衡。最终形成一个隐形的系统——代理记住重要信息，而你无需为未使用的上下文付费。

值得一试，如果……

你厌倦了每次会话都向编码代理重复相同的项目上下文，或者你希望寻找一个轻量级、开源的内存服务替代方案。如果你重视本地优先工具、版本控制的项目知识，以及审查和策划代理记忆的能力，MemoryCustodian 尤其有用。对于任何使用 AI 编码助手、希望获得持久、最小化且可共享项目记忆的团队或独立开发者来说，它都是一个实用的选择。