wp_cli 是一个命令行工具,让你在自己的电脑上自动化操作云手机。可脚本化、可复现,每个操作都有记录。

安装

在下载中心获取对应平台的二进制(macOS arm64/x64、Linux x64/arm64、Windows x64),并核对页面展示的 SHA-256:

shasum -a 256 wp_cli-aarch64-apple-darwin.tar.xz   # 须与下载页校验和一致
tar -xJf wp_cli-*.tar.xz && sudo mv wp_cli /usr/local/bin/
wp_cli --version

shell 补全:wp_cli completions zsh > ~/.zfunc/_wp_cli(bash/fish/powershell 同理)。

登录

先在控制台(自动化 → API 凭据)签发机器凭据,然后:

wp_cli auth login --token wpa_...     # 或:printf '%s' "$WP_TOKEN" | wp_cli auth login
wp_cli auth whoami                    # 所属用户与作用域

凭据存入系统 keyring(不可用时回退 0600 文件),不会出现在命令历史、日志或错误输出。

会话

wp_cli env list          # 凭据范围内的云机
wp_cli env use E123      # 选中当前设备(类 kubectl context)
wp_cli observe status --env E456   # 单次覆盖

观测与动作

wp_cli observe inspect                  # UI 语义树
wp_cli observe screenshot --out s.png   # 截图落盘
wp_cli ui tap --text 登录                # 语义元素优先
wp_cli ui type --text "你好世界"          # 任意 Unicode,逐字符一致
wp_cli ui wait --text 欢迎 --timeout-ms 8000

批量群控

wp_cli batch ui tap --text 确定 --group 3          # 分组 3 内全部设备
wp_cli batch app launch --package com.foo --envs E1,E2,E3

逐台结果相互隔离 —— 单台失败不中断其余。

MCP 模式(stdio)

wp_cli mcp        # stdio MCP server,工具面与 remote endpoint 完全一致

当 agent 与你同机运行、或需要 connect(本地端口桥接,local-bridge 作用域)时用它 —— 这是 remote endpoint 唯一刻意不提供的能力。