REVIT_MCP_study

治理 Revit 房間粉刷明細表與材料代碼。當使用者提到粉刷明細表、F/B/W/C 材料編號、跳號、重排、材料表對照 CSV、AE-材料版、room finish schedule、finish code remap、material board family sync、粉刷比對 CSV 時使用。

IFC 結構同步至 Revit 原生結構構架與結構柱的工作流程。當使用者提到 IFC 結構模型、依 IFC 建立梁柱、sync_ifc_structural_to_native、StructuralFraming、StructuralColumns、UB-通用樑、AE-鋼柱、SHS/SHC/RC 柱判斷、b/h 參數顛倒、柱頂或梁頂貼齊樓板底、replaceExisting 重建、IFC_STRUCT_SYNC 註記時使用。

Revit 輕隔間牆數量計算與 CSV 報表更新。觸發條件：使用者提到輕隔間、隔間牆、partition wall takeoff、TYPE 牆、牆面積、扣除門窗開口、物流中心_ALL_輕隔間數量計算、更新既有輕隔間 CSV。

Create or review auditable Revit quantity-takeoff Excel reports for partition walls, baseboards, interior wall finishes, room schedules, and scaffolding. Use when the user asks for 數量計算、算量、輕隔間 Excel、踢腳 Excel、內牆粉刷 Excel、空間表更新 Excel、施工架數量、room perimeter、opening deductions、net height, or wants an existing pyRevit takeoff method reused through RevitMCP.

房間重新排序編號與批次自動編號工作流。使用者提到房間編號、房間重新排序、room numbering、renumber rooms、自動編號、從 B134 開始、只排 B1F 等需求時使用。優先工具：renumber_rooms_by_level、get_active_view、get_rooms_by_level。

Revit 施工架數量計算流程，適用於台灣工程估算。當使用者提到 frame scaffold、scaffold with protection facilities、外部施工架周長、地下室外牆防水毯周長來源、室內房間施工架、樓梯/電梯室內裝修施工架、room perimeter x height 或 length x width x height takeoff 時使用。Primary tools: calculate_selected_detail_line_perimeter and calculate_room_scaffold_perimeters.

Revit 輕隔間牆高於 6m 的結構回饋索引圖工作流。當使用者要找 TYPE 系列高牆、排除管道間/樓梯間/電梯間或 Type-F 牆、輸出房間清單，並以藍色房間與紅色牆線標示時使用。

Revit 房間關聯門窗統計，用於不鏽鋼門檻數量與未來開口相關計算。當使用者要依房間統計門或窗、排除指定房間或門窗類型、依類型備註/門編號彙總、計算不鏽鋼門檻，或準備門檻長度計算資料時使用。Primary tools: get_room_door_counts, get_room_window_counts, query_elements_with_filter.

將使用者自己的 domain、skill 與 tool 內容轉譯為 HJPLUS 台灣建築師知識庫可提交的 PR 草案，涵蓋 fork 檢查、內容對齊、檔案重編、作者確認與提交流程。觸發條件：HJ PR、fork、提案草案、domain 轉 skill、轉譯、貢獻草案、PR draft。

批次材質修改（複製原材質模式）：為每個 Type 的原材質建立複本，只修改複本的 Appearance diffuse color，保留 Graphics 顏色與其他屬性。適用於渲染白模（Enscape/V-Ray 看到白色，平面圖切割圖案維持原材質）。也支援復原（assign_existing_material）。觸發條件：使用者提到材質、material、白色模型、white model、渲染、render、批次換材質、統一材質、復原材質、restore material。工具：get_types_by_category、batch_set_material、assign_existing_material。

