前言¶
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 的集成。开发者无需手动处理会话关闭和上下文保存，即可获得持久化记忆能力。
