SuperAPI AI 工具集

spatial-reasoning

智能体与模型

查看项目

更新于 10-15 22:38

技能介绍

用途:在 OpenUSD 场景中做 3D 空间推理,包括坐标数学、包围盒分析、无碰撞布局、look-at 相机放置以及轻量路径与网格辅助,用于摆放、缩放和排列场景资产。

主要能力:提供 scripts/spatial.py 脚本,含 place() 放置助手、look_at_rotation() 相机朝向、grid_positions() 网格布局、in_zone() 区域边界检查、bake_waypoints() 烘焙路点动画等。

使用方式:在暴露技能执行助手的运行时中调用 run_script("scripts/spatial.py", args=["--help"]);在已构建的 Isaac Sim 树中,从 _build/*/release 用 ./python.sh(Linux)或 python.bat(Windows)运行同一文件,或直接执行不依赖模拟器的 shell 助手。

关键约定:舞台为 Z-up、metersPerUnit=1.0(米);旋转始终用 AddRotateXYZOp();变换矩阵顺序为 Translate * Rotate * Scale;读取资产 metersPerUnit 必须用 Usd.Stage.Open(),不能用 Sdf.Layer.FindOrOpen()(对二进制 .usd crate 会静默失败)。

限制:面向 Isaac Sim 6 / Kit 110(除非某节另有说明);不替代 NVIDIA 官方文档处理未支持的边界情况。需已构建 Isaac Sim($ISAAC_SIM_DIR 或 _build/linux-x86_64/release)、NVIDIA GPU 与当前驱动,并满足 isaac-sim-orchestrator 的 shell 环境变量约定($ISAAC_SIM_DIR、$ISAAC_LAB_DIR、$WORKSPACE_DIR)。