用途:通过公开的 orca CLI 操作 Orca 所管理的工作树、文件夹上下文、终端、仓库、自动化、产物、技能共享与工作树评论,并控制 Orca 应用内嵌的浏览器。当 Orca 运行中的编辑器/运行时是事实来源时使用它;若 Orca 状态无关紧要,则用普通 shell 工具。触发场景包括 Orca 工作树、子工作树、在工作树中启动 codex/claude、读取/等待/发送 Orca 终端、完整交接给另一代理、控制 Orca 内浏览器。
主要能力:受管工作树与文件夹上下文、终端读写与等待、仓库操作、自动化、产物、技能共享、工作树评论,以及内嵌浏览器控制。具体子命令与参数未在本资料中列出,需通过下方方式获取。
使用方式:先为本次会话解析可执行文件并固定复用。若设置了 ORCA_CLI_COMMAND 环境变量,使用其值;否则在暴露 ORCA_DEV_REPO_ROOT 的开发检出中用 orca-dev;否则在 Linux 的非 Orca 管理终端中用 orca-ide,切勿直接运行裸 orca(在那里通常解析到 GNOME Orca 屏幕阅读器 /usr/bin/orca 并开始语音);其余情况用 orca。下文以 ORCA 作为所解析可执行文件的占位符,运行前替换,不要真的运行 ORCA。运行任何 Orca 命令前,先执行 ORCA skills get orca-cli 获取与二进制版本匹配的完整指南,再运行具体命令。不要凭记忆或缓存猜测子命令与标志。确认应用已启动可运行 ORCA status --json(必要时先 ORCA open --json),代理调用优先加 --json。
回退:仅当所选二进制明确报告 skills get 为未知命令时,才使用有界的只读引导:ORCA status --json、ORCA worktree ps --json、ORCA terminal list --json,并告知用户更新 Orca 可恢复完整指南;除此之外不要猜测命令。
限制:本资料为发现存根而非使用指南,完整参考由 orca 二进制自身提供,故未在此列出具体子命令、参数与平台细节;若所选可执行文件无法运行,应报告其确切错误并停止,不要回退到其他可执行文件,以免静默指向不同构建。