SuperAPI AI 工具集

orca-emulator

智能体与模型

查看项目

更新于 10-16 07:15

技能介绍

用途:在 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 构建。运行 Orca 命令前先加载完整指南:ORCA skills get orca-emulator,它会打印与即将处理命令的精确二进制版本匹配的完整指南,涵盖启动设备、点击手势、输入、硬件按键、摄像头注入、权限与无障碍树。不要凭记忆或缓存副本猜测子命令与标志,它们在 Orca 版本间会变化。确认应用已启动可用 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 二进制自身提供,不在此文件中,以免与实际运行命令的二进制产生偏差。