前言¶
DeepSeek Harness（DSH）的插件生態允許開發者擴展其功能。dsh-git-memory 旨在解決智能體開發中長期上下文難以管理的問題。它利用 Git 的特性，提供一種受控、可審查且可回滾的長期記憶存儲方式。
插件概述¶
這是一個基於 Git 的記憶管理插件，由開發者 starfishwrx 維護，採用 MIT 許可證。
核心功能¶
該插件當前處於兼容性測試/預-alpha 階段，主要包含以下已覈實功能：
- 可安裝 Bundle：提供包含
dsh.bundle清單的安裝包。 - 動態上下文註冊：通過
ctx.systemPrompt.context()註冊穩定的動態上下文。 - 元數據觀察：僅對會話或事件進行元數據級別的觀察，不保留原始對話內容。
- 人類命令：提供直接命令
/memory status。 - 模型工具：提供只讀模型工具
memory_status。
安裝與啓用¶
在安裝前，請確保環境滿足以下依賴要求：
- Node.js 24 或更新版本
- pnpm 11
- DeepSeek Harness
0.1.0-rc.6
安裝步驟：
- 克隆倉庫：
git clone https://github.com/starfishwrx/dsh-git-memory.git
cd dsh-git-memory
- 安裝依賴並驗證構建：
pnpm install
pnpm verify
- 將插件添加到 Web profile：
dsh plugin --profile web add .
- 導出配置（確認插件已加載）：
dsh --profile web --dump-config
使用方式¶
插件安裝後，可以通過以下方式使用：
- 通過人類命令查看狀態：
啓動 Web profile，然後輸入：
/memory status
- 通過模型工具：
模型可以直接調用只讀工具memory_status。
安全與限制¶
由於當前版本爲兼容性測試，存在以下限制和安全機制：
- 未存儲記憶：當前發佈證明 DSH 集成接口是可行的，但故意不存儲用戶記憶。
- 無持久化與寫入：不進行對話記錄持久化，不執行後臺模型調用，不進行記憶寫入。
- 存儲路徑：託管倉庫位於
$DSH_HOME/git-memory，不會出現在用戶的源代碼倉庫中。 - 文件系統限制：記憶工具不接受任意的文件系統目的地。
- 敏感數據拒絕：憑據、私鑰、Cookie 和 Token 等敏感值會被硬性拒絕。
- Git 操作限制：Git 遠程、推送以及託管倉庫之外的寫入操作默認禁用。
- 源代碼狀態：該包尚未發佈到 npm。
結語¶
dsh-git-memory 提供了一種將 Git 的版本控制能力引入 DeepSeek Harness 長期上下文管理的思路。儘管目前處於測試階段，且不包含實際的數據存儲功能，但其設計原則（如受控記憶事務、本地化存儲、審計能力）爲構建安全的智能體記憶系統提供了基礎。
