企业官网建设流程全解析

SO-ARM 从 100 到 101：我们踩了哪些坑，又怎么填上的

【免费下载链接】SO-ARM100Standard Open Arm 100项目地址: https://gitcode.com/GitHub_Trending/so/SO-ARM100

SO-ARM 是 RobotStudio 与 Hugging Face 联合开源的 3D 打印开源机器人手臂，SO-101 是它的第二代迭代。这篇文章基于两代机型的实际搭建经历，把经验按"坑"来组织，讲清楚哪些坑还值得你踩，哪些已经被填平了。

腕关节对不上：开源机器人手臂的翻车现场

半夜十一点，SO-100 的腕部零件刚下打印机，我们装上舵机一试，螺丝孔偏了那么一点点。拧上螺丝腕部就歪，不拧又松。重打了一遍，结果一样。SO-100 时代，腕关节和小臂是一体打印件，出一点问题就得整套重来；加上 12 颗电机全是同一个规格，leader 臂的手感一直发沉。SO-101 这一代，我们把这类问题一个个解决了，这篇文章把过程原原本本摊开讲。

📌 TL;DR：这套 3D 打印机器人手臂值不值得搞

• 定位：主从式遥操作开源机器人手臂，配套 LeRobot 开源库使用，主要用来采集演示数据、做模仿学习实验。
• 硬件门槛：双臂全套物料约 230 美元（一千三百多人民币），需要一台 FDM 3D 打印机；不想自己打也有代打印服务和整机套件。
• 组装难度：SO-101 省掉了 SO-100 时代"拆齿轮"的步骤，组装时间从大半天压缩到两三个小时。
• 适合：家里有打印机、愿意动手折腾、想认真做机器人学习的人。
• 不适合：想开箱即用，或者只想摆着看、不想碰任何机械装配的人。

如果后两条你全中，建议直接去买成品；如果只中第一条，继续往下看。

踩坑清单：SO-101 组装前要先知道的五个坑

坑 1｜打了二三十个零件，孔对不上

当时怎么翻的：SO-100 时代的零件文件散在多个目录里，腕部和小臂还是一体件，一次打印失败就整件报废，装配时也容易对不上孔。

SO-101 怎么解的：按功能拆成模块化零件，STL/SO101/Individual/ 里每件都是独立打印、独立装配的单元——基座用 Base_SO101.stl，腕部用 Wrist_Roll_Pitch_SO101.stl，肩俯仰用 Rotation_Pitch_SO101.stl，各自只管一件事，坏了哪件重打哪件。

你自己能怎么规避：补件、重打时按单件清单来，别一次性整套重打；坏件补打，好件接着用。

坑 2｜Leader 臂手感发沉：12 颗电机全用同一个减速比

当时怎么翻的：SO-100 用 12 颗 STS3215 舵机，清一色 1/345 减速比。follower 臂没问题，但 leader 臂上扭矩过大，扳动扳机像挤重物，遥操作跟手性很差。

SO-101 怎么解的：电机减速比分级配置。follower 臂保留 C001（1/345）高扭矩型号保负载；leader 臂换成三种规格混搭，大致是：

follower 臂 C001（1/345）×6；leader 臂 C046（1/147）×3、C044（1/191）×2、C001（1/345）×1

换完之后再动 leader 臂，运动明显轻快，跟手性回到了"用手带"的区间。

你自己能怎么规避：采购时严格按 README 里的物料表买，别图省事整箱买同型号；SO-101 的 leader 臂统一用 7.4V 版本，电压别买错。

坑 3｜打印文件自己排托盘，还塞不进打印平台

当时怎么翻的：早期要一个个文件打，自己排摆放、自己算支撑，小平台排不下整个托盘，稍一疏忽支撑就扎进了螺丝孔。

SO-101 怎么解的：按打印机机型整合成"拿来就打"的文件。220×220mm 平台（Ender 等）直接用 Ender_Follower_SO101.stl 和 Ender_Leader_SO101.stl；205×250mm 平台（Prusa/UP Plus）用 Prusa 版文件。摆放方向和支撑策略都预设好了，切片软件里基本不用再动。

你自己能怎么规避：打印前先量打印平台尺寸再选对应文件；完全没打印机的话，看 3DPRINT.md 里的代打印渠道。

坑 4｜打印机"差不多准"，零件还是装不进去

