docs: 沉淀机柜装配布线关系

docs/FreeCAD 3D自动布线设计方案.md

@@ -448,19 +448,40 @@ end_terminal_display
 
 注意：批量生成布线连接的依据是导线任务，不是“所有端子自动互连”。如果文档中只有端子而没有 `wires[]` 或 `QETWiring_01_Tasks`，系统不能判断哪些端子应该连接。
 
+### 6.3 现场机柜资料对自动布线的约定
+
+根据本地测试机柜、甲方布线操作视频和安装板/导轨/设备位置关系视频，第一版自动布线需要按真实机柜装配习惯理解对象：
+
+1. 柜体和框架主要提供结构边界，默认作为障碍或场景参考，不作为导线可走路径。
+2. 安装板是柜体结构的一部分，通常通过螺丝孔、加强梁或连接件固定在柜体内，不能理解为悬空对象。
+3. 安装板、背板、门板等薄板可作为低优先级 `RoutingRange` 支撑面；它们用于没有线槽或线槽不完整时的贴面过渡，不应优先于线槽。
+4. DIN 导轨固定在安装板或梁上，是设备安装基准，不是导线主路径。导轨自身不应被自动识别成线槽。
+5. 设备不能悬空，应装在导轨或安装板上。自动布线只消费设备最终 3D 位姿、工程端子位置和端子出线方向。
+6. 线槽是导线主路径。导线应优先从设备端子经 `TerminalAccess` 进入线槽，再沿 `WireDuct` 网络到达另一端。
+7. 过线孔/穿线孔用于连接不同安装面、线槽或柜体开孔处的网络，应建模为 `WiringCutOut`，不是普通障碍。
+
+因此，自动布线的推荐空间语义是：
+
+```text
+工程端子 -> TerminalAccess -> WireDuct / WiringCutOut / RoutingRange -> TerminalAccess -> 工程端子
+```
+
+安装板和导轨的机械配合关系会影响对象最终位置，但当前路由器不从装配约束求解位置；它只读取 FreeCAD 文档中已经确定的几何位姿。后续如果增加装配语义，应保存在 FreeCAD 文档中，不扩展第一版数据库绑定表。
+
 ## 7. 当前限制
 
 当前版本可完成布线连接原型，但仍有以下限制：
 
 1. 线槽实体中心线生成基于包围盒长轴，不理解真实线槽开口、盖板和内部空间。
-2. 多根线会沿同一路径生成，暂未做并行错位排列。
+2. 多根线共路时已做基础错位显示，但不是线束级排布，也不计算每根线在线槽内的真实截面位置。
-3. 未计算线槽填充率和容量。
+3. 已支持简单路径容量属性和超容量避让，但未按线径、截面积、填充率计算真实线槽容量。
 4. 未考虑线径、最小弯曲半径。
 5. 未做强弱电分槽、线缆类型隔离。
 6. 障碍检测基于 AABB，存在误报和漏报。
 7. 辅助路由区域是网格近似，不等于专业软件的完整布线区域建模。
 8. 端子出线方向依赖端子 LCS 方向；如果模板端子方向不准，布线连接会受影响。
 9. 导线几何当前保存在 FreeCAD 文档，不作为第一版数据库字段回写。
+10. 当前不自动求解导轨、安装板和设备之间的 Assembly 配合关系；装配位置以 `scene.FCStd` 中对象的最终 `Placement` 为准。
 
 ## 8. 后续需要完成
 

docs/FreeCAD 机柜装配操作文档.md

@@ -364,6 +364,34 @@ Z = 1200 mm
 
 不要选择 `Gears`。导轨不是运动部件。
 
+### 7.4 现场机柜中的配合关系
+
+从现场沟通和安装板/导轨/设备位置关系视频看，柜内对象不是“飘在空间里”的独立几何，而是通过机械配合关系装到柜体内：
+
+| 对象 | 常见宿主 | 典型配合关系 | 对布线的意义 |
+| --- | --- | --- | --- |
+| 安装板 | 柜体框架、背板梁、连接件 | 平面贴合、平行、距离、螺丝孔对齐 | 可作为低优先级布线支撑面 `RoutingRange` |
+| DIN 导轨 | 安装板、梁 | 背面贴合、平行、距离、孔位固定 | 作为设备安装基准，不作为导线主路径 |
+| 线槽 | 安装板、柜内侧边、梁 | 底面贴合、平行、距离、螺丝孔固定 | 作为导线主路径 `WireDuct` |
+| 设备 | DIN 导轨或安装板 | 卡扣贴合、面贴合、孔位固定、固定间距排列 | 提供工程端子位置和出线方向 |
+| 过线孔/穿线孔 | 安装板、柜体隔板 | 与开孔同轴或共面 | 作为跨区域路径 `WiringCutOut` |
+
+当前 FreeCADExchange 的能力边界：
+
+1. FreeCAD 原生 `Assembly` 工作台可以做平面对齐、距离、同轴/共线等配合关系。
+2. FreeCADExchange 目前主要保存对象最终 `Placement`，并提供轻量的 `贴合到选中面` 辅助。
+3. `贴合到选中面` 是一次性位姿调整，不是持久 Assembly 约束求解器。
+4. 当前不会自动保存“设备装在哪根导轨上”“导轨固定在哪块安装板上”这类完整宿主关系。
+5. 自动布线读取 `scene.FCStd` 里的最终几何位置，不从装配约束反推位置。
+
+推荐建模习惯：
+
+1. 先把柜体或安装板固定好。
+2. 导轨、线槽都贴合到安装板或柜体内部结构上。
+3. 设备必须装到导轨或安装板上，避免悬空。
+4. 装配调整后重新生成布线路径网络，让 `WireDuct`、`RoutingRange` 和 `TerminalAccess` 跟随最新位置刷新。
+5. 如果后续要做自动装配，应优先在 FreeCAD 文档内增加宿主语义，例如 `Cabinet`、`MountingPlate`、`DINRail`、`WireDuct`、`Device`，不要扩展第一版数据库绑定表。
+
 ---
 
 ## 8. 放置线槽