SuperAPI AI 工具集

add-provider

编程与开发

查看项目

更新于 10-16 06:56

技能介绍

用途

add-provider 是 ClaudeBar 项目中的一项开发技能,用于指导开发者按照既有的 TDD 模式与架构,向 ClaudeBar 添加新的 AI 助手提供商(例如 Antigravity、Cursor 等)。它把新增提供商的完整流程拆分为可执行的阶段,并给出对应的代码骨架与测试模板。

架构概览

文档指出完整架构参见 docs/ARCHITECTURE.md,并列出三个核心组件:

  • AIProvider:位于 Sources/Domain/Provider/,是带有 isEnabled 状态的富领域模型。
  • UsageProbe:位于 Sources/Infrastructure/CLI/,负责从 CLI/API 获取配额。
  • Tests:位于 Tests/InfrastructureTests/CLI/,包含解析测试与行为测试。

主要能力与工作流

技能按五个阶段推进:

  1. 解析测试(红→绿):创建 {Provider}UsageProbeParsingTests.swift,覆盖将配额解析为 UsageQuota、百分比映射、重置时间解析、账户邮箱提取、缺失数据的容错处理等。
  2. 探针行为测试(红→绿):创建 {Provider}UsageProbeTests.swift,使用 Mockable 模拟 CLIExecutor,验证 isAvailable 在未检测到/检测到时的返回值、不可用时的错误抛出、成功时返回 UsageSnapshot。
  3. 实现探针:创建 {Provider}UsageProbe.swift,实现 UsageProbe 协议,包含 isAvailable() 与 probe(),并提供静态 parseResponse 以便测试。
  4. 创建 Provider:创建 {Provider}Provider.swift,实现 AIProvider,包含 id、name、cliCommand、dashboardURL、statusPageURL、isEnabled(通过 settingsRepository 持久化)、isSyncing、snapshot、lastError,以及 isAvailable() 与 refresh()。
  5. 注册 Provider:在 Sources/App/ClaudeBarApp.swift 中把新 Provider 加入 AIProviders 列表;并在 Sources/App/Views/Theme.swift 中补充颜色、名称、SF Symbol 图标与图标资源名。

领域模型映射

文档给出源数据到领域模型的映射关系:配额百分比对应 UsageQuota.percentRemaining(0-100);模型/层级名称对应 QuotaType.modelSpecific("name");重置时间对应 UsageQuota.resetsAt(Date);账户邮箱对应 UsageSnapshot.accountEmail。

错误处理

使用既有的 ProbeError 枚举:cliNotFound("{Provider}")、authenticationRequired、executionFailed("message")、parseFailed("message")。

ISP:提供商专属设置仓库子协议

若提供商需要特殊配置或凭据,可按 ISP 创建子协议:先在 Domain 中定义 {Provider}SettingsRepository(扩展 ProviderSettingsRepository),再在 Infrastructure 的 JSONSettingsRepository 中实现,最后更新 Provider 与 Probe 使用该子协议。文档列举了现有示例 ZaiSettingsRepository(配置路径 + 环境变量)与 CopilotSettingsRepository(环境变量 + GitHub 凭据)。

参考实现与图标

references/antigravity-example.md 提供完整可运行示例,包含完整解析测试套件、带 mock 的探针行为测试、带进程检测的探针实现与 Provider 类模式。references/provider-icon-guide.md 说明如何创建提供商图标:带圆角矩形背景的 SVG 模板、生成 1x/2x/3x 尺寸 PNG、资源目录设置与 ProviderVisualIdentity 扩展。

检查清单

文档末尾给出检查清单:解析测试已创建并通过、探针行为测试已创建并通过、探针实现完成、Provider 类已创建、Provider 已在 ClaudeBarApp 中注册、视觉标识已加入 Theme.swift(颜色、名称、图标)、提供商图标 SVG 已创建(带圆角矩形背景)、图标 PNG 已生成(64、128、192px)、全部 300+ 既有测试仍然通过。

适用场景与限制

该技能适用于需要向 ClaudeBar 新增 AI 提供商并希望遵循项目既有 TDD 与架构约定的开发者。文档未提供具体的安装命令、收费信息或平台支持范围,这些内容暂未提供。