# -*- 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 件连接壁整圈连续、单实体）"),
    ]