SuperAPI AI 工具集

isaac-sim-assets

智能体与模型

查看项目

更新于 10-15 22:38

技能介绍

用途:配置 Isaac Sim 从默认托管服务、指定 Asset Region Profile 或本地资产包加载资产,并诊断优先级与可用性问题,避免硬编码存储端点。权威依据为 Isaac Sim 的 Accessing assets 指南,其中包含随附的 profile 标识符、可用性清单、可下载资产包与当前启动说明。

使用方式:先确定访问模式——默认托管服务用默认 Asset Region Profile;区域托管服务选用文档中对应区域的 profile;本地或自定义根目录设置 ISAACSIM_ASSET_ROOT 指向带版本的资产根;资产缺失时先判断是解析出的根目录错误,还是所选 profile 不提供该资产。资产根优先级依次为 ISAACSIM_ASSET_ROOT、ISAACSIM_ASSET_REGION_PROFILE、命令行设置、Experience 文件、扩展默认值;ISAACSIM_ASSET_ROOT 会覆盖 profile 选定的根,若 profile 似被忽略,可清除该变量并重启,例如 Linux 执行 unset ISAACSIM_ASSET_ROOT,Windows 命令提示符执行 set ISAACSIM_ASSET_ROOT=,PowerShell 执行 Remove-Item Env:ISAACSIM_ASSET_ROOT -ErrorAction SilentlyContinue。选择托管 profile 时使用文档中对应区域的标识符,如 export ISAACSIM_ASSET_REGION_PROFILE=PROFILE_NAME 后运行 ./isaac-sim.sh,Windows 用 set "ISAACSIM_ASSET_REGION_PROFILE=PROFILE_NAME" 后运行 isaac-sim.bat。使用本地资产包需先下载并校验完整资产包的全部部分再解压,确认解压后的版本化根目录同时包含 Isaac 与 NVIDIA 目录,然后只设置显式根目录,如 export ISAACSIM_ASSET_ROOT="$HOME/isaacsim_assets/Assets/Isaac/VERSION_DIRECTORY" 后运行 ./isaac-sim.sh,Windows 用 set "ISAACSIM_ASSET_ROOT=C:\isaacsim_assets\Assets\Isaac\VERSION_DIRECTORY" 后运行 isaac-sim.bat。路径应通过公共 API 解析,不要硬编码托管 profile 的存储端点或从可用性清单推导对象 URL,例如 from isaacsim.storage.native import get_assets_root_path, path_join,再 asset_root = get_assets_root_path()、asset_path = path_join(asset_root, "Isaac/Robots/<asset-path>.usd");异步代码使用 get_assets_root_path_async。验证时在应用中选择 Utilities > Check Default Assets Root Path,确认报告的根与预期模式一致;非默认 profile 上资产缺失时检查该 profile 的可用性清单,清单状态为可用仅代表镜像可用,不代表清单覆盖路径之外的所有依赖都存在;若资产未提供,改用默认 profile 或经验证的本地资产包,并区分访问被拒、传输错误与对象缺失。

限制:不负责安装 Isaac Sim,安装请求应转至 isaac-sim-installation;不要编辑用户的 omniverse.toml 来选择 profile;不要暴露或推荐直接的 bucket 或 CDN URL;不要假设清除 ISAACSIM_ASSET_REGION_PROFILE 就能恢复默认根;不要声称区域 profile 包含完整的默认资产目录。