用途 setup-agent-phone 面向 Android Agent Phone 的初始化与故障恢复:当手机配对、权限或连接需要修复时,通过 USB 完成设置。资料将其定位为一项由单一负责人持有的专用设备操作,强调不要占用其他任务的设备。
硬件与软件前提 需使用专用的 Android 11 及以上手机、数据线,并开启 USB 调试。浏览器侧需 Chromium WebUSB 或 Opensteer Desktop;Safari 与 Firefox 无法执行设置。仅充电线不会暴露 ADB。手机需解锁,必要时接受 USB 调试授权提示。
设置方式 打开 Settings → Computers → Add a phone。先启用 Personal remote access 并保持其 Mac 唤醒。选择目标手机,取消操作则不会选中任何设备。Desktop 会为所选 USB 手机自动共享已有的本地 ADB 服务。若浏览器设置繁忙,可改用 Desktop;其他直连 USB 控制器需先释放会话。仅对自有 ADB 服务执行 adb kill-server。在同一对话框内重试或重新插拔可保留注册的幂等性。
数据与归属 确认异签名的数据擦除或其他 Deployment 的取消配对,须取得所有者同意。同一 Deployment 的既有设置应重定向并保留密钥与访问权。完成后在 Computers 中检查在线状态与访问情况。
恢复流程 强制停止后重新打开 Agent Phone;若 OEM 管理禁用了无障碍或电池豁免,需在 Android 设置中重新启用。锁定重启后需解锁一次。Host 来源变更或 proof-v2 之前的手机需重新运行 USB 设置。Advanced Protection 可能禁止该服务,此限制无法靠重试连接解决。
清理 对自行启动的诊断捕获循环或服务器,用记录的 PID 执行 kill <pid> 停止;对自行启动的模拟器使用 adb -s <serial> emu kill;对自行启动的 ADB 服务使用 adb kill-server。调用方拥有的设备与服务应保持运行。失败时同样需要清理。