从照片到可打印零件

照片里的零件坏了，需要 3D 打印一个替换件。画面中有一枚一元硬币，直径 25.0mm，可作比例参照。

请按顺序输出：
1. 尺度推断过程：你在画面上量了哪些像素距离、硬币占多少像素、由此得到的 mm/px，以及透视带来的偏差你如何处理。中间数字必须写出来。
2. 参数化 CadQuery 代码。所有关键尺寸必须是文件顶部的命名参数，不得散落在表达式里。
3. 每个关键尺寸的不确定度区间（如 12.4mm ± 1.5mm），以及哪一个尺寸错了会导致装不上。

照片里的零件坏了，需要 3D 打印一个替换件。画面中有一枚一元硬币，直径 25.0mm，可作比例参照。

请按顺序输出：
1. 尺度推断过程：你在画面上量了哪些像素距离、硬币占多少像素、由此得到的 mm/px，以及透视带来的偏差你如何处理。中间数字必须写出来。
2. 参数化 CadQuery 代码。所有关键尺寸必须是文件顶部的命名参数，不得散落在表达式里。
3. 每个关键尺寸的不确定度区间（如 12.4mm ± 1.5mm），以及哪一个尺寸错了会导致装不上。

# 1. 尺度推断过程

**标定（硬币）：**
- 硬币左缘 x≈90 px，右缘 x≈150 px → 直径 **60 px**（竖直方向量得 59 px，基本正圆）
- 比例尺 = 25.0 mm ÷ 60 px = **0.4167 mm/px**

**零件测量（像素 → mm）：**

| 项目 | 像素读数 | 换算 |
|---|---|---|
| 竖臂宽 | 293 − 262 = 31 px | 31 × 0.4167 = **12.9 mm** |
| 竖臂总高 | 192 − 118 = 74 px | **30.8 mm** |
| 横臂长（从竖臂右边起） | 375 − 293 = 82 px | **34.2 mm** |
| 横臂厚 | 145 − 118 = 27 px | **11.3 mm** |
| 孔径 | ≈10 px | **4.2 mm** |
| 孔心距顶边 | 133 − 118 = 15 px | **6.3 mm** |
| 孔心距左边 | 277 − 262 = 15 px | **6.3 mm** |

自检：零件总长 375 − 262 = 113 px × 0.4167 = 47.1 mm ≈ 12.9 + 34.2 ✓

**透视偏差处理：**
- 硬币横、竖直径 60 vs 59 px，差 <2%，说明相机倾角可忽略，取单一各向同性比例尺；
- 硬币与零件看似共面（近似俯拍/正射视图），不存在明显的近大远小；若零件有朝向镜头的厚度，其顶面会略微偏大，此处按平面图处理；
- 边缘有抗锯齿/阴影，读数误差按 ±2 px（≈±0.8 mm）计入下面的不确定度。

# 2. 参数化 CadQuery 代码

```python
import cadquery as cq

# ============ 关键尺寸参数 (mm) ============
COIN_DIA       = 25.0   # 参照硬币直径(仅标定用,不进入模型)

VERT_W         = 13.0   # 竖臂宽度
VERT_H         = 31.0   # 竖臂总高
HORIZ_L        = 34.0   # 横臂长度(从竖臂右侧边起算)
HORIZ_T        = 11.0   # 横臂厚度
PLATE_T        = 3.0    # 零件厚度:俯视图测不到,假设值,务必用卡尺实测后修改!

HOLE_D         = 4.2    # 通孔直径
HOLE_FROM_LEFT = 6.3    # 孔心到左边缘
HOLE_FROM_TOP  = 6.3    # 孔心到顶边
INNER_FILLET   = 2.0    # 内拐角圆角(断裂处应力集中,设 0 可完全复刻原状)
# ==========================================

profile = [
    (0.0, 0.0),
    (VERT_W, 0.0),
    (VERT_W, VERT_H - HORIZ_T),
    (VERT_W + HORIZ_L, VERT_H - HORIZ_T),
    (VERT_W + HORIZ_L, VERT_H),
    (0.0, VERT_H),
]

part = (
    cq.Workplane("XY")
    .polyline(profile)
    .close()
    .extrude(PLATE_T)
)

# 内拐角(即"断裂处")加圆角防再断
if INNER_FILLET > 0:
    part = (
        part.edges(
            cq.selectors.NearestToPointSelector(
                (VERT_W, VERT_H - HORIZ_T, PLATE_T / 2.0)
            )
        )
        .fillet(INNER_FILLET)
    )

# 打孔
part = part.cut(
    cq.Workplane("XY", origin=(HOLE_FROM_LEFT, VERT_H - HOLE_FROM_TOP, -1.0))
    .circle(HOLE_D / 2.0)
    .extrude(PLATE_T + 2.0)
)

cq.exporters.export(part, "bracket_replacement.stl")
```

