← 返回目录

Agent Device

社区

让 AI 代理检查、控制并验证应用。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 133 / 438
Stars: ★ 5.1k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 22.12+
凭据: 无需凭据
许可证: MIT
最近提交: 3 天前

59FMRS · C

Callstack 开源的 MIT 许可设备自动化 CLI，适合代理驱动的应用检查、控制、验证、调试和证据采集。清单版本为 0.20.0，npm 包通过 stdio 提供服务；源材料未列出具体 MCP 工具标识符或客户端配置示例。

最强项 · 文档质量 15/20 最弱项 · 安全与权限 8/20

可靠性

10/20

安全与权限

8/20

维护活跃度

14/20

文档质量

15/20

安装易用性

12/20

查看各项评分依据

可靠性 10/20: 清单声明了 npm、stdio 传输和版本号，README 描述了会话、检查-操作-验证流程以及多平台依赖，正常路径看起来可行。但仅提供清单和 README，没有可审查的 MCP 初始化/工具列表实现、提交测试或错误处理证据；因此无法确认握手、声明工具与实际行为的一致性，按静态校准扣分。
安全与权限 8/20: 工具可检查、控制并调试真实设备和应用，还可能保存截图、视频、日志、网络数据及性能信息，副作用和潜在敏感数据边界较广。材料未说明权限模型、凭据处理、网络数据流、危险操作确认或数据保留策略；未发现明确的凭据窃取、隐蔽外泄或不可逆操作红线证据，但缺失的安全控制证据导致明显扣分。
维护活跃度 14/20: 仓库非归档，提供 MIT 许可证、明确的 GitHub 归属、npm 版本 0.20.0、CI 徽章和贡献入口，显示出可识别的维护主体与发布路径。但材料未提供提交频率、问题响应、依赖更新、安全响应渠道或版本发布历史，因此不能给予接近满分的持续维护评价。
文档质量 15/20: README 提供安装前提、基本命令、操作示例、支持平台、能力范围、工作机制、CI/云端场景、限制说明及文档入口，覆盖面较好。可是认证方式、完整 MCP 客户端配置、工具参数/错误语义、成本、权限边界和系统故障排查证据不足；且外部文档未被实际审查，故扣分。
安装易用性 12/20: npm 全局安装、Node.js 版本要求、doctor 检查和 help 入口构成了可理解的起点，并列出本地、CI 和云端运行方式。但没有提供主流 MCP 客户端的实际配置示例，iOS/Android/电视/桌面平台的环境依赖和设备准备较复杂，且关键安装细节依赖外部文档，因此只能评为中等。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码控制浏览器

适合谁

使用 React Native、Expo、Flutter 或原生应用的开发团队
需要在本地设备、模拟器、仿真器或 CI 中验证应用的团队
希望由代理在运行时选择操作的 QA 和开发工作流

不适合谁

需要传统静态测试套件完全替代品的团队
依赖物理 Fire TV、设备捕获或 Vega 选择器后端的场景
缺少可用 iOS、Android、桌面或目标平台运行环境的用户

所需权限

访问并控制已连接的 iOS、Android、电视、桌面或其他受支持设备环境
读取应用无障碍树、日志、网络数据、性能信息和崩溃详情（目标平台支持时）
按请求保存截图、视频、追踪和其他验证证据

风险与副作用

设备操作可能改变应用状态或执行测试动作
无障碍数据不足时，元素定位和验证可靠性可能下降
旧的 @eN 引用可能不再指向同一元素；应只使用最新输出中的引用
Vega OS 当前仅支持 VVD；物理 Fire TV、捕获和选择器后端不受支持

安装接入

准备工作

运行环境：Node.js 22.12+

需要 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 传输。

验证是否装好

先运行 `npm install -g agent-device@latest`，再执行 `agent-device doctor`，如输出显示各目标环境检查通过即说明安装成功。

常见排障

先运行 agent-device doctor 检查设置
确认 Node.js 版本满足目标平台要求
运行 agent-device help workflow 查看当前 CLI 行为和工作流指南
检查目标设备、模拟器或仿真器是否已正确启动并可访问
优先使用最新快照或 settle 操作产生的引用；无障碍数据不足时使用截图或视频

试试这样问

连接成功后，可以直接对 AI 助手这样说：

打开 iOS 模拟器上的 Contacts 应用并截图当前表单界面
在 Android 应用里点击登录按钮，并验证跳转到了主页面
用 agent-device 对我改过的 React Native 页面做一次可访问性快照检查
把刚才的操作步骤保存为 .ad 脚本以便在 CI 中重放

使用场景

让编码代理在运行中的应用内执行操作并验证代码修改

移动应用端到端测试和可重复工作流

通过截图、日志、追踪和性能数据诊断问题

保存 .ad 脚本或导出严格 Maestro YAML 以便回放

详细介绍

agent-device 是一个通过命令行让 AI 代理检查、控制、调试和验证 iOS、Android、tvOS、Android TV、Amazon Vega OS TV、Web、macOS 和 Linux 应用的工具。它支持无障碍快照、元素定位、设备操作、截图、视频、日志、追踪、网络数据、性能采样、崩溃详情和 React 分析等能力。