兼容性与注意事项
ADHDev 提供了广泛的内置提供方清单，但兼容性仍应保守看待。本页是你在依赖某个特定工作流之前设定预期的最快方式。
清单在先，验证在后
请遵循以下经验法则：
- 内置意味着该提供方存在于随附的清单中。
- 已验证意味着该提供方已被手动测试并提升。
- 在某个提供方被提升之前，即使它出现在启动器、文档或能力页面中，也请将其视为未验证。
实用的起点
如果你正在为实际使用评估 ADHDev，请从已经拥有公开 Partial 证据的提供方开始，而不仅仅是清单中存在。
IDE 工作流
- Cursor
Cursor 目前是 IDE 风格控制、Remote View 和会话切换的最清晰的公开起点。
扩展工作流
- Codex 扩展
这是当前拥有最强公开证据的扩展路径。其他扩展可能仍会出现在清单或启动界面中，但在被提升之前应视为探索性的。
CLI 工作流
- Claude Code
- Codex CLI
它们通过托管的 PTY/session-host 栈运行，通常是验证远程监控和恢复流程最容易的地方。
已知注意事项
IDE 支持以 Electron 为先
ADHDev 依赖 Chrome DevTools Protocol 进行 IDE 控制。这意味着基于 Electron 的 IDE 是当前的主要目标。
- 当前以 Electron 为先的目标集合：Cursor、Windsurf、Kiro、PearAI、Antigravity、Trae
- 检测/启动覆盖：VS Code、VSCodium
- 当前不适配：非 Electron 的 IDE，如 Zed、IntelliJ 及类似的原生桌面应用
VS Code 家族与 Cursor/Windsurf 不同
VS Code 和 VSCodium 可以被检测和启动，但它们与原生集成的 AI IDE 不是一回事。当你加入诸如 Cline、Roo Code、Codex 或 Claude Code 之类的扩展流程时，它们的相关性会大得多。
Trae 有一个真实的注意事项
Trae 在聊天和控制方面可用，但其模型和模式控件仍然依赖通用 UI 交互，并且可能因应用版本和布局而失败。
实际上：
- 读取聊天可用
- 发送消息可用
- Remote View 可用
- 模型切换和模式切换应视为部分可用
一些 ACP 代理依赖上游的实验性标志
少数 ACP 适配器依赖上游功能，而这些功能在它们各自的工具中仍被标记为实验性。
- Gemini CLI（ACP）目前以
--experimental-acp启动 - Qwen Code（ACP）目前以
--experimental-skills启动
它们仍然可能有用，但应被视为实验性选择而非默认安全的选择。
认证仍然是工具专属的
ADHDev 不会替代每个工具自己的登录流程。
- CLI 和 ACP 代理仍然需要它们自己的 API 密钥或登录状态
- 如果你尚未认证底层工具，缺少 API 密钥可能看起来像启动失败
- 这对 Gemini、Claude、Codex 和许多 ACP 代理尤其重要
推送通知取决于平台
当仪表板作为 PWA 安装时，推送通知效果最佳。
- iOS 需要 PWA 安装路径才能使用 web push
- 通知操作按钮在所有平台上并不一致地显示
- 即使操作按钮不可用，通知本身仍可能到达
Windows 当前阻止 Node.js 24+
ADHDev 目前将 Windows + Node.js 24+ 视为常规 npm/全局 CLI 安装和启动不受支持。
- PowerShell 单行安装程序现在在检测到此组合时会引导一个可移植的 Node.js 22 运行时
- 如果你计划在 Windows 上直接使用
npm install -g adhdev，请使用 Node.js 22.x - 这是在 Windows PTY/session-host 路径于更新的 Node 版本上稳定之前的临时保护措施
Linux 仍然以清单为先
一些文档和清单表格提到了 Linux，是因为随附的提供方/检测器清单包含了面向 Linux 的进程名、端口和 Unix 风格的命令路径。
这尚不应被解读为公开支持承诺。
- 当前经过公开安装测试的路径是 macOS 和 Windows
- Linux 尚未得到足够验证，无法作为受支持的路径呈现
- 如果你今天在 Linux 上试验，请将其视为未验证，并预期需要手动排查
Cloud vs Standalone 预期
Cloud
当你需要以下内容时使用 Cloud：
- 从本地网络外部访问
- 推送通知
- 多机器管理
- API 密钥和 webhook
Standalone
当你需要以下内容时使用 Standalone：
- 仅本地的设置
- 无云依赖
- 基于局域网的监控和控制
Standalone 对 OSS 用户和本地团队非常适合，但诸如推送通知和面向互联网的远程访问之类的仅云功能不在该路径之内。
当前通常表现最佳的组合
如果你想要对产品最具代表性的第一印象，以下仍然是最稳妥的起始路径：
- 桌面上的 Cursor，可选配合移动端批准或 Remote View
- 如果你特别想要扩展工作流，可在受支持的宿主 IDE 内使用 Codex 扩展
- 通过仪表板终端使用 Claude Code 或 Codex CLI
- 先用一台机器加一个 IDE，等基础感觉稳定后再上多机器
在哪里查看当前状态
关于当前的提升列表和逐类别状态，请使用支持的提供方。该页面是关于仅存在于清单中的内容与背后有明确验证的内容的公开参考。