前言¶
在 DeepSeek Harness（dsh）中，將整個記憶索引預加載到系統提示詞會消耗大量 tokens，即便當前任務並不需要這些記憶。dsh-unified-memory 通過 SQLite 全文索引解決了這個問題。它只預加載反饋規則，在需要時檢索記憶，保持每輪成本低廉且穩定。
是什麼¶
mattcarvercom/dsh-unified-memory 是一個爲 DeepSeek Harness 提供長期記憶的插件。它使用 Claude Code 的記憶格式，將記憶存儲爲本地 Markdown 文件。通過 SQLite 全文索引，它實現了按需檢索，避免了將整個記憶庫塞入上下文。
核心功能¶
- 長期記憶存儲：以 Markdown 文件形式存儲記憶，每個文件包含元數據（如 origin、modified 時間）。
- 按需檢索與成本控制：通過 SQLite 全文索引，只在需要時檢索記憶，大幅降低每輪對話的 token 消耗。
- 三種工作模式：
dsh：獨立的私有存儲，存儲在~/.dsh/memory。overlay：讀取 Claude Code 的記憶（只讀），但寫入自己的存儲。shared：與 Claude Code 共享記憶文件夾，雙方讀寫同一份記憶。
- 出處追蹤：每個文件包含
origin字段，明確記錄數據來源。 - 完全本地化：無網絡請求，所有索引和存儲操作在本地完成。
安裝與啓用¶
使用官方安裝命令添加插件：
dsh plugin --profile web add github:mattcarvercom/dsh-unified-memory#v1.0.1
安裝後需要重啓 dsh web 才能生效。插件默認以 dsh 模式啓動。
典型用法¶
安裝完成後，使用 mem mode 命令管理記憶模式：
mem mode # 查看當前模式
mem mode shared # 切換爲 shared 模式（會觸發遷移）
mem mode shared --dry-run # 僅預演遷移過程，不執行
在 shared 模式下，DeepSeek Harness 和 Claude Code 可以讀寫同一份記憶庫，避免重複記憶。
適用場景與注意¶
適用場景：本地模型上下文窗口有限，或需要處理長期代理任務時，該插件可以保持每輪 token 消耗在低位。
注意事項：
1. 環境依賴：需要 Node.js 22.19+ 或 24+。
2. 模式依賴：overlay 和 shared 模式需要安裝 Claude Code。
3. 隱私安全：插件會告知代理不要在記憶中存儲機密信息，但文件本身以明文存儲。
4. 文件遷移：mode 配置項不會自動移動文件。切換模式時，必須運行 mem mode 命令，該命令會先備份再遷移。
5. 許可證：採用 MIT 許可證。
結尾¶
該插件通過 SQLite 索引和 Claude Code 格式，爲 DeepSeek Harness 提供了輕量級、低成本的長期記憶解決方案。所有數據存儲在本地，不涉及雲端請求。