当时怎么翻的：舵机安装孔大了 0.1mm，螺丝拧上松垮；小了 0.1mm，根本拧不进。这种偏差在切片预览里看不出来，装配时才现原形，而这时候大零件已经全部打完了。

SO-101 怎么解的：用校准 gauge 做双基准验证。STL/Gauges/ 里有两套：一套拿真 STS3215 舵机当基准，打 Gauge_0.STL 和 Gauge_tight_1.STL 直接试装；另一套拿标准乐高块当基准，打 Lego_Size_Test_02_zero.STL 和它的 -0.1 版本。先打 gauge、试装通过，再打正式零件。

你自己能怎么规避：换料、换机器、换切片参数后，第一件事永远是打 gauge。花一片料的钱，换一整臂的免报废。

坑 5｜出问题了，文档里查不到

当时怎么翻的：电机不动、腕部卡滞，老版文档里只有"请检查接线"这类一句话，调试全凭运气和拆机手感。

SO-101 怎么解的：文档重新组织——README 作为 SO-101 主入口，分步指引装在里面；老版 SO100.md 明确标注已弃用，避免新老步骤混着看；装配中卡住的环节，可以补打 Mount_Helper 对位工装辅助定位。排查流程写成"先查什么、再查什么"的症状导向顺序，而不是参数罗列。

你自己能怎么规避：自己写文档时，把"症状 → 排查顺序"写在前；作为用户遇到问题，先按症状检索，别上来就拆。

装完之后还能玩什么：可选硬件彩蛋 🧩

主体装完，Optional/ 目录里有一整排扩展等你：

• 腕部摄像头：32×32 UVC 模块支架有三款（六角螺母、一体化、插拔式），另有 RealSense D405/D435 托架和 Vinmooog 摄像头转接件，Wrist_Cam_Mount_32x32_UVC_Module 和 RealSense_D405 各有说明。这是做模仿学习的标配。
• 柔性夹爪：用 TPU 95A 打 Compliant_Moving_Jaw_SO101.stl，内部镂空筋结构利用 Fin Ray 效应，抓水果这类易碎物比刚性指套友好得多，且外形尺寸和原装指套一致，直接替换。
• 4040 铝型材基座：把手臂固定在 4040 型材上，配合 Overhead 相机支架，多臂协同部署就成立了。
• 社区第三方扩展：基于开放接口，社区还长出了触觉皮肤、双臂移动平台 XLeRobot 之类的东西，都在 README 的可选硬件一节列着。

给后来者的三条忠告

1. 先打 gauge，再打大零件。gauge 只花一片料，却能在大件打印前抓住尺寸偏差。这个顺序救过我们好几回，也是我们写文档时第一个强调的事。
2. 保留两代兼容，降低试错成本。SO-101 沿用了 SO-100 的基座和大量接口，手里的旧件可以继续混用。开源硬件"可以逐步升级"比"彻底换代"更友好，旧用户不用从零再来。
3. 文档要症状导向。SO-101 文档最大的价值不在参数表的完备，而在"出现 X 症状时按什么顺序查"。如果你的用户以非专业者居多，把排障流程写成决策树，比堆参数有用得多。

下一步 & 参与方式 🚀

团队已经启动 SO-102 的规划，方向有三个：材料上换碳纤维增强 PLA+ 提升结构强度；内置 IMU 实现不依赖视觉的姿态估计；低功耗模式下延长待机时间。新硬件就绪前，可以先在仿真里把算法跑通——Simulation/ 里有 SO-100 的 URDF 和 SO-101 的 Webots 场景，虚实对照着来。

想参与的话，入口有三个：

• git clone https://gitcode.com/GitHub_Trending/so/SO-ARM100自己动手搭一套，踩到的坑写成 issue 提上去——这正是下一版迭代方向的来源；
• 你所在地区如果有更顺手的采购渠道，直接提交 BOM 表补充，README 里那张表就是这么越补越全的；
• 装完之后，把装配笔记和翻车记录发到讨论区或项目 Discord 里。这个项目最好的素材，就是搭过的人写下来的"翻车实录"。

我们不求点赞收藏，只希望下次你遇到"腕关节对不上"的时候，答案就在这篇文章里。

【免费下载链接】SO-ARM100Standard Open Arm 100项目地址: https://gitcode.com/GitHub_Trending/so/SO-ARM100