orca-cli

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Orca CLI

This discovery stub loads the version-matched guide from the Orca executable used for this session.

此发现桩会从当前会话使用的 Orca 可执行文件加载版本匹配的指南。

Resolve the CLI for this session

解析当前会话的 CLI

Choose the executable once and reuse it for every later command:

If the
```
ORCA_CLI_COMMAND
```
environment variable is set, use its value. Orca exports this for managed WSL sessions.
Otherwise, in a dev checkout whose session exposes
```
ORCA_DEV_REPO_ROOT
```
, use
```
orca-dev
```
.
Otherwise, on Linux outside an Orca-managed terminal, use
```
orca-ide
```
. Never run bare
```
orca
```
there — outside Orca's terminals it normally resolves to the GNOME Orca screen reader (
```
/usr/bin/orca
```
) and starts speech on the user's machine.
Otherwise, use
```
orca
```
.

Below,

ORCA

is a placeholder for the executable you resolved. Substitute it before running anything; do not create a shell variable or run

ORCA

literally. This works the same way in POSIX shells, PowerShell, and cmd.exe.

If the selected executable cannot run, report its exact error and stop. Do not fall through to another executable, which could silently target a different Orca build.

选择一次可执行文件，并在后续所有命令中重复使用：

如果已设置
```
ORCA_CLI_COMMAND
```
环境变量，则使用其值。Orca 会为受管理的 WSL 会话导出此变量。
否则，如果处于开发检出目录且当前会话提供
```
ORCA_DEV_REPO_ROOT
```
，则使用
```
orca-dev
```
。
否则，如果在 Orca 管理的终端之外使用 Linux，则使用
```
orca-ide
```
。切勿在此环境中直接运行
```
orca
```
——在 Orca 终端之外，它通常会解析到 GNOME Orca 屏幕阅读器（
```
/usr/bin/orca
```
），并在用户设备上启动语音朗读。
否则，使用
```
orca
```
。

下文的

ORCA

是已解析可执行文件的占位符。在运行任何命令前将其替换为实际可执行文件；不要创建 shell 变量，也不要直接运行

ORCA

。此规则在 POSIX shell、PowerShell 和 cmd.exe 中均适用。

如果选定的可执行文件无法运行，请报告其确切错误并停止。不要回退到其他可执行文件，否则可能会在无感知的情况下指向另一个 Orca 构建版本。

Load the version-matched guide before running Orca commands

运行 Orca 命令前加载版本匹配的指南

text

ORCA skills get orca-cli

Prefer

--json

. Use the selected executable's

--help

for commands or flags the guide does not cover. If a command reports that Orca is not running, start it with

ORCA open --json

and retry. If it fails with

runtime_access_denied

, your sandbox blocked the connection: re-run it with escalated permissions, and do not run

ORCA open

or restart Orca. If

skills get

is unknown, explain that updating Orca restores the guide; use

--help

for read-only discovery and do not guess unsupported commands.

text

ORCA skills get orca-cli

优先使用

--json

。对于指南未涵盖的命令或标志，请使用所选可执行文件的

--help

。如果命令报告 Orca 未运行，请使用

ORCA open --json

启动它并重试。如果命令因

runtime_access_denied

而失败，说明沙箱阻止了连接：请使用提升后的权限重新运行，并且不要运行

ORCA open

或重启 Orca。如果

skills get

是未知命令，请说明更新 Orca 后即可恢复指南；使用

--help

进行只读发现，并且不要猜测不受支持的命令。