DeepSeek Harness (DSH) 的理念是“一切皆插件”。在開發智能體時,一個常見的問題是:每次會話重啓,智能體都像第一次見面,忘記之前的上下文。dsh-memory 插件實現了 Claude Code 的記憶模型,讓智能體在會話間保持記憶,且不會混淆不同項目。它採用純文件存儲,無任何依賴。
插件定位¶
該插件由 annkun 維護,提供 DeepSeek Harness 的持久化記憶功能。它通過純 Markdown 文件實現記憶存儲,不需要服務器、賬戶或嵌入提供商。
核心功能¶
- 跨會話記憶:智能體在重啓後會“喚醒”時帶有上下文。
- 可視化記憶管理器:通過 UI 管理記憶,支持搜索、標籤、分組。
- 項目隔離:項目記憶攜帶子目錄標籤,會話作用域讀取和寫入,避免跨項目混淆。
- 安全與邊界:設計有界(硬性限制),管道安全(原子寫入、拒絕寫入祕密),零依賴。
安裝與啓用¶
- 確保已安裝 DSH CLI。
- 運行安裝命令。注意
--profile參數必須放在add之前。
dsh plugin --profile web add @fooxe/dsh-memory
- 重啓 DSH。工具註冊僅發生在服務啓動時。停止服務(Ctrl+C),然後重新啓動服務,再打開新會話。
典型用法¶
該插件提供了四個核心工具:
memory_save:保存持久化記憶。memory_search:不區分大小寫的關鍵詞搜索(支持 ID、標題、標籤、內容)。memory_read:讀取單條記憶。memory_list:按作用域列出最近記憶。
使用示例:
在會話中告訴智能體記住偏好,例如:
“Remember — this project uses pnpm, not npm.”
智能體會調用memory_save保存該信息。在下一個會話中詢問:
“Which package manager do we use?”
智能體會直接回答來自記憶的內容,無需再次詢問。
作用域與注意事項¶
插件使用兩個隔離的作用域存儲記憶:
- 用戶作用域(
~/.dsh/memory):存儲個人偏好、跨項目經驗、工作習慣。 - 項目作用域(
<project-root>/.dsh/memory):存儲技術決策、約定、團隊共享信息。
注意事項:
* 命令順序:--profile 必須放在 add 之前。
* 重啓生效:安裝後必須重啓 DSH 才能註冊工具。
* 安全拒絕:寫入路徑會拒絕所有祕密信息。
* Windows 兼容:包含 Windows 路徑保護機制。
* 原子寫入:防止崩潰導致文件損壞。
總結¶
該插件通過文件系統實現了可靠的記憶功能,適合需要長期上下文的智能體開發場景。更多詳情可訪問 GitHub 或 SkillHub 目錄。