用途:为 Isaac Lab-Arena 准备可运行的检出环境,并在就绪证据处停止;不选择策略、数据集、实验配置或输出目录,不安装贡献者钩子,不运行完整 pytest,不解释实验结果。
首要依据:改动状态前先阅读当前检出的 docs/pages/quickstart/installation.rst,以其支持表、前置条件和命令为准;若技能与文档不一致,以文档为准并报告差异。
路线选择:尊重用户已请求的方法,否则选限制最少的受支持路线。有 uv 时默认原生 uv,支持评估、模仿学习、强化学习与智能体环境生成;请求使用、现有工作流基于容器或需要 cuRobo 可达性验证时用 Docker。不得静默切换路线。原生 uv 不提供可选 cuRobo 包,ik_reachable 验证需用带 -c 的 Docker。
预检与确认:确认从仓库根目录运行;以只读命令检查现有 .venv、子模块状态、Docker 镜像/容器状态、GPU 可见性及请求的主机挂载路径;复用健康运行时不重装或重建;展示所选路线、文档命令、预期下载/构建及 EULA 或主机目录改动,大型同步或镜像构建前询问一次。文档阅读与安全只读预检立即执行,确认仅针对随后改变状态的同步、构建或停止。缺少前置条件时报告失败检查与文档恢复方法,未经明确批准不安装或更改 GPU 驱动、Docker、NVIDIA Container Toolkit 等系统包。
原生 uv 路线:
git submodule update --init --recursive
uv sync --extra dev
非交互命令使用 .venv/bin/python。启动命令接受 EULA:
OMNI_KIT_ACCEPT_EULA=YES ACCEPT_EULA=Y
.venv/bin/python -c "import isaaclab_arena; print(isaaclab_arena.file)"
要求从当前检出解析导入,随后运行安装文档中的短零动作验证,除非用户要求跳过仿真启动。
Docker 路线:
git submodule update --init --recursive
./docker/run_docker.sh
可选参数:-d 挂载数据集到 /datasets;-m 挂载模型到 /models;-e 挂载评估输出到 /eval;-c 构建/使用 cuRobo 镜像;-s 覆盖每检出容器后缀。启动前确认请求的挂载路径存在;挂载标志仅在创建容器时生效。停容器前先检查其名称、镜像与挂载并展示完整重建命令,获批准后再停止。列出该检出容器:
docker ps --filter "volume=$(git rev-parse --show-toplevel)" --format '{{.Names}}\t{{.Image}}'
选出匹配镜像类型与后缀的名称赋给 ARENA_CONTAINER,不要取任意首个匹配。以主机用户验证可编辑源码挂载:
docker exec "$ARENA_CONTAINER" su $(id -un) -c
"cd /workspaces/isaaclab_arena &&
/isaac-sim/python.sh -c 'import isaaclab_arena; print(isaaclab_arena.file)'"
要求路径位于 /workspaces/isaaclab_arena/. 之下,随后在容器内运行短零动作验证。
完成:报告所选路线与具体证据(解释器或容器、导入路径、零动作退出状态),将就绪与策略成功分开。贡献者引导或强制重建用 dev-container,回归测试仅在用户明确要求时用 run-tests。请求的实验属于后续工作流,不纳入本技能。
限制:材料未提供收费、价格、具体平台支持范围或效果数据。