將 Excel 中的 worksheet 批次匯入 Revit Drafting View，忠實還原合併儲存格、表格框線、Excel 原始 column/row 尺寸與長文字 wrap 行為，並在覆蓋舊 view 時自動還原所有 sheet 上的 viewport 位置。觸發條件：使用者提到 excel 表格、excel to drafting、excel to legend、表格匯入 revit、批次匯入 excel、面積計算表匯入。**永遠優先使用 `import_excel_to_drafting_views` 一站式命令**——不要先呼叫 `read_excel_tables` 再 chain `create_legends`，那是過時的多步驟模式，已被一站式命令取代。`create_legends` / `read_excel_tables` 僅在「需要 Legend View 而非 Drafting View」或「純讀取 Excel 結構不建 view」這兩種特殊情況下才使用。

跨專案複製含 model views 的圖紙：Revit 原生「Insert Views from File」無法匯入含 model view 的 sheets，本 skill 用兩階段流程（讀取→確認衝突→執行）自動化重建。處理 view 四級分類（Tier 1 自動建立 / Tier 2 部分建立 / Tier 3 只匹配 / Tier 4 人工處理）、ScheduleSheetInstance 重建、DraftingView 內容跨文件複製、Sheet custom parameters（圖集/Discipline/繪圖人等）一併複製、衝突解決需使用者確認。內含補丁工具 sync_sheet_parameters_from_source 用於補齊舊 sheet 的 metadata。觸發條件：使用者提到跨專案複製圖紙、複製 sheets、Insert Views from File、轉移圖紙、source.rvt、import sheets、移植視圖、把另一個 rvt 的圖紙複製過來、cross-document、cross-project、補 sheet folder、修圖紙分組。工具：read_source_file_sheets、copy_sheets_from_file、sync_sheet_parameters_from_source。

批次對齊 view 範圍 + viewport 在 sheet 上的位置：三階段流程結合 ScopeBox、titleblock 對齊與 viewport 定位。階段一用 set_scope_box_for_views 把一組 view 的 CropBox 綁到指定 ScopeBox（範圍統一）；階段二（可選）用 align_titleblocks_on_sheets 對齊圖框 instance 位置（解決 change_element_type 後位置不一致）；階段三用 position_viewports_on_sheet 把這些 viewport 移到 sheet 上的指定錨點位置（位置統一）。適用於跨專案複製後對齊新 view、批次統一系列圖紙的 layout、出圖前最後對齊。觸發條件：使用者提到對齊 view、統一範圍、套用 scope box、批次定位 viewport、view 對齊 title block、對齊圖框、titleblock 對齊、align views to scope box、position viewports on sheet、align titleblock、sheet layout 對齊、批次出圖整理。工具：set_scope_box_for_views、align_titleblocks_on_sheets、position_viewports_on_sheet、get_viewport_map、get_sheet_viewport_details。

批次將指定的 ViewTemplate 套用到多個 view：支援以圖紙（sheets）或 view 名稱/ID 選取目標 view，可搭配 viewTypeFilter 過濾類型，並提供 dryRun 預覽 + skipIfSameTemplate 避免重複套用。適用於：跨專案複製後統一視圖樣式、出圖前批次校正 view template、把整本圖集的 view 改成統一 template、補齊新建 view 的樣板設定。觸發條件：使用者提到批次套用 view template、批次改 view template、視圖樣版批次修改、整套圖紙套同一個樣版、apply view template to sheets、batch view template、change view template for sheets、把這幾張 sheet 的 view 改成 XX template。工具：get_view_templates、get_all_sheets、get_sheet_viewport_details、get_viewport_map、batch_apply_view_template。

以指定的 FloorPlan 視圖為範本，在多個 Level 上批次建立樓層平面視圖（複製 ViewFamilyType、View Template、Phase、Phase Filter），並可選擇性把新 view 的 CropBox 對齊到指定 Detail Group（例如圖框）。支援 Viewport 選取自動解析為底層 view。適用於補齊缺漏的正式建築圖系列（A-X層平面圖）、統一系列裁剪範圍。觸發條件：使用者提到批次建立樓層平面、補齊平面圖、補漏平面圖、依範本建視圖、create floor plans、A-系列缺漏、樓層平面圖缺漏、align cropbox 到圖框、統一裁剪範圍、對齊圖框、viewport 對齊、這個視圖對齊 cropbox、選中的視圖對齊。工具：get_all_views、get_all_levels、get_element_info、get_active_view、get_selected_elements、create_floor_plans_from_template、align_view_cropbox_to_element、query_elements_with_filter、get_viewport_map。

