项目记忆

您的代理忘记了一切。
在这里,他们停止。

一个持久的、共享的知识库,您的 AI 编码代理在工作时自行编写。决策、架构、陷阱和惯例在会话、重启和机器中存活。

关闭会话,上下文窗口消失。项目记忆是留下的部分:为 AI 代理提供的长期记忆,按项目存储,供每个打开该代码库的代理和队友读取。没有旁边的记笔记应用,没有复制粘贴,没有每天早上重新解释您的代码库。

项目记忆
与项目共享
代理会话
代理,星期一
上下文窗口100%
工作中
项目记忆+1
架构
决策
陷阱
惯例
功能
在每个会话中存活。每个代理都能读取。

每个 AI 编码代理都有相同的漏洞。它读取您的代码库,弄清楚为什么身份验证模块是那样构建的,遇到去年的迁移陷阱,然后会话结束,所有内容都蒸发了。明天它从零开始,重新发现相同的内容,消耗相同的令牌。

您可以将其中一些内容粘贴到 CLAUDE.md 中,希望它保持最新。这适用于您已经知道的规则。它不适用于您的代理在工作时产生的知识:他们刚刚与您一起做出的决策,他们探索的死胡同,只有在凌晨两点才变得明显的构建内容。

项目记忆关闭了这个循环。您的代理将他们所学的内容写入持久知识库,使用 MCP 工具,作为正常工作的一部分。它与项目一起存在,而不是与您的帐户一起存在,因此下一个代理可以读取它,您的队友的代理也可以在他们的机器上读取。

会话遗忘症,以及它实际的成本

症状如此熟悉,以至于大多数人停止注意它们。

您重新解释相同的架构

每个新会话都以您输入相同的三段关于项目如何连接的段落开始。这是代理编码中最常重复的提示。

代理支付重新学习他们已知的内容

一个必须在采取行动之前重新阅读一半代码库的代理,花费真实的令牌和真实的时间重新发现它昨天已经掌握的知识。

同样的陷阱被触发两次

您的代理在六月遇到并修复的一个陷阱在七月是不可见的。没有记录,所以没有什么能阻止下一个代理再次走进它。

知识停留在一台机器上

您的代理所学的内容存在于您的会话中,在您的笔记本电脑上。您队友的代理对此一无所知,从头开始项目。

项目记忆为您提供的内容

为 AI 代理提供的长期记忆层,内置于这些代理已经运行的 IDE 中。

超越会话的知识

笔记按项目存储在服务器端。关闭代理,退出应用程序,重启 Mac,切换笔记本电脑:当您回来时,记忆仍然存在。

由代理编写,而不是由您编写

代理通过 memory_save MCP 工具在正常工作中保存,无需确认提示。您获得一个自我填充的知识库,而不是无人更新的文档。

与项目中的每个人共享

记忆与项目相关,而不是与您的用户帐户相关。克隆代码库,在 AgentsRoom 中打开,您可以读取您队友的代理所写的相同记忆。

五个自动生成的文件夹

架构、决策、惯例、陷阱、功能。文件夹在首次使用时创建,因此结构随着知识的出现而显现。无需设置。

默认情况下更新而不是创建

在现有名称下保存笔记会就地更新该笔记。记忆随着时间的推移而变得更深,而不是扩展到四十个近乎重复的条目。

一个真实的知识图

笔记通过 [[维基链接]] 彼此链接。图形视图绘制这些链接,按文件夹聚集笔记,并淡化那些逐渐过时的笔记,以便您可以看到您的项目实际掌握的知识。

模糊搜索所有内容

搜索同时运行在笔记名称、检索线索、完整内容和标签上,因此您可以找到您半记得的决策。

免费,无笔记限制

项目记忆不是付费附加组件,没有配额。没有单独的同步订阅可购买:记忆及其图形只是 AgentsRoom 的一部分。

您的项目填充的五个文件夹

规范结构,在首次写入时自动创建。每个主题一个笔记,每个想法一个笔记。

架构

模块的实际工作方式及其代码所在的位置。代理读取的笔记,而不是重新爬行十二个文件。

决策

每个决策一个笔记:上下文、选择及其原因。这是阻止某人在六个月后悄悄撤销它的部分。

惯例

在工作中发现的规则,而不是您事先写下的规则。命名、模式、这个代码库的做法。

陷阱

陷阱、过去的事件、再也不要这样做。一次修复的错误不应再支付第二次。

功能

每个功能的功能状态:今天发布的内容、半成品、故意遗漏的内容。

捕捉知识的三个时刻

任何知识库的难点是将任何内容写入其中。项目记忆从三个方面解决这个问题。

01

默认情况下,随时发生

AgentsRoom 中的每个代理在其系统提示中获得记忆指令:在重要结果、做出决策、遇到陷阱、理解模块、发布功能后,写下来。与保存技能或提示不同,记忆写入无需确认。这是一个正常的工作手势,因此它实际上会发生。

02

每个代理始终记忆

