Duoplus Agent

核心功能与用法

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 CloudPhone Agent 是一套通过 ADB（Android Debug Bridge）协议远程控制 Android 云手机的自动化技能。其核心工作模式为：将操作指令编码为 Base64 JSON，通过 ADB 广播发送至目标设备运行的 StandardSoftwareService 系统服务执行。主要功能覆盖三大类别：状态感知（get_ui_state 获取 UI 元素与截图）、屏幕操作（点击、滑动、长按、输入）、应用导航（启动应用、返回主页、页面后退）。

使用流程遵循"观察-执行-验证"循环：首先调用 get_ui_state 获取当前屏幕状态与可交互元素，然后发送 CLICK_ELEMENT、INPUT_CONTENT、SLIDE_PAGE 等动作指令，等待 1-3 秒后再次调用 get_ui_state 验证结果。所有动作指令均为"fire-and-forget"模式，需依赖状态查询确认执行效果。

显著优点

1. 完整的自动化能力：支持坐标点击、元素识别点击、文本输入、键盘操作、多向滑动、截图保存等移动端核心操作，覆盖绝大多数 App 自动化场景。

2. 相对坐标系统：采用 0-1000 相对坐标系，而非绝对像素坐标，使脚本具备跨设备分辨率适配能力。

3. 元素级操作支持：CLICK_ELEMENT 支持通过 text、resource_id、content_desc 定位元素，大幅降低坐标硬编码的维护成本。

4. 状态反馈机制：get_ui_state 同步返回 UI 元素描述与 Base64 压缩截图，便于 AI 或人工判断当前界面状态，实现闭环控制。

5. 纯本地通信：所有操作通过本地 ADB 完成，无外部服务器依赖，数据不离开本地网络环境。

潜在缺点与局限性

1. 依赖特定系统服务：目标设备必须预装并运行 StandardSoftwareService，限制了通用 Android 设备的直接使用。

2. 异步执行复杂性：动作指令无返回值，必须配合固定延时（1-3秒）和状态查询实现可靠同步，增加了流程设计的复杂度。

3. T3 来源可信度：维护者为个人开发者账号（duoplusofficial），无企业背书或开源社区广泛验证，长期维护稳定性存疑。

4. ADB 环境依赖：需要本地安装配置 ADB 工具，对非技术用户有一定门槛。

5. 网络可达性要求：远程云手机需保持网络可达（IP:PORT），断网或防火墙会导致控制失败。

适合的目标群体

• 移动端自动化测试工程师：需要进行跨设备 App 功能验证、UI 回归测试
• RPA/业务流程自动化开发者：需在云手机环境执行重复性操作任务（如数据采集、账号管理）
• 云游戏/云应用服务商：构建自动化运维、监控、客服机器人系统
• AI Agent 开发者：需要将物理世界操作能力扩展至 Android 生态的具身智能项目

使用风险与注意事项

1. 执行可靠性风险：动作指令的"fire-and-forget"特性意味着网络丢包或设备异常不会反馈错误，需设计超时重试与状态校验机制。

2. 设备状态敏感性：云手机的网络延迟、系统负载、弹窗干扰（如系统更新、权限请求）可能导致自动化流程中断，需增加异常处理分支。

3. 安全边界意识：虽然当前版本无可执行风险代码，但 ADB 本身具备设备完全控制能力（shell、文件系统、安装应用），需确保云手机环境隔离，避免敏感数据暴露。

4. 版本兼容性：StandardSoftwareService 的接口版本演进可能导致指令失效，建议锁定 Skill 版本并关注维护者更新公告。

5. 坐标与元素识别精度：动态加载内容、动画过渡、WebView 混合界面可能导致元素检测延迟或坐标漂移，建议关键操作前增加显式等待。