SuperAPI AI 工具集

orca-emulator

通用与其它

查看项目

更新于 10-15 20:08

技能介绍

用途:在 Orca 内部驱动 macOS 上已启动的 Apple Simulator,包含点击、手势等模拟器控制操作,并在 Orca 的模拟器窗格中显示实时设备画面。

主要能力:相比直接使用 serve-sim 或 simctl,Orca 会处理设备作用域、辅助进程生命周期与 worktree 上下文,因此 Orca 内控制模拟器时应优先使用 Orca。

使用方式:先解析本次会话要用的可执行文件并固定复用。若设置了 ORCA_CLI_COMMAND 环境变量则用其值;否则在暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 orca-dev;否则在非 Orca 管理的 Linux 终端中使用 orca-ide(不要在 Linux 上直接运行裸 orca,它通常指向 GNOME Orca 屏幕阅读器 /usr/bin/orca 并会让用户机器开始朗读);否则使用 orca。文中 ORCA 是可执行文件占位符,运行前需替换,不要创建 shell 变量或直接运行 ORCA 字面量,在 POSIX shell、PowerShell 和 cmd.exe 中同理。若选定的可执行文件无法运行,报告其确切错误并停止,不要回退到其他可执行文件以免指向不同 Orca 构建。

运行前先加载版本匹配的指南:ORCA skills get orca-emulator。命令优先加 --json。指南未覆盖的命令或标志可查所选可执行文件的 --help。若命令提示 Orca 未运行,用 ORCA open --json 启动后重试。若报 runtime_access_denied,说明沙箱阻止了连接,应以提升的权限重新运行,且不要运行 ORCA open 或重启 Orca。若 skills get 未知,说明更新 Orca 可恢复该指南;只可用 --help 做只读发现,不要猜测不受支持的命令。

限制:仅在 macOS 上针对已启动的 Apple Simulator 生效;需在 Orca 会话内使用;官方页面未提供更多平台、收费或版本细节。