記憶與知識庫使用說明

AI 員工會自己記住東西，也可以照你的吩咐把知識整理成頁面。這兩件事在儀表板的「記憶與知識」同一頁，但底層是兩套不同的系統，用法和時機都不一樣。這一頁把完整用法講清楚。

一句話分辨：

記憶：它自己記下來的。你不用開口，實質對話會自動萃取重點存進去。
知識庫：整份留下來的文件。你貼章程、SOP、規格書這類長期參考資料時，它會自動整理成一頁；你也可以直接說「記到知識庫」明確指定。知識庫就是 wiki，同一個東西。

一、兩者差在哪

	記憶	知識庫（wiki）
怎麼進去	自動累積，不用交代	貼章程／流程／規格這類文件時自動建檔；也可以明講「寫到知識庫」
存成什麼	一條一條的事實	一頁一頁的 Markdown 文件
分類方式	系統自動歸類主題	目錄（資料夾）＋你給的頁面路徑
舊資訊怎麼辦	同一件事有新版本會自動接替，保留歷史	覆寫整頁；自動建檔的頁面會在頁尾留一行版本紀錄（見 2.4），手動寫入的頁面沒有
什麼時候被想起	三類自動帶入，其餘要它主動查	L0/L1 每次自動帶入，L2/L3 要它主動搜尋
誰能看到	只有這位 AI 員工自己	個人知識庫只有自己；共享知識庫全公司可讀
適合放什麼	對話中冒出來的零散事實、偏好、決策	退貨規則、報價流程、產品規格這類要長期查閱的內容

挑選原則很簡單：要能查、要能改、要給別人看的，寫知識庫；其他讓它自己記就好。

二、知識庫怎麼用

2.1 建立頁面：在對話裡直接講

不需要進儀表板編輯，也不需要記語法。在任何接通的頻道（LINE／Telegram／Discord／Slack／網頁對話）對 AI 員工說：

幫我把退貨規則記到知識庫：七天內未拆封可退，運費由買方負擔。

今天查到的三篇論文重點整理成一頁放知識庫，標題叫「RAG 檢索方法比較」。

它會建立一頁 Markdown，自動更新索引 _index.md，並在 _log.md 留一筆操作紀錄。

沒說「知識庫」會怎樣？ 看內容。你貼的如果是章程、標準作業程序、規格書、政策辦法這類長期參考資料，它會自己判斷並建檔（見 2.4）；一般對話、提問、當下的交代則只會以記憶的形式存在。判斷偏保守：它寧可漏建一頁讓你補一句，也不會把閒聊寫成文件。明講「記到知識庫」永遠有效，這條路沒有變。

2.2 分類：目錄由它自動選，你也可以指定

每個知識庫預設有四個目錄，AI 員工寫入時依內容自己挑：

目錄	放什麼	例子
`entities/`	人、公司、產品、客戶	`entities/wang-ming.md`
`concepts/`	領域概念、流程、原則	`concepts/return-policy.md`
`sources/`	原始資料的摘要	`sources/2026-07-30-rag-papers.md`
`synthesis/`	跨主題的分析、比較、趨勢	`synthesis/vendor-comparison.md`

想指定就直接說：「放在 concepts/ 底下，檔名叫 return-policy」。沒指定時它按上表歸類，檔名用 kebab-case。

2.3 層級：決定這頁「多常被想起」

每一頁的 YAML frontmatter 有一個 layer 欄位，這是知識庫最關鍵的設定：

層級	值	行為
L0 身分	`identity`	每次對話都自動帶入
L1 核心	`core`	每次對話都自動帶入
L2 情境	`context`	不自動帶入，搜尋才會用到
L3 深層	`deep`	不自動帶入，搜尋才會用到（預設值）

沒寫 layer 的頁面一律當 L3。所以一頁「寫進去了但它好像沒在用」的知識，多半就是停在 L3。要它每次都記得，在對話裡說「把這頁設成核心層」或「layer 設 core」。

同一頁還有 trust（0.0–1.0 信任分數），搜尋排序會依信任分數加權，人工審核過的內容排前面。