DraftingView 表格縮放：支援寬度（X 軸）和行高（Y 軸）獨立縮放。寬度以左邊緣為錨點，行高以上邊緣為錨點，將 DetailCurve 和 TextNote 座標按比例縮放。適用於 Excel 匯入後微調表格欄寬、行高、統一多張表格的視覺比例。觸發條件：使用者提到縮放、scale、表格寬度、欄寬調整、行高、列高、縮小表格、放大表格、scale width、scale height、drafting view 寬度、drafting view 高度。工具：scale_drafting_view_width、scale_drafting_view_height。

視埠排列與管理：在圖紙上放置、排列、移動 DraftingView 視埠。支援自動放置（從專案查找 view 並放到圖紙）、跨圖紙移動、水平/垂直排列、邊緣對齊、負間距重疊。觸發條件：使用者提到排列視埠、viewport arrangement、排列 draft view、對齊視埠、align viewports、edge-to-edge、視埠位置、viewport layout、放到圖紙、移動視埠、move viewport、表格排列。工具：get_sheet_viewport_details、arrange_viewports_on_sheet、get_all_views、get_viewport_map、get_all_sheets、get_selected_elements、delete_element。

批次調整房間上限高度：依房間名稱或用途分組，指定目標高度(mm)後一次套用到所有符合的 Room（Upper Limit + Limit Offset），不動樓層。觸發條件：使用者提到房間高度、房高、room height、upper limit、limit offset、批次房高、統一房高、ceiling height、room top。

TextNote 批次操作：在多個 DraftingView 中依文字內容搜尋 TextNote 並批次平移。適用於跨圖面統一調整法規文字、表格附註等重複出現的 TextNote 位置。觸發條件：使用者提到批次移動 TextNote、text note、跨視圖移動文字、批次文字調整、move text notes、batch text。工具：move_text_notes_in_views。

視圖類別可見性控制：在指定視圖中隱藏或顯示整個類別（含連結模型），支援批次多視圖操作。觸發條件：使用者提到隱藏、顯示、hide、unhide、show、類別可見性、category visibility、隱藏樹、隱藏植栽、隱藏傢俱、Planting、連結模型隱藏。工具：set_category_visibility、hide_elements、unhide_elements、get_all_views、get_active_view。

批次複製詳圖項目（DetailCurve、TextNote、FilledRegion、DetailComponent、Dimension）從一個來源視圖到一或多個目標視圖（限同一專案內）。支援按類別過濾、指定特定元素 ID、XY 平移偏移、dryRun 預覽。適用於把標準節點、表格附註、詳圖標頭、尺寸標註從範本視圖一次散佈到整套圖紙；或將某張完成的詳圖複製到其他樓層的同類視圖。觸發條件：使用者提到批次複製詳圖、複製 detail items、copy details to views、複製標註到其他視圖、複製尺寸、複製 dimension、把這個 view 的內容複製到那些 view、套詳圖到多個視圖、batch copy annotations、batch copy dimensions、replicate detail elements、duplicate detail across views、把詳圖搬到別的視圖。

