dsh-subagent-default-model#plugin

dsh-subagent-default-model

为 DeepSeek Harness (DSH) 中的子代理（subagent）派发选择默认模型，可通过 ~/.dsh/settings.yaml 配置。

当创建子代理时未显式指定 model，本插件注入配置的默认模型 —— 因此所有 subagent、subagent_fork 以及任何省略 agentOptions 的工具调用都会经过它。显式传参的覆盖始终生效；配置段缺失或不完整时保持原有行为（子代理继承父会话路由）。

功能特性

单模型 —— 所有子代理运行在同一个配置模型上。
多模型 —— models 列表配合 round-robin / random 策略，让并行子代理分散到多个模型。
连接失败自动切换 —— 子代理遇到连接类失败时，在 models 列表内按 strategy 自动切换模型重试（仅 subagent，主代理不受影响）。
推理强度 —— 可为每个模型条目指定 reasoningEffort（如 high、medium、low）；Web 界面从模型目录加载可用的强度。
热重载 —— 设置变更立即作用于下一次派发。
干净卸载 —— Cordis 销毁时还原原始服务方法。

截图

设置面板（设置 → 插件配置 → 子代理默认模型）：配置一个或多个模型路由，支持 round-robin / random 分配策略与每路由推理强度。

子代理默认模型设置面板

效果验证：10 个子代理在 deepseek-v4-flash 与 Kimi-k3 之间 5/5 均衡分配（round-robin 实测）。

子代理默认模型分配统计

市场

安装

从 npm registry 安装：

npm install dsh-subagent-default-model

或通过 DSH 插件命令（等价，内部同样走 npm）：

dsh plugin --profile desktop add dsh-subagent-default-model

发布（Release / Publish）

发布到 npm registry。完整权威流程见仓库根目录 RELEASING.md（含 2FA 确认、tag 修正、代理、验证步骤）。

要点速览：

# 1. 测试：npm --prefix plugin test
# 2. 更新版本号（plugin/package.json 的 version 字段）和 CHANGELOG.md
# 3. 提交并打标签
git add plugin/package.json plugin/CHANGELOG.md
git commit -m "chore: 版本升级至 X.Y.Z"
git tag -a vX.Y.Z -m "vX.Y.Z: <说明>"
git push origin main
git push origin vX.Y.Z

# 4. 发布到 npm（账号若开启 2FA，需在浏览器确认一步）
cd plugin
npm publish

⚠️ 发布前先跑一遍测试：npm --prefix plugin test。

package.json 的 files 字段已限定只发布 lib/、icons/、cordis.patch.yml、LICENSE、README.md、README.en.md、CHANGELOG.md，test/ 和 node_modules/ 不会进入发布包。

本地安装（DSH Desktop / desktop profile）：

# 在 ~/.dsh/profiles/desktop 下执行（或使用 dsh plugin 命令）
npm install dsh-subagent-default-model
# 或本地开发：dsh plugin --profile desktop add /路径/plugin（link: 安装，改码即时生效）

说明：

本地开发用 link: 安装：dsh plugin --profile desktop add /Users/dmh2002/DshProject/dsh-subagent-default-model/plugin，node_modules 里是源码软链，改代码后重启 DSH Desktop 生效
正式安装 / 他机安装使用 npm registry 版本（见上方 Install）

配置

在 ~/.dsh/settings.yaml 中添加：

# 单模型
subagent-default-model:
  provider: deepseek-official
  model: deepseek-v4-pro

# 或多模型
subagent-default-model:
  provider: deepseek-official
  models:
    - deepseek-v4-pro
    - deepseek-v4-flash
  strategy: round-robin  # round-robin | random

# 带推理强度
subagent-default-model:
  provider: deepseek-official
  models:
    - model: deepseek-v4-reasoner
      reasoningEffort: high
    - provider: other-provider
      model: gpt-5.6
      reasoningEffort: max
  strategy: round-robin  # round-robin | random

字段	类型	默认值	说明
`provider`	string	—	字符串类型模型条目的 provider。
`model`	string	—	单模型 id（向后兼容）。
`models`	array	`[]`	模型条目列表（string 或 `{provider, model, reasoningEffort?}` 对）。
`strategy`	string	`round-robin`	分配策略：`round-robin` 或 `random`。
`failoverEnabled`	boolean	`true`	子代理连接失败时在 `models` 列表内按队列与策略切换模型（仅 subagent）。
`reasoningEffort`	string	—	可选推理强度（如 `high`、`max`）。

子代理连接失败自动切换

开启 failoverEnabled（默认开启）后，子代理自身的循环遇到连接类失败时，插件会在 models 列表内按 strategy 自动切换模型并重试：

连接类失败 —— 命中以下任一错误码才切换：RATE_LIMIT、QUOTA、SERVER、TIMEOUT、TRANSPORT、EMPTY_RESPONSE。认证错误（如 AUTH）等非连接类失败不会触发切换。
round-robin：按列表顺序切到下一个模型（队列）。
random：随机挑一个模型（不判断之前是否用过）。
需要 ≥ 2 个模型 —— 当 models 少于 2 项时本功能不生效。
耗尽即放行 —— 列表内全部模型轮试失败后，放行真实错误，不做无限重试。
切换时丢弃继承的 reasoningEffort —— 换到新 provider/model 后按默认推理强度请求，避免把主模型的强度强加给不支持它的 provider。
Run 内粘性 —— 同一子代理 run 的后续 step 保持在切换后的模型上。

该机制基于官方 agent/request-error + agent/request 瀑布，且仅对 subagent 生效——主代理循环不会被切换。

工作原理

请求携带显式 agentOptions
  → subagent-default-model 设置
  → 继承父会话路由

插件包装宿主 ctx.subagents 服务（start / startContinuable），覆盖所有派发路径 —— 内置的 subagent / subagent_fork 工具，以及任何调用该服务但未提供 agentOptions 的自定义工具。

專案介紹

專案資訊與收錄訊號

資料評分

安裝與使用

專案截圖

倉庫 README