AI 記憶庫的使用
MBAgent 的 AI 記憶庫（Memory Bank）是一個本地持久化的記憶體系統，能讓 AI 跨會話記住關鍵信息，避免每次對話都從零開始。
NOTE
截圖說明：本篇已為記憶庫面板、寫入等環節配圖。
一、什麼是 AI 記憶庫？
AI 記憶庫是 MBAgent 在本地磁盤上維護的一組結構化文本，AI 在每次新會話開始時都會自動加載，作為長期記憶與上下文背景。
與普通會話歷史不同：
- 會話歷史：屬於某次具體對話，會話結束後歸檔
- 記憶庫：跨會話保留，主動維護，由 AI 自動或用戶手動管理
二、為什麼需要記憶庫？
場景示例
沒有記憶庫時：
你：我家在北京海淀區
AI：好的，記下了（但關閉後就忘了）
（第二天新會話）
你：推薦海淀區附近的餐廳
AI：請問您在哪個城市？有了記憶庫後：
（第一天）
你：我家在北京海淀區
AI：好的，我會記住 → 自動寫入記憶庫
（第二天新會話）
你：推薦海淀區附近的餐廳
AI：根據您之前的記錄，您住在海淀區。為您推薦：xxx、xxx...三、記憶分類
MBAgent 把記憶分成 5 大類：
1. 用戶偏好（user_preferences）
記錄用戶的個人偏好，例如：
- "用戶是 90 後，母語普通話"
- "用戶偏愛簡潔的表達"
- "用戶不喜歡被叫'親'"
2. 項目上下文（project_context）
與當前進行中的項目相關，例如：
- "正在做候鳥瀏覽器的 VitePress 官網"
- "項目技術棧：Vue 3 + VitePress"
- "文檔使用 9 種語言"
3. 事實記錄（facts）
客觀的事實信息，例如：
- "用戶家住北京海淀區"
- "用戶公司叫 XXX"
- "用戶養了一隻柴犬叫豆豆"
4. 注意事項（notes）
需要長期留意的提醒，例如：
- "用戶對花生過敏"
- "用戶在進行低碳水飲食"
- "用戶下週三有客戶拜訪"
5. 工具與流程（workflows）
用戶的工作流程偏好，例如：
- "用戶喜歡用 markdown 表格整理信息"
- "用戶寫代碼時習慣加詳細中文注釋"
四、優先級
每條記憶都有優先級，AI 在加載時會優先使用高優先級的記憶。
優先級等級
| 等級 | 含義 | 適用場景 |
|---|---|---|
| critical | 必須遵循，否則可能出錯 | 過敏信息、安全限制 |
| high | 重要，通常要遵循 | 用戶核心偏好、長期項目背景 |
| medium | 一般 | 工作流程偏好 |
| low | 補充信息 | 個人趣味、性格特徵 |
優先級的使用
當記憶與用戶當下指令衝突時：
- 先看 critical（如有安全相關）
- 再看 high（重要偏好）
- 再看當下指令
- 衝突時 AI 會主動告知用戶
五、記憶的寫入
AI 自動寫入
當 AI 在對話中發現值得記住的信息時，會自動調用 write_memory 工具寫入。
觸發自動寫入的典型情況
| 場景 | AI 自動寫入的內容 |
|---|---|
| 用戶明確說"記住..." | 對應的內容 |
| 用戶透露個人信息 | 歸類為 facts 或 user_preferences |
| 用戶表達偏好 | 歸類為 user_preferences |
| 開始一個新項目 | 歸類為 project_context |
| 用戶介紹工作流程 | 歸類為 workflows |
自動寫入的展示
AI 在回覆中會告知您：
好的，我已記住「您家住北京海淀區」，已寫入 facts 類別。用戶手動寫入
方式一：直接在記憶庫面板裡添加
- 點擊聊天標籤頁右上角的 "AI 記憶庫" 按鈕
- 選擇 "新增記憶"
- 填寫：
- 類別（下拉選擇）
- 內容（自由文本）
- 優先級（下拉選擇）
- 保存
方式二：在對話中讓 AI 記住
請記住：我下週三要去上海出差，記得提醒我帶充電器。AI 會自動調用 write_memory。
六、記憶的查看
在 AI 記憶庫面板查看
點擊聊天標籤頁右上角的 "AI 記憶庫" 按鈕，打開面板，可以看到：
- 全部記憶列表：按優先級、類別排序
- 搜索框：按關鍵詞檢索
- 篩選：按類別、優先級篩選
在會話裡查看
在新會話開始時，AI 會把高優先級記憶摘要放在開頭，您可以看到 AI 已經記住了什麼。
七、記憶的編輯與刪除
編輯單條記憶
- 在記憶庫面板找到要修改的條目
- 點擊 "編輯"
- 修改內容、優先級
- 保存
刪除單條記憶
- 找到要刪除的條目
- 點擊 "刪除"
- 確認刪除
批量操作
- 批量導出：把所有記憶導出為 JSON 文件
- 批量導入：從 JSON 文件導入
- 清空所有：慎用，會清空全部記憶
WARNING
清空前請備份。一旦清空，AI 會忘記所有長期信息。
八、AI 對話中如何使用記憶庫
自動加載
新會話開始時，AI 會自動加載高優先級記憶（critical + high）作為上下文。
主動調用
AI 可以通過 read_memory 工具在會話中隨時查詢記憶庫。
主動告知
當用戶指令與已有記憶衝突時，AI 會：
⚠️ 提醒：您之前提到「不喜歡被叫親」，這次回覆我會注意。九、隱私與安全
IMPORTANT
記憶完全本地存儲：
- 記憶文件存儲在
%LOCALAPPDATA%\mbagent\memory\目錄 - 不會上傳到任何服務器
- 卸載 MBAgent 時自動清除
- 建議敏感信息用本地變量管理，不要寫入記憶庫
十、進階玩法
玩法一：項目背景包
把項目所有相關信息寫入記憶庫，AI 在整個項目週期內都能記住：
- 技術棧
- 代碼規範
- 部署流程
- 已知問題
玩法二：客戶檔案
為每個客戶建立記憶分類：
- 公司信息
- 過往對話重點
- 偏好風格
- 注意事項
玩法三：學習筆記
把您正在學習的知識要點寫入，AI 在您提問時會結合：
你在學 Rust，所有相關問題 AI 會以初學者能理解的方式回答玩法四：個人知識圖譜
把您感興趣的領域和已掌握的技能寫入，AI 在推薦時會結合您的背景。
十一、常見問題
Q1：記憶太多會不會拖慢 AI？
A：MBAgent 會智能加載高優先級記憶，不會全部塞進上下文。低優先級記憶只在相關時被檢索。
Q2：AI 寫入的記憶不準確怎麼辦？
A：直接編輯該條記憶，AI 在後續會使用修正後的版本。
Q3：不同 AI 助手（候鳥、新必應等）之間記憶通用嗎？
A：目前記憶庫是 MBAgent 內部的，不同助手暫不共享。
Q4：刪除會話會影響記憶庫嗎？
A：不會。會話是會話，記憶是記憶，刪除會話不會清除記憶。
Q5：可以設置某條記憶的有效期嗎？
A：目前不支持有效期，可手動編輯或刪除。
下一步：瀏覽器控制權管理 → 把候鳥瀏覽器交給 AI 操作。