前言¶
DSH 的能力擴展通常以插件方式進行。一個常見問題是會話之間的上下文不連續:本次會話裏確認過的偏好、項目約定、查詢過的資料,下一次會話不一定還能繼續使用。
interest-memory 針對這個問題,提供一個本地長期記憶服務:會話結束時整理並寫入,會話開始時召回相關條目。DeepSeek Harness 可以通過 DSH bridge 插件接入這個服務。
這是什麼¶
interest-memory 由 djasdh 維護,屬於記憶類能力。它將跨會話長期記憶拆成一個本地 Go 服務,使用 SQLite-vec 向量索引,並提供驗證流程。
對 DeepSeek Harness 來說,接入形式是 Cordis plugin;安裝對象是 @djasdh/interest-memory-dsh-bridge。該服務以單個二進制和 SQLite 文件作爲本地知識庫,也支持多個 agent framework 共享同一個服務。
核心功能¶
下面介紹已覈實的能力。
會話接入¶
- DeepSeek Harness 通過 Cordis plugin 接入。
- 會話開始時進行 recall injection。
- 會話結束時進行 transcript push。
- 提供
memory_search/memory_logsconsumer tools。
本地存儲與檢索¶
- 使用 SQLite-vec 向量索引,並提供 FTS fallback。
- 以單個二進制 + SQLite 文件作爲本地知識庫。
- 條目攜帶證據,例如 web URL、turn、query。
記憶治理¶
- 使用 3-stage verification:check / claims / contradictions。
- 語義相似的 interest points 自動合併或關聯。
- 舊條目標記 superseded / archived,並保留 replacement chain。
- LLM 寫入 wiki 頁面並建立語義邊。
查詢與可視化¶
- 搜索結果攜帶 outlinks / backlinks,支持 graph walk。
- 提供 REST API:sessions、recall、search、logs、interest-points、wiki pages、fork、jobs、stats、graph。
安裝與啓用¶
先安裝本地服務,再安裝 DSH bridge。
安裝服務¶
使用安裝腳本:
curl -fsSL https://raw.githubusercontent.com/djasdh/interest-memory/main/scripts/install.sh | bash
這條命令會執行安裝腳本。
配置 LLM¶
如果需要使用 LLM 進行寫入、驗證或嵌入,可運行:
curl -fsSL https://raw.githubusercontent.com/djasdh/interest-memory/main/scripts/install_llm.py | python3 - --provider <provider>
這裏的 <provider> 需要替換爲實際 provider。資料中說明 LLM / embedding 可指向本地 Ollama / vLLM,用於完全離線場景。
安裝 DeepSeek Harness bridge¶
在 DSH 中安裝 bridge:
dsh plugin --profile web add @djasdh/interest-memory-dsh-bridge
該命令安裝的是 DSH bridge,用於把 interest-memory 接入 DeepSeek Harness。
典型用法¶
以下接口使用 {agent} 作爲 agent 路徑段。
推送會話結束內容¶
POST /api/v1/{agent}/sessions
用於在會話結束時推送 session-end transcript。
召回注入¶
GET /api/v1/{agent}/recall?query=&after=&before=&days=
用於在會話開始時召回相關記憶。
查詢完整內容¶
GET /api/v1/{agent}/search?query= or ?id=&top_k=
用於查詢完整內容與 graph 信息。
查看變更日誌¶
GET /api/v1/{agent}/logs?limit=&offset=
用於查看 change log。
適用場景與注意¶
適合希望在 DSH 中沉澱跨會話信息,同時保留本地存儲、可查詢和可審計路徑的使用者。它也可作爲多個 agent framework 共享的本地記憶服務。
需要注意:
- 服務不可用時不會阻塞會話。
session_transcripts保存完整原始文本;如擔心磁盤增長,需要在外部做 trim。fork.max_concurrency/verify.max_concurrency用於限制峯值內存。interestmemory.kanban_exclude列出的 Kanban boards 會被丟棄。- 共享結果會標註來源:recall 行使用
[from: <agent>],search / get 使用result.agent。 - 插件以當前 dsh 進程權限運行。安裝前應檢查源碼與許可證;當前已覈實資料未確認許可證。
- 插件目錄是獨立站點,不把目錄頁視爲 DeepSeek 或幻方官方應用商店。
鏈接¶
- GitHub:
https://github.com/djasdh/interest-memory - 插件目錄頁:
https://www.skillhub.cn/plugins/djasdh/interest-memory(該鏈接來自插件線索,未在本次抓取資料中直接確認)