核心功能与用法
cloudphone skill 是一套基于 cpc-mcp-server 的云手机自动化方案,通过 mcporter CLI 工具将任务下发至云端 Android 环境执行。其核心工作流为:配置 API 认证 → 创建 AutoJS Agent 任务 → 云端设备执行 → 获取结果(截图/日志/文本)。
关键调用模式:
- 使用
mcporter call cpc-mcp-server.createAutoJsAgentTask创建任务,需通过--args传入 JSON 格式的 instruction 与 lang 参数 - 任务创建后返回
taskId与sessionId,用于后续状态查询与结果拉取 - 指令支持自然语言描述,云端 Agent 会将其解析为具体 UI 操作序列
典型应用场景:
- 电商/金融类 App 的自动化回归测试(登录 → 核心流程 → 断言截图)
- 远程批量运维操作(同时操控多台云设备执行相同脚本)
- 多语言环境下的 UI 验证(通过 lang 参数指定指令语言)
显著优点
1. 零本地环境依赖:无需本地 ADB、模拟器或物理设备,完全云端执行
2. 自然语言驱动:指令以人类可读方式编写,降低脚本编写门槛
3. 标准化认证流程:通过 CLOUDPHONE_API_KEY 环境变量统一管理,避免硬编码泄露
4. 结果可观测性强:原生支持截图、日志、结构化文本等多种输出形式
潜在局限与风险
执行不确定性:云端 Agent 对复杂手势、动态加载内容的处理可能存在稳定性波动,建议关键流程增加重试机制。
延迟问题:网络传输 + 云端调度带来秒级到分钟级延迟,不适用于需要毫秒级响应的实时交互场景。
认证安全风险:API Key 需严格遵循环境变量注入模式,任何硬编码或日志打印都可能导致云设备控制权泄露。
调试困难:远程执行环境下,问题定位依赖返回的截图与日志,无法像本地调试一样实时打断点。
适合人群
- QA 工程师:需要跨设备、跨版本进行批量回归验证
- 运维团队:管理大量云设备进行定时巡检任务
- 自动化开发者:希望快速验证 AutoJS 脚本在真实云端环境中的效果
常规风险
- 密钥泄露风险:
CLOUDPHONE_API_KEY权限等同于云设备控制权,需配合密钥轮换与最小权限原则 - 指令注入风险:若 instruction 包含用户输入,需防范通过自然语言诱导执行非预期操作
- 成本风险:云手机按使用时长计费,长时间运行的循环任务可能产生意外费用