3.4 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 的坐标、方向和单位保持原样,不添加自动翻转。旧缓存的 urdfInfo.frames.interfaceType 不覆盖文件中 Link 名的识别结果。多个同类节点无法唯一配对时提示并单独展示,不随机选取。
旧的 LINK_head、Link-head、省略 0、中文 Link 或 PEDAL 接口不再按新规范自动识别;模型资源仍可加载。机械需要在源文件中修改 Link 并同步 joint 的引用后重新上传;只改文件名不会改变文件内部接口。旧记录不会被批量修改。服务器的检索目录和 AI 分类也应将旧 pedal_l/r 同步为 leg_l/r。