在 DeepSeek Harness（DSH）的插件生態中，Agent 的記憶管理是核心痛點。上下文窗口有限，會話之間往往缺乏有效的狀態持久化與檢索機制。dsh-memory-manager 是一個面向 AI Agent 的統一記憶管理層插件，由 xiaoshi7915 維護。它旨在解決 Agent 在對話過程中信息丟失、無法跨會話檢索以及長期記憶難以維護的問題。
核心功能¶
該插件提供了從短期緩存到長期沉澱的完整記憶管理能力。
-
記憶分層與存儲
- 短程滑動窗口記憶：限制每會話的消息條數或 Token 上限，超出部分自動截斷或生成摘要。
- 長程向量記憶：使用 SQLite 元數據配合自定義向量索引，支持本地存儲。
- 分層能力：支持 L0 原始對話、L1 原子記憶、L2 場景、L3 畫像等多層級結構。 -
檢索與摘要
- 語義/混合檢索：融合向量（餘弦）與關鍵詞（詞項重疊），支持降級模式。
- 智能摘要：支持本地抽取式摘要，可選 LLM 增強。 -
生命週期與安全
- 生命週期管理：支持 TTL 過期、重要性評分、存儲上限清理（LRU 策略）。
- 安全存儲：默認使用 AES-256-GCM 加密存儲，支持 scrypt 派生密鑰。 -
會話與共享
- 多會話隔離：默認僅本會話可見。
- 全局記憶共享：支持跨會話共享記憶，可整體開關。 -
其他能力
- 可視化 Web 管理界面：支持記憶瀏覽、語義搜索、導入導出與設置。
- 導入導出：支持 JSON 全量備份或 JSONL 僅記憶導出。
- 三態嵌入源：支持關閉（純關鍵詞）、遠程 API、本地 ONNX 推理三種模式。
- 會話記憶檔位：支持 auto/chat/work/off 檔位配置。
安裝與啓用¶
安裝前請確保環境滿足要求：Node.js >= 22.5。
dsh plugin add xiaoshi7915/dsh-memory-manager
安裝完成後，可通過以下方式訪問或驗證：
- 訪問 GUI：http://127.0.0.1:4599/
- 健康檢查：http://127.0.0.1:3080/api/memory/healthz（取決於 DSH 運行端口）
典型用法¶
獨立演示模式：若不依賴 DSH 主程序，可直接運行該插件提供的服務：
# 安裝依賴
npm install
# 啓動演示服務器
npm run serve
啓動後，打開瀏覽器訪問 http://127.0.0.1:4599/ 即可使用 Web 管理界面。該界面支持記憶瀏覽、語義搜索、導入導出及配置修改。
配置與調試：
- 插件默認開箱即用，採用“哈希+關鍵詞”降級模式。
- 數據默認存儲在 ~/.dsh/memory-manager/，可通過環境變量 DSH_MEMORY_DIR 覆蓋。
- 插件內置 8 個 Agent 工具（mm_*），可直接在 DSH 中調用。
注意事項¶
- 運行環境：需要 Node.js >= 22.5，利用了內置的
node:sqlite與crypto模塊。 - 數據安全：插件本地優先、零雲依賴，數據存儲在本地。
- 加載機制：更新插件代碼後，必須重啓 DSH 才能加載新代碼。
- 默認行爲：未配置真實嵌入模型時，默認使用哈希向量與關鍵詞混合檢索，閾值會自動適配。
總結¶
dsh-memory-manager 提供了一套從短期緩存到長期向量記憶、從語義檢索到加密存儲的完整解決方案。它通過可視化管理界面降低了 Agent 記憶管理的複雜度，適合需要長期記憶與跨會話檢索能力的 DSH 用戶。
