dsh-memory-graph：DSH 的本地知識圖譜與長期記憶插件

前言¶

DeepSeek Harness 的設計理念強調模塊化與擴展性。在構建具備長期記憶能力的智能體時，開發者常面臨數據持久化方案侵入性強、圖譜維護困難或檢索效率低的問題。dsh-memory-graph 是一個基於 DSH 生命週期擴展點開發的插件，它通過本地 SQLite 數據庫提供長期記憶與時間知識圖譜，不修改 Harness 源碼，卸載即可移除所有工具與 UI 組件。

插件定位¶

這是一個本地優先、非侵入式的長期記憶與知識圖譜插件，由維護者 zmh2000829 開發，採用 MIT 許可證。它爲 DSH 代理提供可審計、可維護的持久化存儲，並在 DSH Web 界面中渲染實體圖譜。

核心能力¶

該插件通過以下機制實現記憶與知識圖譜的穩定運行：

非侵入式設計：不依賴 Harness 源碼補丁或 Fork 代理循環。卸載插件後，其工具、監聽器、路由及 UI 貢獻會自動移除。
可維護的圖譜：使用規範名稱、衝突檢測、實體合併/重命名、孤立節點發現以及引用感知的垃圾回收，確保圖譜在長時間對話後仍保持可用。
中文檢索支持：使用 FTS5 三元組索引結合短查詢回退機制，處理連續 CJK 文本而無需依賴空白符分詞。
混合相關性召回：結合詞法匹配、圖鄰近性、重要性、時間衰減和顯式訪問強化進行排序。語義召回（OpenAI 兼容嵌入）默認關閉，作爲可選補充。
每回合控制：DSH Web 界面提供“默認”、“本回合開啓”、“本回合關閉”選項，允許在對話中動態調整記憶策略，該設置僅對下一輪生效。
故障處理與恢復：支持可恢復的源歸檔（限制上下文長度）和持久化故障處理（SQLite 寫入失敗進入離線郵箱，啓動時重放）。

安裝與啓用¶

當前版本直接從 GitHub 克隆安裝。安裝前請確保環境滿足 Node.js 版本要求（^22.19.0 或 >=24.0.0）。

克隆倉庫並安裝依賴：

git clone https://github.com/zmh2000829/dsh-memory-graph.git
cd dsh-memory-graph
npm ci
npm run check

將本地檢出鏈接到 DSH 配置文件：

dsh plugin --profile web add "$PWD"
dsh web

打開 DSH Web 界面，在側邊欄展開 Memory 即可查看儀表盤與知識圖譜。

使用與維護¶

安裝後，插件默認啓用自動召回、自動輪次摘要和可視化。知識圖譜視圖基於配置文件範圍的數據庫，而非當前會話，可用於檢查關聯、重複實體及錯誤關係。

驗證安裝：

    dsh plugin --profile web list dsh-memory-graph

升級：由於使用本地檢出鏈接，升級時只需拉取代碼並重新校驗：

    cd /path/to/dsh-memory-graph
    git pull --ff-only
    npm ci
    npm run check

卸載：

    dsh plugin --profile web remove dsh-memory-graph

注意：卸載操作僅移除配置鏈接，**不會**刪除本地 SQLite 數據庫和 JSONL 備份文件。

注意事項¶

環境依賴：插件依賴 Node.js 環境，安裝前請使用 dsh --version 和 dsh plugin --profile web list 確認 CLI 與配置文件可用。
數據安全：數據存儲在本地私有 SQLite 數據庫中，確保 DSH 進程有讀寫權限。
多會話共享：Web 界面的知識圖譜儀表盤基於全局配置文件數據庫，所有會話共享同一數據源；如需隔離，需使用獨立的 path 配置。
版本兼容：請確保使用 Node.js ^22.19.0 或 >=24.0.0。