# Reality Node · 磁吸软桥领夹 v0.4

2026-10-29。Huang 确认按「硬壳＋可替换 TPU 软桥＋磁铁」出一版。旧版保留，本文及本目录是该修订的主记录。**结构概念，不可直接送印装机。**

## 实际改动

- 取消轴耳、金属轴、扭簧、硬桥罩。保留衣外 XIAO＋原装相机、衣内 503450 / 1000mAh 电池和独立上置的 40×20mm 天线区。
- 前舱主体 28×34×20mm，后舱 44×82×10mm。全部外露高度以 `checks.json` 中 `front_including_bridge_height` 为准，包含软桥最高点，不能只报主体高度。
- 上述前舱主体尺寸是基础壳型，不包含朝衣料凸出的磁铁座及盖垫；完整前舱包络另见 `front_with_pads`，不以主体厚度替代整机厚度。
- 当前生成值：前舱含接口座、磁铁座和盖垫的包络为 28×35.3×21.6mm；含软桥最高点的外露总高约 43.73mm。页面和交付使用这些完整尺寸。后舱不含软桥的壳体与盖垫完整包络见检查报告。
- TPU 软桥宽 20mm、径向厚 3.2mm 是建模初值。两端 T 形肩进入硬壳接收槽；留装配间隙和三个贯通通道。T 槽不等于已验证防拔脱；桥须在拆壳、断开/抽出线束后更换，不是可热插拔模块。
- 两对磁铁隔衣相吸；四颗圆片先按 Ø5×1.5mm 做空间占位，不指定牌号、不承诺吸力。磁铁在独立硬壳槽内，面向衣料用 TPU 盖垫覆盖。磁极须实配确认，防脱锁固及误吞风险仍需处理。
- 磁铁/夹衣载荷由硬壳承受，不压电池。电池预留 36×52×6mm 包络不应被壳体或磁铁座侵占。用等重假件测试，不用软包电池做夹持或跌落试验。
- 电源红黑双线按绝缘外径 0.6mm，同轴线按 0.7mm 建模。每条线独立跨桥孔，固定段到柔性段完整展示；端点只标接线区域，不是焊接图。

## 预览与检查的边界

开口滑块代表后舱增加的平移量 0/2/4/6/8mm，不再伪装成铰链旋转。每档拟合相同桥中线长度，软桥与三条线一起变形；这是几何示意，不是 TPU 力学、线束寿命、真实开口适配或夹紧力验收。闭合软垫之间名义净空 0.8mm。

生成器保存逐对检查、对应开口和体积容差，校验所有打印件为有效单实体。检查包含壳体/原装硬件、电池保留区、天线、磁铁槽、软垫以及五档的软桥/壳体/跨桥线。通过数字只覆盖列出的几何对象和状态，不可沿用旧版报告或外推全行程、RF、疲劳、安全性。

桥内采用无折返的三次 Bézier 中线；开合各档以 CAD 曲线实际弧长拟合。壳内固定线段以圆柱/球组成的复合体表示，弯角不是已完成的实体线束弯曲方案。CAD 计算在本进程内限制为两个 OCCT 线程，不修改系统或其它进程。

尚未完成：线束端部独立应力释放、盖板锁固和板托、TPU 硬度/层向/最小弯曲半径及反复开合、磁铁实际夹力/封闭防脱、衣料滑移与试戴、天线佩戴后的 Wi-Fi/蓝牙、开关和声光通道、实物焊点及电池成品测量。不要佩戴或充电未经验证的样机。

## 重建

```sh
uv run --offline --with 'cadquery>=2.5,<2.7' python generate.py
```

依赖未缓存时去掉 `--offline`。项目内使用 `../references/xiao-sense-model/Seeed Studio XIAO-ESP32-S3-Sense.step` 的全部实体，不拆相机排线、不缩放硬件；源码包自带同一参考 STEP 及 Three.js。`output/` 中提供整机/零件 STEP、STL、前端资源、路线和检查报告；`CONCEPT` 文件名不代表允许送印。

需求来源：本线程 2026-10-29 20:20 的方案确认。既有尺寸/官方模型沿用 `../collar-clip-v0.3/README.md`，未做任何实物测量或无线测试。