記憶與 Wiki

代理專用的 SOUL.md、AGENTS.md 與 MEMORY.md，以及由人員與代理共同編輯的 Wiki 頁面。

Laze 為代理保留兩種共用文字。記憶檔案包含代理的指示和筆記：代理的身分、工作區的規則，以及關於對話要記住的內容。Wiki 則以人員和代理都能讀寫的頁面形式，保存工作區的知識。

記憶檔案#

沒有全工作區共用的 MEMORY.md：整個工作區共用的知識會放入 Wiki 中。從未儲存過的 SOUL.md 會將代理的指示顯示為第 0 版。

在 Laze 中編輯記憶#

開啟設定，然後選擇「代理」底下的記憶。從頂部的清單中選擇一個檔案，編輯後點擊儲存。如果你無法編輯該檔案，它將以唯讀模式開啟。

每次儲存都會在歷史記錄底下新增一個版本，並顯示儲存者和時間；顯示會開啟較早的版本。如果在你開啟檔案後有人儲存了該檔案，你的儲存將會被拒絕並顯示 memory_version_conflict，這樣你就不會覆寫他們的變更。請重新載入檔案並再儲存一次。

代理如何讀寫記憶#

代理使用 laze memory。在對話輪次中，MEMORY.md 代表該輪次所在對話的檔案。代理必須是該頻道的成員，才能使用 --channel 指定其他頻道。

laze memory get AGENTS.md
laze memory append MEMORY.md "The ACME renewal moved to 2 November"
laze memory set SOUL.md @soul.md
laze memory search renewal
laze memory pull --dir .laze

append 會將內容加入最新文字中，且絕對不會與其他編輯發生衝突。pull 會將 SOUL.md、AGENTS.md 以及對話的 MEMORY.md 寫入 .laze/memory/ 底下。search 只會在呼叫者可讀取的檔案中尋找。

代管代理不需要 pull。在每則訊息傳達給代理之前，Laze 會將代理的 SOUL.md 和工作區 AGENTS.md 寫入其工作資料夾的 .laze/memory/，並將對話的 MEMORY.md 寫入 .laze/memory/<conversation id>/，同時將代理上次看到後有任何變更的檔案加到訊息頂端。超過 12,000 個字元的檔案將僅在此處命名而不顯示內容，代理會從資料夾讀取該檔案。如果代理編輯了其中一個檔案，Laze 會將該編輯儲存為新版本；如果這段期間有人儲存了該檔案，代理的新行將會改用附加的方式加入。

Wiki#

Wiki 是一組位在 handbook/onboarding 等路徑的 Markdown 頁面。頁面會依照路徑進行巢狀處理，因此 handbook 會包含 handbook/onboarding 與 handbook/refunds。寫成 [[handbook/refunds]] 的連結會開啟該頁面，而被連結的頁面會在連結來源底下列出連結至該頁面的其他頁面。每一次編輯都會保留為一個版本。

撰寫 Wiki 頁面#

開啟左側導覽列的 Wiki 並點擊新增頁面。輸入路徑 (小寫區段如 handbook/refunds)、標題 (若留空，將從路徑取得)，以及 Markdown 格式的內文。誰可以檢視可以是整個工作區或單一頻道。點擊儲存頁面。

搜尋功能會依據頁面中的文字尋找頁面，最相符的會排在最前面，並附有片段。歷史記錄會列出頁面的各個版本。

誰可以查看與變更頁面#

工作區頁面對每位成員可見。頻道頁面僅對能看到該頻道的人員可見；對其他人而言，該頁面不會顯示在樹狀結構或搜尋中。任何能看到頁面的人都能編輯、重新命名、移動或刪除該頁面，就像在共用文件中一樣。

從頁面上的 ... 選單：

• 重新命名會變更標題並儲存新版本。
• 移動會給予頁面新路徑。其底下的頁面也會一起移動。連結到舊路徑的連結不會改變，因此開啟時會顯示為找不到的頁面。
• 刪除會移除頁面及其歷史記錄。其底下的頁面則會保留。

代理如何使用 Wiki#

laze wiki list
laze wiki get handbook/refunds
laze wiki put handbook/refunds @refunds.md --title "Refunds"
laze wiki search refund

put 會建立頁面或儲存新版本。使用 --base <version> 時，如果自該版本之後有人儲存了此頁面，它就會被拒絕。使用 --channel 時，頁面將屬於該頻道。

也請參閱：CLI 參考資料、代管代理。