SuperAPI AI 工具集

orca-cli

部署与运维

查看项目

更新于 10-16 16:28

技能介绍

Orca CLI 用于通过命令行操作 Orca 管理的各类对象,包括 worktree、文件夹上下文、终端、代码仓库、自动化、构件(artifacts)、技能共享、worktree 评论以及 Orca 的内置浏览器。

该页面本身是一个发现存根(discovery stub),不直接提供完整命令列表,而是加载与当前会话所用的 Orca 可执行文件版本相匹配的指南。

使用方式

首先确定本次会话应使用的可执行文件,并在后续所有命令中复用同一个,不要中途切换。选择规则如下:

  1. 若设置了 ORCA_CLI_COMMAND 环境变量,使用其值。Orca 会为受管理的 WSL 会话导出该变量。
  2. 否则,在会话暴露 ORCA_DEV_REPO_ROOT 的开发检出(dev checkout)中,使用 orca-dev。
  3. 否则,在 Linux 上且不在 Orca 管理的终端内时,使用 orca-ide。文档明确提示:绝不要在那种环境下直接运行裸命令 orca,因为在 Orca 终端之外它通常解析为 GNOME Orca 屏幕阅读器(/usr/bin/orca),会在用户机器上启动语音。
  4. 否则,使用 orca。

在文档中,ORCA 是可执行文件的占位符,运行前需替换为实际解析出的名称,不要创建 shell 变量,也不要直接运行字面量 ORCA。该做法在 POSIX shell、PowerShell 和 cmd.exe 中一致。若选定的可执行文件无法运行,文档要求报告其确切错误并停止,不得退回到其它可执行文件,以免静默指向不同的 Orca 构建。

运行 Orca 命令前,先加载与版本匹配的指南:

ORCA skills get orca-cli

其它说明与限制

  • 优先使用 --json。
  • 对于指南未覆盖的命令或标志,使用所选可执行文件的 --help。
  • 若某命令报告 Orca 未运行,可用 ORCA open --json 启动后重试。
  • 若失败并返回 runtime_access_denied,表示沙箱阻止了连接:需以提权后的权限重新运行,且不要执行 ORCA open 或重启 Orca。
  • 若 skills get 未知,说明更新 Orca 可恢复该指南;此时仅用 --help 做只读发现,不要猜测不支持的命令。

本页未提供的信息(如具体价格、平台支持范围、完整命令清单等),请以 Orca 可执行文件内加载的对应版本指南和 --help 输出为准。