在任何代理上打开始终记忆切换,它会获得更严格的规则:在每个产生持久学习的回合结束时,先持久化。对生成大量知识的角色很有用,比如在重构过程中工作的架构师或映射失败模式的 QA 代理。

03

在退出时

当您关闭仍有活动会话的代理时,AgentsRoom 会询问是否先记忆。选择记忆,指令进入正在运行的会话,以便代理在您关闭标签之前写下它所学到的内容。通常丢失知识的时刻变成了保存知识的时刻。短会话会自动跳过,因为两分钟的差事不值得记忆,您可以选择不对一个代理、一个项目或所有地方进行提示。

查看您的项目所知道的内容

图形视图将记忆转变为地图而不是列表。

图形视图[[维基链接]]
架构决策陷阱
最近更新过时维基链接

每个笔记都是一个节点。文件夹形成集群。代理在笔记正文中写入的 [[维基链接]] 成为边缘,因此图形绘制出您项目知识的实际形状,而不是文件夹树。

新鲜度驱动视觉效果。最近更新的笔记更大更亮;几周未触及的笔记缩小并褪色,时间范围为六十天。过时的知识看起来过时,这正是您想要注意的时刻。单击任何节点以打开该笔记。

每个项目一个记忆,而不是每个人一个

这是大多数记忆工具搞错的部分。

大多数知识工具将一切范围限制在用户帐户:您的笔记、您的库、您的同步。这个模型在第二个人加入时就会崩溃,因为重要的知识是关于项目的,而不是关于您的。

AgentsRoom 将项目记忆与提交到代码库的项目 ID 关联。每个打开该项目的人都可以读取和写入相同的记忆。队友克隆代码库,打开它,他们的代理继承了您代理所学到的一切。无需发送邀请,无需共享库,无需导出和重新导入。

一个值得了解的后果是:访问是基于能力的。登录并拥有项目 ID 是授予访问权限的条件,因此将公共存储库的记忆视为公共,并保持机密信息的排除。

三个工具,您的代理完成其余工作

项目记忆通过 MCP 向代理公开,因此任何连接的代理 CLI 使用相同的接口。

memory_list

列出文件夹和笔记及其检索线索和内容预览。代理被告知在任何非平凡任务开始时调用它,在探索代码库之前:模块可能已经被解释。

memory_get

通过 ID 或确切名称返回一条笔记的完整 markdown 正文。名称是维基链接解析的方式,因此代理可以从一个笔记直接跟随 [[a-link]] 进入下一个。

memory_save

创建或更新笔记。同名意味着就地更新。需要一个名称、一个检索线索、markdown 正文、一个可选的文件夹和标签。

设计上与提供商无关:这些工具由 AgentsRoom MCP 服务器提供,因此您在 AgentsRoom 中运行的 Claude Code、Codex CLI 和其他代理 CLI 都读取和写入相同的项目记忆。

它是如何工作的

没有设置步骤。记忆从空开始并自行填充。

01

您的代理开始读取

从第一次会话开始,每个代理都被告知在开始深入代码之前检查项目记忆。早期它找不到任何内容,继续工作。

02

您的代理开始写入

第一个真实的决策,第一个陷阱,第一个模块的正确理解:代理保存一条笔记。文件夹在需要时出现。您可以在 Dock 中观察大脑图标上的计数上升。

03

此后的每个会话都更短

新代理以对项目的工作理解打开。您停止编写相同的三段上下文,代理停止支付令牌重新发现它已经工作过的内容。

它的价值所在

曾经存在于一个人头脑中的知识,或无处可寻。

处理客户代码库的代理

十二个客户项目,每个项目都有其独特之处。每个项目都有自己的记忆,因此在三个月后重新拾起一个项目并不意味着从提交日志中重新学习。

入职,无论是人还是代理

新开发人员克隆代码库,他们的代理已经知道架构、惯例和陷阱。记忆是入职文档,除了它是当前的,因为它是在工作发生时编写的。

无人记得的遗留代码

将代理指向陈旧的模块,让它弄清楚其功能,并将其写入架构。下一个接触它的人从解释开始,而不是从谜团开始。

代理之间的交接

PM 代理范围,开发代理构建,QA 代理验证。每个代理写下他们所学到的内容,下一个代理读取,因此链条不会在步骤之间失去线索。

记忆、技能和提示不是同一回事

AgentsRoom 保留三个库,因为它们回答三个不同的问题。

项目记忆

关于这个项目的真实情况是什么?

代理发现的事实:决策、架构、陷阱、惯例、功能状态。由代理编写,与整个项目共享,特定于此代码库。

技能库

我们如何完成这种任务?

在相关时加载的可重用程序:审查清单、迁移模式、可访问性审计。可跨项目移植并可导出到其他工具。

探索技能库

提示库

我想再次问什么?

您经常发送的指令,保存并组织,以便您停止重新输入它们。由您编写,由您发送。

探索提示库