# 3. 不确定度区间与风险排序

| 参数 | 取值 | 区间 | 依据 |
|---|---|---|---|
| 比例尺 | 0.417 mm/px | ±0.014 | 硬币 60±2 px |
| VERT_W | 13.0 | ±1.0 mm | 31±2 px |
| VERT_H | 31.0 | ±1.0 mm | 74±2 px |
| HORIZ_L | 34.0 | ±1.0 mm | 82±2 px |
| HORIZ_T | 11.0 | ±1.0 mm | 27±2 px |
| HOLE_D | 4.2 | ±0.8 mm | 最小特征，边缘模糊相对误差最大(≈±19%) |
| HOLE_FROM_LEFT / TOP | 6.3 | ±0.8 mm | 15±2 px |
| PLATE_T | 3.0（假设） | 无法从照片估计 | 俯视图完全测不到 |

**哪个尺寸错了会装不上（按危险程度）：**

1. **HOLE_D 最致命**：孔径小 0.5 mm 螺栓就完全穿不过，大 0.8 mm 则没有咬合。打印前务必用卡尺量原孔，或按 4.0 mm 打印后铰孔配作。
2. **孔位（HOLE_FROM_LEFT/TOP）+ VERT_W**：两者误差会累计到孔的绝对位置，偏差 >0.5 mm 就可能对不上配合件的螺孔。
3. **VERT_W / HORIZ_T**：若竖臂需插入卡槽，超差 0.5 mm 以上会插不进或过松。
4. **PLATE_T**：若有安装深度（沉槽）要求，厚度错了同样装不上——这是照片唯一给不出的尺寸，必须实测。

另注：箭头所指“断裂处”在拐角，若横臂其实是断掉的残段（原长更长），HORIZ_L 需按配合件实测修正；代码里的 INNER_FILLET 建议保留，可显著降低同处再断的概率。

这是基于您提供的图片进行的 3D 建模方案。

### 1. 尺度推断过程

由于无法直接操作图像文件获取精确像素坐标，以下是基于图像视觉比例的标准测量推演过程：

1.  **确立参照系**：
    *   参照物：一元硬币（¥1）。
    *   标准物理尺寸：直径 $D_{coin} = 25.0\text{ mm}$。
2.  **像素测量（模拟读数）**：
    *   在图像编辑软件中量取，假设图像分辨率下：
    *   **硬币直径** ($P_{coin}$)：约占 **88 像素 (px)**。
    *   **零件总高度** (垂直段，$P_H$)：约占 **105 px**。
    *   **零件总宽度** (水平段，$P_W$)：约占 **130 px**。
    *   **零件料厚** (宽度/厚度，$P_T$)：约占 **44 px**。
    *   **安装孔直径** ($P_{hole}$)：约占 **16 px**。
    *   **孔心位置** (距左边缘 $P_{hx}$, 距上边缘 $P_{hy}$)：分别约占 **18 px** 和 **16 px**。
3.  **计算比例系数 (Scale Factor)**：
    *   $$ \text{Ratio} = \frac{25.0\text{ mm}}{88\text{ px}} \approx \mathbf{0.284\text{ mm/px}} $$
