> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# 自動記憶

> 讓代理跨工作階段為每個專案自行儲存與回憶筆記

自動記憶讓代理在專案之外保留自己的持久筆記，使其能在後續工作階段回想過去的決策、修正與眉角，而不必每次重新學習。

<Info>
  預設停用。請至**設定 > 代理 > 啟用自動記憶**開啟（位於[實驗性功能](/zh-Hant/ctor/reference/settings#實驗性功能)）。
</Info>

## 運作方式

啟用後，每個工作階段都會在專案之外取得一個記憶目錄，位於 `~/.bricks-project-desktop/memory/`：

* **專案聊天**——以專案為鍵值
* **主聊天**——所有[主聊天](/zh-Hant/ctor/guide/main-chat)工作階段共用單一目錄
* **工作樹聊天**——與專案主要檢出共用同一個記憶目錄，因為記憶是以專案為鍵值，而非分支或工作樹資料夾。從工作樹聊天儲存的筆記，在主要檢出的聊天中也看得到，反之亦然
* **子代理**——在工作階段中產生的子代理，共用該工作階段的記憶目錄

`MEMORY.md` 作為索引。代理應將其保持在約 200 行以內，並將細節移至與其並存的主題檔案中。每回合開始時，`MEMORY.md` 的前 200 行（或 25 KB，以先達到者為準）會自動加入系統提示；當主題被提及時，代理會以 `read_file` 隨需讀取主題檔案。

## 代理會儲存什麼

代理會自行判斷哪些內容值得記住——也就是未來工作階段可能用得上、不易察覺的持久事實，例如您的修正與偏好、決策及其理由，還有得來不易的除錯心得。系統會指示代理略過機密資訊、僅限單次工作階段的暫時性細節，以及 `AGENTS.md`／`CLAUDE.md` 或 `application.json` 中已涵蓋的內容。

您隨時可以請代理記住或忘記某件事——它會用編輯其他檔案相同的方式，更新 `MEMORY.md` 與其主題檔案。

## 工具存取權

記憶目錄位於專案之外，因此 `read_file`、`write_file` 與 `edit_file` 都能存取該處；記憶寫入也會略過通常套用於專案檔案的限制：

* 不受專案[沙箱](/zh-Hant/ctor/reference/sandbox)的寫入限制約束
* 不受[計畫模式](/zh-Hant/ctor/reference/plan-mode)封鎖——即使計畫模式將其他操作限制為唯讀，代理仍可儲存記憶筆記
* 不會觸發診斷或通知執行中的應用程式——記憶寫入對[模擬器](/zh-Hant/ctor/reference/preview)與 Config Editor 而言是無形的，如同技能檔案一樣

[沙箱](/zh-Hant/ctor/reference/sandbox)開啟時，記憶目錄會自動加入沙箱化的讀取與寫入許可清單，因此沙箱化工作階段無需額外設定即可正常運作。

## 開啟記憶資料夾

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

## 資料儲存

| 資料   | 位置                                  |
| ---- | ----------------------------------- |
| 自動記憶 | `~/.bricks-project-desktop/memory/` |

<Tip>
  設定 `BRICKS_PROJECT_DESKTOP_DATA_DIR` 環境變數可覆蓋預設資料目錄（`~/.bricks-project-desktop/`），記憶根目錄也會隨之移動。
</Tip>