name: provider-management description: 管理模型提供商优先级、认证(OAuth/订阅/API)、使用限制和跨所有主要AI提供商的自动故障转移的技能 version: 2.0.0
提供商管理技能
跨所有主要提供商全面管理AI模型,支持多重认证和自动故障转移。
概述
支持所有主要AI提供商和模型,提供三种认证方法:
| 优先级 | 认证类型 | 描述 |
|---|---|---|
| 100 | 订阅 | Pro/Plus/Max订阅(最高优先级) |
| 50 | OAuth | OAuth 2.0令牌(Antigravity风格) |
| 10 | API | 直接API密钥(最低优先级) |
支持的模型
Claude (Anthropic)
claude-4-opus,claude-sonnet-4,claude-3.5-sonnet,claude-3.5-haiku,claude-3-opus- 提供商:anthropic-subscription, anthropic-oauth, anthropic-api, bedrock, vertex, openrouter
GPT (OpenAI)
gpt-4.1,gpt-4.1-mini,gpt-4o,gpt-4o-mini,o1,o3-mini- 提供商:openai-subscription, openai-oauth, openai-api, azure, openrouter
Gemini (Google)
gemini-2.5-pro,gemini-2.5-flash,gemini-2.0-flash,gemini-1.5-pro- 提供商:google-subscription, google-oauth, google-api, vertex-google, openrouter
Grok (xAI)
grok-3,grok-3-mini- 提供商:xai-subscription, xai-api, openrouter
其他模型
- Llama:
llama-4-maverick,llama-3.3-70b(bedrock, together, groq, openrouter) - DeepSeek:
deepseek-r1,deepseek-v3(deepseek-api, together, openrouter) - Mistral:
mistral-large,codestral(mistral-api, bedrock, azure, openrouter) - Cohere:
command-r-plus(cohere-api, bedrock, openrouter) - Qwen:
qwen-2.5-72b(together, openrouter)
提供商特定模型ID
| 标准ID | anthropic-api | bedrock | vertex | openrouter |
|---|---|---|---|---|
| claude-sonnet-4 | claude-sonnet-4-20250514 | anthropic.claude-sonnet-4-20250514-v1:0 | claude-sonnet-4@20250514 | anthropic/claude-sonnet-4 |
| gpt-4o | gpt-4o-2024-11-20 | - | - | openai/gpt-4o |
| gemini-2.5-pro | - | - | gemini-2.5-pro-preview-05-06 | google/gemini-2.5-pro-preview |
可用命令
/provider-auth
配置提供商的认证。
# 查看所有认证状态
/provider-auth status
# 设置API密钥
/provider-auth setup anthropic-api --key sk-ant-...
# 启动OAuth流程(Antigravity风格)
/provider-auth oauth google-oauth
# 设置订阅令牌
/provider-auth setup anthropic-subscription --key <session-token>
/provider-models
列出模型和提供商映射。
# 列出所有模型
/provider-models list
# 按系列筛选
/provider-models list --filter claude
# 获取模型信息及所有提供商ID
/provider-models info claude-sonnet-4
# 按能力筛选
/provider-models capability reasoning
/provider-priority
管理提供商顺序。
/provider-priority
/provider-priority set anthropic-subscription,anthropic-api,bedrock
/provider-priority move bedrock 1
/provider-limits
配置使用限制。
/provider-limits
/provider-limits anthropic-api --daily 1M --monthly 10M
/provider-status
查看使用情况仪表板。
/provider-status
/provider-status bedrock
/provider-status --reset
/provider-switch
手动控制。
/provider-switch bedrock
/provider-switch --auto on
配置文件
~/.opencode/provider-fallback/
├── config.json # 优先级、限制、设置
├── usage.json # 使用情况跟踪
├── auth.json # 存储的凭据(0600权限)
└── tokens.json # OAuth令牌
认证优先级流程
1. 收到模型请求(例如,claude-sonnet-4)
2. 获取该模型供应商所有已配置的提供商
3. 按认证优先级排序:订阅(100)> oauth(50)> api(10)
4. 按使用容量筛选
5. 选择最佳可用提供商
6. 获取提供商特定模型ID
7. 使用适当的凭据发出请求
OAuth设置(Antigravity风格)
对于Google、Anthropic或OpenAI OAuth:
# 1. 启动OAuth流程
/provider-auth oauth google-oauth
# 2. 提示时输入客户端ID和密钥
# 3. 浏览器打开进行授权
# 4. 回调服务器接收令牌
# 5. 令牌安全存储
OAuth令牌在到期前60秒内自动刷新。
最佳实践
优先订阅
- 首先配置订阅认证(最高优先级,通常包含额外功能)
- 添加OAuth作为次要(适用于个人账户)
- 使用API密钥作为后备
多供应商设置
# 配置多个供应商
/provider-auth setup anthropic-subscription --key <token>
/provider-auth setup openai-api --key sk-...
/provider-auth setup google-api --key AIza...
# 系统自动为每个模型系列选择最佳方案
可靠性建议
- 每个供应商配置2-3种认证方法
- 设置保守的限制(实际值的80%)
- 保持自动切换启用
- OAuth令牌自动刷新
故障排除
OAuth令牌过期
令牌自动刷新。如需手动刷新:
/provider-auth refresh google-oauth
订阅未检测到
确保会话令牌有效且未过期:
/provider-auth setup anthropic-subscription --key <new-token>
使用了错误的认证方法
检查已配置的提供商和优先级:
/provider-auth status
系统始终优先选择:订阅 > oauth > api