核心功能
DuoPlus CloudPhone Agent 是一款专用于控制 DuoPlus 云手机服务的自动化工具,通过 ADB 广播命令实现远程设备操控。该 skill 封装了完整的 Android 自动化交互能力,包括应用启动、UI 元素定位、手势操作、文本输入、截图验证等核心功能。
主要用法:
- 设备连接:通过
adb connect <IP>:<PORT>建立无线连接 - UI 分析:使用
uiautomator dump提取界面层级结构,获取元素坐标和属性 - 交互执行:通过
scripts/send_command.sh发送 JSON 格式命令,支持点击(坐标/文本)、长按、双击、滑动、输入、键盘按键、返回主页等操作 - 视觉验证:执行
screencap截图后使用cwebp压缩,便于传输和分析
显著优点:
1. 协议轻量:基于 ADB 广播机制,无需复杂 SDK 集成
2. 功能完备:覆盖常见自动化场景(点击、输入、滑动、等待元素等)
3. 坐标灵活:采用 0-1000 相对坐标系,适配不同分辨率设备
4. 脚本友好:JSON 命令格式易于程序化生成和调试
局限性与风险:
- 无返回值:所有命令均为 fire-and-forget 模式,需依赖截图或 UI dump 验证结果
- 依赖外部服务:必须配合 DuoPlus CloudPhone 服务运行,无法独立使用
- 时序敏感:命令间需手动等待 1-3 秒,无内置同步机制
- 工具依赖:需要预装
adb和cwebp,环境配置门槛较高 - 安全隐忧:使用相对坐标和文本匹配定位元素,稳定性受界面变化影响
适合人群:
- 需要批量管理云端 Android 设备的开发者或运维人员
- 构建基于云手机的自动化测试、RPA 流程的技术团队
- 熟悉 ADB 和 shell 脚本的中高级用户
安全建议:该 skill 通过本地 ADB 与云服务通信,网络层面相对可控,但需注意:设备 IP 和端口暴露在公网时的未授权访问风险;send_command.sh 脚本中的命令注入风险;以及云手机服务商的数据隐私合规性。