Skip to main content
自動記憶讓代理在專案之外保留自己的持久筆記,使其能在後續工作階段回想過去的決策、修正與眉角,而不必每次重新學習。
預設停用。請至設定 > 代理 > 啟用自動記憶開啟(位於實驗性功能)。

運作方式

啟用後,每個工作階段都會在專案之外取得一個記憶目錄,位於 ~/.bricks-project-desktop/memory/
  • 專案聊天——以專案為鍵值
  • 主聊天——所有主聊天工作階段共用單一目錄
  • 工作樹聊天——與專案主要檢出共用同一個記憶目錄,因為記憶是以專案為鍵值,而非分支或工作樹資料夾。從工作樹聊天儲存的筆記,在主要檢出的聊天中也看得到,反之亦然
  • 子代理——在工作階段中產生的子代理,共用該工作階段的記憶目錄
MEMORY.md 作為索引。代理應將其保持在約 200 行以內,並將細節移至與其並存的主題檔案中。每回合開始時,MEMORY.md 的前 200 行(或 25 KB,以先達到者為準)會自動加入系統提示;當主題被提及時,代理會以 read_file 隨需讀取主題檔案。

代理會儲存什麼

代理會自行判斷哪些內容值得記住——也就是未來工作階段可能用得上、不易察覺的持久事實,例如您的修正與偏好、決策及其理由,還有得來不易的除錯心得。系統會指示代理略過機密資訊、僅限單次工作階段的暫時性細節,以及 AGENTS.mdCLAUDE.mdapplication.json 中已涵蓋的內容。 您隨時可以請代理記住或忘記某件事——它會用編輯其他檔案相同的方式,更新 MEMORY.md 與其主題檔案。

工具存取權

記憶目錄位於專案之外,因此 read_filewrite_fileedit_file 都能存取該處;記憶寫入也會略過通常套用於專案檔案的限制:
  • 不受專案沙箱的寫入限制約束
  • 不受計畫模式封鎖——即使計畫模式將其他操作限制為唯讀,代理仍可儲存記憶筆記
  • 不會觸發診斷或通知執行中的應用程式——記憶寫入對模擬器與 Config Editor 而言是無形的,如同技能檔案一樣
沙箱開啟時,記憶目錄會自動加入沙箱化的讀取與寫入許可清單,因此沙箱化工作階段無需額外設定即可正常運作。

開啟記憶資料夾

只要聊天已儲存至少一個記憶檔案,開啟記憶就會顯示在其操作選單中,點選即可在您的檔案總管中開啟記憶目錄。在目錄有內容之前,此項目會保持隱藏。

資料儲存

設定 BRICKS_PROJECT_DESKTOP_DATA_DIR 環境變數可覆蓋預設資料目錄(~/.bricks-project-desktop/),記憶根目錄也會隨之移動。