前言¶
DeepSeek Harness（DSH）采用插件化架构。在使用官方子代理工具（subagent / subagent_fork）时，开发者往往需要对不同根会话的模型提供方、模型名称或推理模式进行精细化控制，同时希望有一套统一的默认路由策略。
dsh-subagent-conductor 旨在解决这一问题。它作为一个独立的设置与默认路由层，运行在官方子代理工具的选择逻辑之前，提供根会话选择、角色模板管理和全局默认路由配置能力。
插件定位¶
该插件由用户 YrracOwl 维护，属于 admin-security 类别。它不修改 DSH 本体，也不替换官方工具 subagent 或 subagent_fork，也不注册自己的委派工具。它主要提供运行在官方工具选择逻辑之前的设置层，负责解析 Provider、Model 和 Reasoning Effort。
核心功能¶
-
生命周期安全的路由与角色控制
插件在子代理请求边界运行，提供基于会话、角色和全局默认的层级化路由策略。 -
输入框根会话选择
在输入框根会话选择器中，用户可以为不同的根会话指定 Provider、Model 和 Reasoning Effort。该选择器渲染在对话输入区域的左侧，支持查看各值的有效来源（默认角色、根会话、全局默认、官方或原生继承）。 -
角色模板与可视化编辑器
支持创建和管理角色模板，包含 ID、显示名称、描述以及对应的 Provider/Model/Reasoning Effort 组合。提供可视化的增删改查界面，支持通过 JSON 进行批量编辑和备份。 -
全局默认路由配置
允许设置全局默认的 Provider/Model 对及推理模式，当没有特定根会话选择时生效。
安装与启用¶
通过命令行安装插件：
dsh plugin --profile web add dsh-subagent-conductor
安装后需要重启 DSH Web 进程，插件才能生效。
典型用法¶
- 基础配置：安装并重启后，在设置面板中管理全局默认路由和默认角色。
- 批量管理：使用 JSON 导入/导出功能对角色进行批量编辑和备份。
- 版本迁移：从 DSH 0.1.x 升级至 0.2 时，需手动在 profile patch 中配置
defaultRoute和sessionSelections。
适用场景与注意¶
- 版本兼容性：插件兼容 DSH <= 0.1.5 和 DSH >= 0.1.7-rc.2。
- 功能变更：v0.2 版本移除了 v0.1 中的
subagent_direct工具和私有 marker 相关功能。v0.2 移除了subagentProvider、backgroundMode、maxDepth、enableRunInBackground等配置项，这些功能现在由官方工具行管理。 - 迁移注意：DSH >= 0.1.7 时，若存在 v0.1 的配置文件，插件启动时会提示警告。需手动在 profile patch 中迁移
defaultRoute和sessionSelections配置。 - 依赖项：插件依赖
@deepseek-ai/schemastery，版本约束需满足^3.18.4。 - 许可证：使用 MIT 许可证。
总结¶
dsh-subagent-conductor 为 DeepSeek Harness Web 提供了结构化的子代理路由管理能力。它不干扰官方工具的核心逻辑，而是通过前置层的设置，帮助用户在根会话层面统一管理模型选择和角色模板。
更多信息请访问：
* GitHub 仓库：https://github.com/YrracOwl/dsh-subagent-conductor
* 技能目录：https://www.skillhub.cn/plugins/YrracOwl/dsh-subagent-conductor
