61 lines
4.2 KiB
Markdown
61 lines
4.2 KiB
Markdown
# 零件文件、分类与 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 不参与零件分类。
|
||
|
||
```json
|
||
{
|
||
"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 内部关节。前台“属性 → 装配关节”提供角度预览与归零;下级零件跟随运动,保存版本与导出工作台状态时保留装配角度。仅给根零件设置旋转轴不会产生额外连接。
|
||
|
||
旋转以实际接口位置为支点,变换为 `父零件 × 父接口 × 轴旋转 × 子接口的逆`。不绕模型原点旋转,不更改文件原始坐标。预览滑块的一圈范围不表示机械限位。
|