2.4 自動建檔：不用開口的那條路

貼一份文件進來、AI 回一句「好的我記下來了」，這種情況以前什麼都不會留下。現在它會先判斷這段文字是不是長期參考資料，是的話自動整理成一頁。

判斷依據（都符合才會建檔，門檻刻意設高）：文件性名詞（章程、辦法、規範、SOP、規格書、手冊…）、條號或編號結構、足夠的長度、標題行。反過來，第一人稱偏好（「我喜歡…」）、時效性交代（「明天提醒我…」）、連續提問都會扣分，不會被當成文件。

自動建檔的頁面放在哪：你自己這位 AI 員工的知識庫，auto/ 底下依類型分五個資料夾：章程 auto/charter/、流程 auto/sop/、規格 auto/spec/、政策 auto/policy/、其他 auto/reference/。你手動整理的目錄（entities/、concepts/、sources/、synthesis/）自動建檔永遠不會碰。

自動頁跟你確認過的頁不一樣：

頁面開頭有一段提示，說明這頁是自動整理、未經人工確認。
內容逐字保留原文，不會被改寫（章程、合約這類文字失真的代價太高）。
不會自動帶入對話。自動頁停在 L2 情境層，AI 要主動搜尋才看得到。所以就算它判斷錯了，也不會污染每一次回答。
搜尋排序權重比人工頁低很多。

同一份文件貼第二次會更新同一頁，不會長出第二頁，頁尾的「版本紀錄」會多一行。

在哪裡管理：儀表板「記憶與知識 → 策展台 → 自動建檔」。每一頁可以：

動作	效果
檢視	看整頁內容與版本紀錄
確認為正式知識	這頁升級成你核可的內容，開始每次自動帶入對話
分享到共享知識庫	複製一份到共享區，其他 AI 員工也讀得到
移除	這頁從知識庫消失，收進封存區可還原

想整個關掉自動建檔：在該 AI 員工的知識庫目錄放一個 .scope.toml，宣告 [namespaces.auto] mode = "operator_only"，之後就只有你手動寫得進去。

2.5 個人知識庫與共享知識庫

個人知識庫：~/.duduclaw/agents/<員工>/wiki/，只有這位 AI 員工讀得到。
共享知識庫：~/.duduclaw/shared/wiki/，全公司的 AI 員工都讀得到。公司規章、共用 SOP、產品規格放這裡。

要寫到共享區就明說：「這條放共享知識庫，讓大家都看得到。」

個人版只有一個知識庫，儀表板上不會出現「個人／共享」的分頁切換。

三、什麼時候會取用知識庫

這是最容易誤會的一段。取用分兩種路徑：

自動帶入（L0 + L1）：每次對話開始前，系統會把身分層和核心層的頁面依當前問題的相關度排序，在 6 KB 預算內塞進系統提示。同一個對話 session 內，選中的頁面會固定 15 分鐘不換，這樣才吃得到 prompt 快取。你什麼都不用做。

主動搜尋（L2 + L3）：其餘頁面要 AI 員工自己判斷「這題該查知識庫」，呼叫搜尋工具找出來。搜尋是全文檢索，依信任分數與來源類型加權排序。

所以要不要主動提醒？ 一般不用。L0/L1 的內容它每次都看得到；L2/L3 的內容，只要問題裡有關鍵字，它通常會自己去查。

有兩種情況值得補一句：

它答錯或答得含糊，而你確定知識庫裡有正確答案 → 說「查一下知識庫再回答」。
問題用詞和頁面用詞差很遠（例如頁面寫「退貨政策」，你問「東西不想要了怎麼辦」）→ 直接提頁面名稱最快。

四、記憶怎麼用

4.1 它會自動記什麼

來源	記什麼	儀表板分類
對話蒸餾	實質對話中的事實、決定、偏好	依內容歸到工作／客戶／偏好等
關鍵事實	跨對話重複出現的重點	觀察洞察分頁
學習訊號	預期與實際落差（它答得好不好）	學習訊號
使用足跡	你的應用程式使用時長與活躍時段（需開啟）	使用足跡
錯誤歸納	同類錯誤累積後歸納出的規則	規則與決策

