前言¶
DeepSeek Harness (DSH) 的核心理念是插件化。在開發智能體時，實現持久化記憶通常需要手動處理會話狀態、數據序列化和清理邏輯。dsh-gentle-engram 是爲此設計的適配器，它將 Engram 的持久化能力橋接到 DSH 的工作流中，通過 Cordis 生命週期鉤子管理狀態。
這是什麼¶
這是一個 Host Cordis 插件，由 eehcx 維護。它爲 DeepSeek Harness 提供了與 Engram 的集成，確保 Engram 的持久化行爲在 DSH 中可靠運行。
核心功能¶
該插件主要提供以下能力：
- 工具調用：複用官方的
@deepseek-ai/dsh-mcp-client行來調用 Engram MCP stdio 工具。 - 生命週期鉤子：掛鉤 DSH 的多個關鍵節點，包括會話啓動、接收輸入提示、工具結果返回、回合停止以及代理銷燬。
- 上下文注入：將相關的 Engram 上下文種子化，傳遞給下一步模型調用。
- 異步持久化：異步保存提示詞和經過過濾的被動工具學習內容。
- 寫入序列化：對每會話的寫入進行序列化，並在回合邊界等待掛起的寫入完成。
- 會話清理：在代理銷燬時關閉 Engram 會話，並記錄結構化摘要。
- 安全性：從不直接訪問 Engram 的 SQLite 文件，並避免轉發可能包含敏感信息的參數。
安裝與啓用¶
使用該插件需要滿足以下前提條件：
- 已安裝 DeepSeek Harness 並啓用
dsh plugin命令。 - 系統已安裝 Engram 並在 PATH 中可用。
- 已配置好 DSH 配置文件，例如
web。
安裝步驟如下：
- 執行安裝命令：
npx @deepseek-ai/dsh plugin --profile web add dsh-gentle-engram
- 安裝完成後，重啓 DSH 服務。
在啓動 DSH 之前，建議檢查 Engram 是否可用：
engram --version
適用場景與注意¶
該插件適用於需要在 DSH 中集成持久化記憶功能的場景。
注意事項：
* 該包是一個 Host bundle，其 cordis.patch.yml 文件同時管理了 MCP 橋接和生命週期插件。
* 不要編輯插件自帶的預設文件，也不要手動添加第二個 Engram MCP 行。
* 該插件依賴 Engram 的存在，若 Engram 未安裝或不可用，插件無法正常工作。
短結尾¶
dsh-gentle-engram 通過自動化的生命週期管理，簡化了 DeepSeek Harness 與 Engram 的集成。開發者無需手動處理會話關閉和上下文保存，即可獲得持久化記憶能力。
