Files
make-cad/design-docs/lh20-tendonless-prototype.md
Jerry 3d07e3c1ae DECISION: Use independent geared joint modules for LH20
DECISION: Build an original, parameterized 20-axis hand using three sizes of two-stage planetary joints, with no tendon or pull-cable transmission. Keep unselected motors and electronics explicitly represented as reserved spaces.

WHY: In the 2026-11-16 discussion the owner chose WUJI Hand 2 as the main reference, authorized exterior and internal design, clarified that electrical wiring is allowed, and prioritized precise manipulation and compliant grasping. Public WUJI assets do not disclose a manufacturable internal drivetrain. The resulting design and evidence boundary are recorded in design-docs/lh20-tendonless-prototype.md and examples/lh20_hand/DESIGN.md.

ALTERNATIVE CONSIDERED AND REJECTED: Copying simplified public reference meshes would not establish a working internal layout. Tendon drives contradict the owner's requirement. The initial MR84 support spacing gave an inadequate side-moment screening margin, so the candidate support was widened to the MR104 envelope; catalog rating is still not a module load qualification.

WHAT CHANGES: Add separately named CAD parts, real involute gears, keyed torque interfaces, bearing envelopes, five finger assemblies, palm/frame/cover/pad geometry, tactile reservations, independent kinematics, pinned build inputs and reviewed local collision reliefs. Use unique bearing assembly identities so different joints can be driven at different angles. Generated output and unrelated concurrent work remain outside this commit.

Checked: Final native build contains 1011 solid occurrences and 176 part definitions. Independent BREP validity, canonical constraint solving and external interference checks passed for neutral, four opposition poses and one intermediate state. A/B/C internal checks and an A module at 17.3 degrees passed. Full travel, minimum wall thickness, strength, selected motors, retention details and real performance are not qualified.

Co-Authored-By: Codex <noreply@openai.com>
2026-11-16 18:33:00 +08:00

5.1 KiB

LH20 原创无腱绳灵巧手:设计与证据边界

2026-11-16 的需求与取舍

用户先比较 WUJI Hand 2、Linker O 系列与 Sharpa,随后明确选择 WUJI 为主要参考,要求从外形到内部开始设计,允许自主做工程取舍。用户澄清“不要线束”是禁止腱绳/拉索机械传动,允许内部电线,并选择精细操作与柔顺抓取优先。

WUJI 的公开结构资料与模型可用于理解五指、20 轴、开发与仿真接口,不能据此声称获得其未公开的电机、传动、制造图或性能。参考资料固定的仓库提交与供应商链接见 examples/lh20_hand/DESIGN.md。本工作独立放在 examples/lh20_hand/,不修改并行工作的 examples/dexterous_hand_20dof/ 或 SDK 导出器。

决策一:独立关节模块与参数化原始几何

采用三档两级行星关节、五个可替换手指、分节承力框架、外盖与软指腹;20 个主动转轴全部具有独立驱动位置。用真实渐开线齿形、D 形传扭接口、齿圈止转和成对轴承表达内部关系,不把示意圆盘或外壳当成完整传动。电机、编码器、触觉与板卡尚未完成选型的位置均标记为包络,不能把包络密度计作实际器件质量。

比较过 MR84 的紧凑输出支承;侧向弯矩初筛使其余量不足,因此改为 MR104 外形与 3.2 mm 轴承中心距。此筛查不构成承载能力、组合载荷或寿命认证。传动形式没有蜗杆或丝杠自锁结构,但反驱摩擦与柔顺性能仍需台架试验。

零件与装配按 parts/、joint_module.py、finger.py、hand.py 分层。拇指零位重定义为平展姿态,角度限位同步变换。标准轴承的装配身份按关节唯一化,解决同一通用定义在不同角度下发生引用身份冲突的问题。

决策二:柔顺控制只能使用明确的力矩预算

控制示例采用关节阻抗与雅可比转置力预算,所有量统一为 SI 单位,异常状态输出归零。当前电机和效率仍为假设,因此先把输出视为软件请求而不是硬件保证。3 N / 8 N 是设计目标;伸直中指 8 N 工况超过当前 A 档峰值预算,不能删除这个失败结果。控制示例使用姿态相关的力限幅与 20% 预算余量,不把仿真或公式当成真实传感器闭环。

决策三:模型交付由可复查证据约束

采用独立 OCP 实体检查、精确布尔干涉、独立运动学、有限差分雅可比、MuJoCo 坐标对照与短时数值运行,并检查 STEP/FreeCAD 重读。渲染仅显示实际 CAD。原生包、图像、导出与检查记录用 SHA-256 绑定,交付脚本拒绝陈旧或失败的证据。

简化胶囊碰撞曾漏掉局部外盖与叉架的重叠。保留失败报告,以实测交集生成带来源的局部避让特征;限制材料去除与脱落碎片,并重新构建与检查。没有忽略碰撞对来获得通过。避让数据的摘要参与参数和缓存失效。有限姿态检查仍不能证明完整运动范围无碰撞,体积/连通性限制也不能证明最小壁厚与刚度合格。

SDK 的 FreeCAD 原生特征翻译不支持本例的部分工作平面操作,因此 .FCStd 明确为 BREP 装配快照。原生特征与构建逻辑保存在笔记本和 .scadpkg 中,不能称为完整翻译后的 FreeCAD 特征树。

交换检查最初将原生 SDK 的自适应体积积分与 FreeCAD 的固定阶积分直接比较,误差超过 0.001% 阈值。检查源代码与独立计算后,改为两端使用一致的固定阶积分,保留原生积分估值与差异,阈值不放宽;同时增加全部边界顶点的双向位置检查。顶点比较不能替代完整曲面误差测量,所有原始诊断结果均保留。

审计入口与后续边界

项目 可复查入口 边界
需求、构型与材料 DESIGN.md、parameters.py 原创数字原型,非 WUJI 内部复刻
几何与代表性姿态 verify/geometry.py、clearance_reliefs.json 展开、四组对指、一个中间状态;非连续全行程
齿轮与关节运动 joint_module.py、独立模块检查 A/B/C 零位与 A 档 17.3°;非齿面动力学/寿命
数值与控制 verify/engineering.py、verify/test_control.py 数值一致性与限幅;非实物精度或稳定性
交换与交付 export_model.py、release.py 检查摘要与实体;未完成制造、公差与实机验证

仍需完成电机与热设计、齿轮强度和寿命、轴承配合与轴向固定、紧固件、公差栈、全范围运动间隙、真实布线与电路,以及单关节、单指、整手样机试验。详细结果由 out/engineering_review.md 与机器可读记录提供;生成物不进入 Git。

提交系列(按主题,不绑定可重写的哈希)

  1. DECISION: Use independent geared joint modules for LH20:参数化模型和需求记录。
  2. DECISION: Bound compliant-control requests by posture torque budgets:控制与相应测试。
  3. DECISION: Gate LH20 delivery on reproducible geometry and export checks:检查、图像、交换与交付工具。