前言¶
DeepSeek Harness 的核心在於插件化架構。記憶管理是智能體開發的剛需，但現有的記憶方案往往存在取捨：Hermes 風格的輕量快照（MEMORY.md）省 token 且保前綴緩存，但不可檢索；Noema 風格的可檢索知識庫功能完善，但引入了 Rust 服務端依賴和額外的 prompt 操作。
dsh-hybrid-memory 旨在融合兩者優勢。它提供了一套無需自動注入、數據本地存儲的混合記憶方案，採用分層設計，平衡了常駐記憶的輕量性與知識庫的檢索效率。
插件概述¶
dsh-hybrid-memory 是一個由 Frog755 開發的 DeepSeek Harness 記憶插件，開源協議爲 MIT。它通過三層架構（L1/L2/L3）整合記憶能力，解決單一記憶方案在性能與功能上的短板。
核心能力¶
該插件的核心功能分爲三層：
- L1 快照記憶：繼承 Hermes 風格，支持
memory_add、memory_replace、memory_remove。數據以MEMORY.md和USER.md形式存儲，字符上限與模型無關，僅在模型主動調用時按需讀取。 - L2 可檢索知識庫：基於 SQLite FTS5 實現，支持
memory_remember、memory_search、memory_browse。採用“一事實一文件”的 Markdown 格式存儲，並針對中文進行了分詞優化。 - L3 多工具導入：支持從 Hermes、Claude、Codex、WorkBuddy 等工具導入既有記憶，利用內容哈希去重。
此外，插件包含以下輔助機制：
* 按需讀取（零上下文開銷）：v0.2.0 起，插件移除了所有自動注入邏輯（如 systemPrompt 常駐注入、pre-step 召回）。記憶僅在模型主動調用 memory_* 工具時進入上下文。
* 安全與穩定性：內置威脅掃描（檢測提示注入/外泄）、原子寫操作（防止漂移）以及審覈隊列（pending/）。
* 中文檢索：利用 FTS5 的 unicode61 特性支持中文全文檢索。
安裝與配置¶
插件依賴 Node.js 22.5+ 環境，且需在 DeepSeek Harness 的 Web Profile 下運行。
安裝命令如下：
dsh plugin --profile web add @frog755/dsh-hybrid-memory@latest
首次安裝後需要重啓一次 DSH，之後支持熱重載。
數據默認存儲在本地磁盤，路徑爲 D:\Develop\DeepSeek Harness\memory。如需修改，可設置環境變量 DSH_HYBRID_MEMORY_ROOT。
典型用法¶
1. 管理常駐條目（L1）
新增常駐條目或修改現有條目，無需檢索即可直接生效。
# 新增關於用戶的條目
memory_add(user, "用戶偏好使用 Python 而非 JavaScript，且喜歡詳細註釋。")
# 替換已有條目
memory_replace(agent, "項目約定", "項目約定：所有 API 響應需包含 CORS 頭。")
2. 保存知識庫事實（L2）
將臨時信息轉化爲可檢索的知識，默認直接寫入，或通過 review=true 進入審覈隊列。
# 寫入知識庫
memory_remember("項目依賴", "本項目依賴 Node.js 22.5+ 版本。")
# 強制進入審覈隊列
memory_remember("安全規則", "禁止訪問敏感網絡段", review=true)
3. 檢索與瀏覽
使用全文檢索或目錄瀏覽查找信息。
# 按關鍵詞搜索
memory_search("數據庫配置")
# 瀏覽知識庫目錄
memory_browse()
4. 融合召回
當模型需要記憶時，調用 memory_recall。它會融合 L1 快照與 L2 檢索結果，並按 token 預算打包返回。
5. 導入記憶
從其他工具遷移歷史記憶。
# 從 Hermes 導入
memory_import(sources=["hermes"])
數據與隱私¶
所有記憶數據均存儲在本地磁盤，不向任何外部服務發送數據。數據根目錄默認位於 D:\Develop\DeepSeek Harness\memory，包含以下結構：
MEMORY.md/USER.md：L1 快照。facts/：已激活的知識庫事實。pending/：待審覈的記憶。index.db：FTS5 索引數據庫。imports.json：導入去重賬本。
注意事項¶
- 無自動注入：這是該插件的重要行爲變更。如果模型沒有主動調用
memory_*工具，記憶將不會自動出現在上下文中。這雖然增加了模型的使用成本，但換取了零上下文記憶開銷。 - 審覈機制：默認
auto-accept（直接寫入）。若需對記憶進行人工審覈，應在調用memory_remember時設置review=true。 - 兼容性：僅支持 DeepSeek Harness（Cordis 架構）的 Web Profile。
- 本地權限：插件運行在當前進程的權限下，安裝前請檢查源碼與許可證。
