从3D模型反推螺丝清单:Microduck复刻紧固件逆向实战——146个过孔里的M2系统
从3D模型反推螺丝清单:Microduck复刻紧固件逆向实战——146个过孔里的M2系统
做Microduck 复刻时,最尴尬的不是画不出结构,而是官方没给螺丝清单——上游只开源了 MJCF 仿真模型和 47 个 STL 网格,机械 BOM 一片空白。那结构件到底要买多少螺丝、多长、什么规格?本项目的做法是:直接扫描 3D 网格的孔特征,用几何反推出一份完整的 M2 紧固件清单,最后用实物打印件验证成立。
💡 官方公开了完整运动学树(零件挂在谁身上、相对位置精确到 0.1mm),但没有装配文档和紧固件列表。本仓库 microduck-replica 就是把这些「藏在模型里的信息」全部还原出来的结果。
为什么可以从网格里「数」出螺丝
STL 网格虽然只是三角面片,但 CAD 导出的孔在网格上就是一个圆柱面。只要能自动找出所有圆柱面、量出直径、判断它是孔还是凸台,孔位清单就有了。
扫描工具 scripts/analyze_holes.py 的流程只有 6 步:
- 焊接重复顶点,建立面片邻接图
- 按二面角 35° 切割,region-grow 出「光滑曲面片」(锐边处断开,孔的圆柱面就会独立成一片)
- 每片拟合圆柱——圆柱面法向都垂直于轴,所以轴 = 法向协方差矩阵的最小特征向量
- 顶点投影到垂直轴的平面,用 Kåsa 代数圆拟合求直径,相对残差 >3% 的丢弃
- 法向指向轴心 = 孔;背离轴心的是轴/凸台,排除
- 统计包角,只保留 ≥300° 的完整圆孔
47 个零件全部扫描,总耗时 2.5 秒,结果输出到 docs/hole_analysis.json(每个孔的直径、深度、包角、面数都在里面,可复查)。
结论:整机是一套 M2 螺丝系统
结构件完整圆孔的直径分布如下,一眼就能看出设计者的意图:
| 直径 | 数量 | 判读 |
|---|---|---|
| Ø2.2 | 77 | M2 过孔(标准 M2 clearance 2.2–2.4) |
| Ø4.4 | 28 | M2 沉头孔(M2 内六角柱头 Ø3.8,沉孔 4.0–4.5) |
| Ø1.6 | 20 | M2 攻丝底孔(M2 标准底孔正好 1.6) |
| Ø2.4 | 22 | M2 松配过孔 |
| Ø2.0 | 12 | M2 紧配过孔 |
| Ø2.7 / Ø2.8 | 20 | M2.5 过孔(少量) |
| Ø4.8 | 10 | M2 沉头孔(另一种沉孔深度) |
| Ø5.4 / Ø6.0 | 16 | 轴孔 / 轴承座,非螺丝 |
几个关键交叉验证,说明这不是巧合:
- Ø2.2 与 Ø4.4 成对出现在
yaw2roll、leg、ankle_left、neck_pitch等件上——典型的「过孔 + 沉头孔」组合,锁定用的是 M2 内六角圆柱头螺丝 xl330.stl自身有 Ø2.0×4 + Ø1.6×8,与 Dynamixel XL330 的 M2 安装孔完全一致xl330网格在整机中引用了 15 次——整机 15 个舵机(14 个受策略控制,第 15 个驱动喙/下颚),与官方 README 的 "15 servos" 一致
146 个过孔是怎么算出来的
按各网格在整机中的实际引用次数加权(leg 实际 ×4、hip_l/yaw2roll 等 ×2):
| 网格 | 整机用量 | M2 过孔 | M2 底孔 | 沉头孔 |
|---|---|---|---|---|
xl330 |
×15 | 4 | 8 | — |
hip_l |
×2 | 9 | — | 6 |
yaw2roll |
×2 | 8 | — | 6 |
leg |
×2 | 6 | — | 6 |
neck_pitch |
×1 | 12 | — | 4 |
face_part |
×1 | 10 | 4 | — |
ankle_left / ankle_right |
×1 各 | 5 | — | 5 |
| 其余 20 余种结构件 | — | 合计约 98 | — | — |
整机 M2 级孔(Ø1.9–2.5 mm、包角 ≥300°)加权合计 237 个,其中:
- 60 个在舵机本体上(15 × 4)—— 外购件自带孔,不用你操心
- 21 个在轴承 / PCB / 电池等标准件上
- 扣掉外购件后,结构件过孔约 146 个 —— 这就是文章标题里那个数字,也是你要买螺丝的真实依据
⚠️ 早期统计曾写「213 个」,复算不出来——差异来源是早期未按装配体用量加权且混入了未被 MJCF 引用的网格,已在 docs/紧固件反推.md 中勘误。
螺丝长度从哪来:孔深分布
螺丝长度不能拍脑袋,脚本同时记录了每个孔的深度(沿轴方向的顶点跨度)。Ø2.2 孔的实测深度分布:
| 孔深区间 | 数量 | 对应螺丝 |
|---|---|---|
| 0–3 mm | 51 个(占 51/79) | M2×4(薄壁位) |
| 3–5 mm | 24 个 | M2×8 |
| 8–12 mm | 4 个 | M2×12 |
由此得出建议采购量(含损耗和试装,见 docs/机械采购清单.md):
| 规格 | 数量 | 用途 |
|---|---|---|
| M2×4 内六角圆柱头 | 60 | 薄壁位 |
| M2×6 内六角圆柱头 | 80 | 主力规格 |
| M2×8 内六角圆柱头 | 40 | 孔深 3–5 mm 位 |
| M2×12 内六角圆柱头 | 15 | 少量深孔 |
| M2 螺母 | 50 | 无攻丝处 |
| M2 热熔螺母 | 60 | 打印件推荐替代直接攻丝 |
| M2.5×6 | 20 | 少量 Ø2.7 孔位 |
合计约 325 件,对 237 个孔位有 1.37 倍余量。💡 打印件上强烈建议用热熔螺母而不是直接攻丝,记得配专用烙铁压头。
实物验证:第一批打印件,M2 螺丝真的装进去了
反推最怕「纸上对、实物错」。2026-09-02 首批打印件出炉后,第一个验证点就来了——黑色腿部结构件上的 M2 螺丝顺利装入:
这意味着「整机是 M2 螺丝系统」的结论在实物上至少对这几个孔位成立。后续 2026-09-13,15 颗飞特 HD-1910 版整机装出,紧固件方案完全跑通:
完整过程记录在 构建日志.md。
⚠️ 局限性:这是反推,不是图纸
用之前请务必知道边界:
- 仿真网格 ≠ 工程图纸——只保证外形与惯量正确,不保证配合公差
- FDM 打印收缩会让 Ø2.2 孔偏小 0.1–0.3 mm,装配前务必先打试件校验
- 沉头孔与过孔可能被重复计数(同一颗螺丝的两个特征),螺丝数量以过孔为准
- 腰孔、异形槽、包角 <300° 的圆弧、>14 mm 大开口均不在统计内
- 螺丝长度是按孔深推算的区间,不是实测值
总结
这套方法可以推广到任何「只有 STL、没有 BOM」的开源硬件:
- 用网格圆柱面检测脚本(scripts/analyze_holes.py)扫出全部孔的直径/深度/包角
- 按孔径聚类,对照标准件(M2 过孔 Ø2.2 / 沉头 Ø4.4 / 底孔 Ø1.6)识别螺丝系统
- 按 MJCF 装配体引用次数加权计数,扣除外购件自带孔位
- 按孔深分布推算螺丝长度,加 30% 余量采购
- 首批打印件实物验证
最终产物:docs/紧固件反推.md(完整推导)· docs/hole_analysis.json(原始数据)· docs/机械采购清单.md(带采购链接的清单)。146 个过孔、一套 M2 系统,从 47 个 STL 里 2.5 秒数出来——这大概就是「逆向工程」最划算的形态。



