本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-llm-fallbacks

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-llm-fallbacks

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• • anthropic/claude-3-5-sonnet # 先走
• • deepseek-official/deepseek-v4-flash # 最后一档（Flash 或 Pro）
• • kind: preset # 冻结的 UTC+8 窗口；仅链可编辑
• • anthropic/claude-3-5-sonnet
• • kind: custom # 自定义窗口（可跨午夜）

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后需要做什么？

安装插件后还需要在共享设置（web 端 Setting → Plugins → Fallbacks 卡片，或 $DSH_HOME/settings.yaml 的 fallbacks: 段）里把 enabled 设为 true 并配置至少一条 rootChain，否则插件是不会干预请求的零改动 no-op。

配置保存在哪里？

保存在 DSH 共享设置文档（默认 $DSH_HOME/settings.yaml 的 fallbacks: 命名空间），web 设置卡、dsh-tui /settings、YAML 三个表面读写同一份配置；插件不另存本地副本，dsh 升级不会丢失配置。

升级到 0.2.2 之后老的会话为什么打不开？

0.2.2 之前的版本会往会话日志里写 fallbacks/switch 事件，插件和宿主解析的是不同模块实例，导致新版本 dsh 无法加载这类会话。修复方法见 README 的 Repair 小节，先停 dsh 再运行 pnpm repair:fallbacks-switch-logs -- --apply --backup，脚本会把这些老事件标记为可忽略并保留 .bak 备份。0.2.2 之后不再写新事件，无需修复。

rootChain 最后一项必须是 V4 官方模型吗？

是的，全天链最后一项必须恰好是 deepseek-official/deepseek-v4-flash 或 deepseek-official/deepseek-v4-pro 二选一，作为最后兜底；前面的项才是按顺序走的降级项。非官方模型尾节点在启动时只告警不报错，但 web 设置卡和 gateway 端 save 时会直接拒收，无法用界面保存。

dsh-tui 怎么用？

dsh-tui profile 下 /fallbacks 是只读诊断（看当前会话的 origin、角色、降级链、近期切换、cooldown），/fallbacks config 是配置回看（同上一行说明）。编辑请走 /settings 里的 fallbacks 段，需要 dsh-tui ≥ v0.8.5；老版本只有 YAML 文件可改。

不卸载但临时关掉怎么办？

把 enabled 设为 false 即可，与未安装效果一致；也可通过 fallbacks.presets: 'none' 停止 7 个内置预设角色的自动声明。所有状态会自动清空，下次 enabled: true 重新激活。

有哪些内置时段预设？

4 个 UTC+8 冻结窗口预设：liang-peak（每天 09:00–12:00 与 14:00–18:00）/ liang-valley（其余时间）/ glm-peak（周一至周五 14:00–18:00，需配置 zai-coding-cn）/ glm-valley（其余时间）。预设有就让 tz 锁定为 Asia/Shanghai，不可改。

模型选择器里多出来的 Auto 是什么？

启用插件后会自动注册一个名为 FallbacksChain、模型名 Auto 的虚拟 provider/model，选它就把当前有效的降级链作为根代理的主模型直接使用（不要求进入失败才触发）；任何真实模型仍保持故障后再走链的回退行为。关闭插件这个虚拟项立刻消失。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.1-rc.1+ (peerDependency)
• Node: >=22 (engines.node)

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则