核心用法
DuoPlus CloudPhone Agent 是一款基于 ADB 广播命令的 Android 云手机远程控制工具，需配合 DuoPlus 云服务使用。核心功能包括：
- 设备连接：通过
adb connect <IP>:<PORT>建立无线连接 - 应用控制：启动应用（
OPEN_APP）、返回首页（GO_TO_HOME）、返回（PAGE_BACK） - UI 交互：点击坐标（
CLICK_COORDINATE）、点击文字元素（CLICK_ELEMENT）、长按（LONG_COORDINATE）、双击（DOUBLE_TAP_COORDINATE） - 文本输入：输入内容（
INPUT_CONTENT）、键盘操作（KEYBOARD_OPERATION） - 手势操作：滑动（
SLIDE_PAGE，支持方向或自定义坐标） - UI 分析：通过
uiautomator dump获取页面层级结构 - 视觉验证：截图（
screencap）+ cwebp 压缩，便于大模型视觉分析 - 等待控制：固定等待（
WAIT_TIME）、元素等待（WAIT_FOR_SELECTOR）
命令通过 scripts/send_command.sh 脚本发送 Base64 编码的 JSON 广播，采用 "发射后不管" 模式，需配合截图验证执行结果。
显著优点
1. 无需 Root：基于标准 ADB 和 Android 广播机制，兼容性强
2. 云原生设计：专为云手机场景优化，支持远程无线连接
3. 多维度交互：同时支持坐标级控制和语义级元素定位（text/resource_id）
4. 大模型友好：内置 cwebp 压缩和尺寸调整，优化视觉模型输入
5. 灵活坐标系：采用 0-1000 相对坐标，自动适配不同分辨率
潜在局限
1. 服务依赖：必须安装 DuoPlus 云服务，无法独立运行
2. 无同步反馈：命令为异步广播，不返回执行结果，依赖截图验证
3. 单设备操作：需显式指定 -s <DEVICE_ID>，大规模集群管理需自行编排
4. 元素定位限制：CLICK_ELEMENT 依赖 uiautomator，对 WebView/游戏场景支持有限
5. 网络依赖：无线 ADB 连接稳定性受网络环境影响
适合人群
- 云手机服务提供商和运维团队
- 移动 App 自动化测试工程师
- 需要批量管理 Android 设备的开发者
- 构建移动端 RPA/自动化工作流的技术团队
常规风险
- 命令注入：JSON 参数未严格转义可能导致 payload 构造问题
- 网络暴露：无线 ADB 默认无认证，建议配合 VPN/防火墙使用
- 误操作风险：坐标点击无二次确认，快速连续操作可能导致意外行为
- 服务稳定性：依赖 DuoPlus 云服务进程存活，崩溃后命令将丢失
- 隐私合规：截图和 UI dump 可能包含敏感信息，需遵守数据保护法规