joshuadavidthomas/opencode-agent-memory

解決的問題

它為 OpenCode 代理提供了一個持久且可自我編輯的長期記憶系統。這能防止代理在不同對話階段或對話上下文被壓縮時遺忘關鍵資訊，讓它們能夠維持一致的角色設定，並記住使用者偏好與專案專屬知識。

運作方式

該外掛程式實作了一個記憶區塊系統——儲存於磁碟上的結構化 Markdown 檔案——這些區塊會被注入到代理的系統提示詞中。這些區塊被分類為全域（跨所有專案共享）或專案專屬。代理使用專用工具與此記憶互動，以列出、建立、更新或替換這些區塊中的內容。此外，它還具備一個選用的日誌功能，用於僅附加的項目，代理可以使用本地嵌入 (all-MiniLM-L6-v2) 對其進行語意搜尋。

適用對象

使用 OpenCode 的開發者，希望其 AI 代理具備長期記憶、一致的身份，並能夠在多次編碼對話階段中記錄與擷取見解。

亮點

• 可自我編輯的記憶：代理可以使用專用工具主動讀取並修改其記憶區塊。
• 持久儲存：資訊儲存於 Markdown 檔案中，能在對話階段重啟與上下文限制中存活。
• 共享範圍：支援用於一般偏好的全域記憶，以及用於程式碼庫架構的專案層級記憶。
• 語意日誌：一個選擇加入的日誌，允許代理捕捉並對發現與決策進行語意搜尋。
• 本地隱私：日誌的語意搜尋完全使用本地嵌入在本地機器上執行。