dsh-llm-fallbacks

English | 中文

dsh（DeepSeek Harness）的自动模型降级插件：当 root agent 或 subagent 的模型请求持续失败（重试耗尽、权限、配额超限、限流 429）时，按角色/模型 fallback 链自动切换 provider/model，当前 step/turn 在目标模型上继续完成——任务不因模型问题中断。

一句话安装（见 安装）：

dsh plugin --profile web add dsh-llm-fallbacks   # 钉版本：加 @

能力一览

• root / subagent 自动降级：任意 agent 在模型故障下按链切换到下一个可用 provider/model，无需手动换模型。
• 两块制配置：块 1 rootChain——root 主代理唯一降级链（空 = root 不降级）；块 2 声明式角色——roles.list 角色实体（id/label/description/chain/fallback）供 roles.rules 按 id 引用（或内置 inherit）；未命中规则 → inherit → rootChain。
• 条目语法：链条目为 provider/model（精确切换）或 provider/*（保留失败模型 id 仅换 provider）——旧链键命名空间（provider/model 键、角色名键）已删除。
• 冷却与回主：被切离/失败的模型在冷却期内不再入选；revertPolicy: cooldown-expiry 冷却到期后自动回主模型，never 会话内不回。
• 行为可见：每次切换追加持久化会话事件 fallbacks/switch（from/to/role/reason），配合 info 级日志（候选尝试顺序与跳过原因）与设置 → 插件配置 → Fallbacks 卡片上的只读状态块，无静默换模型。
• 安全阀：每 step 的 maxSwitchesPerStep 超限后停止切换、保持原错误语义，防止链循环放大延迟；mode: 'always' 的 provider 另有重试上限（alwaysModeRetryCap）。
• 无配置回归（no-op）：enabled 默认关闭（false），无 rootChain/角色链 / 未命中触发码 / 角色解析失败时插件完全 no-op——行为与未安装时一致，不产生任何事件。

安装

一句话安装

dsh plugin --profile web add dsh-llm-fallbacks   # 钉版本：加 @

registry 安装拉取的是已构建产物（dist/），目标机无需构建。插件为纯挂载：对 dsh 源码树零修改，无任何补丁 / postinstall 步骤——dsh 升级无需重打。版本跟随 npm dist-tag（默认 ）；钉精确版本：。