从3D模型反推螺丝清单:Microduck复刻紧固件逆向实战——146个过孔里的M2系统

原创2026-10-14 17:43:371,337 阅读
文章标签:机器人智能硬件硬件开发嵌入式人工智能强化学习语音后端前端3D建模

从3D模型反推螺丝清单:Microduck复刻紧固件逆向实战——146个过孔里的M2系统

做Microduck 复刻时,最尴尬的不是画不出结构,而是官方没给螺丝清单——上游只开源了 MJCF 仿真模型和 47 个 STL 网格,机械 BOM 一片空白。那结构件到底要买多少螺丝、多长、什么规格?本项目的做法是:直接扫描 3D 网格的孔特征,用几何反推出一份完整的 M2 紧固件清单,最后用实物打印件验证成立。

Microduck 装配爆炸图:展示各结构件装配关系与质量

💡 官方公开了完整运动学树(零件挂在谁身上、相对位置精确到 0.1mm),但没有装配文档和紧固件列表。本仓库 microduck-replica 就是把这些「藏在模型里的信息」全部还原出来的结果。

为什么可以从网格里「数」出螺丝

STL 网格虽然只是三角面片,但 CAD 导出的孔在网格上就是一个圆柱面。只要能自动找出所有圆柱面、量出直径、判断它是孔还是凸台,孔位清单就有了。

Microduck 四分之三视图:整机结构与孔位分布

扫描工具 scripts/analyze_holes.py 的流程只有 6 步:

  1. 焊接重复顶点,建立面片邻接图
  2. 按二面角 35° 切割,region-grow 出「光滑曲面片」(锐边处断开,孔的圆柱面就会独立成一片)
  3. 每片拟合圆柱——圆柱面法向都垂直于轴,所以轴 = 法向协方差矩阵的最小特征向量
  4. 顶点投影到垂直轴的平面,用 Kåsa 代数圆拟合求直径,相对残差 >3% 的丢弃
  5. 法向指向轴心 = 孔;背离轴心的是轴/凸台,排除
  6. 统计包角,只保留 ≥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螺丝已成功装入

这意味着「整机是 M2 螺丝系统」的结论在实物上至少对这几个孔位成立。后续 2026-09-13,15 颗飞特 HD-1910 版整机装出,紧固件方案完全跑通:

飞特HD-1910版整机装机正面照:M2螺丝系统整机验证

完整过程记录在 构建日志.md。

⚠️ 局限性:这是反推,不是图纸

用之前请务必知道边界:

  1. 仿真网格 ≠ 工程图纸——只保证外形与惯量正确,不保证配合公差
  2. FDM 打印收缩会让 Ø2.2 孔偏小 0.1–0.3 mm,装配前务必先打试件校验
  3. 沉头孔与过孔可能被重复计数(同一颗螺丝的两个特征),螺丝数量以过孔为准
  4. 腰孔、异形槽、包角 <300° 的圆弧、>14 mm 大开口均不在统计内
  5. 螺丝长度是按孔深推算的区间,不是实测值

总结

这套方法可以推广到任何「只有 STL、没有 BOM」的开源硬件:

  1. 用网格圆柱面检测脚本(scripts/analyze_holes.py)扫出全部孔的直径/深度/包角
  2. 按孔径聚类,对照标准件(M2 过孔 Ø2.2 / 沉头 Ø4.4 / 底孔 Ø1.6)识别螺丝系统
  3. 按 MJCF 装配体引用次数加权计数,扣除外购件自带孔位
  4. 按孔深分布推算螺丝长度,加 30% 余量采购
  5. 首批打印件实物验证

最终产物:docs/紧固件反推.md(完整推导)· docs/hole_analysis.json(原始数据)· docs/机械采购清单.md(带采购链接的清单)。146 个过孔、一套 M2 系统,从 47 个 STL 里 2.5 秒数出来——这大概就是「逆向工程」最划算的形态。

登录后查看全文
microduck-replica