Files
Jerry 6b06fadb47 DECISION: Preserve both hand workspaces in the requested project snapshot
DECISION: Include the existing Claude hand implementation, intermediate LH20 R0.2 source, and saved R0.1 notebook state in the repository snapshot requested by the owner.

WHY: In the 2026-11-17 project publication discussion, the owner requested the current project at https://gitea.robotquan.com/xuyongjie/make-cad.git on main. These workspace sources were present but not yet tracked, while the verified photo-refined R0.4 model and launcher updates were already committed. Saving the sources makes the published project reflect the actual workspace, including both selectable implementations and the intermediate design history.

ALTERNATIVE CONSIDERED AND REJECTED: Pushing only committed R0.4 sources would omit the other hand implementation and intermediate work that are part of the current project.

WHAT CHANGES: Track examples/dexterous_hand_20dof and examples/lh20_hand_r02, including their documentation and reference license; save the existing examples/lh20_hand/hand.py notebook state. Keep the R0.4 launcher selection and existing ignore rules. Generated CAD outputs, caches, virtual environments, and build directories remain local.

Checked: Python compileall passed for both added example directories and the saved notebook. A filename-only credential-pattern scan found no matches in the publication tree. R0.2 remains explicitly documented as an intermediate design; no new complete-hand engineering qualification is claimed for these archived sources.

Co-Authored-By: Codex <noreply@openai.com>
2026-11-17 13:41:10 +08:00
..

LH20:以 WUJI Hand 2 为参考的无腱绳灵巧手

面向精细操作与柔顺抓取的原创参数化工程布局原型。五指、20 个独立转动轴;电机经过两级行星传动驱动关节,允许内部电线,没有腱绳/拉索传动。

当前为 R0.1 数字原型,尚不能直接下单加工或宣称实现了柔顺抓取。 已建立外形、承力框架、真实齿形、轴/轴孔、轴承、外盖与接触垫;电机、编码器和 PCB 的部分内容为明确标注的安装空间。检查覆盖展开、四组对指与一个中间状态,实际结果见工程记录;完整运动包络与结构强度仍需验证。

查看结果

  • out/lh20_right_hand_overview.png:掌面、背面、内部传动布局,均由实际 CAD 渲染。
  • out/joint_A_overview.png:独立关节完整、拆壳和轴向分解图。
  • out/lh20_right_hand_opposition_index_overview.png:食指对指状态的 CAD 几何投影。
  • out/lh20_right_hand.scadpkg:SimpleCAD 原生装配包。
  • out/joint_A.scadpkg、out/joint_B.scadpkg、out/joint_C.scadpkg:可单独打开的三档关节原生模型。
  • out/lh20_right_hand.step:跨 CAD 软件的实体装配。
  • out/lh20_right_hand.FCStd:FreeCAD BREP 装配快照。特征历史保存在源笔记本和 .scadpkg;它不是完整翻译后的 FreeCAD 原生特征树。
  • out/lh20.xml、out/lh20.urdf、out/meshes/:20 轴 MuJoCo/URDF 模型,外观网格来自同一 CAD。
  • out/engineering_review.md:自动汇总的检查结果、质量估算和未闭合项。

生成物不提交到 Git。源文件、确定性种子与构建脚本均在本目录。

参数与模块

档位 数量 模块直径 × 轴向宽度 两级齿数:太阳/行星/齿圈 总减速比
A 6 24 × 22.2 mm 12 / 24 / 60 36:1
B 9 21 × 21.4 mm 12 / 18 / 48 25:1
C 5 18 × 20 mm 18 / 18 / 54 16:1

25° 压力角、齿宽、模数、名义侧隙和三行星等分条件在 parameters.py、parts/drivetrain.py 中定义。非自锁齿轮构型有利于研究反驱,但没有测量摩擦和传动效率之前,不宣称已经具备合格的反驱性能。

hand.py → 五个 finger.py → 二十个 joint_module.py 构成装配层级。所有零件有独立身份、材料和命名连接坐标;外部 20 个主动轴与内部齿轮的从动运动分开描述。参数化零件按掌部、指节和传动分模块存放于 parts/。

内部齿轮角度按行星传动的 Willis 关系给定;这不是齿面接触动力学求解。标准轴承的装配身份按关节区分,允许各轴同时使用不同角度,避免多个从动定义共享同一身份却指向不同状态。

