| name | dwg-column-import |
| description | 從 CAD/DWG 圖層批次建立 Revit 結構柱/建築柱：單位/放樣健檢 → 選模式 → 批次建模。三模式（自動建型別 / 既有族群尺寸對應 / 既有族群柱號對應）依情境選用，分步協作不一口氣。
TRIGGER when: dwg 建柱, cad 建柱, 圖層建柱, 批次建柱, dwg 匯入建模, cad 柱, column from dwg, 從圖面建柱, 柱號對應, 柱名稱對應, C1 C2 柱
|
| user-invocable | true |
依據 domain/dwg-column-import.md 執行。把 CAD 圖面的矩形柱輪廓批次轉成 Revit 柱。
鐵則：建柱不可自動復原，逐步走斷點、每步取得同意，不要一口氣跑完。
Prerequisites（先確認，缺則停止並告知）
- Revit 開在平面視圖（三個工具都要求
ViewPlan）。
- 目標 CAD 已**匯入(import)或連結(link)**到該視圖（模式 C 須 link）。
- （模式 B/C）專案已載入目標矩形柱族。
- 柱輪廓畫在獨立圖層（靠圖層名識別，非顏色/線型）。
模式路由（依使用者語意選一，這是斷點 2 的核心）
| 關鍵字訊號 | 模式 | 帶入參數 |
|---|
| 「柱號 / 對應名稱 / C1 C2 / 沿用圖面命名」 | C 既有族群·柱號對應 | familyName + textLayerName |
| 指定族群但只談尺寸沿用 | B 既有族群·尺寸對應 | familyName |
| 「快速建柱 / 不在意命名」 | A 自動建型別 | 都不給 |
不確定就列出族群問使用者，不要替他預設。
工作流（強制斷點）
步驟 1 — 掃描圖層
get_dwg_column_layers → 回報 CAD 圖層清單、建議柱圖層、Link/Import 狀態。請使用者確認用哪個圖層。
步驟 2 — 放樣/單位健檢 ⛔ 斷點 1（第一要務）
preview_dwg_columns(layerName) → 看 count、sizeSummary、columns，重點看 preflight：
preflight.unitSanity：若為 check，停下，把 preflight.warnings 回報使用者（多半是 CAD 連結單位選錯，如 $INSUNITS=0 的 DXF 連成 mm），請回連結對話框改正單位後重做。不要硬建。preflight.sizeRangeMm / extentMm：複述斷面尺寸跨度與放樣範圍，確認落在合理柱斷面（100–3000mm）與正確圖面位置。
- 向使用者複述「N 根柱、尺寸分布、放樣範圍、單位健檢結果」，取得「定位放樣正確」的確認才往下。
步驟 3 — 選 family 模式 ⛔ 斷點 2（協作選擇，不替使用者預設）
- 模式 B/C：先
get_column_types 或 list_family_symbols 列出可用族群/類型給使用者挑。
- 與使用者敲定：模式（A/B/C）、
familyName、textLayerName、columnType（structural 預設 / architectural）。
- 缺對應柱號類型時的協作路徑（不一口氣）：可先模式 A/B 建尺寸型別 →
modify_element_parameter 改名+改參數成 C1/C2… → 再模式 C 重跑。
- ⚠️
modify_element_parameter 尺寸值是 Revit 內部 feet 不是 mm：600mm 要傳 1.9685（600/304.8）；改名用 parameterName="Name"。
步驟 4 — 批次建柱（改模型，不可復原）
- 執行前複述「將在圖層 X 以模式 ? 建 N 根 columnType 柱，族群 Y、柱號圖層 Z」並取得同意。
create_columns_from_dwg(layerName, columnType, familyName?, textLayerName?)。- 看回傳：
created/failed、typesUsed（含 C1/C2 表柱號對應成功）、unmatchedLabels、labelReadStatus、labelsPreview、matchDebug（dist≈0 表單位/對位成功）。
unmatchedLabels 不為空 → 停下協作：是圖說錯誤？還是族群缺類型（走上面的改名到位協作）？不要自動亂建。
前置補樓層（視需要）
- 報「找不到高於基準層的樓層」→ 先
create_level(elevation, name) 補上層再重試。
關鍵確認（每次帶到，理由見 domain）
- 單位/放樣是第一步且最重要：靠步驟 2 的
preflight 把關。
- 座標對位：柱位置＝CAD 在模型中的實際座標，未做 shared coordinates 換算；建柱後抽查中心對位，import 與 link 各驗。
- DXF/DWG 通用：模式 C 讀柱號 DXF 直讀、DWG 需 ODA（無則
no_oda 優雅降級、柱照建不對名）。
- 圖層而非顏色：只能用圖層名篩選。
Error Handling
| 症狀 | 可能原因 | 處理 |
|---|
| 「請在平面視圖中執行」 | 當前非 ViewPlan | 切平面視圖 |
| 圖層清單為空 | CAD 未載入/連結遺失/不可見 | 確認 import/link 與可見性 |
preflight.unitSanity=check | 連結單位選錯（尺寸全 10x 偏差） | 回連結對話框改正單位重做，勿建 |
| 「找不到…族群」 | 未載入矩形柱族 | 先載入 RC/矩形柱族 |
| preview 數量為 0 | 圖層錯誤或非矩形/尺寸超範圍 | 換圖層；確認柱為 100–3000mm 矩形 |
| 「找不到高於…的樓層」 | 無上層 Level | 先 create_level 補樓層 |
labelReadStatus=no_worker | 找不到 ezdxf_worker.py | 跑 install-addon.ps1 或複製 worker 到 %APPDATA%\RevitMCP\ |
labelReadStatus=no_oda | DWG 需 ODA File Converter | 安裝 ODA 或改用 DXF |
labelReadStatus=error 含「Import」 | CAD 用匯入非連結 | 改用「插入→連結 CAD」 |
unmatchedLabels 不為空 | 族群缺對應類型 | 協作：圖說錯誤？或改名到位後重跑 |
Related
- domain：
domain/dwg-column-import.md
- 互補工具：
create_column（單根手動建柱，與本批次工作流並存）
- 來源 fork：幾何
s9101800111-byte；柱號對應 Roy-y111
