agentmemory 原理：讓 AI 程式助手擁有長期記憶

agentmemory 在本機記錄程式助手做過的事，下次開工時交還相關內容。講清原理、記憶種類、使用情境和主要功能。

AI 程式助手每開一個新對話都從零開始：專案怎麼跑、上週踩過什麼坑、你糾正過它什麼，全要重講。agentmemory 這類工具的思路是：在你的電腦上跑一個記憶服務，自動記下助手做過的事，下次開工時把相關的內容交還給它。多個程式助手共用同一份記憶。

原理：四步

採集：助手的每則提問和每次工具呼叫，比如改檔案、跑測試，都會送到本機的記憶服務。每筆紀錄都標明來源：你輸入的、助手自己的、工具回傳的、匯入的，還是另一個助手共享的。

壓縮：每筆紀錄被壓成標題、涉及的檔案和一段摘要。接上大模型後，會進一步提煉成事實和概念。

檢索：查找時同時用三路：關鍵字、語意相似度、知識圖譜裡的關聯，再合併計分。同一個對話不會佔滿結果，被更新過的舊記憶不會再被搜出來，中文提問也能搜到英文摘要。

沉澱：對話結束後自動總結，提煉出事實和反覆出現的做法；長期沒人用的記憶會慢慢降權；每個對話留一份摘要，原始紀錄清理後也不丟重點。

新對話開始時，它按固定順序把內容放進上下文：置頂記憶、專案概況、相關教訓、最近幾次對話的摘要，總長度控制在你設定的範圍內。

記憶分幾種

觀察紀錄：對話裡發生了什麼，比如哪次工具呼叫找到了測試失敗的原因。

記憶：決定和事實，比如付款介面為什麼必須帶冪等鍵。重複儲存相近內容會變成新版本，舊版本留檔但不再出現在結果裡。

教訓：你糾正過的規則。越常用越可信，長期不用會降權，最後退役。

做法：在多次對話裡重複出現的流程，會被整理成帶觸發條件的步驟。

對話摘要：每個對話一份，記錄結果、改過的檔案和學到的教訓。

使用情境

多個助手共用：週一在 Claude Code 裡修好的問題，週二在 Cursor 裡問，它直接知道原因。

不用再介紹專案：用什麼套件管理器、怎麼跑測試、哪個目錄不能改，開工前就已經載入好。

接著昨天做：闔上電腦時做到一半，隔天新對話知道做到哪、還有什麼沒定。

糾正一次就記住：比如「整合測試不要模擬資料庫」，下次做類似任務前會自動提醒。

查程式碼為什麼這樣寫：提交紀錄能連回產生它的那次對話，看到當時的原因。

第一天就有歷史：可以匯入以前的對話紀錄，過去的經驗馬上能搜到。

主要功能

資料預設只存在本機，不需要帳號，也不需要額外的資料庫。

支援二十多種程式助手，包括 Claude Code、Cursor、Codex、Gemini CLI，以及任何支援 MCP 的用戶端。

內建本機檢視器：瀏覽記憶、重播對話、查看教訓和知識圖譜。

可按專案和助手隔離記憶，也可以讓團隊共用一台記憶伺服器。

不接大模型也能用：紀錄、關鍵字檢索和知識圖譜都在本機完成；接上嵌入模型後有語意檢索，接上大模型後有總結和提煉。

開源，Apache-2.0 授權。

和手動維護記憶的關係

我們在 在不同 AI 之間保留記憶 裡講過自己維護一份上下文檔案。agentmemory 做的是同一件事的自動化版：紀錄、整理、檢索都交給工具。專案規則這類關鍵內容，仍建議寫進 CLAUDE.md 或 AGENTS.md，兩者搭配最穩。

相關商品：Claude API、Codex API。