Project Memory 是智能体记忆的一种答案,但不是唯一答案。CLAUDE.md 文件、mem0、Letta、Zep、basic-memory 以及搭配 MCP 的 Obsidian,各自解决问题的不同部分。

对比 AI 智能体记忆工具

常见问题

AgentsRoom 中的项目记忆是什么?

项目记忆是附加到项目的持久共享知识库。您的 AI 编码代理在工作时使用 memory_save MCP 工具将笔记写入其中,并使用 memory_list 和 memory_get 从中读取。笔记涵盖架构、决策、惯例、陷阱和功能状态。与代理的上下文窗口不同,后者在会话结束时被清除,记忆存储在服务器端,并在会话、重启和机器之间存活。

这与 CLAUDE.md 或 AGENTS.md 文件有什么不同?

它们是互补的。CLAUDE.md 是一个静态指令文件,您手动编写和维护:您已经知道的规则,在每个会话开始时加载。项目记忆是动态的,由代理编写:它捕捉您的代理在工作时学习的内容,逐条笔记,并在您不维护的情况下增长。实际上,CLAUDE.md 保存您的惯例和命令,而记忆保存代码库的累积理解、决策和陷阱。AgentsRoom 还允许您从 UI 编辑您的 CLAUDE.md。

我的队友是否看到相同的记忆?

是的。项目记忆与存储在代码库中的项目 ID 相关,而不是与您的用户帐户相关,因此每个在 AgentsRoom 中打开项目的人都可以读取和写入相同的记忆。您的队友克隆代码库,打开它,他们的代理继承了您代理所学到的一切。无需邀请、导出或导入。访问是基于能力的:登录并拥有项目 ID 是授予访问权限的条件,因此将公共存储库的记忆视为公共,并保持机密信息的排除。

项目记忆是免费的吗?

是的。项目记忆包含在 AgentsRoom 中,无需额外费用,并且没有笔记限制。没有单独的同步订阅,也没有知识图的付费附加组件。您需要登录,因为记忆存储在服务器端,以便可以在项目的用户之间共享。

哪些 AI 代理可以使用项目记忆?

您在 AgentsRoom 内运行的所有代理 CLI。记忆工具由 AgentsRoom MCP 服务器提供,而不是绑定到一个供应商,因此 Claude Code、Codex CLI 和其他支持的 CLI 都读取和写入相同的笔记。这就是将记忆放在 IDE 中而不是一个提供商内部的意义:切换代理不会丢失您项目的累积知识。

我必须告诉代理保存内容吗?

不,尽管您可以。每个代理在其系统提示中获得记忆指令,并在重要结果后自行保存,无需确认提示。除此之外,您可以为特定代理开启始终记忆,这使其在每个产生学习的回合结束时持久化,并且当您关闭具有活动会话的代理时,AgentsRoom 会提供在您关闭标签之前让其记忆会话的选项。

我可以自己读取和编辑记忆吗?

可以。Dock 中的大脑图标打开记忆,徽章显示现有笔记的数量。您可以获得一个文件夹侧边栏,模糊搜索名称、线索、正文和标签,并且有一个完整的编辑器来创建、重命名、复制或删除笔记,并在文件夹之间移动它们。还有一个图形视图,将笔记绘制为节点,维基链接绘制为边缘,并淡化逐渐过时的笔记。

项目记忆可以离线工作吗?

部分可以。桌面应用程序在项目文件夹中保留记忆的本地缓存,因此 AgentsRoom UI 在没有连接的情况下仍然可以显示您的笔记。代理的记忆工具在每次调用时都需要与服务器通信,因此代理需要连接才能读取或写入。缓存文件被 gitignore,因此它不会污染您的代码库。

什么不应该放入项目记忆中?

机密信息、凭证、令牌和机器特定路径。代理收到的工具描述明确禁止存储它们,您在手动编写笔记时也应遵循相同的规则。记忆是关于项目的提炼、持久知识:决策及其原因、模块如何工作、应避免的陷阱、有效的惯例。会话闲聊和一次性细节不属于其中。

我可以关闭项目记忆吗?

可以,在多个层面上。记忆默认开启,项目的代理默认中有一个切换可以将其关闭:关闭代理时没有记忆提示,系统提示中没有记忆指令,代理被告知记忆工具不可用。您还可以保持记忆开启,但仅对关闭提示进行静音,适用于一个代理、一个项目或全局。当您关闭它时,没有内容被删除,因此重新打开时会恢复您已经拥有的笔记。

您可能还喜欢

停止重新解释您的代码库

下载 AgentsRoom,让您的代理开始记忆。免费,无笔记限制。

免费下载 AgentsRoom

配套应用:随时随地监控你的 Agent

使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。

获取扩展
Chrome Web Store

把 Bug 和需求直接发送到您的公开待办清单。

AgentsRoom 实际运行一瞥。

多项目管理
多供应商
多代理运行
实时状态
文件差异与提交
移动应用
实时预览
代理团队
浏览器自动化
Backlog 驱动开发
提示词库
技能库
查看所有功能