SuperAPI AI 工具集

sdf

通用与其它

查看项目

更新于 10-15 21:36

技能介绍

用途:当交付物是 SDFormat 文档时使用本技能。SDFormat 描述模拟器与世界行为,包括模型、世界、坐标系、位姿、链接、关节、惯性、视觉、碰撞、传感器、灯光、物理、插件、include 与模拟器元数据。本技能针对 SDFormat,不用于有符号距离场几何。

主要能力:直接编写与编辑 .sdf XML(.sdf 文件即事实来源,没有 gen_sdf() 契约);用 cadgen sdf validate 校验文档结构、名称作用域、位姿/坐标系图、关节、几何、网格 URI、惯性、传感器与插件;用 cadgen sdf snapshot 渲染 PNG 快照;通过 CAD Viewer 查看结果。

使用方式:命令通过 uv 运行,cadgen 指 uvx --no-config --managed-python --python 3.13 --from cadgen==0.7.21 cadgen,python 同理。常用命令:cadgen sdf validate path/to/model.sdf(可加 --strict、--json)、cadgen sdf snapshot path/to/model.sdf review.png、cadgen viewer --host 127.0.0.1 --json --detach。外部检查默认开启,--gz-check auto 在 gz 位于 PATH 时运行 gz sdf --check,可选 required 或 never。

核心规则:编辑前先确定目标消费者(Gazebo/libsdformat 版本等)与文档类型(模型级、世界级或模型在世界中);新输出优先 version="1.12";使用 SI 单位;在每个非平凡位姿与轴上显式写出 relative_to / expressed_in;不要凭视觉推断空间变换,位姿、轴、缩放、质量、惯性与坐标系名称须来自上游数据、图纸、文档、实测值或明确假设;已有 URDF 时应从 URDF 派生 SDF;编辑前先重新生成上游几何、网格等资产;完成后运行可用检查并报告假设、跳过的检查、未解析资源路径与兼容性风险。

适用场景:机器人/物体模型导出、世界交接、模拟器加载前的校验与可视化审查。

限制:不用于有符号距离场建模、原始几何生成或规划语义;静态渲染不执行 SDF 插件,也不读取文件中的运动元数据;查看器不校验动力学;网格需先 git lfs checkout,否则报 No link mesh loaded for robot。其余细节暂未提供。