cbb
649bd69810
单文件约束取消后，Python 侧没必要再靠 16 处 sys.path.insert 维持扁平模块互认。
现在按职责分包：
arm/paths.py 路径唯一来源（含新增 CACHE、TPL）
arm/constants.py 实测接口数值（原 armcore 的 M/C/CLR/FIT/MOTOR_TOL 段）
arm/cad/{helpers,arm_build,part_tools,parts/} 几何与装配
arm/kinematics.py（原 human_layout.py，唯一运动学事实源）
arm/analysis/{sweep_v2,strength_check,torque_balance,finalize_travel,ws_sweep,gen_env_mesh}
arm/dataio/{screw_mesh,draw_sheet} arm/viewer/{build_viewer,shot}
arm/build_model.py（原 arm_model.py）
顺带修掉的既有缺陷（都是实测撞出来的，不是预防性改动）：
- arm_model 第二次 sys.path 跳到 gitignore 的 scratch/ 去 import 构建必需的包络脚本：
ws_sweep/gen_env_mesh 提升进 arm/analysis/，缓存挪到 data/cache/（gitignore，可重生成）。
- finalize_travel / draw_sheet 顶层就是"算完写文件"，一次 importlib 冒烟测试就把
docs/travel.json 重写了一遍；现在被 import 直接抛错。
- strength_check 用 OUT.replace("/out","/web") 靠字符串形状推路径，改成直接用 WEB。
- build_viewer 里 WORKSPACE 使用点漏改导致 NameError —— 已由构建关卡抓到并修掉。
os._exit 的处置与计划里的假设相反：实测光是 `python -c "import arm.cad.helpers"`
就会在解释器退出时段错误（exit 139，OCC 静态析构），全流程跑完也一样。所以入口
脚本尾部保留 flush + os._exit，并把原因写进注释；被 import 时不生效。
关卡（tests/）：
- verify.py 一条命令跑三层：产物 md5、IK 数值 exact 段、截图。
- 截图基线重做并分级：同一构建连跑两轮实测 102 张逐字节可复现（要求 md5 相同），
3 张线束 x-ray 不可复现（mean<=0.0017、无像素差>8）改为与参考像素比容差；
这 3 张不再入库，免得每次跑关卡都脏 git。
- 新增 ?view=sheet / ?sheet=N / ?theme / ?guide=N 四个 URL 参数：工程图与装配向导
占了约一半 CSS 和 700 行 JS，原先没有任何截图覆盖，拆它们等于没有关卡。
- 关卡灵敏度已验：改坏 IK 基线一个数 -> FAIL；换旧版求解器 -> 5 处 exact 差异。
实测：python -m arm.build_model 退出码 0，全部产物 md5 与基线一致，
105 视图截图全过，IK exact 段逐字节一致。
39 lines
6.7 KiB
Python
39 lines
6.7 KiB
Python
# -*- coding: utf-8 -*-
|
||
"""P05 大臂旋转座：J2 俯仰 -> J3 滚转（复用 part_tools 的 pitch->roll 骨架）。"""
|
||
import cadquery as cq
|
||
from arm.kinematics import Z_R3, Z_SH
|
||
from arm.cad.part_tools import make_pitch_to_roll_bracket
|
||
|
||
def p_shoulder_roll_base(j2, j3, half=None):
|
||
"""P05_大臂旋转座_螺旋体30%_墙4底5_竖打（深度圆角优化版）
|
||
|
||
本件在链路上有两重身份，两处让位都是为前端压盖：
|
||
1. hub_gap=6.0（从动侧）：J2 处 P04 新增了 M2 前端压盖（前端夹紧电机，消除大扭矩下的
|
||
倾斜），压盖占 Y 155.5..161.0，所以从动法兰盘背面必须从 Y=157 后移到 Y=162
|
||
（留 1.0mm 动间隙）。
|
||
2. roll_clamp=True（前端夹紧侧）：P05 自己抱着 M3（J3，-Z 轴），原来也只有后端板
|
||
4xM3x10 单面锁死；现在按 motor_front_clamp 的统一配方在 M3 前端盖外端面
|
||
（Z=389）加一枚 R35 压盖（Z 384..389，4xM3x8 BCD55），与后端板前后双向面压，
|
||
倾斜自由度归零。代价是对侧从动件 P06 的 J3 毂面整体后移 CLAMP_BACKOFF=5.5
|
||
（Z 388.5→383.0），见 p_humerus_bone。
|
||
P08 保持默认 —— J5 处 P07 的前端压盖已做（只需 6.0 的 hub_gap），而 J6 的 M6
|
||
前端压盖尚未做，故 roll_clamp 传 False。
|
||
"""
|
||
s = make_pitch_to_roll_bracket(j2, j3, Z_SH, Z_R3,
|
||
name="P05_大臂旋转座_螺旋体30%_墙4底5_竖打",
|
||
hub_gap=6.0, roll_clamp=True)
|
||
return s
|
||
|
||
|
||
JOINT = 'J2'
|
||
|
||
|
||
def specs(JS):
|
||
"""本件的 (件号, 中文名, 构建 thunk, 配色, 说明) 清单；顺序即 BOM 顺序。"""
|
||
j2 = JS["J2"]
|
||
j3 = JS["J3"]
|
||
return [
|
||
("P05_大臂旋转座_螺旋体30%_墙4底5_竖打", "大臂旋转座", lambda: p_shoulder_roll_base(j2, j3, None), 0x059669,
|
||
"V3圆角+ J2前端夹紧配合：Loft外轮廓R=10mm，后缘凸包两角90°竖棱磨R2圆角（结构/后缘高度不变，打印无悬挂）；【2026-10-07 侧壁放样斜棱圆角】侧壁与有机放样交汇处斜向硬折棱倒R3圆角，消除侧立面与正面放样弧面接缝硬棱，表面光影与触感圆润流线；【2026-10-07】L型内转角R1.5精细圆角（将圆角半径精调至1.5mm，完全杜绝算法异常与外凸台阶，平滑过渡并消除直角应力集中，与螺钉沉孔/运动间隙保持充裕余量）；【2026-10-07 电机座内凹槽与边缘突起消除】彻底消除承压面内侧 4.5mm 环形内凹槽（全腔单一 BAY_R 贯通无接缝），同时 cut_open 敞口高度上限延伸至承压面 (z_r + REAR_SEAT)，侧壁完全平直对齐下方壁面，彻底消除侧沿悬垂突耳；J2 从动法兰盘背面由 Y=157 后移至 Y=162（hub_gap=6.0，给 P04 新增的 M2 前端压盖让位，J2 直锁凸台同步加长到 Y=165.5，3xS01 输出螺钉咬合量不变）；保证 J2 全角度 0 干涉；【2026-10-05d 只切敞口那一圈围挡】用户指出 M3 电机前端(另一头)也有一圈围挡：Z389.0~395.5 的 r30.25~35 前端定位环(6mm 高环墙) + 骑在它上面的 R35 压盖外圈(Ø70 比电机 Ø63.6 凸 3.2mm)，把 M3 前端盖连同穿过 Ø37 孔的 P06 J3 凸台围在中间。第一版把整个前端(定位环+压盖+腔口下沿 389->395)都切了属过度(电机前端失去支撑面、M3 退回单面锁死)，已回退；现只切敞口(-Y)那一圈(盒切，Y 界限与 cut_open 一致)，-Y 半圈从 Z=395.5 一路开到压盖背面 Z=389，背脊(+Y)侧整圈保留作前端盖定位与压盖唯一且足够强的支撑面(4.75mm 宽 x 0.5mm 熔接带)；压盖本体/Ø37 孔/4xM3x8 沉孔/腔口下沿 389.0 全部不动，P05 只少 3.2cm3(154.8->151.6)，仍单实体。不整圈削到 R31.8 的原因：那圈壁与 Loft 在 X=±35 处与 Ø70 柱面相切，整圈切完会脱空出 1.32mm3 碎块破坏单实体；且压盖根部熔接面会从 2.37mm2 缩到 0.78mm2，4xM3x8 夹紧力会把压盖拉下来。开关 FENCE_OPEN_CUT（全机 5 处电机前端定位环敞口侧统一切除，无围挡阻碍装配）。【2026-10-03】M3 前端压盖(R35, Z384.0..389.0)：J3 roll 电机原来也只有后端板 4xM3x10 单面锁死(S02)，大扭矩下绕 J3 轴在 Ø60.3 座孔里点头；现按 P04/P06/P07 同一配方在 M3 前端盖外端面(Z=389)加 4xM3x8(BCD55)沉孔压盖，与后端板前后双向面压，倾斜自由度归零（配方唯一差别是 roll 电机轴向 -Z，压盖朝 -Z 长，见 motor_front_clamp axis=\"Z\"）；代价是对侧 P06 的 J3 毂面整体后移 5.5mm 让位；【2026-10-05 承压面让位腔改为 R35 圆腔、凸台与围挡一并消除】电机尾端垫片位(REAR_SEAT=2.6)用圆腔掏出承压面。**刀半径必须等于外壁 R35**（arm_build.SEAT_R）：取小于 R35（曾试 32.2 = 64.4 方腔内切圆）时，刀半径与外壁之间那圈 2.8mm 环墙完整保留，而承压面只挖到刀半径，于是该环墙相对承压面【凸起】并把电机尾端面围住 —— 这就是用户截图里的一圈围挡（P08 实测 1536.9mm3）。它不是残留，而是 SEAT_R<R35 的必然产物。现 SEAT_R=35.0、SEAT_TOP=+1.0（越过尾端面 1mm，吃掉半包开口处那截0.052cm3 残片）：承压面段整圈挖到外壁，承压面成为完整 R35 平圆盘，凸台与围挡一起消失，电机尾端面与承压面之间再无凸起。承力改由臂身本体承担（band 段 r36..58 有料方位 P04 10/36、其余各 15/36，其余方位靠 z>+1.0 杯体连接，无整圈通槽）。沉孔 z 区间(-8..-4)与圆腔(-2.6..+1.0)不重叠，S02 完好。连带：承压环由「方腔内切 32.2 − 沉孔外缘 30.25 = 1.95mm 窄环」变为「完整 R35 圆环 4.75mm」，受压面积 383->974mm²(2.5 倍)。【2026-10-04 承压面让位腔改为 32.2 圆腔】电机尾端垫片位(REAR_SEAT=2.6)之前用 64.4 **方**腔掏出来，方腔壁以外 z=-2.6..0 那圈料相对新承压面凸起 2.6mm，打印时是悬空薄壁（用户反馈：难打印、需支撑、公差差）。现承压面段改用**SEAT_R=32.2 圆腔**（= 64.4 方腔的内切圆半径，z=-2.6..0 与方腔平接）把整圈挖到承压面高度，凸台零残留；z=0 以上 PCBA 腔仍保持 64.4 方（PCB 是方的必须方腔）。**关键：刀半径必须取 32.2 而不是 R35** —— 中间试过 R35，结果把 r=32.2..35 的连接壁整圈切断：实测 P04 在 z=-2.6..+1.0 只剩 240~320° 方位有料，其余 360° 全掏空，后端法兰与杯壁之间出现 3.6mm 宽通槽 + 225° 一片 0.5mm 孤立薄片（用户截图：肩叉顶部「没连上」）。取 32.2 后 r=32.2..35 这圈 2.8mm 厚壁完整保留，360° 连续，既无凸台又与上方臂身连成一体（实测 5/5 件连接壁整圈连续、单实体）"),
|
||
]
|