用途
该技能用于在需要通过 VMOS Edge Container API 管理云手机实例时使用,操作对象为 VMOS Edge 云手机容器,访问方式基于宿主机 IP(host_ip)。
主要能力
- 主机健康查询:GET /v1/heartbeat、GET /v1/systeminfo
- 实例列表查询:优先 POST /container_api/v1/get_db;若宿主机不支持,回退 GET /container_api/v1/get_db 或 GET /container_api/v1/list_names
- 实例详情查询:GET /container_api/v1/get_android_detail/{db_id}
- 启动相关动作后查询 rom_status;克隆流程后查询 clone_status
- 批量生命周期接口大多使用 db_ids
- 创建实例时 user_name 必填,bool_start 可选
- gms_start / gms_stop 为主机级操作,swap/{enable} 使用 1 / 0
- 上传安装包、文件、证书时显式使用 multipart/form-data
使用方式
核心流程始终遵循 Query -> Plan -> Execute -> Verify。Base URL 是 http://{host_ip}:18182。
确定 host_ip 的规则:
- 如果用户已经明确给了 host_ip,优先使用用户给的值。
- 如果用户没有明确给 IP,先检查本地是否存在 cbs_go 进程;存在则默认 host_ip=127.0.0.1。本地检查 cbs_go 时优先用精确匹配,例如 pgrep -x cbs_go >/dev/null 2>&1。
- 如果用户没有明确给 IP,且本地没有 cbs_go,引导用户提供 host_ip。
- 只接 host_ip;如果用户给的是 cloud_ip,应切到 vmos-edge-control-api。
如果当前会话里同时安装了 vmos-edge-control-api,而 control 要走 host_ip 路由,先用 get_db 或 get_android_detail 帮它解析目标 db_id。
必读参考:先看 references/api-reference.md 里的索引,再按模块只打开需要的 reference 文件;只有在需要精确路径、字段、轮询细节、示例请求时,才读取对应模块 reference;优先按需读取相关段落,不要整份展开到上下文里。
适用场景
适用于通过 VMOS Edge Container API 对云手机容器进行主机查询、实例查询、实例生命周期管理、克隆与 ROM 状态跟踪、GMS 启停、文件与证书上传等操作。
限制与安全边界
主机关机、主机重置、SSD 格式化、实例删除、实例重置、一键新机、镜像升级前必须确认。没有明确要求时,不要修改 IP、证书、时区、语言、国家、root 权限或 Google 状态。