4.2 KiB
零件文件、分类与 Link 接口命名规范(2026-10-14)
前台与后台使用同一份识别代码:shared/part-naming.ts。
文件名
格式:部位名称_R/L/0_模型特征描述.扩展名。
例如:头_0_兔头零自由度.urdf、臂_L_轻量三自由度.step、足_R_长连杆.stp。
下划线分隔,部位和左右取前两段,其余内容是非空的模型特征描述。中文部位或对应英文均可识别;字母识别不区分大小写,但推荐按本表大写书写。原文件名、URDF 和网格不会被程序改写。0 表示不分左右;L/R 是零件的机械左右,不是屏幕左右。当前启用下表的 12 种分类。
| 部位 | Link 接口名 | 保存/匹配分类 |
|---|---|---|
| 躯干 | LINK_TORSO_0 |
torso_0 |
| 头 | LINK_HEAD_0 |
head_0 |
| 腰 | LINK_WAIST_0 |
waist_0 |
| 左臂 | LINK_ARM_L |
arm_l |
| 右臂 | LINK_ARM_R |
arm_r |
| 左手 | LINK_HAND_L |
hand_l |
| 右手 | LINK_HAND_R |
hand_r |
| 左足 | LINK_LEG_L |
leg_l |
| 右足 | LINK_LEG_R |
leg_r |
| 左脚 | LINK_FOOT_L |
foot_l |
| 右脚 | LINK_FOOT_R |
foot_r |
| 尾 | LINK_TAIL_0 |
tail_0 |
足对应 LEG,脚对应 FOOT,互不混用。旧的 PEDAL 分类不再作为足的新命名。
后台上传
STEP 必填,URDF、表单信息与 BOM 仍为选填。URDF 主文件或 STEP 文件符合规范时,自动生成只读分类,并保存 basicFields 中的 partType 与 partSide;比如 leg 与 l。仅上传 STEP 也会识别分类。
优先读取 URDF 主文件名,未识别时读取 STEP 文件名。两者都识别但部位或左右不同,显示具体错误并阻止提交;特征描述可以不同。文件名未识别时,保留手填分类能力,不新增必填项。文件夹名、STL 名、robot name 不参与零件分类。
{
"category": "leg_l",
"basicFields": [
{ "name": "partType", "value": "leg" },
{ "name": "partSide", "value": "l" }
]
}
urdfInfo.frames 保留原始 joint、parent/child、xyz/rpy、axis、limit;child link 按本表识别后生成 interfaceType。URDF 根 link 在 rootLink 中保留,前台也能从实际文件识别根 link 接口。
前台装配
主 URDF 文件名确定零件分类,文件名未识别时使用接口返回的分类。同类、同侧接口匹配,如父 LINK_LEG_L 对子 LINK_LEG_L;不会把 LEG 接到 FOOT,也不会把 L 接到 R。后端明确给定节点配对时使用明确节点。
从实际 URDF 累积关节变换,令父子安装接口坐标系重合:子零件变换 = 父接口变换 × 子接口变换的逆。内部 joint / visual / mesh 的坐标、方向和单位保持原样,不添加自动翻转。标准 Link 名的识别优先级最高;已有文件使用其他 Link 名时,使用后端返回且能对应到实际 Link 的 urdfInfo.frames.interfaceType 识别其类型,不改名或修改坐标。多个同类节点无法唯一配对时提示并单独展示,不随机选取。
新上传文件仍推荐使用完整标准 Link 名。已有的 LINK_head、Link-head 等接口如已返回明确的 interfaceType,前台会利用这个类型及实际 URDF 坐标连接,不要求为查看现有模型而重传。若后端没有类型记录,且实际名称无法识别,不猜测配对;零件会单独展示。旧记录和文件内容不会被修改。服务器的检索目录和 AI 分类也应将旧 pedal_l/r 同步为 leg_l/r。
可选装配旋转轴(2026-10-15)
components[].component.rotationAxis 可为 x/y/z/-x/-y/-z,空值为固定连接。在子零件安装连接点的局部坐标系中增加一个连续旋转关节,默认 0°,保留 URDF 内部关节。前台“属性 → 装配关节”提供角度预览与归零;下级零件跟随运动,保存版本与导出工作台状态时保留装配角度。仅给根零件设置旋转轴不会产生额外连接。
旋转以实际接口位置为支点,变换为 父零件 × 父接口 × 轴旋转 × 子接口的逆。不绕模型原点旋转,不更改文件原始坐标。预览滑块的一圈范围不表示机械限位。