Duoplus Agent

📱 云手机远程自动化控制中枢

通过ADB远程操控Android云手机的自动化工具,支持点击、滑动、输入、截图等操作,需配合StandardSoftwareService使用。

收藏
3.9k
安装
1.3k
版本
1.0.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能与用法

DuoPlus CloudPhone Agent 是一个基于 ADB(Android Debug Bridge)的远程云手机自动化控制工具。它通过向目标设备发送 Base64 编码的 JSON 广播指令,实现对 Android 云手机的全面操控。

核心工作流程
1. 使用 get_ui_state 获取当前屏幕状态(UI 元素描述 + 截图)

2. 发送执行指令(如 CLICK_ELEMENT、INPUT_CONTENT、SLIDE_PAGE)

3. 等待 1-3 秒让操作生效

4. 再次调用 get_ui_state 验证结果

5. 循环直至任务完成

主要指令类别

  • 查询类(有返回):get_ui_state 获取屏幕交互元素和截图;PAGE_SCREENSHOT 截屏
  • 导航类:返回、主页、打开应用
  • 点击类:坐标点击、元素点击、长按、双击
  • 输入类:文本输入、键盘按键
  • 滑动类:指定方向滑动
  • 等待类:固定时长等待、等待元素出现

坐标系统采用 0-1000 相对值,非像素坐标。

显著优点

1. 完整的自动化能力:覆盖点击、滑动、输入、截屏、应用启动等手机操作全场景
2. 双模响应机制:查询指令同步返回,执行指令异步处理,兼顾效率与灵活性

3. 结构化数据返回get_ui_state 返回可解析的 UI 元素描述,便于 AI 理解屏幕内容

4. 相对坐标系统:0-1000 标准化坐标,适配不同分辨率设备

5. 任务生命周期管理:内置 END_TASK 标记,支持完整的任务流程控制

6. 多设备支持:通过 -s DEVICE_ID 参数可同时管理多台设备

潜在缺点与局限性

1. 强依赖前置服务:必须安装 StandardSoftwareService 系统级服务,无法通用
2. 无直接执行反馈:除查询指令外,动作指令均为 fire-and-forget,需自行轮询验证

3. ADB 网络暴露风险:远程连接依赖 adb connect IP:PORT,若网络未隔离存在未授权访问可能

4. Base64 编码开销:所有指令需编码传输,大指令存在性能损耗

5. 固定 MD5 校验:使用硬编码 openclaw-md5,实际安全性存疑

6. 云手机平台绑定:专为 DuoPlus 云手机设计,迁移成本较高

适合人群

  • 云手机平台运维人员
  • 移动端自动化测试工程师
  • 需要批量管理 Android 虚拟设备的开发者
  • 社交媒体矩阵运营、应用多开等场景的技术用户

常规风险

1. 网络层暴露:ADB 默认 5555 端口若暴露于公网,可被未授权利用
2. 权限过度:系统级服务拥有完整设备控制权,一旦攻破影响严重

3. 指令注入:若 params 内容未严格校验,可能存在命令注入风险

4. 隐私泄露:截图和 UI 数据回传包含敏感界面信息

5. 服务稳定性:依赖第三方云手机服务商的基础设施可用性

Duoplus Agent 内容

scripts文件夹
手动下载zip · 5.0 kB
send_command.shtext/x-shellscript
请选择文件