DuoPlus 云手机接入文档
本文说明如何在干活宝AI 桌面客户端中接入 DuoPlus 云手机账号，并列出接入后可执行的操作及其边界。全部内容集中在本页。
一、下载安装包
客户端分 macOS 与 Windows 两个安装包，请选择与所用系统对应的一个。
- macOS
- macOS 11 或更高版本，Apple 芯片（M 系列）。安装包格式为 .dmg。
- Windows
- Windows 10 或 Windows 11，64 位。安装包格式为 .exe。
macOS 安装包当前仅提供 Apple 芯片版本，使用 Intel 芯片的 Mac 暂不支持。
二、获取 API Key
登录 DuoPlus 控制台，按以下路径生成 API Key。生成后请妥善保存，客户端只需填写一次。
控制台路径
DuoPlus 控制台自动化API
API Key 按团队签发。在哪个团队下生成，即对应该团队的设备与数据范围。需要访问其他团队的设备时，请在控制台切换到该团队后重新生成 API Key，并在客户端中替换。
三、选择接入区
接入区分为「中国大陆」与「海外」两个，两者账号体系不互通。请选择与 DuoPlus 账号注册区域一致的接入区。
返回「密钥无效」时的排查顺序
接入区选择错误与 API Key 填写错误，返回的错误信息同为「密钥无效」。出现该提示时请先确认接入区是否与账号区域一致，再检查 API Key 是否完整复制。
四、功能范围
以下五项为当前支持的操作。每项附一条示例指令，可直接在客户端对话中输入。
- 设备状态与到期查询
查看指定分组下云手机的运行状态、到期时间与续费状态。
查看泰国分组下云手机的运行状态与到期时间
- 批量开关机与应用管理
对多台设备批量执行开关机、安装与卸载应用。
将泰国分组的 8 台设备开机，并安装 TikTok
- 命令执行与结果查看
在设备上执行命令，返回截图或界面元素信息，而非对屏幕内容的文字转述。
在这台设备上打开系统设置并截图
- 云号码验证码查询
查询绑定云号码收到的短信验证码。
查询美国号码最新收到的短信验证码
- 云手机购买与续费
购买或续费云手机、包月开机与云号码。该类操作需在授权卡片中确认后执行。
为泰国分组的设备续费一个月
五、操作边界
云手机承载的是长期运营的账号环境。以下四项为客户端的固定行为。
- 设备匹配
- 设备匹配存在多个结果时，列出候选供用户确认，不自动选择。
- 代理通道
- 代理通道变更需用户明确指示，不自动执行。
- 扣费操作
- 涉及扣费的操作均需用户在授权卡片中确认后执行。
- 批量结果
- 批量操作按设备逐台返回结果，失败设备单独列出，不合并为整体成功。
六、问题反馈
接入过程中如遇问题，可通过以下方式联系我们。