[开源] MemAuthority 专门给 Agent 使用的长期记忆工具，解决 Agent 重复摸索和踩坑的痛点

🔗 项目主页：GitHub / iasi777/memauthority

本工具只专注于解决一个主要问题：

踩过的坑不应该再踩一遍，现成的经验总结随取随用

• 用户把关：判断哪些信息真正值得长期留下；
• Agent 执行：理解、检索、归纳、更新与清理记忆；
• MemAuthority 兜底：保证长期记忆的可靠保存和按需读取，防止多版本相互覆盖、内容错乱、异常中断导致记忆损坏。提供多 agent 、多平台共用一套记忆的能力

MemAuthority 适合谁

更看重长期记忆质量的用户

你应该经历过以下的不可控感：

• 不清楚什么内容何时被记下了；
• 不确定什么时候会进入上下文；
• 无法确认内容是否已经过时；
• 想要精确修改或删除时无从下手

你也可能尝试过维护 MEMORY.md ，但随着内容积累，它变得越来越臃肿、杂乱，甚至开始干扰 Agent 的正常判断

MemAuthority 适合的用户：

愿意为记忆质量投入少许精力把关

这里的“花精力”并不需要你频繁手动修改文件，而是在关键节点做几个有价值的高层裁决：

• 某些信息是否值得长期保留；
• 什么时候应该整理记忆；
• 哪些内容涉及隐私或敏感信息；
• Agent 提议整理的结果是否符合你的真实意图

其余机械繁琐的格式整理、分类归档与检索调用，统统交由 Agent 处理

为什么不直接用 MEMORY.md

如果你的项目记忆体量较小、内容极少变动，或者你不想在记忆维护上耗费任何注意力，继续使用 MEMORY.md 是最省心的选择

MemAuthority 聚焦于解决更具体的需求：

把“维护长期记忆”本身，变成一套可靠、可控的工程化工作流

• 按需精准读取：仅在任务真正需要时才加载相关记忆，避免无关信息撑爆或污染上下文；
• 清晰的角色分层：明确区分当前接手状态、长期规则、阶段进展与避坑经验；
• 并发与版本安全：修改前严格校验版本，防止旧的修订静默覆盖新内容；
• 幂等防重保障：网络波动或执行中断时的重试操作，不会产生重复记忆；
• 收敛与历史追溯：活跃记忆库可以随意精简收敛，而完整的修改历史可以由 Git 负责追溯；
• 事务与容灾恢复：写入中断或异常时具备明确的事务日志与恢复机制

如何使用

不需要完全一致的提示词，表达意图即可，你也可以开发自己的独特用法：

1. 开始任务时按需读取

“参考一下这个项目的 MemAuthority ，根据当前上下文按需读取”

Agent 应该选择最短、最合适的读取路径：已知具体位置就直接读取，不知道位置时再检索，需要快速接手项目整体状态时再看 handoff 。如果当前对话本身已经有足够上下文，Agent 不会到 MemAuthority 再复核一遍

2. 精确把关要记录的内容

“把这次任务里值得长期记录的内容列出来，我来决定写哪些”

Agent 提炼候选条目，由你最终决定保留、修改还是舍弃

3. 省心快速记录任务

“记录一下这次任务”

这也是常见用法。默认情况下，Agent 会自行决定需要保存的内容，MemAuthority 保证 Agent 记录内容的下限，上限由模型的能力决定

4. 任务结束后顺手维护

“检查一下这次任务实际用到的 MemAuthority 记忆，根据刚刚发生和核验的事实更新它，并清理过时内容”

刚完成任务的 Agent 掌握最新的代码、工具结果、运行事实和用户裁决。它只需要维护本次真正读取和使用过的记忆，不必每次扫描整个记忆库

5. 暂存未来的想法，释放当前的上下文

“某个值得以后深究的方向，先放到 TODO 列表”

这里的 TODO 不是项目管理工具，而是：未来值得处理，但不应该占据现在工作的注意力

真正完成后，直接删除 TODO 本身；真正形成的长期有效结论，再单独归入长期记忆

如何导入旧的记忆库

只要 Agent 能够读取并理解的格式，就能够进行导入：

• 现有的 MEMORY.md ；
• 通用 Markdown 或纯文本文档；
• JSON 导出文件；
• Prompt 提示词文件；
• 历史交接文档与聊天总结；
• 多份存在冲突的旧笔记；
• 其他任何 Agent 可理解的文本内容

输入意思相近的提示词即可：

“先了解 MemAuthority 的记忆规范，然后检查这份旧记忆库 把仍值得长期保留的内容进行去重、合并、更新和重组；过时、重复、纯流水账、临时和不该长期保存的内容全部剔除，先整理出迁移候选方案，由我确认后再执行写入 ”

MemAuthority 里存的是什么？

长期记忆严格划分为四种角色：

handoff （接手状态）

当前接手该项目必须了解的最小关键状态 它应当保持简短、直接并随项目演进而持续刷新，不会成为冗长的第二份 README

rules （长期规则）

未来 Agent 开展工作仍需遵守的长期决定、架构约束与行为准则 只记录最终的裁决结果，不记录冗长的讨论与争辩过程

progress （阶段进展）

对未来后续工作仍具参考价值的阶段性重要进展 它是最低成本的记录入口，但并非流水账式的永久日志

pitfalls （避坑指南）

未来工作中仍有可能再次遭遇的典型失败模式与防范经验 并非每个普通报错都值得记录

如何避免无用的记忆过多塞进 Context ？

MemAuthority 支持渐进式按需召回：

• 当前对话已经有足够信息时，完全不调用 MemAuthority ；
• 项目不明确时，先定位并确认项目；
• 已知明确 URI 或 Section 时，直接精确读取；
• 已知项目但不知道具体位置时，再在项目范围内检索；
• 需要快速恢复项目整体接手状态时，handoff 通常是最合适的起点；
• Agent 自己判断结果是否相关，只继续读取真正有助于当前任务的内容

Agent 看到的搜索结果是定位坐标，把“需要多少证据才足够”留给正在执行任务的 Agent 判断

MemAuthority 不是历史档案

• 规则调整了，就直接更新规则；
• 状态演进了，就同步刷新状态；
• 内容过时且不再需要，就直接删除

将内容从当前 Memory 中移除，但历史记录依然保存在 Git 中，当然这也决定了其不适合作为大型记忆库