SuperAPI AI 工具集

vmos-edge-container-api

部署与运维

查看项目

更新于 10-16 04:40

技能介绍

用途

该技能用于在需要通过 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 的规则:

  1. 如果用户已经明确给了 host_ip,优先使用用户给的值。
  2. 如果用户没有明确给 IP,先检查本地是否存在 cbs_go 进程;存在则默认 host_ip=127.0.0.1。本地检查 cbs_go 时优先用精确匹配,例如 pgrep -x cbs_go >/dev/null 2>&1。
  3. 如果用户没有明确给 IP,且本地没有 cbs_go,引导用户提供 host_ip。
  4. 只接 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 状态。