用途:在搭建、审查、调试或校验 Orca 的按工作区环境配方时使用。按工作区环境是为每个工作区按需创建的一次性运行时,可以是云沙箱、虚拟机或本地环境。该技能覆盖首次配置(提供商前置条件、可复用基础快照、编码代理认证快照、凭据和状态),不只是每个工作区的生命周期脚本。可用于建立按工作区环境、修复 orca.yaml 中的 environmentRecipes 条目、搭建提供商生命周期脚本,或解决 orca vm recipe doctor 失败。
定位:Orca 是轻量包装层,只负责引导、检测和脚手架,不拥有用户的云账户、账单、镜像或凭据,未经用户明确同意不花费任何费用。
确定本次会话的 CLI:若设置了环境变量 ORCA_CLI_COMMAND,就使用其值(Orca 会为受管 WSL 会话导出此变量);否则,在会话暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 orca-dev;否则,在 Orca 受管终端之外的 Linux 上使用 orca-ide,绝不要在那里直接运行裸 orca,因为在 Orca 终端之外它通常解析为 GNOME Orca 屏幕阅读器(/usr/bin/orca)并开始朗读;其余情况使用 orca。下文以 ORCA 作为占位符,运行前需替换。若所选可执行文件无法运行,报告其确切错误并停止,不要回退到其他可执行文件。
运行前先加载完整指南:ORCA skills get orca-per-workspace-env。它会为将处理后续命令的确切二进制打印完整的版本匹配指南。不要凭记忆或缓存的旧文档猜测子命令或参数。可用 ORCA status --json 确认应用已启动(必要时用 ORCA open --json 启动),代理驱动调用优先使用 --json。
若较旧版本 Orca 不识别 skills get:仅当所选二进制明确报告 skills get 是未知命令时才使用回退,其他失败不算证据。对已确认的旧版二进制,仅使用以下只读引导:ORCA status --json 和 ORCA vm recipe doctor <recipe-id> --repo-path <repo> --json。doctor 是免费的静态检查,未经用户明确批准绝不要添加 --provision,因为它会创建提供商资源并可能花钱。之后告知用户更新 Orca 即可通过 ORCA skills get orca-per-workspace-env 恢复完整指南。