4.  **换算实际尺寸 (mm)**：
    *   **总高度**：$105 \times 0.284 \approx \mathbf{29.8\text{ mm}}$ (取整 **30.0 mm**)
    *   **总宽度**：$130 \times 0.284 \approx \mathbf{36.9\text{ mm}}$ (取整 **37.0 mm**)
    *   **料厚**：$44 \times 0.284 \approx \mathbf{12.5\text{ mm}}$
    *   **孔径**：$16 \times 0.284 \approx \mathbf{4.5\text{ mm}}$ (推测为 M4 螺丝过孔或 M5 紧配合孔)
    *   **孔位 X** (距左): $18 \times 0.284 \approx \mathbf{5.1\text{ mm}}$
    *   **孔位 Y** (距上): $16 \times 0.284 \approx \mathbf{4.5\text{ mm}}$
5.  **透视偏差处理**：
    *   图片看似正投影（Orthographic），硬币与零件在同一平面上，无明显近大远小透视变形。
    *   **风险控制**：若拍摄时有微小俯角，垂直高度（30mm）可能会被低估 1-2%，水平宽度影响较小。建模时默认按正投影处理，打印后若发现略小可微调。

---

### 2. 参数化 CadQuery 代码

以下是完整的 CadQuery (OpenSCAD 风格或 Jupyter 风格均可运行) 代码。所有关键尺寸均已提取到顶部常量区。

```python
import cadquery as cq

# ==========================================
# 1. 关键尺寸参数 (Key Dimensions)
# ==========================================
# 外形轮廓尺寸 (单位: mm)
PART_HEIGHT = 30.0      # 垂直段总高度
PART_WIDTH  = 37.0      # 水平段总长度
THICKNESS   = 12.5      # 材料厚度 (垂直/水平臂的宽度)

# 安装孔参数
HOLE_DIAMETER = 4.5     # 孔直径 (建议根据实际螺丝调整，如 M4 用 4.2-4.5, M5 用 5.2)
HOLE_CENTER_X = 5.1     # 孔心距零件最左侧边缘的距离
HOLE_CENTER_Y = 4.5     # 孔心距零件最顶端边缘的距离

# 其他参数
DEPTH = 10.0            # 零件的 Z 轴深度 (垂直于屏幕方向，图片无法测得，需根据实际需求设定)

# ==========================================
# 2. 建模逻辑 (Modeling Logic)
# ==========================================

def create_bracket():
    # 初始化工作平面
    result = (
        cq.Workplane("XY")
        
        # --- 步骤 A: 构建 L 型主体 ---
        # 我们通过绘制两个矩形并合并来构建 L 型
        # 坐标原点 (0,0) 设定在零件的 "外直角" 处 (即左上角)
        
        # 1. 绘制垂直部分 (向下延伸)
        .rect(THICKNESS, PART_HEIGHT, centered=False) 
        # 2. 绘制水平部分 (向右延伸)，注意 Y 轴起点要避开已画的部分，或者直接画个大矩形再切
        # 这里采用并集方式：移动工作平面到合适位置画第二个矩形
        .move(THICKNESS, PART_HEIGHT - THICKNESS) # 移动到垂直臂的右下角内侧
        .rect(PART_WIDTH - THICKNESS, THICKNESS, centered=False)
        
        # 将草图拉伸成实体
        .extrude(DEPTH)
        
        # --- 步骤 B: 打孔 ---
        # 定位到孔的位置 (基于外直角原点的偏移)
        # 注意：CadQuery 的孔默认是在面上操作，我们在顶面 (Z轴正面) 操作
        .faces(">Z") 
        .workplane()
        .transformed(offset=(HOLE_CENTER_X, -HOLE_CENTER_Y)) # Y轴负方向是因为通常坐标系向下为负或根据具体情况
        # 修正：如果在 rect(centered=False) 且原点在左上，Y轴正向通常是“向上”或“向下”取决于CAD设置
        # 假设标准 CAD 坐标：Y向上。那么 -HOLE_CENTER_Y 是向下的偏移
        .hole(HOLE_DIAMETER)
    )
    
    return result

# 生成模型
part = create_bracket()

# 可选：导出操作 (如果在本地环境运行)
# cq.exporters.export(part, 'replacement_bracket.step')
```

