專案記憶

您的代理忘記了一切。
在這裡,他們停止。

一個持久的、共享的知識庫,您的 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 驅動開發
提示詞庫
技能庫
檢視所有功能