设备前置检查清单——跑 AutoGLM 之前逐项确认
一份 checklist 过设备
在你第一次运行 python main.py ... "打开美团搜索附近的火锅店" 之前，按下面这份清单逐项核对。很多新手踩的坑都是一两步没做对导致的。
Android 设备清单
| # | 检查项 | 验证方法 | 过 |
|---|---|---|---|
| 1 | 系统版本 ≥ Android 7.0 | 设置 → 关于手机 → Android 版本 | □ |
| 2 | 开发者模式已开启 | 设置里能看到"开发者选项" | □ |
| 3 | USB 调试已开启 | 设置 → 开发者选项 → 勾选 | □ |
| 4 | 部分机型：USB 调试（安全设置）已开启 | 小米/华为等需要同时开 | □ |
| 5 | ADB Keyboard 已安装 | 应用列表能看到图标 | □ |
| 6 | ADB Keyboard 已启用 | 输入法列表已勾选 | □ |
| 7 | 数据线支持数据传输 | adb devices 能看到设备 | □ |
| 8 | adb devices 输出 device 状态 | 不是 unauthorized 不是空列表 | □ |
HarmonyOS NEXT 设备清单
| # | 检查项 | 验证方法 | 过 |
|---|---|---|---|
| 1 | 系统版本 ≥ HarmonyOS NEXT | 设置 → 关于手机 | □ |
| 2 | 开发者模式已开启 | 设置 → 系统和更新 → 开发者选项可见 | □ |
| 3 | USB 调试已开启 | 开发者选项中勾选 | □ |
| 4 | 数据线支持数据传输 | hdc list targets 有输出 | □ |
| 5 | hdc list targets 输出设备 ID | 不是空列表 | □ |
鸿蒙设备不需要安装 ADB Keyboard，原生支持中文输入。
iOS 设备清单
| # | 检查项 | 验证方法 | 过 |
|---|---|---|---|
| 1 | iOS 版本 ≥ 12.0 | 设置 → 通用 → 关于本机 | □ |
| 2 | WebDriverAgent 已编译并安装到设备 | Xcode 编译运行 | □ |
| 3 | 设备上信任了开发者证书 | 设置 → 通用 → VPN 与设备管理 | □ |
| 4 | WDA 服务运行中 | 浏览器访问 localhost:8100/status | □ |
| 5 | iproxy 端口转发已建立 | curl localhost:8100/status 有响应 | □ |
通用检查（所有设备）
| # | 检查项 | 验证方法 | 过 |
|---|---|---|---|
| 1 | Python 环境 Python 3.10+ | python --version | □ |
| 2 | Open-AutoGLM 依赖已安装 | pip install -r requirements.txt 跑过 | □ |
| 3 | 模型服务已就绪（API 或本地） | curl / 部署验证脚本 | □ |
| 4 | 手机电量 > 20%，避免执行中关机 | 充电中或电量充足 | □ |
| 5 | 屏幕解锁状态 / 开发者选项里"保持屏幕唤醒"已开启 | 调试时不让屏幕锁定 | □ |
逐项不过怎么办
任何一项没过，优先解决设备侧问题，不要跳过。
全部通过后
运行一条最简命令验证完整链路：
python main.py --base-url http://localhost:8000/v1 --model "autoglm-phone-9b" "打开设置应用"预期：手机自动打开设置，Agent 输出"任务完成"。能走到这一步说明硬件、软件、模型服务全链路通了。