Devicebase 手机控制

要解决什么问题

移动端自动化往往卡在「真机在哪、怎么连、坐标怎么算」：本地 adb 只能管插着的设备，CI 和多机编排需要统一 API；用视觉模型看截图时，模型常输出 [0,1000] 归一化坐标，直接当像素点会点错位置。

Devicebase CLI 通过云端/服务侧设备池，用同一套子命令远程操作 Android、HarmonyOS、iOS：点击、滑动、输入、启动应用、截图，以及 dump-hierarchy 导出可访问性 UI 树。

技能如何工作

• 环境与设备：运行前需配置 DEVICEBASE_API_KEY（及文档要求的 DEVICEBASE_BASE_URL）；每条命令必须带 -s / --serial 指定设备序列号。可用 list-devices 按关键字或状态筛选设备。
• 交互模型：触控类命令使用像素坐标，格式为 x,y（逗号分隔，不是空格）。导航用 back / home；应用侧用 launch-app 与 current-app；文本用 input / clear-text（需先聚焦输入框）。
• 观测与调试：device-info 拿分辨率、电量、系统版本等；screenshot 默认走 stdout，可用 -o 落盘；dump-hierarchy 返回 JSON 节点（resource-id、text、bounds 等），便于定位元素再回写坐标。
• 与 AI Agent 协作：若 LLM 基于截图给出归一化坐标，必须先按屏幕宽高换算：actual_x = normalized_x * screen_width / 1000，actual_y 同理；错误会直接表现为点偏。

适用边界与注意点

• 依赖 Devicebase 服务与有效 API Key；401/404/连接失败需先查密钥、序列号与 DEVICEBASE_BASE_URL。
• 任意参数或 API 错误通常以 退出码 1 结束，脚本里应显式检查。
• launch-app 不能为空包名；坐标、bounds 格式不符合 CLI 约定会本地报错，避免在流水线里静默失败。