provider-fallback-plugin
为AI编码工具提供多模型供应商的自动故障转移与用量管理
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:provider-fallback-plugin。 它的用途是:为AI编码工具提供多模型供应商的自动故障转移与用量管理 完整的 Skill 内容见:https://321skill.com/skills/provider-fallback-plugin/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“/provider-switch anthropic-subscription”,它会立即将当前会话的AI模型供应商切换到Anthropic的订阅计划。当遇到“Rate limit exceeded”错误时,插件会自动尝试列表中的下一个可用供应商,确保你的编码会话不会中断。
介绍
Provider Fallback Plugin 旨在解决开发者在依赖AI模型(如Claude、GPT)进行编码时,因单一供应商的速率限制、配额耗尽或服务中断而导致工作流中断的问题。它通过集成多达25个供应商和116个模型,构建了一个智能的备用网络,当首选供应商不可用时,能自动切换到其他可用选项,保障编码过程的连续性。
使用方式非常便捷,通过npm全局安装后,在OpenCode或Claude Code的配置文件中添加插件即可。开发者可以通过一系列简单的斜杠命令(如/provider-status、/provider-switch)来查看状态、切换供应商或配置认证。插件还支持基于项目的本地配置,允许为不同项目设置特定的模型和供应商优先级。
该插件非常适合重度依赖AI辅助编程的开发者,尤其是全栈开发、智能体开发者和运维工程师。他们经常需要在不同项目中使用不同模型,或面临突发性的API限制,此插件能有效提升他们的开发效率和稳定性。
建议用户初次使用时,先通过/provider-auth命令配置好常用的几个供应商(如Anthropic、OpenAI),并利用/provider-analytics功能定期查看用量和成本,以便优化资源配置和预算。对于团队项目,可以利用其本地配置文件功能,统一团队的AI模型使用策略。
核心特点
与单一供应商的插件或简单的手动切换不同,本插件实现了真正的智能自动故障转移,并集成了跨14个主流模型家族的116个模型,提供了业界最广泛的供应商覆盖和精细化的用量分析与成本追踪。
注意事项
该插件主要服务于OpenCode/Claude Code等特定AI编码工具生态,不适用于其他独立的AI应用或通用开发环境。
常见问题
如何查看当前正在使用哪个供应商和模型?
在编辑器中输入命令 `/provider-status`,即可查看当前活跃的供应商、模型、用量统计和配额状态。
如何为我的项目单独设置优先使用的模型?
在项目根目录创建 `.opencode/provider-fallback.local.md` 文件,使用YAML格式指定 `default_model` 和 `priority_override` 即可覆盖全局设置。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/provider-fallback-plugin/raw/index.md 读取 provider-fallback-plugin 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/provider-fallback-plugin/raw/index.md(查看排版版本)