Files
2026-10-15 10:40:26 +08:00

3.4 KiB
Raw Permalink Blame History

零件文件、分类与 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。