Orca Emulator 是 Orca 环境内的模拟器控制技能,提供带实时设备视图的模拟器面板,用于在 macOS 上驱动已启动的 Apple Simulator,支持点击、手势等操作输入。在 Orca 内进行模拟器控制时,应优先使用 Orca,而非直接调用 serve-sim 或 simctl,因为 Orca 会处理设备作用域、辅助进程生命周期和工作树上下文。
使用方式:先确定本次会话可用的可执行文件并复用。若设置了 ORCA_CLI_COMMAND 环境变量,使用其值;否则在暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 orca-dev;否则在非 Orca 托管终端的外层 Linux 上使用 orca-ide(不要运行裸 orca,它通常指向 GNOME Orca 屏幕阅读器并会启动语音);其余情况使用 orca。文中 ORCA 是可执行文件占位符,执行前需替换,不要创建 shell 变量或直接运行 ORCA,在 POSIX shell、PowerShell 和 cmd.exe 中同样适用。若所选可执行文件无法运行,报告其确切错误并停止,不要回退到其他可执行文件。
运行命令前先加载版本匹配的指南:ORCA skills get orca-emulator。建议使用 --json。未覆盖的命令或标志可用所选可执行文件的 --help 查看。若命令提示 Orca 未运行,用 ORCA open --json 启动后重试;若失败于 runtime_access_denied,说明沙箱阻止了连接,需以提升权限重新运行,且不要运行 ORCA open 或重启 Orca。若 skills get 未知,说明更新 Orca 可恢复该指南,可先用 --help 做只读探索,不要猜测不支持的指令。