SuperAPI AI 工具集

isaaclab-setup-troubleshooting

测试与质量

查看项目

更新于 10-15 22:38

技能介绍

用途:当用户需要安装 Isaac Lab、验证本地环境,或诊断常见的安装、启动与仿真性能问题时使用。该技能不重复官方安装与排障文档,官方文档为唯一权威来源。

主要能力:识别安装模式(uv checkout、显式 uv 环境、uv wheel 安装、Isaac Sim 源码构建、Docker、云、后端专属设置),并识别操作系统、Python 环境、GPU/驱动、Isaac Sim 源码与目标后端;在给出命令前先阅读匹配的安装指南与排障参考;将后端专属设置路由到统一安装指南,将后端选择问题路由到物理后端概念文档;对异常缓慢的仿真或训练,路由到排障参考的性能章节,并在调优前先对代表性负载做性能分析;XR 遥操作设置属于独立工作流,路由到 CloudXR 操作指南。

使用方式:在 Isaac Lab 检出目录中使用文档化的 uv 命令,如 uv run python、uv run isaaclab train、uv run isaaclab play。all extra 是 ov、rl-games、sb3、skrl、rsl-rl、rerun、viser 的精选列表,不含 Isaac Sim 与独立 URDF/MJCF 导入器;导入器需按文档的解析器覆盖安装 importers extra。XR 遥操作入口为 uv run --extra teleop isaaclab teleop run|record|replay,且 teleop 不能与 mimic 或 all extra 在同一条命令中组合。验证与训练命令使用无后缀任务名。失败模式不明确时,索取最小相关错误输出;优先运行最小验证命令,再跑示例、训练或渲染。

验证清单:确认用户只走一条受支持的安装路径;确认 Python 与包命令在预期的 Isaac Lab 检出目录及 uv 管理环境中运行;先跑最小导入或验证命令;按观察到的错误类别查阅排障文档;仅在文档化检查用尽后才升级到环境专属调试。技能变更时运行:uv run --no-project python tools/skills/cli.py check。

限制:本技能作为官方文档的路由器,不复制安装或排障内容;若文档不完整或过时,应更新文档而非扩展本技能。具体安装步骤、错误修复细节与性能调优参数以官方文档为准,此处暂未提供。