SuperLocalMemory：讓 AI 代理跨工作階段保留記憶

白話介紹：SuperLocalMemory 是做什麼的？

SuperLocalMemory 是 Qualixar 推出的開源 AI 代理記憶工具。可以把它想成一本「助手能夠查詢與更新的專案筆記」：今天記錄的技術決策、工作規則或偏好，下次開啟工作階段時仍可找回，減少一再交代背景的時間。

它負責保存、檢索、修正與管理這些資料，適合長期使用 AI 開發工具、經常切換編輯器，或希望自行掌握專案知識的使用者。仍需安裝並設定支援的客戶端，讓助手實際呼叫記憶工具。

讓專案決策跨工作階段保留下來

記憶可依事實、決策、規則及操作方法等類型整理。搜尋綜合語意、關鍵字、時間與關聯，並能透過專案或記憶類型篩選，協助找到目前工作需要的資訊。

當設定改變時，可以以新紀錄取代舊資訊，同時保留歷史。經審閱的修正可還原；時間查詢還能分辨事件發生的時間與系統得知的時間。這適合維護持續變動的專案知識，但搜尋分數不是事實正確率。

先完成一次記憶儲存與查詢

官方安裝指南列出 npm 路徑需要 Node.js 18+ 與 npm 9+；採用 pipx 或 uv 時，支援 Python 3.12–3.14。

1. 執行 npm install -g superlocalmemory 安裝套件。
2. 執行 slm setup，初次使用可選 Mode A。
3. 儲存不含敏感資料的測試內容，例如 slm remember "測試資料庫使用連接埠 5434。"。
4. 以 slm recall "測試資料庫使用哪個連接埠？" 搜尋，核對回傳紀錄。
5. 用 slm status 查看狀態，再依編輯器設定，例如 slm connect cursor。

確認這個小流程可用後，再加入自動擷取。不同客戶端的外掛、hooks 與 MCP 設定方式不盡相同，不能把某一套步驟直接當作所有工具的設定。

決定資料留在本機還是交給外部模型

Mode A 使用本機嵌入模型，核心儲存與搜尋不需生成式模型服務商。首次安裝的相依套件與模型仍需準備。Mode B 透過 Ollama 或相容端點增加語言模型處理能力，只有端點位於本機時才是本機處理。Mode C 可將問題與記憶文字交給所設定的服務商。

請參閱模式與網路邊界比較。本機資料庫不會讓雲端助手的推論也自動留在電腦上。角色、工作區、保留政策與稽核紀錄屬於資料管理能力，不能當作法律合規認證。

用答案檢查與文件搜尋補足工作流程

答案檢查會判斷找到的記憶是否足以回答問題，而非只看文字是否相似。Laya 在 Apple Silicon 上執行，模型下載約 1.1 GB；下載後不需服務商金鑰。Jev 則是需自行提供金鑰並同意啟用的線上選項，通常傳送問題與前 3 筆記憶，額外開啟重排時可涉及前 20 筆。這些檢查不保證助手永遠答對。

選用的媒體索引可搜尋支援的圖片與 PDF 頁面，利用 OCR 及檔案、頁碼引用回到來源。功能預設關閉，需要 16 GB 記憶體與額外下載。資料夾及 Obsidian 知識庫也能用 slm sources add 以唯讀方式對應。 媒體索引目前不支援 Intel Mac 或 Windows on ARM。

串接不同助手與確認費用

支援的客戶端可透過 MCP 或整合共用記憶。Web access 以 OAuth 串接網頁應用，並區分唯讀或允許儲存。提供記憶的電腦需保持連線；資料庫留在本機，但請求和結果會經過閘道與所連接的應用。

截至 2026 年 10 月 18 日，本機核心免費並採 AGPL v3 授權。網頁存取有每個連線的每日免費額度，但查閱的公開頁面未確認統一數字，因此不列出猜測的次數或月費。外部模型、Jev 與助手本身可能另外收費。預先建置的安裝支援 Apple Silicon、64 位元 Windows 與 Linux，未提供 Intel Mac 或 32 位元 Windows 對應版本。

常見問題

沒有網路也能使用嗎？

模型與相依套件準備好後，Mode A 核心可以在本機運作。網頁存取、外部模型與部分助手仍需網路。

一定需要 API 金鑰或付費嗎？

Mode A 本機核心不需要模型服務商金鑰。Jev 或雲端模型需使用自己的服務憑證，費用由相應服務商決定。

不同助手可以共用記憶嗎？

可透過支援的整合或 MCP 使用同一個記憶庫。設定 profile 與權限後，先測試從一個客戶端儲存、另一個客戶端查詢，確認資料範圍正確。

官方資源與開發者社群

• 官方原始碼與文件：查閱授權、串接方式與問題回報。
• 日常工作流程範例：儲存、替換、時間查詢與網頁存取。
• 答案檢查說明：確認 Laya、Jev 的行為及外傳資料。