| name | dwg-beam-import |
| description | 從 CAD/DWG 圖層批次建立 Revit 結構樑：掃描圖層 → 確認批次與模式 → 放樣健檢 → 批次建樑 → 詢問下一批次。支援全正交與含非正交（斜樑）圖說，分批處理（大樑 → 次樑 → 地樑）。
TRIGGER when: 結構樑翻模, dwg 建樑, cad 建樑, 圖層建樑, 批次建樑, beam from dwg, 從圖面建樑, 樑翻模, 大樑, 次樑, 地樑, create_beams_from_dwg
|
| user-invocable | true |
依據 domain/dwg-beam-import.md 執行。把 CAD 圖面的雙線樑批次轉成 Revit 結構樑。
鐵則：建樑不可自動復原，逐步走斷點、每步取得同意，不一口氣跑完。
Prerequisites（先確認，缺則停止並告知）
- Revit 開在平面視圖（三個工具都要求
ViewPlan）。
- 目標 CAD 已匯入或連結到該視圖。
- 專案已載入目標結構樑族群。
- 樑輪廓與文字標注畫在獨立圖層（靠圖層名識別）。
工作流（強制斷點）
步驟 1 — 掃描圖層 ⛔ 斷點
get_dwg_beam_layers → 回報視圖、CAD 數量、推薦樑圖層，並依序詢問：
- 這次先處理哪個批次？（大樑 / 次樑 / 地樑）
- 翻模模式：
- 模式 A（快速）：指定統一型別，全部套用，不需要文字圖層
- 模式 B（名稱對應）：依圖面文字自動配對 Revit 型別
步驟 2 — 依模式收集參數
- 模式 A：詢問族群名稱 + 統一型別名稱（如
50x70）→ 直接進步驟 3
- 模式 B：詢問文字圖層（X 向、Y 向可分開，也可共用）→ 詢問族群名稱 → 進步驟 3
步驟 3 — 放樣健檢（僅供參考，不等確認）
preview_dwg_beams(layerName) → 回報偵測樑數、X / Y / 斜向各幾根、樑寬範圍，直接繼續下一步。
步驟 4 — 批次建樑（改模型，不可復原）⛔ 執行前複述參數取得同意
create_beams_from_dwg(layerName, familyName, textLayerNameX?, textLayerNameY?, typeName?, beamRole?)
內部兩波機制（斜樑防呆）：
- 第一波：正交樑優先配對，消耗標籤進
usedLabelKeys
- 第二波：斜樑用剩餘標籤，點到線段距離配對（閾值 = 樑寬/2 + 500mm）
回傳檢查：
| 現象 | 處理 |
|---|
unmatchedLabels 不為空 | 停下協作：族群缺對應型別？ |
failed > 0 且 unmatchedLabels 為空 | 樑端點問題（太短/無支撐），手動補 |
labelReadStatus = no_oda | 安裝 ODA File Converter 或改用 DXF |
步驟 5 — 詢問下一批次
完成後詢問：是否繼續處理下一批次？（大樑 → 次樑 → 地樑）
Error Handling
| 症狀 | 處理 |
|---|
| 「請在平面視圖中執行」 | 切換至平面視圖 |
| 圖層清單為空 | 確認 CAD 已匯入/連結且可見 |
| preview 數量為 0 | 換圖層或確認樑為雙線且寬度在 100–2500mm |
| 「找不到族群」 | 先載入結構樑族群 |
Related
- domain：
domain/dwg-beam-import.md
- 互補 skill：
dwg-column-import（柱翻模）
- 核心實作：
MCP/Core/DwgBeamExecutor.cs
