DSH plugin 怎么用提示词配置?创造模式与 plugin_manager install_bundle
DSH plugin 可以用提示词配置并持久化:在创造模式下,agent 会写一个纯配置组合包,在 patch 中插入目标插件,再通过 plugin_manager install_bundle 安装。 插件配置属于当前 profile,影响其会话并在进程重启后保留;启用 HMR 时新工具会出现在同一个运行中的会话里。这也是 DSH插件 的推荐配置方式:不手改文件,用自然语言改插件配置。
DSH plugin 的创造模式提供什么:Plugin Manager 与只读运行时检查
创造模式提供两样东西:Plugin Manager 和只读的运行时检查(来源)。 分工如下:
- Plugin Manager — 负责安装 / 移除组合包、停用条目。预期:agent 能按提示词落地配置改动。
- 只读运行时检查 — 读取当前运行状态。预期:改配置前能先看清现状,避免盲改。
- 配置归属 — 插件配置属于当前 profile,影响该 profile 的会话。预期:改的是这份 profile 的组合包与 patch,重启后仍保留。
这意味着两件事:一是提示词配置不是「会话内的临时状态」,而是真正写进 profile;二是它与 自定义 profile 是同一套配置体系,只是一个手改、一个由 agent 代改。
DSH plugin 怎么用提示词装配置:以接入 MCP 服务器为例
官方示例是接入一个 MCP 服务器:启动 Web profile 并选择创造模式,用提示词让 agent 把服务器配到当前 profile(来源)。 提示词形如:
将
<endpoint>处的 MCP 服务器配置到当前 profile,命名为demo。立即启用它的工具,然后调用它的 ping 工具并告诉我结果。
agent 的动作序列是固定的:
- 写纯配置组合包 — 生成一份只含配置的组合包。预期:不改任何插件代码。
- 在 patch 中插入插件 — 例如
@deepseek-ai/dsh-mcp-client。预期:目标插件被挂进插件树。 - 执行
plugin_manager install_bundle— 安装这份组合包。预期:返回管理结果,启用 HMR 时工具立即出现在同一会话。
验证要有两条证据:一是管理结果 application: applied,二是成功调用 mcp__demo__ping。只看到前一条不足以证明配置真的生效。想了解 MCP 客户端的配置字段,见 接入 MCP 记忆插件。
DSH plugin 配置结果怎么判读:applied、restart-required 与失败
管理结果有三种走向,判读方式不同(来源):
application: applied— 配置已激活。预期:当前会话即可用,配合一次真实工具调用验证。restart-required— 条目已保存但尚未激活。预期:需要重启进程才生效,别误判为失败。- 失败条目 — 配置本身有问题。预期:按报错修复配置后重试。
改配置前先读组合包 patch,确认将要改动的条目;停用条目或移除组合包都要经 Plugin Manager 操作,可接受的配置与连接失败行为以官方 MCP client 参考为准。
写完自检三项:是否用 applied 加一次真实调用双重验证;是否区分了 restart-required 与失败;是否在改前读过 patch。想对照社区插件怎么被装进 profile,可在 DSH Plugin Hub 检索。
常见问题
DSH plugin 的创造模式提供 Plugin Manager 与只读的运行时检查两项能力。Plugin Manager 让 agent 用纯配置组合包增删插件,运行时检查则让你读取当前运行状态;两者配合就能用提示词改插件配置而不必手改文件。
DSH plugin 的做法是:启动 Web profile 并选创造模式,用提示词把 MCP 服务器配到当前 profile 并命名。agent 会写一个纯配置组合包,在 patch 中插入 @deepseek-ai/dsh-mcp-client,再通过 plugin_manager install_bundle 安装并立即启用工具。
DSH plugin 的已保存条目若返回 restart-required,说明它尚未激活,需要重启才生效;失败条目则需要修复配置。启用 HMR 时新工具会出现在同一个运行中的会话里,此时应同时检查管理结果 application: applied 与成功调用。
DSH plugin 用提示词改的插件配置属于当前 profile,会影响该 profile 的会话,并在进程重启后保留。所以改配置实质上是在改这个 profile 的组合包与 patch,而不是临时的会话内状态。
DSH plugin 用提示词改配置前应先读取组合包 patch,确认将要改动的条目。停用条目或移除组合包都要经 Plugin Manager 操作;约束条件与连接失败行为以官方 MCP client 参考为准。
相关术语
- creation mode(创造模式)
- 创造模式是 DSH plugin 中允许用提示词配置插件的运行模式,它提供 Plugin Manager 与只读运行时检查,让 agent 能增删插件配置并持久化到当前 profile。— https://deepseek-harness.github.io/deepseek-harness/develop/practice/dynamic-cordis
- Plugin Manager
- Plugin Manager 是 DSH plugin 在创造模式下用于管理插件的组件,支持安装或移除组合包、停用条目,是提示词配置插件的执行入口。— https://deepseek-harness.github.io/deepseek-harness/develop/practice/dynamic-cordis
- plugin_manager install_bundle
- plugin_manager install_bundle 是 DSH plugin 安装纯配置组合包的工具调用,agent 借它把写好的 patch 落进当前 profile 并启用插件。— https://deepseek-harness.github.io/deepseek-harness/develop/practice/dynamic-cordis
- restart-required
- restart-required 是 DSH plugin 配置管理结果的返回状态,表示已保存的条目尚未激活,需要重启进程才生效。— https://deepseek-harness.github.io/deepseek-harness/develop/practice/dynamic-cordis
来源
- DeepSeek Harness 官方文档 - 通过提示词配置持久化插件· deepseek-ai
- DeepSeek Harness - Plugin Manager README· deepseek-ai