这个项目能做什么

agent-device是Callstack推出的开源工具，为AI编码代理提供运行应用的实时反馈循环。它以CLI、内置stdio MCP服务器和类型化Node.js客户端的形式分发，全部共享同一运行时环境。支持的目标包括iOS、Android和HarmonyOS的模拟器、仿真器及物理设备，还有tvOS、Android TV、Amazon Vega OS电视、网页、macOS和Linux。它可与Claude Code、Codex、Cursor、Windsurf、Cline、Goose等代理配合使用，也可作为基于AI SDK或Eve构建的代理的底层运行时。README中描述的核心功能包括：通过可访问性快照、引用、选择器和React Native组件树检查应用状态，而非仅依赖截图；对可见UI执行操作：点击、按键、填写字段、滚动、手势、等待、断言状态及处理警报；通过截图、视频、日志、跟踪、网络数据、性能样本、崩溃详情和React分析诊断故障；通过将步骤保存为.ad脚本供本地或CI使用来重复工作流，可选择性导出为严格的Maestro YAML格式。安装通过npm进行（Node.js需22.12+，网页自动化需24+），之后运行doctor命令检查设置。会话范围限定于调用者的git工作树，主机本地设备声明可防止并行代理接管彼此的模拟器和仿真器。无需守护进程即可检查设备所有权并释放陈旧所有者。相同命令可驱动BrowserStack、AWS Device Farm和Limrun上的托管设备。平台后端各不相同：iOS使用本地可访问性桥和XCTest，Android使用ADB，HarmonyOS使用HDC和ArkUI uitest，Vega虚拟设备使用Vega CLI/VDA，macOS使用本地助手，Linux使用AT-SPI。支持深度各不相同，capabilities命令会报告每个目标支持的内容。该项目定位为Appium、Detox和Maestro的补充：这些工具用于编写和维护测试套件，而agent-device让代理可在运行时读取应用状态并选择命令，可选择性将运行导出为这些格式。它采用MIT许可证。