用途:在 Orca 内部驱动 macOS 上已启动的 Apple Simulator,通过 Orca 的模拟器面板查看实时设备画面,并执行点击、手势等控制操作。资料建议在 Orca 内优先使用它,而不是直接调用 serve-sim 或 simctl,因为它会处理设备作用域、辅助进程生命周期和工作树上下文。
使用方式:先确定本次会话使用的可执行文件并复用。若设置了环境变量 ORCA_CLI_COMMAND,使用其值(Orca 会为受管 WSL 会话导出)。否则,在暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 orca-dev。否则,在非 Orca 管理的 Linux 终端中使用 orca-ide;不要在 Linux 上直接运行裸 orca,因为它通常指向 GNOME Orca 屏幕阅读器(/usr/bin/orca)并会在用户机器上启动语音。其余情况使用 orca。文中 ORCA 是可执行文件占位符,运行前需替换,不要创建 shell 变量或直接运行 ORCA。
运行 Orca 命令前先加载版本匹配的指南:ORCA skills get orca-emulator。优先使用 --json。指南未覆盖的命令或标志可查看所选可执行文件的 --help。若命令提示 Orca 未运行,用 ORCA open --json 启动后重试。若报 runtime_access_denied,说明沙箱阻止了连接,需以提升权限重跑,且不要运行 ORCA open 或重启 Orca。若 skills get 未知,说明更新 Orca 可恢复指南,可用 --help 做只读发现,不要猜测不支持的命令。若所选可执行文件无法运行,报告其确切错误并停止,不要回退到其他可执行文件。
限制:资料未提供收费、价格、平台支持范围、具体命令清单及效果说明。