Orca CLI 概述
orca-cli 是一个发现存根(discovery stub),会从本次会话所使用的 Orca 可执行文件加载与版本匹配的指南。根据现有资料,它可用于操作由 Orca 管理的工作树、文件夹上下文、终端、仓库、自动化、技能共享、工作树评论,以及 Orca 的内置浏览器。
解析本次会话的 CLI
使用前需先选定可执行文件,并在后续所有命令中复用它:
- 如果设置了 ORCA_CLI_COMMAND 环境变量,则使用其值。Orca 会为受管理的 WSL 会话导出该变量。
- 否则,在会话暴露 ORCA_DEV_REPO_ROOT 的开发检出(dev checkout)中,使用 orca-dev。
- 否则,在 Linux 上且处于 Orca 管理终端之外时,使用 orca-ide。资料特别提醒:在那里绝不要运行裸 orca——在 Orca 终端之外,它通常会解析为 GNOME Orca 屏幕阅读器(/usr/bin/orca),并在用户机器上启动语音朗读。
- 否则,使用 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 进行只读探索,不要猜测不受支持的命令。
限制与暂未提供的信息
现有资料未提供具体的安装命令、收费方式、价格、可运行平台范围、实际效果验证以及详细的使用步骤示例;这些内容暂未提供。