用途：VMOS Edge CLI 是控制 VMOS Edge Desktop（Electron 应用）的命令行工具，用于在边缘主机上创建、启动、停止、删除 Android 虚拟设备，通过 CDP 自动化桌面 UI，并编写 YAML 剧本或批处理 JSON 来编排设备工作流；也可处理 vmos-edge-cli 错误码、安装或校验该工具。不适用于原生 ADB 命令、Appium、Android Studio 模拟器或其他非 VMOS 的 Android 工具。
使用前检查（必须完成）：确认 Node.js 18 及以上，运行 node --version；检查 CLI 运行 vmos-edge-cli --version；若缺失则安装 npm i -g @vmosedge/cli，再用 vmos-edge-cli schema 验证。schema 安装后仍失败应报错并停止，不要自行尝试替代方案；官方仅支持 npm i -g @vmosedge/cli 这一安装路径，不要改用 node dist/main.js、pnpm build 或 pnpm link。
核心原则：用 ui state 检查页面而不用 screenshot（state 免费且结构化，screenshot 消耗视觉 token，仅在用户要求保存图片时使用）；用 ui click/type 交互而不用 eval 点击或输入；页面变化后（点击、跳转、返回）须重新运行 ui state，不复用旧索引；连续的安全操作应批量执行；会改变状态的操作（create、delete、start、stop、reset）绝不能混在同一批次，每条需单独直接调用并确认结果后再执行下一条；写 batch/YAML 前先运行 schema 确认参数名。设备与镜像命令需带 --host <ip>，主机命令把 <ip> 作为位置参数。
工作流：预检 → 检查（ui state、设备列表、主机信息）→ 执行（单条或变更用直接调用，连续安全操作用 batch，可复用流程用 run）→ 解析结果（失败按错误码分支）→ 验证（页面变化后 ui state，输入后 ui form-state，变更后 device info）。应用在命令之间保持运行，无需每次 app start。
格式速查：终端为 vmos-edge-cli <domain> <method>（空格）；YAML 动作写 domain.method，变量用 ${{ expr }}；batch JSON 动作写 domain.method，变量用 $expr。三者变量语法不可互换。
参考资料包括 page-map.md、command-patterns.md、ui-automation.md、error-recovery.md、invocation-preflight.md，应在对应场景下读取而非凭记忆操作。
限制：除上述资料外，价格、平台支持细节、并发上限等未提供；不得编造功能或使用步骤。