快速判断

安装前先看这几项

配置资料: 配置资料部分完整
配置难度: 未知，待补配置
适合新手: 建议具备相关经验
兼容状态: 声明兼容，尚未实测
验证状态: 源码已审阅，未标记运行实测

配置资料部分完整

本站已整理安装目标，但尚未补齐该插件的全部专属配置。完成配置前需要核对固定来源。

仍需核对：插件专属配置项、成功验证结果、首次使用示例、数据清理方法。

功能

这个插件能做什么

为 DSH 配置按错误码、角色和时段工作的模型故障转移链，在鉴权、额度或限流失败后自动切换 Provider/Model，并提供可选 Auto 虚拟模型。

适合谁

需要接入模型、服务、运行环境或基础设施的开发者。

使用门槛

该插件涉及较高配置难度或敏感权限，不建议在生产工作区直接试装。

准备

安装前准备

本站尚未核验该插件的专属前置条件。请先准备独立 Web Profile、测试工作区，并核对固定来源中的运行时、外部服务和账号要求。

安装

如何安装 dsh-llm-fallbacks

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到: web Profile
DSH 基线: 0.1.1-rc.2
安装来源: GitHub 源码（锁定提交）
固定目标: github:omdsh-dev/dsh-llm-fallbacks#f0d4c91c6cfa

01
检查 Node.js 与 pnpm
DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：
环境检查
```
node --version && pnpm --version
```
02
安装到 Web Profile
这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。
GitHub 源码（锁定提交）
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add github:omdsh-dev/dsh-llm-fallbacks#f0d4c91c6cfa
```
03
如遇构建脚本拦截
GitHub 源码插件可能通过 prepare 构建。pnpm 10 及以上会先阻止未授权构建；只把终端明确提示的包名加入该 Profile 的 pnpm-workspace.yaml 中 allowBuilds，审阅脚本后再重复上一步，不要使用全局放行。
04
确认 Bundle 已进入配置
安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 dsh-llm-fallbacks或对应 Bundle 层。
检查配置
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 --profile web --dump-config
```
05
启动并完成最小验证
启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。
启动 DSH Web
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 web
```

卸载与回退

测试不通过时先停止 DSH，再从同一 Profile 移除插件。移除后重新运行配置检查，确认对应 Bundle 层已经消失；插件自己创建的数据和外部账号配置可能需要另行清理。

从 Web Profile 移除

npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web remove dsh-llm-fallbacks

阅读 DSH 插件安装基础指南核对项目 README

配置

插件专属配置

专属配置路径和字段尚未完成核验，请不要根据同类插件猜测参数名。

验证

配置检查与成功结果

本站尚未获得插件专属的验证命令和期望结果。安装后只能确认 Bundle 是否进入组合配置，不能据此宣称插件功能已经运行通过。

使用

第一次使用建议这样验证

以下步骤是根据插件类别提供的安全验证顺序，不是作者仓库的专用命令。具体入口和参数仍以固定提交对应的 README 为准。

先在独立 Profile 中配置服务地址和凭据
验证连接、超时和失败回退
确认日志不会记录完整密钥或敏感请求

权限

它可能接触哪些数据和能力

使用服务凭据读取本地文件

不直接读取或保存模型密钥，而是复用 DSH 已配置的 LLM adapters；启用后可覆盖请求 Provider/Model、重试当前请求、按角色调用一次自动分类模型并通过设置接口修改链路，默认 enabled=false

数据存储：尚未完成独立核验，测试前应确认插件是否写入工作区、用户目录、数据库或外部服务。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

排查

故障排查与数据清理

本站尚未整理插件专属故障模式。遇到问题时先停止 DSH、保存日志、核对固定提交对应的 README，不要反复扩大权限重试。

清理边界待核对：从 Profile 移除插件通常不会自动删除插件创建的数据、外部账号或凭据。

证据

兼容性与审阅记录

兼容性说明

插件版本 0.3.3、仓库 LICENSE 为 MIT，DSH peer 依赖精确对齐 0.1.1-rc.2；本站完成固定提交静态审阅，未在真实多 Provider、附件/工具调用、限流风暴、跨时段切换或长会话恢复下运行

数据流

原模型请求及完整 messages/system/tools/附件 → 当前 Provider 失败 → 本地错误码、冷却、失败记录和链路规则 → 备用 Provider 收到同一完整请求 → 响应继续进入原 Agent；可选角色自动匹配只发送 Agent 来源、Preset 和角色描述。

源码审阅结论

已审阅固定提交的默认配置、候选链、请求错误处理、虚拟适配器、角色自动匹配、冷却状态和设置网关。插件默认关闭且有切换次数、冷却与递归保护；但一旦启用，同一敏感提示、附件和工具 schema 可能自动重发给不同服务商，产生额外费用、跨境/合规和数据保留差异。只配置已批准的 Provider，按角色拆分最小链路，避免把 AUTH 错误误当可无限重试，并监控费用与切换日志。

来源与维护信息

本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后，请重新核对作者说明。

精确来源: GitHub：omdsh-dev/dsh-llm-fallbacks（外部链接，在新标签页打开）
来源登记表: GitHub dsh-plugin Topic（外部链接，在新标签页打开）
来源快照: GitHub Topic 采集记录
固定提交: f0d4c91c6cfa
许可证: MIT
主要语言: TypeScript
中文资料: 有中文审阅摘要

dsh-llm-fallbacks