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

快速上手

dsh-llm-fallbacks

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:btspoony/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)

常见问题

装上之后会自动接管我的模型选择吗？

不会。enabled 默认关闭（src/schema.ts:29），未启用或未配置链条时插件是零侵入的 no-op，跟没装完全一样。需要主动打开开关并填写链条才生效。

触发降级切换的失败类型有哪几种？

默认 triggerCodes = ['AUTH', 'QUOTA', 'RATE_LIMIT']（src/config.ts:145）。5xx 等可重试错误由宿主 llm-retry 先退避重试，预算耗尽后同样会进入本插件的决策流程，不需要额外加 triggerCodes。

可以只用一个真实模型当主选、链只在失败时介入吗？

可以。在模型选择器里选任意真实模型就是「fallback-only」行为：会话模型仍是首选，只有它失败后才走链（README.md:153）。想用链当主选就在模型选择器里选「FallbacksChain / Auto」这一虚拟条目。

旧的 chains / roles.default 配置会自动迁移吗？

不会自动改写。插件只在启动时打印 warning，配置面板顶部显示迁移横幅，需要按 docs/configuration.md 的迁移表手工改写（README.md:133）。

升级到 0.2.2+ 之后旧的会话打不开了怎么办？

0.2.2 之前的版本会在会话里写 durable 事件，新版 dsh 会拒绝加载（issue #52）。先停 dsh，再 clone 本仓库跑 pnpm repair:fallbacks-switch-logs -- --apply --backup，脚本会把旧事件标记为 ignorable 让会话恢复加载（README.md:46-58）。

会修改 DSH 本体代码吗？

不会。安装方式只是 bundle 行插入 + client 注入 + 自带 gateway 通道，零 dsh 源码改动、无 postinstall 步骤，dsh 升级不需要重新打补丁（README.md:182-184）。

支持 macOS / Windows / Linux 吗？

package.json 没有声明 os/cpu 限制，按 Node.js 实际支持的平台运行即可；本插件不引入原生模块。

怎么在终端里看当前降级状态？

在 dsh-tui profile 里执行 /fallbacks 看会话级只读诊断（origin、角色、链、最近切换、冷却），执行 /fallbacks config 看完整配置回显，/settings 里也有完整的 Fallbacks 编辑区（需要 dsh-tui ≥ v0.8.5，README.md:137-145）。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.1-rc.1+
• Node: >=22
• Platforms: 跨平台

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则