SeverusZh/dsh-plugin-subagent-director
31最近提交 2026年8月14日
dsh-plugin-subagent-director DSH 插件
Subagent Director（子代理导演）是一个 DeepSeek Harness 插件，允许你为子代理指定具体的 LLM 供应商和模型，支持按角色或按调用临时覆盖。它提供角色模板（如代码审查员、翻译员），包含职责描述、persona 和可选模型绑定，并采用四级回退链实现灵活配置。设置面板可可视化地管理默认模型和角色卡片。
如何安装 dsh-plugin-subagent-director DSH 插件
dsh plugin --profile <name> add dsh-plugin-subagent-director来源命令需要人工核对。复制不会执行命令。
dsh-plugin-subagent-director DSH 插件数据来源
dsh-plugin-subagent-director DSH 插件快照日期：2026年8月16日
discovered
dsh-plugin-subagent-director DSH 插件能做什么
- 为子代理配置默认的 LLM 路由（供应商）和模型，支持每次调用时通过工具参数临时覆盖。
- 定义角色模板，包含描述、persona 和可选的模型绑定。
- 四级回退链：调用参数 > 角色绑定 > 插件默认 > 继承主代理（未配置时零侵入）。
- 系统提示自动注入角色清单，让主代理知道何时委派给谁。
- DSH 设置面板内可视化配置默认模型和角色卡片（增删改）。
- 支持可续聊的子代理后台会话，可通过 send_message 持续委派。
dsh-plugin-subagent-director DSH 插件适合哪些场景
- 为代码审查子代理指定专用的推理模型（如 deepseek-reasoner）。
- 创建一个翻译员角色，始终使用便宜的模型进行快速翻译。
- 让主代理通过一次工具调用动态选择多个子代理角色。
- 让子代理使用不同的供应商（如 pi-ai），而主代理仍用默认供应商。
- 构建多步骤工作流，每个子代理调用都有独立的模型分配。
dsh-plugin-subagent-director DSH 插件适合谁
- 希望精细控制子代理 LLM 供应商和模型的 DSH 用户。
- 在 DSH 中构建基于角色委派的多代理系统的开发者。
dsh-plugin-subagent-director DSH 插件的限制
- 需要 DSH 0.1.0-rc.x 或更高版本（如徽章所示）。
- 需要在 cordis.patch.yml 中添加两个插件条目（主条目 + 桥接条目）才能使用 Web 设置界面。
- 可观测性功能（在 composer 下显示子代理实际运行的供应商/模型）暂不可用，仍在开发中。
- 设置命名空间仅通过专用的桥接条目暴露给 Web UI；无头模式会自动跳过桥接条目。
dsh-plugin-subagent-director DSH 插件的仓库 README 摘录
以下文字摘自 dsh-plugin-subagent-director DSH 插件的上游仓库 SeverusZh/dsh-plugin-subagent-director 的 README，版权归原作者，仅作引用。
> 为 DeepSeek Harness 的 subagent 指定 LLM 供应商与模型，并用「角色模板」规划主代理与子代理的分工。 <p align="center"> <img alt="npm version" src="https://img.shields.io/npm/v/dsh-plugin-subagent-director?label=npm"> <img alt="license" src="https://img.shields.io/npm/l/dsh-plugin-subagent-director"> <img alt="DeepSeek Harness" src="https://img.shields.io/badge/DeepSeek%20Harness-0.1.0--rc.x-blue"> </p> [English](#english) · [特性](#特性) · [快速开始](#快速开始) · [角色模板](#角色模板) · [术语](#术语) · [开发](#开发) · [路线图](#路线图) · [FAQ](#faq) --- ## 特性 - **供应商与模型选择** —— 为 subagent 配置默认 LLM 供应商（route）与模型；每次委派也可以由模型显式指定； - **角色模板** —— 定义「代码审查员」「翻译员」等角色：职责描述（给主代理看）+ persona（注入子代理）+ 可选模型绑定； - **四级回退链** —— 单次调用参数 > 角色绑定 > 插件默认 > 继承主代理（未配置时零侵入）； - **主代理指引** —— 系统提示自动注入角色清单，主代理知道何时委派给谁； - **设置界面** —— DSH 设置面板内可视化配置（默认模型 + 角色卡片增删改）； - **continuable 后台** —— 返回可续聊子代理 id，配合 send_message 持续委派； - **可观测性** —— 打开子代理会话时，composer 下方显示其实际运行的供应商/模型。⚠️ 该功能暂不可用，正在开发中； ## 快速开始 ### 安装 ```bash dsh plugin --profile <name> add dsh-plugin-subagent-director ``` 或本地开发时以 file: / link: 路径挂载（示例见下）。 ### 配置（cordis.patch.yml） 需要**两个插件条目**（本包拆分了桥接条目，用于把设置命名空间暴露给 Web UI）： ```yaml - insert: - id: subagent-director name: dsh-plugin-subagent-director
阅读完整 README仓库许可: MIT
dsh-plugin-subagent-director DSH 插件常见问题
为什么需要在 cordis.patch.yml 中添加两个插件条目？
DSH 的 Web API 只向白名单内的 settings 命名空间开放读写。本插件通过自注册的 `/subagent-director` HTTP 路由桥接自己的命名空间，而该路由依赖的 `webServer` 服务只能通过 Cordis 的 `inject` 获取。为了避免将 web 服务器依赖引入主插件，桥接功能被拆分为独立的 `subagent-director-bridge` 条目。在无 Web 界面的无头模式下，桥接条目会自动不激活，主条目不受影响。
如果不配置任何角色，插件的行为是怎样的？
如果未配置任何角色，插件的表现与未安装时完全一致：子代理继承主代理的模型，零侵入。四级回退链会一直回退到继承主代理的设置。
新的供应商或 API 密钥会自动出现在设置界面中吗？
会的。设置页面订阅了供应商和设置变更事件。当你在 Models 页面新增供应商或 API 密钥后，插件设置界面中的下拉列表会自动刷新，无需重启。
能否在单次子代理调用中临时覆盖模型，而不改变角色？
可以。调用 `subagent_role` 工具时，可以传递可选的 `provider` 和 `model` 参数。这些参数在四级回退链中优先级最高（调用参数 > 角色绑定 > 插件默认 > 继承主代理）。例如：`subagent_role({ role: "code-reviewer", model: "deepseek-chat", prompt: "..." })`。
可观测性功能（在 composer 下显示实际模型）已经可用了吗？
目前尚未可用。README 明确说明该功能正在开发中，当前不可用。该功能计划在未来的版本（v0.2）中实现，届时子代理的实际供应商和模型会显示在 composer 下方。