找出並刪除 Revit 視圖中的重複 detail element（同 Type + 位置量化後相同），優先保留 Detail Group 內的副本、刪除 group 外的副本，避免破壞共用標準詳圖。涵蓋 DetailComponent / DetailCurve / FilledRegion / TextNote / Dimension。採 dryRun 預覽 → 使用者確認 → 執行刪除的兩階段 SOP，邊界情形（全部都在 group / 全部都不在 group）會列出但不動，由使用者決定是否處理。觸發條件：使用者提到刪除重複詳圖、清除重複 detail、清重複元件、清理視圖、視圖重複、重複的標頭、重複的尺寸、重複的線、重複的填充、重複的標註、重複的詳圖元件、dedup detail、duplicate detail elements、deduplicate view、清理重複 annotation。

批次解除 Revit 幾何接合（Join Geometry）。以任一類別為中心解除其與指定 target 類別的接合關係，預設 target 涵蓋 8 大類（牆、樓板、建築柱、結構柱、結構構架、基礎、屋頂、天花板）。適用於渲染白模前置、幾何分析、上色前清理接合。提供「跑兩次驗證」、「交叉檢查來源數量」的 SOP，提醒 session-scoped 還原限制。觸發條件：使用者提到解除接合、取消結合、取消接合、解除幾何結合、批次斷開接合、unjoin、unjoin geometry、白模準備、render preparation。

Wrap a standalone Revit IExternalCommand (.cs / DLL, WPF dialog allowed) into a revit-mcp MCP tool. Generates the C# command handler + switch case + TypeScript tool definition, builds, dual-path deploys, guides the restart, auto-verifies the tool is live, then commits (never pushes). Use when the user says "把這支 DLL/.cs 變成 MCP 工具", "封裝成 revit-mcp tool", "wrap this command as an MCP tool".

牆面套管剖面批次建立工作流程：先向使用者確認命名前綴與排序方式，再依牆面套管/開孔位置批次建立平行剖面視圖並輸出摘要。觸發條件：使用者提到牆面套管剖面、批次建立套管剖面、對有開孔的牆建剖面、wall section batch、平行剖面。工具：batch_create_wall_sections、create_parallel_section_view。

消防偵煙探測器設置法規檢討：出風口距離、壁樑距、天花板貼附、區格涵蓋、探測面積五項規定檢核並於 Revit 圖面上色標示。觸發條件：使用者提到偵煙探測器、偵煙設置、探測器違規、smoke detector check、消防探測器。工具：analyze_smoke_detectors、visualize_detector_results、get_active_view。

進階開發者工作流（opt-in）：在 Loader/Core 熱重載分支上，不重啟 Revit 即可重建 CoreRuntime → 部署 → 重載 → 驗證，加速 CommandExecutor 類修改的迭代。觸發條件：使用者提到熱重載、core reload、不重啟 Revit、CoreRuntime、重載核心、hot reload、reload_core、開發迭代加速。

從 CAD/DWG 圖層批次建立 Revit 結構樑：掃描圖層 → 確認批次與模式 → 放樣健檢 → 批次建樑 → 詢問下一批次。支援全正交與含非正交（斜樑）圖說，分批處理（大樑 → 次樑 → 地樑）。 TRIGGER when: 結構樑翻模, dwg 建樑, cad 建樑, 圖層建樑, 批次建樑, beam from dwg, 從圖面建樑, 樑翻模, 大樑, 次樑, 地樑, create_beams_from_dwg

