Files
frontend/Client/docs/part-naming.md
T
2026-10-15 10:35:55 +08:00

4.2 KiB
Raw 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 的坐标、方向和单位保持原样,不添加自动翻转。标准 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 内部关节。前台“属性 → 装配关节”提供角度预览与归零;下级零件跟随运动,保存版本与导出工作台状态时保留装配角度。仅给根零件设置旋转轴不会产生额外连接。

旋转以实际接口位置为支点,变换为 父零件 × 父接口 × 轴旋转 × 子接口的逆。不绕模型原点旋转,不更改文件原始坐标。预览滑块的一圈范围不表示机械限位。