前言¶
在 DeepSeek Harness（DSH）的开发与调试中，经常需要为特定任务（如代码审查、快速摘要）配置独立的模型路由和推理策略。手动为每个请求创建新的上下文不仅繁琐，而且难以复用。dsh-subagent 插件通过将命名配置转化为可调用的工具，解决了这一问题。
这是什么¶
dsh-subagent 是一个社区维护的 DeepSeek Harness 插件，作者为 xie-tj，采用 MIT 许可证。它将命名后的子代理配置转化为模型可见的代理工具，允许 Root Agent 通过工具调用（如 subagent_<name>）来委托特定任务。
核心功能¶
该插件提供了以下核心能力：
- 配置管理：支持在设置页面创建、编辑和删除子代理配置。
- 上下文模式：在
spawn（独立子上下文）和fork（继承已完成父对话）两种模式中选择。 - 路由策略：可选择跟随当前对话的 Provider/Model，或固定自定义的模型路由。
- 推理配置：可选择跟随当前推理等级或固定自定义的推理 effort。
- 动态刷新：可从 Host 的模型目录中刷新自定义选项。
- 热更新：应用配置更新无需重启 Host，已存在的可延续子代理会保留创建时的路由策略。
- 工具接口：除 UI 外，还提供
custom_subagent工具供模型管理配置。 - 默认代理：支持标记一个配置为“默认子代理”，在系统提示词中引导模型使用对应的工具。
安装与启用¶
安装前请确保 DeepSeek Harness 版本兼容（需 0.1.1-rc.2 兼容包），并且目标 Profile 加载了 Web UI（例如 web profile）。
安装命令¶
在终端执行以下命令将插件安装到 Web profile：
dsh plugin --profile web add github:xie-tj/dsh-subagent
验证安装¶
安装完成后，可以通过以下命令检查依赖是否正确加载：
dsh plugin --profile web why
在输出结果中查找 dsh-subagent 相关条目，确认 cordis.patch.yml 层已合并。
典型用法¶
安装并重启 Web Profile 后，可通过以下方式使用：
-
配置端：
打开 Settings → Subagents。在此页面可以新建或编辑配置项，设置后端模式（spawn/fork）、模型路由和推理等级。 -
运行端：
每个活动的 Root Agent 会自动获得subagent_<name>工具（例如subagent_fast）。Agent 可直接调用这些工具来执行预设的任务策略。同时，Agent 也可通过custom_subagent工具进行配置管理。
适用场景与注意¶
- 适用对象：需要在多个对话中复用特定模型组合和推理策略的开发者。
- 状态管理：插件本身不维护本地磁盘状态，配置数据存储在 DSH 的设置提供者、Profile 依赖清单和组合层中。
- Profile 依赖：由于需要 Web UI 和特定工具暴露，安装时必须指定一个加载了 Web 运行时的 Profile。若安装到非 Web Profile，需额外确保该 Profile 加载了
@deepseek-ai/dsh-client-ui-settings以渲染设置页面。
结语¶
dsh-subagent 通过标准化的配置与工具映射，降低了在 DSH 中构建多模型、多策略子代理系统的门槛。你可以通过 GitHub 查看源码，或在 SkillHub 了解更多详情。
