用途:在 Orca 应用内驱动通过 adb 连接的 Android 模拟器或设备,属于跨平台(Windows、Linux、macOS)技能,与 orca-emulator(iOS)和 orca-cli 技能互补。
主要能力:列出与启动 AVD、点击、滑动、打字、硬件按键(含返回和最近任务)、旋转、应用安装与启动、运行时权限、无障碍树、logcat。
使用方式:先确定本次会话使用的可执行文件并全程复用。若设置了 ORCA_CLI_COMMAND 环境变量则用其值(Orca 会为受管 WSL 会话导出);否则在暴露 ORCA_DEV_REPO_ROOT 的开发检出中用 orca-dev;否则在 Orca 管理终端之外的 Linux 上用 orca-ide,切勿直接运行裸 orca(在 Orca 终端之外它通常解析为 GNOME 屏幕阅读器 /usr/bin/orca 并会在用户机器上开始朗读);其余情况用 orca。文中 ORCA 是可执行文件的占位符,运行前需替换,不要创建 shell 变量或照字面执行 ORCA。
运行命令前先加载完整指南:ORCA skills get orca-emulator-android,它会打印与将执行命令的确切二进制版本匹配的完整指南。不要凭记忆或缓存副本猜测子命令与参数。可用 ORCA status --json 确认应用已启动(必要时用 ORCA open --json 启动),面向智能体的调用优先使用 --json。
若所选可执行文件明确报告 skills get 是未知命令,且仅在此时,可用受限只读引导:ORCA status --json 与 ORCA emulator devices --json,然后告知用户更新 Orca 可恢复完整指南;除此之外不要猜测该旧版可能不支持的命令面,应向用户询问。
限制:本文是发现桩而非使用指南,完整版本匹配参考由 orca 二进制自身提供;若所选可执行文件无法运行,应报告其确切错误并停止,不要改用其他可执行文件,以免静默指向不同 Orca 构建。