用途
本技能用于为 ROS、MoveIt 和 Gazebo 编写、维护机器人及世界描述文件。机器人结构用 URDF 描述,MoveIt 规划语义用 SRDF 描述,模拟器与世界用 SDF 描述。每个 .urdf、.srdf、.sdf 文件都是事实来源,应直接编写和编辑 XML,而不是搭建 Python 生成流水线。
三种格式的分工
URDF 负责机器人物理结构:links、joints、几何、惯性、限位、mimic 关节、传动以及机器人状态发布。
SRDF 负责在有效 URDF 之上的 MoveIt 语义:虚拟关节、被动关节、规划组、组状态、末端执行器和禁用的碰撞对。SRDF 与其 URDF 仅通过同目录、同 <robot name> 配对,且该目录中恰有一个这样的 URDF。
SDF 负责模拟器与世界语义:物理、传感器、灯光、插件、世界以及仿真相关元数据。已有 URDF 的机器人应从 URDF 派生 SDF,而不是重新编写。
网格由 CAD 工作流负责:每个 link 一个网格资产,按该 link 的帧导出并记录源单位。网格导出错误应在 CAD 工作流中修复,不能靠 URDF 原点或 SDF 位姿补偿。
主要使用方式
安装方式:
curl -fsSL https://texttocad.dev/install.sh | sh
Windows PowerShell 使用:
irm https://www.texttocad.dev/install.ps1 | iex
若 cad 不在 PATH 中,使用 ~/.local/bin/cad(Windows 为 cad.exe)。cad doctor --check 可查看安装与服务版本而不做修改,cad doctor 修复其报告的问题。cad <verb> --help 给出完整当前接口。
校验与快照示例:
cad urdf validate path/to/robot.urdf cad urdf validate path/to/robot.urdf --packages robot_description=/path/to/pkg cad srdf validate path/to/robot.srdf --strict cad sdf validate path/to/model.sdf --json cad sdf validate path/to/model.sdf --gz-check required cad urdf snapshot path/to/robot.urdf review.png --pose '{"shoulder_pitch": 30}' cad srdf snapshot path/to/robot.srdf review.png --pose arm/ready cad sdf snapshot path/to/robot.sdf review.png --pose '{"arm::elbow": 45}'
编写规则要点
先识别目标消费方(RViz、robot_state_publisher、Gazebo/Ignition、MoveIt、真实机器人驱动或其他模拟器)及其严格程度。写 XML 前建立台账(帧、关节、几何、单位、假设),作为文件顶部注释块,并与模型事实在同一编辑中更新。默认使用 SI 单位:米、千克、秒、弧度;URDF 限位和 SRDF 组状态不使用角度。不根据模糊描述或视觉印象推断变换、网格单位、手性、轴、关节符号或规划语义;不凭直觉填写惯性张量、质心、跨多 link 的单位换算、镜像变换。不通过偏移视觉网格来编码运动学修正。
适用场景与限制
适用于:编写机器人结构描述;添加 MoveIt 规划组、末端执行器、命名状态与碰撞对;为 Gazebo 构建模型或世界;为已有 URDF 派生 SDF;为 link 关联 CAD 网格;计算质量、质心与惯性;在查看器中闭合四杆机构;生成位姿或命名状态快照;校验每次修改。
限制:校验通过只是防护栏而非证明,无法证明关节原点或轴与真实机器人一致、网格单位与尺度匹配、规划组符合任务或插件能够加载。校验一次只针对一个文件;退出码 1 表示目标未通过检查,2 表示命令行被拒绝。查看器不执行模拟器插件。应报告实际运行的检查与跳过的检查。