前言¶
DeepSeek Harness (DSH) 的理念是「一切皆插件」。官方已提供完整的 subagent 底层能力（如 spawn、continuable、toolFilter），但模型目前只有「可以派」的能力，缺乏「何时主动派、怎么拆分任务、如何等待收敛」的编排层。dsh-orchestrate 是一个第三方插件，构建于官方 subagent 能力族之上，填补了决策层、编排模式层与收敛层的空白，让主 Agent 能够主动、积极地调度子 Agent 完成复杂工作流。
安装与启用¶
本插件依赖官方的 subagent 能力族，安装时需指定对应的 provider 版本。以下命令从 npm 安装已验证的组合：
dsh plugin --profile demo add \
@deepseek-ai/dsh-subagent-spawn-in-process@0.1.0-rc.6 \
dsh-orchestrate@0.3.1
安装后，插件将自动注入编排决策能力。如需禁用自动注入，可在配置中设置 auto: false。
核心能力¶
插件提供以下编排工具，用于任务拆分、审查、探索、收敛与管理：
orchestrate_delegate：并行拆分任务。支持单任务或任务书数组，支持通过模板库引用预定义任务书，支持后台运行（run_in_background）与收敛模式（all/any）。orchestrate_review：对抗式审查。通过多个只读子 Agent 挑剔任务方案，返回风险、假设挑战、边界与建议的机械汇总。orchestrate_explore：多样性探索。沿独立方向探索，返回带置信度的发现报告。orchestrate_converge：收敛后台编排。按runId阻塞等待子会话完成并返回汇总。orchestrate_status：查询任务与子会话状态。orchestrate_stop：中止进行中的编排任务。- 模板库：内置 10 个任务书模板（如调研对比、代码审查），支持通过
template参数参数化调用。
使用示例¶
在 DSH 交互中，主 Agent 可以直接提出并行需求。例如：
并行调研这三个方向：① SQLite vs DuckDB 存储，② RAG chunk 策略，③ 索引方案。
Agent 会调用 orchestrate_delegate 并返回结构化汇总。对于代码审查场景，可直接调用模板：
调用 orchestrate_delegate，template=code-review-multi，templateArgs={ module: ['src/a', 'src/b'] }
配置与限制¶
配置项¶
| 键 | 默认值 | 含义 |
|---|---|---|
provider |
spawn |
子 Agent 使用的 provider 名称 |
auto |
true |
是否注入 orchestration:policy 决策段 |
denyTools |
orchestrate_* |
子 Agent 需隐藏的工具列表 |
maxDepth |
1 |
子 Agent 递归深度上限 |
templatesDir |
包内 delegations/ |
模板目录路径 |
registryCapacity |
100 |
编排记录保留上限 |
使用限制与注意事项¶
- 第三方插件：本插件非官方出品，安装前请检查源码与许可证。
- 权限限制：依赖官方部署 sandbox 默认
read-only，若部署改为 workspace-write，子 Agent 将继承写权限。 - 状态持久化：编排状态存于进程内，重启后需重新编排。
- 成本估算：
costTokens为估算值，非官方精确计数。 - 工具隔离：子 Agent 自动隐藏
orchestrate_*工具，防止递归调用。 - 任务拆分：
task参数路径不自动拆分，需自行转换为任务书数组。
结语¶
dsh-orchestrate 通过模板化与标准化工具，将多智能体协作方法论工程化，适合需要并行处理、多视角审查与复杂逻辑拆解的场景。如需查看更多模板或贡献代码，可访问：
* 插件目录
* GitHub 仓库
