agentmemory 原理：让 AI 编程助手拥有长期记忆

agentmemory 在本机记录编程助手做过的事，下次开工时交还相关内容。讲清原理、记忆种类、使用场景和主要功能。

AI 编程助手每开一个新会话都从零开始：项目怎么跑、上周踩过什么坑、你纠正过它什么，全要重讲。agentmemory 这类工具的思路是：在你的电脑上跑一个记忆服务，自动记下助手做过的事，下次开工时把相关的内容交还给它。多个编程助手共用同一份记忆。

原理：四步

采集：助手的每条提问和每次工具调用，比如改文件、跑测试，都会发给本机的记忆服务。每条记录都标明来源：你输入的、助手自己的、工具返回的、导入的，还是另一个助手共享的。

压缩：每条记录被压成标题、涉及的文件和一段摘要。接上大模型后，会进一步提炼成事实和概念。

检索：查找时同时用三路：关键词、语义相似度、知识图谱里的关联，再合并打分。同一个会话不会占满结果，被更新过的旧记忆不会再被搜出来，中文提问也能搜到英文摘要。

沉淀：会话结束后自动总结，提炼出事实和反复出现的做法；长期没人用的记忆会慢慢降权；每个会话留一份摘要，原始记录清理后也不丢重点。

新会话开始时，它按固定顺序把内容放进上下文：置顶记忆、项目概况、相关教训、最近几次会话的摘要，总长度控制在你设定的范围内。

记忆分几种

观察记录：会话里发生了什么，比如哪次工具调用找到了测试失败的原因。

记忆：决定和事实，比如支付接口为什么必须带幂等键。重复保存相近内容会变成新版本，旧版本留档但不再出现在结果里。

教训：你纠正过的规则。越常用越可信，长期不用会降权，最后退役。

做法：在多次会话里重复出现的流程，会被整理成带触发条件的步骤。

会话摘要：每个会话一份，记录结果、改过的文件和学到的教训。

使用场景

多个助手共用：周一在 Claude Code 里修好的问题，周二在 Cursor 里问，它直接知道原因。

不用再介绍项目：用什么包管理器、怎么跑测试、哪个目录不能改，开工前就已经加载好。

接着昨天做：合上电脑时做到一半，第二天新会话知道做到哪、还有什么没定。

纠正一次就记住：比如「集成测试不要模拟数据库」，下次做类似任务前会自动提醒。

查代码为什么这样写：提交记录能关联回产生它的那次会话，看到当时的原因。

第一天就有历史：可以导入以前的会话记录，过去的经验马上能搜到。

主要功能

数据默认只存在本机，不需要账号，也不需要额外的数据库。

支持二十多种编程助手，包括 Claude Code、Cursor、Codex、Gemini CLI，以及任何支持 MCP 的客户端。

自带本地查看器：浏览记忆、回放会话、查看教训和知识图谱。

可按项目和助手隔离记忆，也可以让团队共用一台记忆服务器。

不接大模型也能用：记录、关键词检索和知识图谱都在本机完成；接上嵌入模型后有语义检索，接上大模型后有总结和提炼。

开源，Apache-2.0 协议。

和手工维护记忆的关系

我们在 在不同 AI 之间保留记忆 里讲过自己维护一份上下文文件。agentmemory 做的是同一件事的自动化版：记录、整理、检索都交给工具。项目规则这类关键内容，仍建议写进 CLAUDE.md 或 AGENTS.md，两者配合最稳。

相关商品：Claude API、Codex API。