用途：通过 alera emulator 命令操作 Alera 工作区关联的单个移动模拟器标签页，用于检查、连接、查看和自动化 Android 模拟器与 iOS 模拟器。运行时宿主负责设备发现、辅助进程、输入、观察和生命周期，因此不要直接启动 adb、emulator、simctl、scrcpy 或 serve-sim。
主要能力：先读取后端能力标志（alera emulator --json capabilities），因为 Android 与 iOS 支持的操作不同，不支持的操作返回 unsupported_capability。可发现设备、连接设备、列出连接、截图快照、点击、手势、输入文本、按键、旋转屏幕，以及安装和启动应用构建。Android 还支持运行时权限授予/撤销和有界 logcat 读取；permission 与 logcat 在 iOS 返回 unsupported_capability。
使用方式：--json 属于命令组，放在子命令之前，例如 alera emulator --json devices --platform android。目标解析顺序为 --tab-id、--workspace-id、ALERA_WORKSPACE_ID；ALERA_TAB_ID 标识运行命令的终端，不作为模拟器标签页。仅支持虚拟设备，Android 设备 id 为 AVD 名称，iOS 为模拟器 UDID。操作前先 snapshot，动作需携带最近观察返回的 snapshotId，点击与手势坐标是 0.0 到 1.0 的归一化视口位置。状态变化后需重新读取快照，避免使用过期坐标。敏感文本可用 --text-stdin。
限制：安装包须匹配已连接后端，iOS 设备构建无法在模拟器中运行；max-lines 必须在 1 到 1000 之间。detach 释放调用方流租约但不改变所选设备；shutdown 仅在 Alera 启动该虚拟设备时关机。错误返回 ok: false 及 code、message、nextSteps，CLI 以非零退出。不要用这些命令驱动物理手机或平板，不要暴露或重建本地流传输凭据。