pi-model-fallback
在遇到API限制时自动切换备用模型
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-model-fallback。 它的用途是：在遇到API限制时自动切换备用模型 完整的 Skill 内容见：https://321skill.com/skills/pi-model-fallback/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“分析这段代码的安全性。” 当首选模型因达到调用上限返回429错误时，Skill会自动将请求转发给备用模型（如从 GPT-4 切换到 Claude-3），并返回分析结果，确保你的审查流程不中断。
介绍
这个 Skill 主要解决了开发者在调用 AI 模型服务时，因遇到供应商错误（如 429 速率限制、服务暂时不可用）而导致工作流中断的问题。它作为一个 Pi 扩展，能够监控模型提供商的响应状态，一旦检测到预设的错误类型，便会自动无缝切换到预先配置好的备用模型上，从而保障任务的连续执行。
使用方式非常直接。开发者需要将其作为扩展安装到 Pi 环境中，并在配置中指定首选模型和备用模型。当首选模型因触发速率限制等原因调用失败时，扩展会自动将请求重定向到备用模型，整个过程对用户透明，无需手动干预。
它非常适合那些重度依赖特定 AI 模型 API 进行自动化任务、批量处理或构建稳定服务集成的开发者。例如，在持续集成/持续部署（CI/CD）流水线中调用模型进行代码审查，或在数据批处理脚本中使用模型生成内容，都需要避免因临时的 API 限制而导致整个流程失败。
建议在使用前仔细测试备用模型的输出质量与成本，确保其能满足任务的基本要求。同时，需注意此扩展主要处理的是供应商端的临时性错误，对于网络问题或应用程序逻辑错误可能无效。合理设置错误重试策略和回退条件，可以更好地平衡服务的可靠性与成本。
核心特点
与同类仅提供错误重试的扩展不同，它专注于在特定提供商错误（如429）发生时执行模型切换，而非简单的重试；并且它直接集成在 Pi 生态中，配置和使用更为轻量便捷。
注意事项
不适合用于对模型输出一致性要求极高、无法接受不同模型间差异的场景。
常见问题
支持哪些错误类型触发切换？
主要支持如 429 速率限制等提供商错误，具体取决于扩展实现。
可以配置多个备用模型吗？
当前版本通常支持配置一个备用模型，具体需查看文档。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-model-fallback/raw/index.md 读取 pi-model-fallback 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-model-fallback/raw/index.md（查看排版版本）