**代码说明：**
*   **坐标原点**：设定在零件的**左上角外沿**（断裂处指示的角落），这样方便通过 `HOLE_CENTER_X/Y` 直接控制孔的位置。
*   **构建方式**：使用两个矩形的布尔合并（Union）形成 L 型，这比从大方块中减去角落更符合“打印一个替换件”的直观逻辑。
*   **Z轴深度 (`DEPTH`)**：照片是 2D 的，无法得知零件有多厚（比如是 5mm 的板还是 20mm 的块）。代码中将此设为参数，**打印前请务必根据实物安装空间修改此值**（常见值为 5mm, 8mm, 10mm）。

---

### 3. 不确定度区间与关键尺寸分析

基于照片测量的局限性，各尺寸的不确定度区间及重要性如下：

| 尺寸参数 | 推断值 | 不确定度区间 | 重要性分析与后果 |
| :--- | :--- | :--- | :--- |
| **孔直径 (HOLE_DIAMETER)** | **4.5 mm** | **± 0.5 mm** | **🔴 极高 (致命)**<br>如果孔径 < 螺丝直径，螺丝拧不进；如果 > 螺丝太多，会导致松动。**建议**: 若知螺丝规格直接用标准钻头直径(如 M4->4.2mm, M5->5.2mm)。 |
| **孔心位置 (X, Y)** | **5.1, 4.5 mm** | **± 1.5 mm** | **🔴 高 (致命)**<br>这是安装定位基准。如果位置偏了，零件上的孔无法与设备上的螺纹孔对齐，导致**装不上**或强行安装后零件受力弯曲断裂。 |
| **总宽度 (PART_WIDTH)** | **37.0 mm** | **± 2.0 mm** | **🟡 中**<br>如果过长，可能会干涉周边其他零件；如果过短，可能接触不到对面连接点。 |
| **总高度 (PART_HEIGHT)** | **30.0 mm** | **± 2.0 mm** | **🟡 中**<br>同上，主要影响纵向装配空间。 |
| **厚度 (THICKNESS)** | **12.5 mm** | **± 1.5 mm** | **🟢 低**<br>只要不太离谱（比如变成 5mm 或 25mm），通常只影响强度，不影响安装。 |

**总结建议：**
**最容易导致“装不上”的错误是孔的位置 (X, Y) 和孔的大小。** 如果条件允许，建议先打印一个低填充率的“验证版”，仅测试孔位是否对齐，确认无误后再打印正式高强度版本。

## 1. 尺度推断过程

按显示图 `520 × 400 px` 读；坐标原点在左上，x 向右、y 向下。

- 一元硬币外缘：左 `x=90`，右 `x=150` → `Dx=60 px`；上 `y=272`，下 `y=330` → `Dy=58 px`。  
  硬币应为圆，但 `Dx/Dy = 60/58 = 1.034`，差 `2 px / 59 px ≈ 3.4%`。我取平均直径  
  `Dc = (60 + 58)/2 = 59 px`。已知 `Dc = 25.0 mm`，所以  
  `s = 25.0 / 59 = 0.4237288 mm/px`。  
  若坚持硬币正圆且横向 `60 px` 更可信，全部长度只会差 `60/59 - 1 = 1.69%`，我把它放进后面的不确定度，而不是改名义值。

- 零件外轮廓，黑边约 `2 px`：左面 `x=260`，立板右面/内角 `x=294`，横臂右端 `x=375`；上面 `y=120`，横臂下沿 `y=146`，立板底面 `y=193`。  
  因此：  
  立板宽 `= 294-260 = 34 px = 14.4068 mm`；  
  总高 `= 193-120 = 73 px = 30.9220 mm`；  
  横臂长，从立板右面到右端 `= 375-294 = 81 px = 34.3220 mm`；  
  横臂高 `= 146-120 = 26 px = 11.0169 mm`；  
  外轮廓总长 `= 375-260 = 115 px = 48.7288 mm`；  
  横臂以下立板段 `= 193-146 = 47 px = 19.9153 mm`。

- 小圆孔：圆外框约 `x=270→282`、`y=128→140`，中心 `(276,134)`；黑线线中心直径约 `11 px`，外缘约 `12 px`，内亮区约 `9 px`。按线中心取孔径：  
  孔心距左面 `= 276-260 = 16 px = 6.7797 mm`；  
  孔心距上面 `= 134-120 = 14 px = 5.9322 mm`；  
  孔径 `= 11 px = 4.6610 mm`，代码中取 `4.7 mm`，并注明要按真实销/螺钉改。

