用途:通过 ADB 控制已连接的 Android 设备,作为推理与执行引擎读取 UI 状态并自主决定操作,完成点击、滑动、输入、按键、启动应用等任务。
前提:设备需 USB 连接并开启 USB 调试,ADB 已安装且在 PATH 中,设备已授权调试。
主要能力:脚本位于 scripts/ 目录,均支持 -s <serial> 指定设备。设备管理有 check-device.sh、wake.sh、screenshot.sh;屏幕读取有 get-screen.sh;输入操作有 tap.sh x y、type-text.sh "text"、swipe.sh direction、key.sh keyname;应用管理有 launch-app.sh、install-apk.sh。
使用方式:按感知-动作循环操作,先运行 scripts/check-device.sh 检查连接;多设备时根据用户意图选择或询问,记下 serial;用 get-screen.sh 获取无障碍 XML,依据 text、content-desc、resource-id、bounds、clickable 等属性判断元素,从 bounds 计算中心点坐标后点击;每步后等待约 500ms-1s 再重新读取屏幕,直到完成任务。多设备时所有命令保持同一 serial。
适用场景:需要自动操作 Android 界面、按名称或包启动应用、在输入框填字、滚动列表、处理弹窗、安装 APK 等。
限制:无法绕过 PIN、图案或密码,需用户手动解锁;元素可能因界面变化找不到,需重新读取或滚动查找;界面响应慢时需延长等待;官方资料未提供收费、价格等信息。