NinjaSln-labs/dsh-subagent-router ↗★ 0
dsh-subagent-router
为 DeepSeek Harness 提供基于模型路由的子智能体委派工具,支持单次调用覆盖配置、自动路由策略、失败升级与兜底机制,并提供子智能体模型目录工具。
AI 分析
核心用于实现多模型子智能体的智能分发与容灾重试。适合需要构建复杂多 Agent 协同任务、追求高可用性与自动降级/升级路由机制的系统架构师和高级开发者。
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:NinjaSln-labs/dsh-subagent-router说明文档
阅读完整 README ↗配置
设置页 UI:插件提供 client half,配置可在 设置 → 插件配置 里直接编辑(subagent-router 卡片)。全部可配置项都是 live 字段——编辑即时写入用户设置层(~/.dsh/settings.yaml 的 subagent-router 段),保存后下一次 subagent_model 调用即生效,无需重启;清除字段回退到下方组合行配置。
也可以写在组合行的 config 里(作为 base 层,被设置页 user 层覆盖):
| 字段 | 默认 | 含义 |
|---|---|---|
autoEscalate | true | 前台运行失败后是否用高一档自动重试一次。 |
autoReroute | true | 终态失败(quota/auth)时是否换到健康 provider 路由重试。 |
autoEscalationTiers | 1 | 同一 provider 上瞬态失败的最大升级次数(0 表示不升级)。 |
autoProviderOrder | — | provider 优先级:model: "auto" 按此顺序解析 provider(未列出的排在之后);父路由不健康或缺失时用它兜底。不配则用注册表顺序。 |
autoTierPolicy | — | 每档选型模式:{ trivial|standard|complex: 'anchor'|'cheapest'|'strongest' }。anchor=父路由健康时沿用父模型;cheapest=目录里命名分最低;strongest=最高。未配的档位保持内置启发式。 |
autoTierPicks | — | 每档显式候选序:{ trivial|standard|complex: [modelId, ...] },完全覆盖该档选型;候选是全局模型优先级,按 provider 优先级顺序找,第一个被健康 provider 广告的模型胜出(可跨 provider)。 |
recommendTimeoutMs | 8000 | subagent_recommend 的一次性 LLM 分类调用超时(毫秒,范围 1000–60000);超时降级到命名启发式并说明原因。 |
固定默认(不可配置):注册期行为固定为合理默认,不再暴露为配置项(早期版本这些字段可配但「保存」不生效,是陷阱):
| 槽位 | 固定值 | 理由 |
|---|---|---|
| 子代理提供方 | spawn | dsh 主程序的默认可续子代理提供方。 |
| 委派/目录工具名 | subagent_model / subagent_models | 标准命名,改名无场景价值。 |
| 后台模式 | continuable | 与 dsh harness 原生 subagent 语义一致:默认后台、立即返回持久子代理 id、同会话可续聊;需要前台等待时显式传 run_in_background: false。要求提供方具备 prepareContinuable(不支持则挂载时 fail-loud)。 |
| 功能开关 | 全开(run_in_background / model: "auto" / 目录工具) | 关闭无场景价值。 |
| 深度上限 | provider-managed | 交给提供方管理递归预算,任何提供方可挂载(不要求 depthLimit 能力)。 |
示例行:
- id: subagent-router
name: 'dsh-subagent-router'
带模型路由优先级的示例(按你自己的供应商偏好配置):
- id: subagent-router
name: 'dsh-subagent-router'
config:
autoProviderOrder: [deepseek-official, pi-ai-cn] # 供应商优先级
autoTierPolicy:
trivial: cheapest # 琐碎任务永远用最便宜的
standard: anchor # 普通任务跟随父模型
complex: strongest # 重任务用最强模型
autoTierPicks:
complex: [deepseek-v4-pro, pi-3-maxi] # 可选:重任务显式候选序