引導剛寫完 domain 的老師把 SOP 流程圖像化：先討論主流程、做流程健檢（迴圈／死路／缺口），再把流程整理成結構化 spec，交由 scripts/mermaid_from_spec.py 確定性地產出 GitHub 原生 ```mermaid 圖與健檢結論並回嵌 domain。模型不手寫圖，畫圖一律過腳本以保證一致性。觸發條件：使用者提到 domain 流程圖、流程圖像化、把 domain 畫成圖、mermaid、流程健檢、迴圈檢查、圖表型態、diagram、flowchart、visualize domain、畫流程。

從 CAD/DWG 圖層批次建立 Revit 結構柱/建築柱：單位/放樣健檢 → 選模式 → 批次建模。三模式（自動建型別 / 既有族群尺寸對應 / 既有族群柱號對應）依情境選用，分步協作不一口氣。 TRIGGER when: dwg 建柱, cad 建柱, 圖層建柱, 批次建柱, dwg 匯入建模, cad 柱, column from dwg, 從圖面建柱, 柱號對應, 柱名稱對應, C1 C2 柱

族群盤點與清整編排:對指定 category 做雙軸盤點(載入 vs 放置)→ 參數簽章比對 → 提案 → 使用者裁決 → 執行(purge 未使用 / merge 重複型 / rename)→ 驗證。每個破壞性動作前執行 7 項強制前置檢查。觸發條件:使用者提到族群整理、類型盤點、未使用類型、purge、重複類型、合併類型、family cleanup、type inventory、unused type、duplicate type、清掉沒用到的類型。工具:list_family_symbols、query_elements_with_filter、get_element_info、change_element_type、delete_element。

元素上色工作流程：根據參數值對 Revit 元素進行顏色標記與視覺化。觸發條件：使用者提到上色、顏色標示、color code、highlight、視覺化標記、參數上色。工具：get_category_fields、get_field_values、query_elements_with_filter、override_element_graphics、clear_element_override、unjoin_wall_joins、rejoin_wall_joins。

消防安全檢討：防火時效視覺化、走廊防火分析、外牆開口距離檢討（第 45 條、第 110 條）。觸發條件：使用者提到防火、耐燃、fire rating、防火時效、走廊、corridor、逃生、外牆開口、鄰地距離、Article 45、Article 110、防火區劃。工具：override_element_graphics、check_exterior_wall_openings、query_elements_with_filter。

停車場檢討：停車位淨空高度檢查（>210cm）與停車位數量分類統計（法定、無障礙、增設等八類）。觸發條件：使用者提到停車場、停車位、車位淨空、車道寬度、parking、clearance、機車位、無障礙車位。工具：get_rooms_by_level、query_elements_with_filter、override_element_graphics、get_field_values。

牆壁內外方向檢查：檢測外牆的 Exterior/Interior Side 是否正確，錯誤方向會影響飾面位置與容積計算。觸發條件：使用者提到牆壁方向、內外側、Exterior Side、Interior Side、牆壁檢查、wall orientation、wall check。工具：query_elements_with_filter、override_element_graphics、get_wall_info。

專案品質檢核：圖紙編號一致性、詳圖元件完整性、視圖組織、參數正確性、MCP 系統健康度。觸發條件：使用者提到 QA、品質檢查、驗證、一致性、專案檢核、系統健康、quality check、review。工具：get_all_sheets、get_detail_components、get_all_views、query_elements_with_filter。

建築法規檢討：居室採光比（第 41 條）、容積率與樓地板面積計算、停車位尺寸與數量檢核。觸發條件：使用者提到採光、daylight、容積率、FAR、樓地板面積、建蔽率、停車、parking、法規檢討、送審、regulatory。工具：get_room_daylight_info、query_elements_with_filter、get_rooms_by_level。

排煙窗法規檢討：無窗居室判定、無開口樓層判定、排煙有效面積計算、剖面標註、Excel 報告匯出。觸發條件：使用者提到排煙、排煙窗、無窗居室、無開口樓層、建技規§101、消防§188、天花板下80cm、有效開口、煙層。工具：check_smoke_exhaust_windows、check_floor_effective_openings、create_section_view、create_detail_lines、create_filled_region、create_text_note、export_smoke_review_excel。

Deploy the built RevitMCP.dll to the correct Revit Add-ins folder for a specified version (Windows only)

MEP 管線與結構（CSA）碰撞偵測，使用 Curve-to-Solid 策略進行干涉分析、視覺化與報告匯出。 TRIGGER when: 碰撞, 干涉, clash, MEP, 管線穿牆, 套管, 穿越, penetration, 碰撞偵測, 管線衝突