前言¶
DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”，通過擴展插件來增強智能體的能力。dsh-memgas 是其中的長期記憶插件，解決的是智能體在多會話交互中丟失項目上下文、無法複用歷史約定與決策的問題。
插件定位¶
該插件由用戶 quqxui 維護，基於 MIT 許可證開源。它爲 DSH 提供長期記憶存儲能力，核心在於多通道檢索融合與記憶演化閉環。
核心功能¶
多通道檢索融合¶
插件並行運行四個檢索通道，並基於倒數排名融合（RRF）方法輸出最終結果：
* Lexical（詞法）：基於 SQLite FTS5，保留標識符完整性，適合路徑、包名、錯誤碼。
* Dense（密集）：向量相似度，適合同義問法。
* Granularity（粒度）：基於熵路由器加權，決定檢索單元（會話/輪次/摘要/關鍵詞）。
* Graph（圖）：基於個性化 PageRank 的關聯圖檢索，適合多跳關聯。
記憶演化閉環¶
插件在後臺隊列中運行六個維護進程，持續優化記憶庫：
* Associate：將新記憶與現有記憶聚類關聯。
* Reconcile：合併重複項，處理衝突。
* Reinforce：增加常用記憶的權重。
* Decay：歸檔未使用的記憶。
* Abstract：對大集羣進行摘要。
* Re-associate：刷新關聯圖。
本地存儲¶
數據存儲於本地 SQLite，不依賴外部 API Key 或模型下載，不離開機器。
安裝與啓用¶
安裝插件需要訪問 npm registry 或直接從 GitHub 安裝。
dsh plugin --profile web add dsh-memgas
或
dsh plugin --profile web add github:quqxui/dsh-memgas
倉庫包含預構建的單文件工件，GitHub 安裝無需構建步驟。安裝後重啓 DSH 即可生效，默認零配置。
典型用法¶
模型工具¶
模型可調用以下工具：
* memory_save：保存事實或約定。
* memory_search：檢索記憶。
* memory_status：查看狀態。
用戶命令¶
用戶可通過 /memory 前綴指令管理記憶：
/memory search <query> # 檢索並列出記憶卡片
/memory diag <query> # 查看各檢索通道的詳細結果和融合過程
/memory list [n] # 按重要性列出記憶
/memory export # 導出記憶爲 JSON
/memory forget <id> # 歸檔記憶
示例¶
在一個會話中保存項目約定：
$ dsh --profile headless "Use memory_save to remember: this project deploys on port 8080,
and dependencies are managed with pnpm."
Saved to memory:
1. **Environment**: the project's deployment port is 8080.
2. **Convention**: dependencies are managed with pnpm (not npm/yarn).
在新會話中直接提問，無需顯式調用工具，插件已將記憶注入上下文：
$ dsh --profile headless "What port does this project deploy on? What manages dependencies?
Answer directly."
From long-term memory:
- **Deployment port**: 8080
- **Dependency management**: pnpm
配置與擴展¶
雖然支持零配置運行，但仍可通過 cordis.patch.yml 進行自定義。配置項包括模式選擇（lite/hybrid/memgas）、召回數量、自動摘要開關以及本地模型嵌入器配置。
適用場景與注意¶
該插件適合需要跨會話維護複雜項目上下文的場景。數據完全本地存儲，適合對隱私敏感的項目。安裝前建議檢查源碼與許可證。
