SeverusZh/dsh-plugin-subagent-director

Name: SeverusZh/dsh-plugin-subagent-director
Author: SeverusZh

Plugin插件 Native原生 ⭐ 18 MIT Subagents & Orchestration子代理与编排 Models & Routing模型与路由 Prompts & Skills提示词与技能

子代理总监：为DeepSeek Harness（dsh插件）提供按子代理的LLM提供商/模型选择及角色模板

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

Subagent Director is a native plugin built exclusively for DeepSeek Harness (DSH). It enables users to assign specific LLM providers and models to DSH subagents, and plan the division of labor between the main agent and subagents via preconfigured or custom role templates. To install the latest version, users can simply run dsh plugin --profile <name> add dsh-plugin-subagent-director in the command line, and the plugin will automatically set up all required configuration entries. It has a range of features including constrained model selection from the official allowlist, hot config reload, role matching by display name, and a four-step fallback chain for model routing.

After installation, users can manage default model settings and add, edit, or delete role templates directly through the DSH settings panel, or by editing the subagent-director namespace in settings.yaml. The plugin comes with several prebuilt common roles, including code reviewer, architect, test engineer, technical docs writer, researcher, and translator, each with a preconfigured persona and responsibility description. The main agent will automatically get a list of available roles, so it can delegate tasks to the appropriate subagent during the conversation without extra manual configuration. This makes it easy for users to split complex tasks into specialized sub-tasks handled by different models.

Version 0.5.0 and above of this plugin only supports DSH version 0.1.2-alpha.4 or newer, users running older DSH versions need to install version 0.4.0. If you uninstall the plugin, any sessions that used it will not open in environments where the plugin is not loaded, as there is currently no official API for registering third-party event types. The plugin is released under the open-source MIT license, so it is free to use and modify. For local development, users need to install dependencies and build the project first before mounting it via the link method.

这是一个专为 DeepSeek Harness (DSH) 开发的原生插件，核心功能是为 DSH 的子代理指定 LLM 供应商与模型，并通过预设的角色模板规划主代理和子代理的分工。它支持仅从官方授权列表选择模型、配置热更新、按显示名匹配角色，内置四级模型路由回退链，还提供 DSH 设置面板内的可视化界面管理默认模型和自定义角色模板。

用户安装后可以直接通过 DSH 命令行完成安装，插件会自动从自带的配置文件挂载所需条目，无需用户手动插入配置。用户可以通过 DSH 设置面板或编辑 settings.yaml 配置默认模型、添加自定义角色，插件内置了代码审查员、架构师、测试工程师等多个常用角色模板可供直接使用。主代理会自动获得角色清单指引，对话中即可按需求委派子代理完成分工。

本插件 v0.5.0 及以上版本仅支持 DSH 0.1.2-alpha.4 及以上版本，旧版本 DSH 需要安装 0.4.0 版。卸载插件后，之前用过本插件的会话无法在未挂载插件的环境中打开，这是上游暂未提供对应 API 导致的已知限制。本插件采用 MIT 许可证开源，可免费使用，本地开发需要先安装依赖并构建，再通过链接方式挂载。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：dsh-plugin-subagent-director（SeverusZh/dsh-plugin-subagent-director）
仓库：https://github.com/SeverusZh/dsh-plugin-subagent-director
本站详情页：https://www.yhbd.top/plugins/severuszh-dsh-plugin-subagent-director/
本站登记：类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 18 · 最近提交 2026-09-29 · 主语言 TypeScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示

18 stars - an early-stage project星标 18，属于早期项目

DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

dsh plugin --profile web add dsh-plugin-subagent-director

把 SeverusZh/dsh-plugin-subagent-director 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

15.4 KB · 缓存于 2026-09-29 05:50:11 · 15.4 KB

🎬 Subagent Director（子代理导演）

为 DeepSeek Harness 的 subagent 指定 LLM 供应商与模型，并用「角色模板」规划主代理与子代理的分工。

