2026.09.19
agent-device：让 AI 编程代理验证正在运行的应用
agent-device 为 AI 编程代理提供 CLI、MCP 和 Node.js API，用于检查、操作和验证多类应用。它适合希望把代理接入移动端测试、调试或 CI 的开发者，但平台能力、环境依赖与证据完整度需要在采用前逐项确认。
项目用途
agent-device 是 callstack 开源的应用自动化与验证工具，目标是给 AI 编程代理增加一个“运行中的应用反馈回路”。项目提供命令行界面、内置 MCP 服务器和类型化 Node.js API，因此既可以直接交给能够运行 CLI 的代理，也可以接入支持 MCP 的客户端，或嵌入自行构建的 Node.js 代理运行时。
它的核心流程是检查、操作和验证：代理读取应用的可访问性快照，使用引用或选择器定位界面元素，再执行点击、输入、滚动、手势、等待、断言和弹窗处理。README 特别强调快照比只依赖截图更适合代理理解界面；截图和视频则可作为证据，或用于可访问性数据不足的场景。
图片来源：agent-device。项目公开截图，界面可能随版本变化。
已知功能与适合人群
项目列出的目标包括 iOS、Android、HarmonyOS、tvOS、Android TV、Amazon Vega OS TV、Web、macOS 和 Linux，覆盖模拟器、仿真器以及部分实体设备场景。它还提到 React Native、Expo、Flutter 和原生应用，但具体命令与证据能力随目标变化。
对移动端开发者、负责端到端测试的工程师、希望让编码代理自证改动的团队，以及需要把探索结果带入 CI 的维护者而言，agent-device 可能较有价值。可用能力包括保存工作流为 .ad 脚本、导出 Maestro YAML，以及收集截图、视频、日志、追踪、网络数据、性能采样、崩溃信息和 React 性能分析。项目也描述了按 Git worktree 管理会话和设备占用，以减少并行代理互相接管设备的情况，并支持连接 BrowserStack、AWS Device Farm 和 Limrun 等远程设备服务。
采用前的限制
首先，不应把多平台列表理解为每个平台能力相同。README 明确表示 HarmonyOS 和 Vega OS 等较新的后端只覆盖部分命令，并建议通过 capabilities 查询目标支持范围。苹果、Android、桌面、电视和 Web 使用的底层桥接不同，故快照、交互、录制和性能数据的可用性不能仅凭总览判断。
其次，环境准备是实际部署的一部分。README 要求 Node.js 22.12 或更高版本，Web 自动化要求 Node.js 24 或更高版本；目标平台还需要各自的模拟器、仿真器、实体设备、驱动或远程云配置。官方资料要求先运行 doctor，但本文不替读者确认本机是否满足条件。
再次，可访问性质量会影响代理可靠性。项目说明清晰标签、角色和测试 ID 有助于稳定运行；如果应用暴露的语义不足，截图或视频只能补充证据，并不等于自动化一定可靠。并行任务还需要理解会话范围、设备声明和过期占用处理。
截至提供的官方发布记录，v0.21.4 于 2026 年 9 月 16 日发布，改动涉及 Android、iOS、录制、设备所有权和运行器生命周期等区域。采用时应固定已验证版本，并针对自己的平台与工作流重新检查 capabilities、设备权限、证据产物和 CI 行为。仓库元数据显示许可证为 MIT；这不替代团队对依赖、平台条款和内部安全流程的审查。
资料来源
资料核对日期：2026-09-19