Files
Jerry 8d3415602f DECISION: Refine the complete five-finger exterior from physical reference photos
DECISION: Refine R0.3 into a separate R0.4 exterior using the user's physical-hand photographs, preserving all five four-axis finger chains, including the little finger removed from the photographed sample.

WHY: On 2026-11-17 the user supplied five close-ups and asked for a comparison-based improvement, explicitly explaining the missing little finger. The photographs reveal curved shells, fork openings, stepped joint caps, black contact pads and a spatial thumb root more clearly than the earlier website screenshot. design-docs/lh20-r04-photo-refinement.md records the interpretation, assumptions, rejected alternatives and checks. No scale marker or internal section was supplied, so the existing dimension baseline remains an original design input and the internal drive remains pending.

ALTERNATIVE CONSIDERED AND REJECTED: Merely changing colours, duplicating the missing-finger state, or presenting a concept image would not improve the actual complete CAD model. Reusing earlier verification reports would conceal new geometry and motion failures.

WHAT CHANGES: Add curved shells and removable covers, nested fork ears, stepped three-fastener caps, wraparound black pads, segmented flex-circuit placeholders and a canted thumb mounting frame. Preserve native articulated source, binding geometry checks and previews to captured packages. A small export adapter uses the native writer's existing metadata_properties=False option and saves complete descriptive records in a hashed sidecar because >22 kB constraint strings overflow the OCCT STEP reader; geometry and assembly structure remain intact, and the shared SDK is unchanged.

Checked: Single finger and complete hand passed positive-volume, BREP validity, constraint and exact interference checks in straight and specified light-flex poses. Diagnosed and removed a 0.256 mm3 knuckle overlap without changing the 0.01 mm3 threshold. All five fingers retain four axes. STEP reimport retained 245 solids with relative volume error 4.03e-7. URDF has 21 links, 20 joints and 84 mesh files. Reviewed actual front/back/oblique/side CAD views and the R0.3 comparison. Packaging verified 102 files, relative mesh paths, source hashes and independent-finger versus nested-finger volumes. Python compilation passed. Full travel, actuator integration, continuous flex routing, manufacturing and hardware performance are not qualified.

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

LH20 R0.4 — 实物照片对照优化

依据 2026-11-17 用户提供的五张实物照片细化 R0.3。保留完整五指(包括照片中被拆掉的小拇指)、20 轴和无腱绳设计方向。

本版把平板指节改为圆弧壳体与独立弧面盖,重做关节叉架开口、阶梯端盖和三点紧固细节,扩大黑色指腹包覆,增加分段柔性电路走线占位,并让拇指基座有空间朝向。尺寸沿用现有设计值,不能从无标尺照片声称实测还原。

这是外形与关节布局模型。内部电机、减速器、轴承和连续柔性电路未完成适配。橙色件表示走线占用位置,不是已验证的柔性电路设计。

查看

用户原入口:http://127.0.0.1:8780/hand_launcher/#/chatgpt。

另一个菜单:http://127.0.0.1:8764/hands/codex;独立编辑器:http://127.0.0.1:8795/。R0.3 保留在原目录及端口 8785。

重建与检查

.venv/bin/python examples/lh20_hand_r04/build.py finger
.venv/bin/python examples/lh20_hand_r04/verify.py --name finger --collisions
.venv/bin/python examples/lh20_hand_r04/render.py --name finger
.venv/bin/python examples/lh20_hand_r04/build.py hand
.venv/bin/python examples/lh20_hand_r04/verify.py --collisions
.venv/bin/python examples/lh20_hand_r04/render.py
.venv/bin/python examples/lh20_hand_r04/compare.py
.venv/bin/python examples/lh20_hand_r04/build.py hand --pose relaxed
.venv/bin/python examples/lh20_hand_r04/verify.py --name hand_relaxed --collisions
.venv/bin/python examples/lh20_hand_r04/export.py
.venv/bin/python examples/lh20_hand_r04/package.py ~/Downloads/LH20_Codex_R04_实物对照优化_2026-11-17

out/hand.scadpkg 为完整五指原生包。*_build.json 记录包摘要与具体角度;*_check.json 检查实体、约束和精确干涉(0.01 mm³ 阈值);检查失败历史会保留。轻屈姿态为四根长指各 (0,8,10,6) 度,拇指 (0,4,8,8) 度。通过这两组检查也不意味着全行程无干涉。

hand_overview.png 是真实 CAD 掌面、背面和斜视图,另有 hand_side.png 与 finger_* 局部视图。预览记录绑定原生包摘要。

LH20_R04_exterior.step 通过回读数量和体积检查;LH20_R04_exterior.urdf 与 meshes/ 包含完整五指、21 link、20 个关节。URDF 只用于外观及运动学查看,effort/velocity 为零,无惯量、碰撞模型或驱动能力声明。网格和关节坐标为米,STEP 为毫米。

该版每根手指的 AP242 描述性 JSON 超过 22 kB,触发本机 OCCT STEP 读取器的字符串扫描缓冲限制。exchange_step.py 使用原生写入器已有的 metadata_properties=False 选项,保持实体、名称、颜色、放置及装配层级,将完整描述记录写入 LH20_R04_exterior_metadata.json 并绑定包和 STEP 摘要。未修改 STEP 文本或简化几何;仍须通过原有回读检查。

打包脚本校验来源摘要、相对网格引用和 ZIP 文件摘要;不会覆盖已有交付目录。实际检查摘要见 out/,不沿用其他版本的结果。

2026-11-17 本轮结果:245 个实体的展开和上述轻屈姿态检查均通过;检查确认五指各四轴。STEP 回读保留 245 个实体,体积相对误差约 4.03×10⁻⁷;URDF 为 21 link、20 joint、84 个网格。单指、整手的同名分件还在打包时比较体积,防止子装配缓存混入旧形状。

源码与边界

  • parts/finger_surfaces.py:圆弧壳体、可拆盖、叉架、黑色指腹和走线槽。
  • parts/joint_details.py:阶梯端盖和候选紧固件。
  • parts/links.py:组合独立分件及关节连接点。
  • parts/palm.py:掌壳、检修盖和倾斜拇指安装框架。
  • finger.py、hand.py:关节约束与完整五指装配。

制造公差、承力、轴向固定、真实电机与传动空间、连续电气路线、全运动包络、触觉器件和实物抓取性能仍需后续工程验证。详见 BRIEF.md 中逐张照片对应的修改与假设。