前言¶
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 倉庫
