用途:orca-per-workspace-env 属于 Orca 的按工作区环境(Per-Workspace Environments)能力,用于设置、审查、调试或验证一次性、按需创建的运行时环境,类型包括云沙箱、虚拟机、SSH 主机或本地环境。
主要能力与用法:该技能是一个发现入口,会加载与当前会话所用 Orca 可执行文件版本匹配的指南。加载命令为:ORCA skills get orca-per-workspace-env。执行前需先解析本次会话的 CLI 可执行文件,并全程复用同一可执行文件:若设置了 ORCA_CLI_COMMAND 环境变量,则使用其值(Orca 会为受管 WSL 会话导出该变量);否则若开发检出中暴露 ORCA_DEV_REPO_ROOT,则使用 orca-dev;否则在 Linux 且非 Orca 受管终端中使用 orca-ide,切勿直接运行裸 orca(此时通常解析为 GNOME Orca 屏幕阅读器 /usr/bin/orca 并触发语音);其他情况使用 orca。文中 ORCA 仅为占位符,运行前需替换,不能字面运行。上述方式在 POSIX shell、PowerShell 和 cmd.exe 中一致。
命令与错误处理:建议优先使用 --json;指南未覆盖的命令或参数可用所选可执行文件的 --help 查询。若命令提示 Orca 未运行,执行 ORCA open --json 后重试。若报 runtime_access_denied,说明沙箱阻止了连接,应以提升权限重跑,且不要执行 ORCA open 或重启 Orca。若 selected executable 无法运行,应报告其确切错误并停止,不得回退到其他可执行文件。若 skills get 未知,说明更新 Orca 可恢复该指南,可用 --help 做只读发现,不要猜测不支持的命令。
限制:资料未提供具体环境类型之外的配置细节、收费、平台或效果说明,部分事实暂未提供。