用途：在 Orca 应用内驱动 iOS 模拟器/仿真器流，完成点击、手势、文字输入、硬件按键、摄像头注入、运行时权限以及无障碍树等操作，实时视图保持在 Orca 的模拟器面板中。在 Orca 内运行智能体时，官方建议优先使用它，而非直接调用 serve-sim 或 simctl，因为 Orca 会代为处理设备作用域、辅助进程生命周期与工作树上下文。它与 orca-cli 技能互补，后者面向终端、工作树和内置浏览器。
使用方式：先为当前会话确定可执行文件并全程复用。若设置了 ORCA_CLI_COMMAND 环境变量，使用其值（Orca 会为受管 WSL 会话导出）；否则在暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 orca-dev；否则在 Orca 受管终端之外的 Linux 上使用 orca-ide，切勿在该环境运行裸 orca，因为它通常解析为 GNOME Orca 屏幕阅读器（/usr/bin/orca）并启动语音；其余情况使用 orca。下文 ORCA 为占位符，运行前需替换，不要创建 shell 变量或直接运行 ORCA。若所选可执行文件无法运行，应报告其确切错误并停止，不要回退到其他可执行文件。
运行命令前先加载完整指南：ORCA skills get orca-emulator，它会打印与将处理后续命令的确切二进制版本匹配的完整指南，涵盖启动设备、点击与手势、输入、硬件按键、摄像头注入、权限和无障碍树。不要凭记忆或缓存的旧副本猜测子命令与标志。可用 ORCA status --json 确认应用已启动（必要时用 ORCA open --json 启动），智能体调用优先使用 --json。
若旧版 Orca 不识别 skills get：仅当所选二进制明确报告 skills get 为未知命令时才使用回退方案，其他失败不能证明是旧版，应报告而非猜测或更换可执行文件。对确认的旧版二进制，仅使用以下只读引导命令：ORCA status --json 与 ORCA emulator list --json，然后告知用户更新 Orca 即可通过 ORCA skills get orca-emulator 恢复完整指南；除此之外应询问用户，不要猜测该旧版可能不支持的命令面。
限制：本文件仅为发现存根，不是使用指南，完整参考由 orca 二进制自身提供，以避免与将实际运行命令的二进制产生偏差。具体子命令、标志与参数随 Orca 版本变化，资料未提供固定清单，需以二进制输出的版本匹配指南为准。