适合谁
- 使用 React Native、Expo、Flutter 或原生应用的开发团队
- 需要在本地设备、模拟器、仿真器或 CI 中验证应用的团队
- 希望由代理在运行时选择操作的 QA 和开发工作流
I
59FMRS · C
Callstack 开源的 MIT 许可设备自动化 CLI，适合代理驱动的应用检查、控制、验证、调试和证据采集。清单版本为 0.20.0，npm 包通过 stdio 提供服务；源材料未列出具体 MCP 工具标识符或客户端配置示例。
agent-device 是一个通过命令行让 AI 代理检查、控制、调试和验证 iOS、Android、tvOS、Android TV、Amazon Vega OS TV、Web、macOS 和 Linux 应用的工具。它支持无障碍快照、元素定位、设备操作、截图、视频、日志、追踪、网络数据、性能采样、崩溃详情和 React 分析等能力。
工具能力
暂未整理工具清单。
安装接入
需要 Node.js 22.12 或更高版本；Web 自动化需要 Node.js 24 或更高版本。运行 npm install -g agent-device@latest 安装 CLI，然后运行 agent-device doctor 检查环境。服务器清单声明使用 npm 包 agent-device 0.20.0，并通过 stdio 传输。
选型与风险
不适合谁
- 需要传统静态测试套件完全替代品的团队
- 依赖物理 Fire TV、设备捕获或 Vega 选择器后端的场景
- 缺少可用 iOS、Android、桌面或目标平台运行环境的用户
所需权限
- 访问并控制已连接的 iOS、Android、电视、桌面或其他受支持设备环境
- 读取应用无障碍树、日志、网络数据、性能信息和崩溃详情（目标平台支持时）
- 按请求保存截图、视频、追踪和其他验证证据
风险与副作用
- 设备操作可能改变应用状态或执行测试动作
- 无障碍数据不足时，元素定位和验证可靠性可能下降
- 旧的 @eN 引用可能不再指向同一元素；应只使用最新输出中的引用
- Vega OS 当前仅支持 VVD；物理 Fire TV、捕获和选择器后端不受支持
常见排障
- 先运行 agent-device doctor 检查设置
- 确认 Node.js 版本满足目标平台要求
- 运行 agent-device help workflow 查看当前 CLI 行为和工作流指南
- 检查目标设备、模拟器或仿真器是否已正确启动并可访问
- 优先使用最新快照或 settle 操作产生的引用；无障碍数据不足时使用截图或视频
使用场景
让编码代理在运行中的应用内执行操作并验证代码修改
移动应用端到端测试和可重复工作流
通过截图、日志、追踪和性能数据诊断问题
保存 .ad 脚本或导出严格 Maestro YAML 以便回放
支持客户端
暂未确认支持的客户端。