Cloud Phone Agent

📱 云端 AutoJS 自动化任务执行

通过 mcporter 调用云端 AutoJS Agent 实现 Android 自动化任务,支持远程云手机执行、截图回传与日志采集,适合批量回归测试与脚本化运维。

收藏
6.7k
安装
1.7k
版本
0.0.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能与用法

cloudphone skill 是一套基于 cpc-mcp-server 的云手机自动化方案,通过 mcporter CLI 工具将任务下发至云端 Android 环境执行。其核心工作流为:配置 API 认证 → 创建 AutoJS Agent 任务 → 云端设备执行 → 获取结果(截图/日志/文本)。

关键调用模式:

  • 使用 mcporter call cpc-mcp-server.createAutoJsAgentTask 创建任务,需通过 --args 传入 JSON 格式的 instruction 与 lang 参数
  • 任务创建后返回 taskIdsessionId,用于后续状态查询与结果拉取
  • 指令支持自然语言描述,云端 Agent 会将其解析为具体 UI 操作序列

典型应用场景:

  • 电商/金融类 App 的自动化回归测试(登录 → 核心流程 → 断言截图)
  • 远程批量运维操作(同时操控多台云设备执行相同脚本)
  • 多语言环境下的 UI 验证(通过 lang 参数指定指令语言)

显著优点

1. 零本地环境依赖:无需本地 ADB、模拟器或物理设备,完全云端执行
2. 自然语言驱动:指令以人类可读方式编写,降低脚本编写门槛

3. 标准化认证流程:通过 CLOUDPHONE_API_KEY 环境变量统一管理,避免硬编码泄露

4. 结果可观测性强:原生支持截图、日志、结构化文本等多种输出形式

潜在局限与风险

执行不确定性:云端 Agent 对复杂手势、动态加载内容的处理可能存在稳定性波动,建议关键流程增加重试机制。

延迟问题:网络传输 + 云端调度带来秒级到分钟级延迟,不适用于需要毫秒级响应的实时交互场景。

认证安全风险:API Key 需严格遵循环境变量注入模式,任何硬编码或日志打印都可能导致云设备控制权泄露。

调试困难:远程执行环境下,问题定位依赖返回的截图与日志,无法像本地调试一样实时打断点。

适合人群

  • QA 工程师:需要跨设备、跨版本进行批量回归验证
  • 运维团队:管理大量云设备进行定时巡检任务
  • 自动化开发者:希望快速验证 AutoJS 脚本在真实云端环境中的效果

常规风险

  • 密钥泄露风险CLOUDPHONE_API_KEY 权限等同于云设备控制权,需配合密钥轮换与最小权限原则
  • 指令注入风险:若 instruction 包含用户输入,需防范通过自然语言诱导执行非预期操作
  • 成本风险:云手机按使用时长计费,长时间运行的循环任务可能产生意外费用

Cloud Phone Agent 内容

手动下载zip · 3.9 kB
mcporter-readme.mdtext/markdown
请选择文件