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

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