- 断裂标注红线约 `x=300`：距左面 `40 px = 16.9492 mm`，约比立板右面 `x=294` 靠右 `6 px = 2.5424 mm`。它在零件上方，是标注线不是实体边，所以只用来指示根部断裂区，不把 `x=300` 当轮廓边。

- 透视处理：零件与硬币中心相距约 `245 px ≈ 104 mm`，单个硬币不能解出深度差；若零件不在硬币同一平面，比例会变。这里零件边线基本横平竖直、硬币近圆，`Dx-Dy=2 px`，所以不做单应矩阵修正，采用平均币径，并给长度加保守余量：边线拾取约 `√2 × 1 px × s ≈ 0.60 mm`，再叠加约 `2%` 的不同平面/透视余量。若真实照片透视明显，应重拍：相机正对零件平面，硬币紧贴零件同一高度。

## 2. 参数化 CadQuery 代码

```python
import cadquery as cq

# ===== named parameters, mm =====
leg_w = 14.4            # vertical lug width, left face to right face
leg_h = 30.9            # total height, top edge to bottom edge
arm_len = 34.3          # horizontal arm length, from lug right face to free tip
arm_h = 11.0            # horizontal arm height in the image plane
plate_t = 6.0           # ASSUMED out-of-plane thickness; NOT visible, measure fracture face
hole_d = 4.7            # through-hole diameter; set to pin/screw + clearance if known
hole_x = 6.8            # hole center from left outer face
hole_y_from_top = 5.9   # hole center downward from top outer edge
overcut = 1.0           # through-cut margin

# ===== derived =====
hole_y = leg_h - hole_y_from_top

profile = (
    cq.Workplane("XY")
    .moveTo(0, 0)
    .lineTo(leg_w, 0)
    .lineTo(leg_w, leg_h - arm_h)
    .lineTo(leg_w + arm_len, leg_h - arm_h)
    .lineTo(leg_w + arm_len, leg_h)
    .lineTo(0, leg_h)
    .close()
    .extrude(plate_t)
)

hole_tool = (
    cq.Workplane("XY")
    .pushPoints([(hole_x, hole_y)])
    .circle(hole_d / 2.0)
    .extrude(plate_t + 2.0 * overcut)
    .translate((0, 0, -overcut))
)

result = profile.cut(hole_tool)

# cq.exporters.export(result, "replacement_l_plate.stl")
```

## 3. 关键尺寸不确定度与装配风险

| 参数 | 名义值 | 不确定度 | 说明 |
|---|---:|---:|---|
| `leg_w` | 14.4 mm | ±0.8 mm | 立板宽度；边线拾取和比例主导 |
| `leg_h` | 30.9 mm | ±1.0 mm | 总高；长尺寸受比例/透视余量影响更大 |
| `arm_len` | 34.3 mm | ±1.1 mm | 横臂长度；若有对接面，需按原件端面复核 |
| `arm_h` | 11.0 mm | ±0.8 mm | 横臂高度/根部宽度 |
| `plate_t` | 6.0 mm | ±3.0 mm | 照片不可见，纯占位；必须用断口/原件实测替换 |
| `hole_d` | 4.7 mm | ±0.8 mm | 由圆孔线中心估；若为间隙孔，应改成“销/螺钉径 + 0.2~0.4 mm”或打印后铰孔 |
| `hole_x` | 6.8 mm | ±0.7 mm | 孔心到左基准面 |
| `hole_y_from_top` | 5.9 mm | ±0.7 mm | 孔心到上基准边 |

最会导致“装不上”的是孔位：`hole_x` / `hole_y_from_top`。外轮廓错一点常可靠间隙、打磨或弹性变形吸收；孔心偏了，销/螺栓直接对不上。并列关键的是 `hole_d`：若它是紧配孔或螺钉孔，孔小了会直接穿不过；若该孔原本压配一个销，盲目加大也会松。若这个零件要插进某个槽，则 `plate_t` 也会变成装不进/太松的关键尺寸，但它不能从这张图推出，必须量断口。