DSH plugin 怎么用提示词配置?创造模式与 plugin_manager install_bundle

插件开发发布于 2026-10-02作者: DeepSeek Plugin 插件市场
DSH pluginDeepSeek Harness创造模式Plugin Managerplugin_manager
DeepSeek Harness 的 DSH plugin 在创造模式下用提示词配置:agent 写纯配置组合包,经 plugin_manager install_bundle 安装并插入 patch;插件配置属于当前 profile,重启后保留。

DSH plugin 可以用提示词配置并持久化:在创造模式下,agent 会写一个纯配置组合包,在 patch 中插入目标插件,再通过 plugin_manager install_bundle 安装。 插件配置属于当前 profile,影响其会话并在进程重启后保留;启用 HMR 时新工具会出现在同一个运行中的会话里。这也是 DSH插件 的推荐配置方式:不手改文件,用自然语言改插件配置。

DSH plugin 的创造模式提供什么:Plugin Manager 与只读运行时检查

创造模式提供两样东西:Plugin Manager 和只读的运行时检查(来源)。 分工如下:

  1. Plugin Manager — 负责安装 / 移除组合包、停用条目。预期:agent 能按提示词落地配置改动。
  2. 只读运行时检查 — 读取当前运行状态。预期:改配置前能先看清现状,避免盲改。
  3. 配置归属 — 插件配置属于当前 profile,影响该 profile 的会话。预期:改的是这份 profile 的组合包与 patch,重启后仍保留。

这意味着两件事:一是提示词配置不是「会话内的临时状态」,而是真正写进 profile;二是它与 自定义 profile 是同一套配置体系,只是一个手改、一个由 agent 代改。

DSH plugin 怎么用提示词装配置:以接入 MCP 服务器为例

官方示例是接入一个 MCP 服务器:启动 Web profile 并选择创造模式,用提示词让 agent 把服务器配到当前 profile(来源)。 提示词形如:

将 <endpoint> 处的 MCP 服务器配置到当前 profile,命名为 demo。立即启用它的工具,然后调用它的 ping 工具并告诉我结果。

agent 的动作序列是固定的:

  1. 写纯配置组合包 — 生成一份只含配置的组合包。预期:不改任何插件代码。
  2. 在 patch 中插入插件 — 例如 @deepseek-ai/dsh-mcp-client。预期:目标插件被挂进插件树。
  3. 执行 plugin_manager install_bundle — 安装这份组合包。预期:返回管理结果,启用 HMR 时工具立即出现在同一会话。

验证要有两条证据:一是管理结果 application: applied,二是成功调用 mcp__demo__ping。只看到前一条不足以证明配置真的生效。想了解 MCP 客户端的配置字段,见 接入 MCP 记忆插件。

DSH plugin 配置结果怎么判读:applied、restart-required 与失败

管理结果有三种走向,判读方式不同(来源):

  1. application: applied — 配置已激活。预期:当前会话即可用,配合一次真实工具调用验证。
  2. restart-required — 条目已保存但尚未激活。预期:需要重启进程才生效,别误判为失败。
  3. 失败条目 — 配置本身有问题。预期:按报错修复配置后重试。

改配置前先读组合包 patch,确认将要改动的条目;停用条目或移除组合包都要经 Plugin Manager 操作,可接受的配置与连接失败行为以官方 MCP client 参考为准。

写完自检三项:是否用 applied 加一次真实调用双重验证;是否区分了 restart-required 与失败;是否在改前读过 patch。想对照社区插件怎么被装进 profile,可在 DSH Plugin Hub 检索。

常见问题

DSH plugin 的创造模式能做什么?Plugin Manager 是什么?

DSH plugin 的创造模式提供 Plugin Manager 与只读的运行时检查两项能力。Plugin Manager 让 agent 用纯配置组合包增删插件,运行时检查则让你读取当前运行状态;两者配合就能用提示词改插件配置而不必手改文件。

DSH plugin 怎么用提示词配置一个 MCP 服务器?

DSH plugin 的做法是:启动 Web profile 并选创造模式,用提示词把 MCP 服务器配到当前 profile 并命名。agent 会写一个纯配置组合包,在 patch 中插入 @deepseek-ai/dsh-mcp-client,再通过 plugin_manager install_bundle 安装并立即启用工具。

DSH plugin 用提示词装完 MCP 服务器后工具为什么没出现,是不是还要重启进程?

DSH plugin 的已保存条目若返回 restart-required,说明它尚未激活,需要重启才生效;失败条目则需要修复配置。启用 HMR 时新工具会出现在同一个运行中的会话里,此时应同时检查管理结果 application: applied 与成功调用。

DSH plugin 用提示词改的配置属于哪个 profile?重启后会丢吗?

DSH plugin 用提示词改的插件配置属于当前 profile,会影响该 profile 的会话,并在进程重启后保留。所以改配置实质上是在改这个 profile 的组合包与 patch,而不是临时的会话内状态。

DSH plugin 用提示词改配置前要注意什么,改前是否要先读组合包 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

来源