提供方

ADHDev 使用一套提供方系统，通过一个仪表板支持 IDE、CLI 工具和扩展。

提供方清单与已验证的支持被有意地当作不同的东西：

• 清单：提供方存在于内置目录中，且可以被 ADHDev 加载
• 已验证的支持：提供方已被明确测试并带有证据地提升

提供方类别

类别	说明	示例
ide	桌面 IDE 应用程序	Cursor、VS Code、Windsurf
cli	基于终端的 AI 代理	Cursor CLI、Claude Code
extension	IDE 扩展/插件	Cline、Roo Code

提供方如何工作

从高层来看，提供方是告诉 ADHDev 如何执行以下操作的集成层：

• 检测目标工具
• 通过 CDP、PTY 或 stdio 连接到它
• 读取聊天或运行时状态
• 发送输入或控制操作
• 在工具支持时暴露模型、模式或批准控件

这些行为是否真的可靠到足以称为“受支持”，是一个单独的验证问题。

用户应关心什么

作为最终用户，主要问题不是提供方是如何实现的。而是：

• 该提供方是否存在于内置清单中？
• 它被记录为 Verified、Partial 还是 Unverified？
• 对你关心的工作流有哪些注意事项？

请使用以下页面来了解：

• 支持的提供方
• 支持的 IDE
• 兼容性与注意事项

提供方源配置

Providers 标签页中的 Provider source config 区域控制从何处解析提供方定义：

• normal 加载普通用户根目录以及上游/捆绑的提供方。
• no-upstream 跳过下载的上游源，仅使用本地/捆绑的定义。
• explicit providerDir 让 ADHDev 指向某个特定的提供方根目录，例如本地的 adhdev-providers 检出。

在更改源模式或 providerDir 后使用 Apply + Reload。重新加载会影响提供方解析、修复/验证流程和新的启动。现有正在运行的会话可能需要重启才能获取已更改的提供方脚本。

CLI 模型列表与用量

对于 CLI 提供方，在底层工具支持的情况下，模型列表和剩余用量数字是实时读取的，而非手工维护：

• 模型列表：codex-cli、grok-cli、cursor-cli、antigravity-cli、opencode 和 kimi 会在运行时报告自己的模型列表（查询失败时回退到 manifest）。claude-cli 没有列出命令，因此直接使用 manifest 中的列表。
• 用量：adhdev quota <provider> 会针对 antigravity、codex、grok 和 kimi 实时查询提供方自己的用量 API。Claude Code 仅通过其 statusLine 钩子暴露用量，因此为它启用用量报告需要显式选择安装一个包装器（adhdev quota claude:install），而不是守护进程自动完成的事。完整命令说明见 CLI 命令。

自动批准与信任提示

自动批准模式是一个按提供方、由 manifest 声明的设置，带有仓库级默认值 —— 它会回答提供方自己的批准/信任提示，而无需在仪表板中逐个按钮操作。不同提供方的覆盖范围和行为各不相同（不同 CLI 的按钮布局和信任弹窗措辞不同），因此应将自动批准视为特定于提供方的功能，而非单一的统一开关。

提供方存在但仍然失败的情况

一个提供方可能存在于清单中却仍有缺口。

常见原因：

• IDE 或代理的上游 UI 变更
• 部分的工作流覆盖
• 底层工具中缺少认证
• 存在但仍处于 Unverified 状态的提供方
• 未启用或未通过机器检测的 CLI 提供方
• 尚未应用/重新加载的提供方源配置更改

如果发生这种情况，请从提供方问题开始。