用途
orca-emulator 用于在 Orca 应用内部驱动移动端（iOS）模拟器/仿真器串流，可执行点击、手势、键入文字、硬件按键、摄像头注入、运行时权限、无障碍树等操作，实时画面保持在 Orca 的模拟器面板中。
在 Orca 内运行智能体时，官方建议优先使用本能力，而非直接调用原始的 serve-sim 或 simctl，因为 Orca 会代为处理设备作用域、辅助进程生命周期和 worktree 上下文。它与 orca-cli 技能（面向终端、worktree 和内置浏览器）互为补充。
本文档的性质
当前内容是一个发现入口（discovery stub），不是使用指南。完整且与版本匹配的 Orca 模拟器参考文档由 orca 二进制文件自身提供，被有意保存在该文件之外，以避免与实际执行命令的二进制版本发生偏差。
使用方式
1. 为当前会话解析 CLI
一次性选定可执行文件，并在后续所有命令中复用：
- 若设置了 ORCA_CLI_COMMAND 环境变量，使用其值。Orca 会为受管理的 WSL 会话导出该变量。
- 否则，在会话暴露 ORCA_DEV_REPO_ROOT 的开发检出目录中，使用 orca-dev。
- 否则，在 Orca 管理的终端之外的 Linux 上，使用 orca-ide。在那里绝不要运行裸 orca——在 Orca 终端之外它通常会解析为 GNOME Orca 屏幕阅读器（/usr/bin/orca），从而在用户机器上启动语音。
- 否则，使用 orca。
下文中的 ORCA 是所解析出可执行文件的占位符。运行任何内容之前都要替换它；不要创建 shell 变量，也不要原样运行 ORCA。该做法在 POSIX shell、PowerShell 和 cmd.exe 中相同。
如果所选可执行文件无法运行，请报告其确切错误并停止。不要回退到另一个可执行文件，这可能静默指向不同的 Orca 构建。
2. 运行 Orca 命令前先加载完整指南
执行：
ORCA skills get orca-emulator
该命令会打印出完整、与版本匹配的指南，适用于接下来处理命令的那个确切二进制——涵盖设备启动、点击与手势、键入、硬件按键、摄像头注入、权限以及无障碍树。请先阅读它，再运行所需的具体命令。
不要凭记忆或该 stub 的缓存副本猜测子命令或参数。它们会随 Orca 版本变化，而本文件有意不再列出它们。用 ORCA status --json 确认应用已启动（如需要，用 ORCA open --json 启动），并优先对智能体驱动的调用使用 --json。
3. 如果较旧版本的 Orca 无法识别 skills get
仅在所选二进制明确报告 skills get 是未知命令时，才使用以下回退方案。其他失败并不能证明是较旧二进制；应报告该失败，而不是猜测或更改可执行文件。对于已确认的旧版二进制，仅使用以下受限的、只读的引导来定位：
ORCA status --json ORCA emulator list --json
然后告知用户，更新 Orca 后可通过 ORCA skills get orca-emulator 恢复完整的、与版本匹配的指南。除这些命令之外，请询问用户，而不是猜测这个较旧二进制可能不支持的命令面。
适用场景
- 在 Orca 应用内对 iOS 模拟器/仿真器进行交互式操作（点击、手势、输入、按键）。
- 进行摄像头注入与运行时权限设置。
- 检查或操作无障碍树。
- 在 Orca 内运行智能体并需要设备作用域、辅助进程生命周期和 worktree 上下文管理时。
限制
- 当前文件只是发现入口，不含完整命令参考；子命令与参数会随 Orca 版本变化，不能凭记忆猜测。
- 在不属于 Orca 管理的 Linux 终端中，裸 orca 可能解析为 GNOME Orca 屏幕阅读器而非 Orca 应用。
- 若所选可执行文件无法运行，应报告错误并停止，不得回退到其他可执行文件。
- 关于收费、价格、平台支持范围、效果或具体使用步骤等，资料未提供。