記憶管理
概述
記憶管理頁面用於檢視和維護帳戶級記憶。帳戶級記憶跨組織共享，綁定到個人使用者 —— 你在不同組織登入同一帳戶，記憶都會跟著你。
Agent 新建對話時會自動查詢帳戶記憶，以「使用者概況」的形式注入 system prompt。這讓 Agent 真正「認識你」。
兩種檢視
| 檢視 | 說明 |
|---|---|
| 列表 | 分頁瀏覽所有記憶條目 + 搜尋 + 編輯 / 刪除 / 清空 |
| 圖譜 | 力導向圖視覺化，展示記憶之間的關聯網路 |
切換檢視：頁面頂部有 列表 / 圖譜 Tab。
列表檢視
記憶條目
每條記憶以卡片形式展示：
| 欄位 | 說明 |
|---|---|
| 文字內容 | 記憶的核心資訊（如「使用者偏好 TypeScript」） |
| 信賴度 | 提取時的信賴度分數（0 ~ 1） |
| 中繼資料 | 附加資訊（來源工作階段 ID、提取時間等） |
操作
| 操作 | 說明 |
|---|---|
| 搜尋 | 按關鍵詞過濾記憶列表 |
| 手動新增 | 輸入新的記憶條目 |
| 編輯 | 修改已有記憶內容 |
| 刪除 | 移除單條記憶 |
| 清空全部 | 一鍵清除所有帳戶級記憶（⚠️ 不可復原） |
分頁
- 預設每頁 50 條
- 初始載入 50 條 + 圖譜資料
- 底部
載入更多追加下一頁
圖譜檢視
切換到圖譜檢視可以視覺化記憶之間的關係網路：
節點類型
| 類型 | 顏色 | 說明 |
|---|---|---|
| Hub（中心） | 紫色 #6d28d9 |
使用者中心節點 |
| Fact（事實） | 藍色 #2563eb |
單條記憶條目 |
| Entity（實體） | 琥珀色 #f59e0b |
從記憶中提取的實體 |
連線類型
| 類型 | 樣式 | 說明 |
|---|---|---|
| 階層關係 | 灰色連線 | Fact → Hub，Entity → Hub |
| 關聯關係 | 琥珀色連線 | Entity ↔ Entity 交叉關聯 |
互動
- 點擊節點：檢視詳情，支援編輯 / 刪除
- 懸停節點：顯示完整文字
- 拖曳：調整節點位置
- 縮放：滾輪縮放檢視
- 摺疊模式：超過 100 條記憶時，中心節點顯示計數標籤（如 "128 條記憶"）而非所有事實節點
圖譜渲染最佳化（2026-04 更新）NEW
新版圖譜引入了雙密度門機制，避免節點過多時標籤重疊導致不可讀：
| 閾值常數 | 值 | 含義 |
|---|---|---|
PILL_READABILITY_MIN_SCALE |
1.5 | 縮放比例小於 1.5x 時不渲染文字標籤 |
PILL_MIN_SCREEN_AREA_PER_NODE |
3000 | 每個節點平均佔螢幕面積少於 3000 像素時不渲染文字標籤 |
兩個條件同時滿足才渲染標籤。未達到時只顯示圓點，保持視覺清晰。
實體類型顏色穩定化：所有 Entity 節點的顏色透過 djb2 hash 計算 —— 同一類型實體在不同檢視、不同時間都保持同一顏色，便於視覺辨認。10 色調色盤支援無限類型循環。
實體類型欄位修復：sourceTypes 和 targetTypes 欄位現已正確傳遞到前端圖譜，之前因遺失導致所有節點都回退到灰色的 Bug 已修復。
記憶寫入方式
手動新增
在列表檢視點擊「新增」按鈕，輸入記憶文字儲存。
對話自動提取
Agent 在對話中自動偵測值得記住的資訊並儲存：
| 觸發方式 | 範例 | 信賴度 |
|---|---|---|
| 顯式命令 | "記住我喜歡用 TypeScript" | 0.99 |
| 隱式偵測 | "我叫張三，是前端開發" | 0.93 |
詳細的提取機制請參考 三維記憶系統。
記憶在對話中的作用
- 新建對話：系統查詢帳戶級記憶概況，以「使用者概況」形式注入 system prompt
- 對話中提問：Agent 根據使用者問題語義查詢相關記憶（memory_query 工具）
- 記憶更新：新的對話資訊可能觸發已有記憶的更新或合併
跨帳號 Gateway 隔離 NEW
為保證隱私，跨帳號 Gateway 派發的工作階段不會存取到你的帳戶記憶：
- 當你的節點設為 enterprise 被同組織其他帳號呼叫時，執行過程無法讀取你的帳戶記憶
- 只有企業記憶（組織級）可被跨帳號工作階段存取
- 本機自己的工作階段不受影響
詳見 多節點架構 — 跨帳號隔離。
操作指南
如何手動新增記憶
- 開啟 APP → 設定 → 記憶
- 在列表檢視中，點擊 新增 按鈕
- 輸入你希望 Agent 記住的資訊，例如：「我偏好使用 TypeScript 撰寫程式碼」
- 儲存
效果：下次新建對話時，Agent 會知道你偏好 TypeScript，在涉及程式碼的回覆中自動使用 TypeScript。
如何檢視記憶圖譜
- 在記憶管理頁面，切換到圖譜檢視
- 中間的紫色大圓是你的使用者中心節點
- 藍色節點是記憶條目（如「喜歡 TypeScript」），透過灰色連線連接到中心
- 琥珀色節點是提取的實體（如「TypeScript」、「React」），實體之間用琥珀色連線表示關聯
- 操作：
- 點擊任意節點檢視詳情，可編輯或刪除
- 拖曳節點調整位置
- 滾輪縮放檢視
- 懸停節點檢視完整文字
如何清空記憶
- 在記憶管理頁面，點擊 清空全部 按鈕
- 確認清空操作
注意：清空操作不可復原。清空後，Agent 在未來的對話中不再知道你的任何偏好、背景和歷史資訊。Agent 會像第一次見面一樣與你交流。只有在確實需要「重新開始」時才使用此功能。
記憶對對話品質的影響
| 記憶狀態 | 對話體驗 |
|---|---|
| 記憶豐富且準確 | Agent 了解你的身分、偏好、專案背景，回覆個人化且精準 |
| 記憶為空 | Agent 像初次見面，每次都需要你重新解釋背景和偏好 |
| 記憶過時或錯誤 | Agent 可能基於錯誤資訊給出不合適的建議 |
| 記憶過多 | 注入到對話的記憶概況變長，可能佔用上下文空間 |
建議：定期（如每月一次）瀏覽記憶列表，刪除過時或不再準確的條目。保持記憶精簡且準確是獲得最佳對話體驗的關鍵。
自動提取 vs 手動新增
| 對比 | 自動提取 | 手動新增 |
|---|---|---|
| 觸發方式 | Agent 在對話中自動偵測 | 你在記憶管理頁面手動輸入 |
| 準確性 | 取決於信賴度閾值，可能遺漏或誤提取 | 完全由你控制，100% 準確 |
| 適用場景 | 日常對話中自然累積 | 希望 Agent 記住特定資訊（如專案規範） |
提示：兩種方式可以結合使用。讓自動提取處理日常資訊，對於重要的專案規範和工作偏好，建議手動新增以確保準確。
常見問題
為什麼 Agent 沒有記住我說的話？
可能的原因：
- 信賴度不夠：資訊不夠「像需要記住的事實」。嘗試更明確地表達：「請記住，我喜歡用深色主題。」
- 被排除規則過濾：純提問、閒聊、程式碼區塊中的內容、時效性資訊（如「今天天氣」）不會被提取。
- 記憶提取延遲：每輪對話結束後才提取記憶，如果對話被中斷，可能未完成提取。
為什麼 Agent 基於錯誤的記憶回答？
你可能有過時的記憶條目。解決方法：
- 開啟記憶管理，搜尋相關記憶
- 找到錯誤的條目，點擊編輯更正或刪除
- 也可以在對話中說「忘掉我之前說喜歡 Python，我現在用 TypeScript」
記憶佔多少上下文空間？
系統在新建對話時會將記憶以概況形式注入 system prompt，通常佔 200-1000 tokens（取決於記憶數量）。相對於 128K-200K 的上下文視窗，佔比很小，不會顯著影響可用空間。
相關文件
- 三維記憶系統 — 記憶系統技術詳解（含企業級和工作階段級）
- 進階設定 — 企業記憶 — 企業級記憶管理（管理員）
- 多節點架構 — 跨帳號 Gateway 隔離