NinjaSln-labs/dsh-subagent-router0

dsh-subagent-router

为 DeepSeek Harness 提供基于模型路由的子智能体委派工具,支持单次调用覆盖配置、自动路由策略、失败升级与兜底机制,并提供子智能体模型目录工具。

AI 分析

核心用于实现多模型子智能体的智能分发与容灾重试。适合需要构建复杂多 Agent 协同任务、追求高可用性与自动降级/升级路由机制的系统架构师和高级开发者。

包名
dsh-subagent-router
版本
0.3.0
许可证
MIT
最近更新
2026年9月2日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:NinjaSln-labs/dsh-subagent-router

配置

设置页 UI:插件提供 client half,配置可在 设置 → 插件配置 里直接编辑(subagent-router 卡片)。全部可配置项都是 live 字段——编辑即时写入用户设置层(~/.dsh/settings.yamlsubagent-router 段),保存后下一次 subagent_model 调用即生效,无需重启;清除字段回退到下方组合行配置。

也可以写在组合行的 config 里(作为 base 层,被设置页 user 层覆盖):

字段默认含义
autoEscalatetrue前台运行失败后是否用高一档自动重试一次。
autoReroutetrue终态失败(quota/auth)时是否换到健康 provider 路由重试。
autoEscalationTiers1同一 provider 上瞬态失败的最大升级次数(0 表示不升级)。
autoProviderOrderprovider 优先级model: "auto" 按此顺序解析 provider(未列出的排在之后);父路由不健康或缺失时用它兜底。不配则用注册表顺序。
autoTierPolicy每档选型模式{ trivial|standard|complex: 'anchor'|'cheapest'|'strongest' }anchor=父路由健康时沿用父模型;cheapest=目录里命名分最低;strongest=最高。未配的档位保持内置启发式。
autoTierPicks每档显式候选序{ trivial|standard|complex: [modelId, ...] },完全覆盖该档选型;候选是全局模型优先级,按 provider 优先级顺序找,第一个被健康 provider 广告的模型胜出(可跨 provider)。
recommendTimeoutMs8000subagent_recommend 的一次性 LLM 分类调用超时(毫秒,范围 1000–60000);超时降级到命名启发式并说明原因。

固定默认(不可配置):注册期行为固定为合理默认,不再暴露为配置项(早期版本这些字段可配但「保存」不生效,是陷阱):

槽位固定值理由
子代理提供方spawndsh 主程序的默认可续子代理提供方。
委派/目录工具名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]  # 可选:重任务显式候选序