提供方

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

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

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

提供方类别

类别	说明	示例
ide	桌面 IDE 应用程序	Cursor、VS Code、Windsurf
cli	基于终端的 AI 代理	Gemini CLI、Claude Code
extension	IDE 扩展/插件	Cline、Roo Code
acp	Agent Client Protocol 代理	35 个内置适配器

提供方如何工作

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

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

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

用户应关心什么

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

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

请使用以下页面来了解：

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

CLI 和 ACP 提供方的机器激活

对于机器运行时提供方（cli 和 acp），存在于清单中并不等同于在某台特定机器上可启动。ADHDev 现在把这些提供方视为按机器选择加入的条目：

1. 打开机器的 Providers 标签页。
2. 为该机器启用提供方。
3. 运行 Detect，以便 ADHDev 验证该机器上已配置的可执行文件。
4. 一旦检测成功，从仪表板或 CLI 启动它。

提供方卡片显示当前的机器状态（Disabled、Enabled, not checked、Not detected 或 Detected）以及最新的检测和验证详情。这可防止一个仅存在于目录中的提供方在本地可执行文件被实际检查之前显示为可用运行时。

自定义可执行文件路径和参数是机器本地的提供方设置。当某个工具安装在默认 PATH 之外或需要一个包装命令时使用它们。

提供方源配置

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

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

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

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

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

常见原因：

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

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