不會記的：打招呼、「好」「收到」這類簡短確認、沒有實質內容的閒聊。系統有一層零成本的分類器先擋掉。

重複的也不會再記一次（v1.53 起）：語意層的新寫入會先跟既有記憶比對相似度，內容幾乎一樣的會被擋下並記錄一筆遙測，避免同一件事累積成幾十條近似記憶稀釋檢索品質。既有記憶的正常更新（改口取代舊說法、再次確認）不受影響；你在儀表板手動整理的記憶也不經過這道閘。想關掉可在 config.toml 設 [memory] novelty_gate = false（預設開啟）。

4.2 什麼時候會被想起

三段內容每次對話自動帶入系統提示：

關於你的關鍵事實（私人對話才帶，群組共用的 session 會擋掉，避免把個人資訊帶進公開場合）
過去犯過的錯（未解決的同類錯誤）
學到的規則（從錯誤歸納出來、通過驗證期的規則，最多三條。v1.53 起，只有附帶實際執行證據的錯誤紀錄才會參與歸納——AI 員工「自己說自己錯了」但查無對應工具紀錄的，不會被拿來產生規則）

其餘記憶要 AI 員工自己判斷需要並執行搜尋。檢索排序同時看相關度、重要性與「多久沒被想起」，常被回想的記憶會活得更久。

4.3 記憶會自己更新

同一個主題有新說法時，舊的那條會被標記為「已被取代」，新的接上去。展開任何一條記憶可以看到完整的取代鏈，也可以查「某個時間點當時的答案是什麼」。所以改口不需要先刪舊的，直接講新的就行。

4.4 刪除記憶

在記憶清單上把滑鼠移到任何一條，右邊會出現垃圾桶圖示，點兩下（第二下是確認）就刪掉。刪掉的記憶立刻從搜尋、瀏覽和對話帶入中消失。

底層是軟刪除：資料會移到封存表，管理者仍可從資料庫救回，超過保留期才真正清除。

五、該用哪個？

你想做的事	做法
讓它記住我喜歡簡短回覆	直接講，會自動進記憶
建立退貨政策讓它每次都照著回	寫知識庫，並設 `layer: core`
整理今天查到的論文重點	寫知識庫，放 `sources/`
全公司 AI 員工都要遵守的規章	寫共享知識庫
修正它記錯的事	直接講新的，舊的會自動被取代
移除一條錯誤記憶	記憶頁滑鼠移過去點垃圾桶
讓它忘記整份知識	到知識庫刪除那一頁
貼一份公司章程讓它以後查得到	直接貼，會自動建檔；在策展台確認為正式知識後每次都會帶入
移除一頁自動建檔的內容	策展台 → 自動建檔 → 移除

六、常見問題

Q：知識庫跟 wiki 是不同東西嗎？ 同一個東西。介面上叫「知識庫」，底層檔案結構與 MCP 工具名稱沿用 wiki。

Q：要跟 AI 員工說「寫到知識庫」嗎？ 貼章程、SOP、規格書這類文件時不用，它會自己建檔（見 2.4）。其他情況要說。判斷不確定時它偏向不建檔，所以想確保留下頁面，明講一句最快。

Q：知識庫可以分類嗎？還是它會自動分類？ 兩者都成立。四個預設目錄由它依內容自動選，你也可以指定路徑。層級（L0–L3）預設是 L3，要調就明講。

Q：什麼狀況下會取用知識庫？要主動提醒嗎？ L0/L1 每次自動帶入，L2/L3 靠它主動搜尋。一般不用提醒；答錯或用詞落差大時，說一句「查一下知識庫」最有效。

Q：記憶跟知識庫的內容重複了怎麼辦？ 知識庫優先。系統帶入時會比對，已經出現在知識庫頁面裡的事實不會再從記憶重複帶一次。

Q：記憶會無限成長嗎？ 不會。長期沒被回想、重要性低的記憶會逐步封存；被頻繁引用的會留下來。