重建

以下命令从仓库根目录运行。依赖版本记录在 requirements.txt;当前已验证 macOS arm64 + Python 3.12 + SimpleCADAPI 2.3.0。

uv venv --python 3.12 .venv
uv pip install --python .venv/bin/python -r examples/lh20_hand/requirements.txt
.venv/bin/python examples/lh20_hand/build.py hand --no-cache
.venv/bin/python examples/lh20_hand/verify/opposition.py
.venv/bin/python examples/lh20_hand/export_sim.py
.venv/bin/python examples/lh20_hand/export_model.py --fcstd
.venv/bin/python examples/lh20_hand/render.py

--fcstd 使用本机 /Applications/FreeCAD.app;其他平台可省略该参数,直接导入 STEP。SimpleCADAPI 当前安装版本的 FreeCAD 原生图翻译器不支持本例的部分工作平面操作,故这里明确导出 BREP 快照。

编辑 parameters.py 后重新构建;hand.py 中的五组角度为度。可在项目编辑器中打开 hand.py,或生成某个实际受驱动装配姿态:

.venv/bin/sca edit examples/lh20_hand/hand.py
.venv/bin/python examples/lh20_hand/build.py hand --pose opposition_index --no-cache

验证

.venv/bin/python examples/lh20_hand/verify/geometry.py --collisions --external-only
for pose in opposition_index opposition_middle opposition_ring opposition_little opposition_index@0.5; do
  .venv/bin/python examples/lh20_hand/verify/geometry.py --collisions --external-only --pose "$pose"
done
.venv/bin/python examples/lh20_hand/verify/engineering.py
.venv/bin/python examples/lh20_hand/verify/pose_projection.py
.venv/bin/python -m pytest examples/lh20_hand/verify/test_control.py -q
for size in A B C; do
  .venv/bin/python examples/lh20_hand/build.py joint --size "$size" --no-cache
  .venv/bin/python examples/lh20_hand/verify/geometry.py --name "joint_$size" --collisions
done
.venv/bin/python examples/lh20_hand/build.py joint --size A --angle 17.3 --no-cache
.venv/bin/python examples/lh20_hand/verify/geometry.py --name joint_A_17p3 --collisions
.venv/bin/python examples/lh20_hand/render.py --name joint_A
.venv/bin/python examples/lh20_hand/render.py --pose opposition_index
.venv/bin/python examples/lh20_hand/release.py

release.py 检查原生包、检查记录、导出文件和图像摘要是否对应,满足检查条件后生成 out/LH20_R01_delivery.zip。上面的完整交付流程包含本机 FreeCAD 快照导出;已有虚拟环境时无需再次运行 uv venv。

--external-only 检查零件与其他模块之间的干涉;每类模块内部另用 --name joint_A/B/C --collisions 检查。包络加速前先用 BREP 布尔差验证所有模块零件确实在包络内。未执行的检查不会标记为通过;发现干涉时程序以非零状态退出并保留零件对和重叠体积。

额外检查包括:A 档 17.3° 实际装配角度下的齿轮干涉、CAD 与独立运动学坐标一致性、雅可比有限差分、MuJoCo 20 轴加载与短时数值运行。它们均不代替实物测试或全运动空间验证。

碰撞修订数据位于 clearance_reliefs.json。verify/design_reliefs.py 将已测得的局部碰撞转换为可审阅的避让特征,并更新参数摘要以使缓存失效;修订后仍必须重建并重新运行独立检查。构建会拒绝过大的材料去除或结构分裂。

接下来必须闭合的工程项目

  1. 完善指根叉架与外盖的连续运动包络,验证整段路径及极限组合,完成最小壁厚、刚度/应力分析。
  2. 确认三档定制电机、电流与热性能;完成齿轮寿命、背隙、支承刚度、轴承寿命和轴向固定。
  3. 完成紧固件、压配/滑配公差、实际电线或 FPC 回环、驱动和触觉电路。
  4. 先制作单关节与单指台架,再扩展整手。测试堵转温升、反驱力矩、接触力标定、循环寿命与控制稳定性。

设计依据及决策见 DESIGN.md;控制与布线方案见 CONTROL.md;供应商电机输入条件见 MOTOR_RFQ.md。参考 WUJI 的构型与开放开发思路,不把未公开的内部结构当成已知,也不把本模型称为 WUJI 复刻品。