feat: 记录布线路径载体容量

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

@@ -366,7 +366,7 @@ QetWiringCutOutBridgeExtensionMm = 20.0
 
 自动生成的 carrier 会随源对象生命周期刷新：源对象仍有效时更新几何；安装板尺寸变化时同步增删 `RoutingRange` 网格线；源对象被删除或不再满足线槽/支撑面规则时，下一次生成布线路径网络会删除对应自动 carrier，并撤销该源对象的穿越/支撑面障碍模式。用户手工创建、没有源对象元数据的 carrier 不会被这一步自动删除。
 
-生成导线的 `QetRouteTrackJson` 会记录实际经过的 carrier。carrier 如果来自线槽、过线孔、支撑面或端子接入源对象，route track 中还会保留 `source_name`、`source_label`、`source_kind`，用于手动测试时追踪“这段线实际走过哪个 3D 源对象”。
+生成导线的 `QetRouteTrackJson` 会记录实际经过的 carrier。carrier 如果来自线槽、过线孔、支撑面或端子接入源对象，route track 中还会保留 `source_name`、`source_label`、`source_kind`，用于手动测试时追踪“这段线实际走过哪个 3D 源对象”。route track 同时记录 carrier 的 `capacity`，用于后续核对多根线共路、容量偏好和绕行行为。
 
 批量生成布线连接后，面板/控制台报告会从第一条可追踪路径中提取一条“路径示例”，显示导线经过的源对象标签，便于快速确认线路是否进入了预期线槽、过线孔和支撑面。
 
@@ -456,6 +456,7 @@ tests/python/freecad_exchange_auto_routing_test.py
 32. 布线路径网络检查会在端子未接入诊断中记录当前端子接入最大距离和端子出线长度，并在中文报告里显示最大接入距离。
 33. 批量布线报告会显示路径网络自动桥接段数和主动避障屏蔽段数，方便核对调参和避障是否实际参与求路。
 34. 批量布线报告会显示最大 lane 编号和 lane 间距，方便确认多根线共路时是否发生了可视错位。
+35. `QetRouteTrackJson` 的 carrier payload 会记录 `capacity`，方便后续分析线槽容量偏好和共路绕行。
 
 已完成 FreeCAD smoke：
 

src/Mod/FreeCADExchange/RoutingNetwork.py

@@ -2678,6 +2678,7 @@ def _carrier_track_payload(carrier):
         "name": getattr(carrier, "Name", ""),
         "label": getattr(carrier, "Label", ""),
         "kind": (getattr(carrier, "QetRouteCarrierKind", "") or "").strip() or ROUTE_CARRIER_KIND,
+        "capacity": _route_carrier_capacity_value(carrier, default=1),
     }
     source_fields = (
         ("source_name", "QetRouteSourceName"),

tests/python/freecad_exchange_auto_routing_test.py

@@ -309,6 +309,27 @@ class AutoRoutingTest(unittest.TestCase):
         self.assertEqual("线槽A", wire_duct_carriers[0].get("source_label"))
         self.assertEqual("WireDuct", wire_duct_carriers[0].get("source_kind"))
 
+    def test_route_track_records_carrier_capacity(self):
+        _install_fake_freecad()
+        terminal_objects, _wiring_objects, routing_network, auto_routing = _reload_modules()
+        app = sys.modules["FreeCAD"]
+        doc = FakeDocument()
+        terminal_objects.ensure_root_group(doc, "project-1")
+        start = _terminal(doc, terminal_objects, "TerminalStart", "terminal-start", app.Vector(0, 0, 0))
+        end = _terminal(doc, terminal_objects, "TerminalEnd", "terminal-end", app.Vector(100, 0, 0))
+        routing_network.create_route_carrier(
+            doc,
+            [app.Vector(0, 0, 20), app.Vector(100, 0, 20)],
+            project_uuid="project-1",
+            kind="WireDuct",
+            capacity=3,
+        )
+
+        result = auto_routing.route_eplan_connection_between_terminals(doc, start, end)
+        route_track = json.loads(result["wire"].QetRouteTrackJson)
+
+        self.assertEqual(3, route_track["segments"][0]["carrier"]["capacity"])
+
     def test_network_eplan_connection_route_offsets_lane_by_route_index(self):
         _install_fake_freecad()
         terminal_objects, _wiring_objects, routing_network, auto_routing = _reload_modules()