npm version license

English · 特性 · 官方选择器适配 · 快速开始 · 角色模板 · 术语 · 开发 · FAQ

特性

供应商与模型选择 —— 为 subagent 配置默认 LLM 供应商（route）与模型；每次委派也可以由模型显式指定；
受控的模型选择 —— provider/model 只从官方 subagent-model-selection 授权列表（allowedModels）中选择：显式传入未授权路由为硬错误，角色/默认层未授权路由被丢弃并回退继承（不与官方 dsh-tool-subagent 双重写模型路由）；
配置热更新 —— settings.yaml / 插件配置页的改动即时生效，无需重启；
角色按显示名引用 —— role 参数未命中 id 时按 displayName 精确匹配（重名取定义顺序第一个并提示），模型按显示名也能命中模板；
角色模板 —— 定义「代码审查员」「翻译员」等角色：职责描述（给主代理看）+ persona（注入子代理）+ 可选模型绑定；
四级回退链 —— 单次调用参数 > 角色绑定 > 插件默认 > 继承主代理（未配置时零侵入）；
主代理指引 —— 系统提示自动注入角色清单，主代理知道何时委派给谁；
配置界面 —— 插件详情页内可视化配置（插件列表 → dsh-plugin-subagent-director；默认模型 + 角色卡片增删改）；设置面板不再承载本插件配置；
continuable 后台 —— 返回可续聊子代理 id，配合 send_message 持续委派；
释放可持续子代理 —— 模型可见工具 close_subagent(subagent_id) 与子代理会话页的「终止可持续状态」按钮，主动释放已完成但仍驻留的 continuable 子代理（内部调用 DSH 核心 drainContinuableChildren）；
可观测性 —— 打开子代理会话时，composer 下方显示其实际运行的供应商/模型（从会话 request/header 记录读取真实路由；读不到时优雅降级）；

与官方子代理选择器的适配

兼容性：v0.5.5 支持 DSH 0.1.5-rc.1+（@deepseek-ai/dsh-* peer 放宽为 >=0.1.7-rc.1），已在 0.1.5-rc.1 / 0.1.5-rc.2 / 0.1.6-alpha.2 / 0.1.7-rc.1 / 0.1.7-rc.2 / 0.2.0-rc.1 实测（alpha4-probe + real-cordis 探针通过，实测 0.1.7-rc.1 / 0.1.7-rc.2 依赖集；0.2.0-rc.1 上通过新的兼容性门禁并正常加载）。设置子系统已迁移至 0.1.7 的 SettingsForms（插件 Config schema + volatile 热更 + 自建配置页）。旧版 DSH（0.1.0-rc.6 及更早）请使用最后兼容的 npm 版本 0.4.0。

DSH alpha.4 起，官方内置 subagent 的模型选择收敛到 subagent-model-selection 设置段（allowedModels 授权列表）。本插件 v0.5.0 完全适配该机制：

只从授权列表选择 —— route-resolver 把 provider/model 约束在官方 subagent-model-selection.allowedModels 内：显式传入未授权路由为硬错误；插件默认层 / 角色绑定层的未授权路由被丢弃并回退继承主代理；
不再双重写模型路由 —— 移除 rc 时代的 applyDefaultRoute 补丁缝，插件与官方选择器不会各自覆盖同一条路由（设置面板可选的 provider/model 即官方「插件-插件配置-Subagent池」里的选项）；
客户端半同步移植 —— 移除 rc 时代对 @deepseek-ai/dsh-client-runtime/client 的全部引用（alpha.4/alpha.5 宿主均不携带该包），dock 读数改读 alpha.4 会话 request/header 记录，配置页在 alpha.4/alpha.5 宿主均可正常加载。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要，完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

渲染基于仓库 SeverusZh/dsh-plugin-subagent-director 的 README.md。在 GitHub 查看原文 →