Files
2026-10-15 10:35:55 +08:00

61 lines
4.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 零件文件、分类与 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 内部关节。前台“属性 → 装配关节”提供角度预览与归零;下级零件跟随运动,保存版本与导出工作台状态时保留装配角度。仅给根零件设置旋转轴不会产生额外连接。
旋转以实际接口位置为支点,变换为 `父零件 × 父接口 × 轴旋转 × 子接口的逆`。不绕模型原点旋转,不更改文件原始坐标。预览滑块的一圈范围不表示机械限位。