VMOS Edge Container Management

在需要通过 VMOS Edge Container API 管理云手机实例时使用这个 skill。

核心流程

• 始终遵循 Query -> Plan -> Execute -> Verify
• Base URL 是 http://{host_ip}:18182
• 如果用户已经明确给了 host_ip，优先使用用户给的值
• 如果用户没有明确给 IP，先检查本地是否存在 cbsgo 进程；存在则默认 hostip=127.0.0.1
• 如果用户没有明确给 IP，且本地没有 cbsgo，引导用户提供 hostip
• 只接 hostip；如果用户给的是 cloudip，应切到 vmos-edge-control-api
• 本地检查 cbsgo 时，优先用精确匹配，例如 pgrep -x cbsgo >/dev/null 2>&1
• 主机健康先查 GET /v1/heartbeat、GET /v1/systeminfo
• 实例列表优先 POST /containerapi/v1/getdb；如果宿主机不支持，再回退 GET /containerapi/v1/getdb 或 GET /containerapi/v1/listnames
• 实例详情查 GET /containerapi/v1/getandroiddetail/{dbid}
• 启动相关动作后再查 romstatus；克隆流程再查 clonestatus
• 如果当前会话里同时安装了 vmos-edge-control-api，而 control 要走 hostip 路由，先用 getdb 或 getandroiddetail 帮它解析目标 db_id
• 批量生命周期接口大多使用 db_ids
• 创建实例时 username 必填，boolstart 可选
• gmsstart / gmsstop 是主机级操作，swap/{enable} 使用 1 / 0
• 上传安装包、文件、证书时显式使用 multipart/form-data

必读参考

• 先看 references/api-reference.md 里的索引，再按模块只打开需要的 reference 文件
• 只有在需要精确路径、字段、轮询细节、示例请求时，才读取对应模块 reference
• 优先按需读取相关段落，不要整份展开到上下文里

安全边界

• 主机关机、主机重置、SSD 格式化、实例删除、实例重置、一键新机、镜像升级前必须确认
• 没有明确要求时，不要修改 IP、证书、时区、语言、国家、root 权限或 Google 状态