用途
add-provider 用于为 DeepChat 新增 LLM 提供商集成。它面向开发者场景:当开发者要求 Codex 添加一个提供商、提供商配置档案或上游提供商时,该技能会针对当前提供商架构生成集成改动。其目标是保持提供商显示数据位于 PublicProviderConf,将运行时行为映射到已知传输,仅在 API 行为确实需要时才使用特殊提供商实现。
必要输入
在编辑源码前,需要收集或推导以下信息:
- 提供商 ID(kebab case 命名)。
- 显示名称。
- API 类型或已知传输族。
- 默认基础 URL。
- 认证类型:API key、无认证、OAuth、配置档案凭据或提供商特定凭据。
- 模型元数据来源:内置配置、provider-db、config-db、实时模型获取或仅自定义。
- 测试模型 ID 与检查策略。
- 官网、API key URL、文档 URL、模型列表 URL。
- 请求特性:请求头、端点后缀、路由重写、流式响应形态、工具调用支持、推理支持、图像/音频/嵌入端点或代理要求。
支持的路径
技能将请求归类为以下三种路径之一:
-
OpenAI 兼容 API:当提供商支持 OpenAI Chat Completions 或 Responses 兼容的 HTTP API 时使用。典型涉及文件包括 src/main/provider/defaults.ts、src/main/provider/providerId.ts、src/main/provider/providerRegistry.ts、当模型来自公共提供商数据库时的 src/shared/providerDbCatalog.ts,以及 test/main/** 下的提供商注册表或创建测试。
-
已有原生传输:当提供商可映射到已有 DeepChat 传输(如 Anthropic、Gemini、Vertex、Azure、Bedrock、Ollama 或 ACP)时使用。典型涉及文件包括 src/main/provider/defaults.ts、src/main/provider/providerRegistry.ts,仅在现有通用表单缺少必需字段时修改设置组件,以及针对提供商创建与连接检查的聚焦测试。
-
特殊提供商:当认证、请求形态、流式响应、发现机制或错误处理与现有传输不同时使用。典型涉及文件包括 src/main/provider/providers/<providerName>Provider.ts、src/main/provider/<providerName>Adapter.ts、src/main/provider/managers/providerInstanceManager.ts、用于交互式认证的 src/shared/contracts/routes/* 与 src/renderer/api/Client.ts、用于提供商特定设置 UI 的 src/renderer/settings/components/,以及覆盖新行为的主进程与渲染进程测试。
护栏
- 不引入 ProviderRuntimeDefinition、生成的运行时清单或运行时包名推断。
- 不自动安装提供商 SDK 包。
- 不在渲染进程中执行提供商逻辑。
- 不将新的 OAuth 凭据存储在提供商 API-key 字段中。
- 当已知传输与显式配置已足够时,不添加特殊提供商。
- 当必要输入无法识别出安全路径时,拒绝该请求。
工作流程
-
当提供商工作涉及提供商运行时范围时,阅读 docs/features/provider-runtime/spec.md;若存在针对当前提供商运行时目标的 plan.md 也一并阅读。将任何遗留的 tasks.md 视为迁移输入,而非另一个执行跟踪器。
-
编辑前检查当前提供商文件:src/main/provider/defaults.ts、src/main/provider/providerId.ts、src/main/provider/providerRegistry.ts、src/main/provider/aiSdk/providerFactory.ts、src/main/provider/managers/providerInstanceManager.ts、src/renderer/settings/components/ProviderApiConfig.vue。
-
将请求归类到某个受支持路径。
-
为该路径添加最小的显式源码改动。
-
实现后,评估提供商创建、认证处理与模型发现是否需要持久回归覆盖;仅添加必要的最小契约级测试。
-
当存在活跃的 SDD plan.md 时,随着连贯的实现切片落地更新它。对于遗留 tasks.md,将剩余工作合并到现有计划中;若没有计划,则在 spec.md 中保留单切片复杂缺陷清单,并为功能、架构或多切片缺陷工作创建 plan.md。不要更新或重建任务文件。
-
运行:pnpm run format、pnpm run i18n、pnpm run lint、pnpm run typecheck。
-
对任何被触及的提供商代码运行聚焦的主进程/渲染进程测试。
输出清单
需要报告:提供商 ID 与 API 类型、所选路径、变更的文件、运行时传输或特殊提供商类、凭据存储位置、模型元数据来源、检查策略与测试模型、已运行的验证命令。
适用场景与限制
该技能适用于 DeepChat 代码库内的提供商集成开发,要求开发者提供完整的必要输入,并遵循既定的架构与护栏。它不自动安装依赖,不在渲染进程执行提供商逻辑,也不在无法确定安全路径时继续。关于具体收费、价格、平台支持范围等信息,资料中暂未提供。