SuperAPI AI 工具集

fractal_add_provider

通用与其它

查看项目

更新于 10-16 06:42

技能介绍

用途:指导贡献者为 Fractal 添加或更新模型提供商,包括提供商注册、认证接入与模型菜单选项调整。

主要能力:说明如何处理提供商注册表模式,包括添加 provider id 常量、在 _PROVIDERS 中注册 ProviderDefinition、使用 default_model 作为默认选项、用 model_options 提供精选备选(不重复 default_model)、仅在需要运行时拒绝其它模型 ID 时使用 restricted_models,以及在需要规范化运行字符串时设置 model_prefix(如 openai、anthropic、openrouter)。提供商行为可选:API key 加 LiteLLM 兼容字符串复用 ApiKeyStringLMBehavior;OpenAI 兼容自定义端点参考 CustomOpenAICompatibleBehavior;CLI/OAuth 提供商需新增专用 behavior 类。密钥不得写入 Fractal 配置,只存引用。

模型 ID 规则:OpenAI 选项不带 openai/ 前缀,Anthropic 不带 anthropic/,OpenRouter 用目录 ID,_normalize_model 补齐前缀。动态目录不要硬编码完整实时响应,应选稳定默认值并注明列表为精选。

使用方式:先运行 git status --short 查看分支与工作区并保留无关改动;阅读 providers.py、onboarding.py、config.py 及相关测试与 README;编辑前查证当前模型 ID,不凭记忆。修改后先跑聚焦测试 .venv/bin/python -m pytest tests/test_providers.py tests/test_cli_config.py,再跑全量 .venv/bin/python -m pytest。仅在用户要求时提交、推送或开 PR(通常 gh pr create --fill)。

限制与注意:新增配置字段需同步更新 ProviderConfig、脱敏渲染、schema 校验与测试;不得添加原始密钥字段。行模式回退须兼容非 TTY 测试与自动化。README 需在提供商、认证来源、默认凭据引用或设置模型菜单变化时更新,并说明菜单为精选而非完整。分支归属不明时应先询问。