القائمة
進階開發者工作流（opt-in）：在 Loader/Core 熱重載分支上，不重啟 Revit 即可重建 CoreRuntime → 部署 → 重載 → 驗證，加速 CommandExecutor 類修改的迭代。觸發條件：使用者提到熱重載、core reload、不重啟 Revit、CoreRuntime、重載核心、hot reload、reload_core、開發迭代加速。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | core-reload-dev |
| description | 進階開發者工作流（opt-in）：在 Loader/Core 熱重載分支上，不重啟 Revit 即可重建 CoreRuntime → 部署 → 重載 → 驗證，加速 CommandExecutor 類修改的迭代。觸發條件：使用者提到熱重載、core reload、不重啟 Revit、CoreRuntime、重載核心、hot reload、reload_core、開發迭代加速。 |
| user-invocable | true |
Operational companion to docs/core-reload-architecture.md and domain/core-reload-boundary.md.
[!IMPORTANT] OPT-IN, NOT main 架構。 main 維持憲法的「單一
MCP/RevitMCP.csproj」結構，不含MCP.Contracts/MCP.CoreRuntime子專案。本 skill 的步驟只在 opt-in 熱重載分支（feature/core-reload-optin）上成立。在 main（單一 csproj）執行dotnet build MCP.CoreRuntime/...會找不到專案 —— 此時請改用/build-revit+/deploy-addon，並向使用者說明熱重載屬 opt-in 進階分支。知識來源：收編自 ChimingLu（啟銘）的熱重載分支（issue #33 決策：核心架構 opt-in、文件與邊界收編進 main）。
MCP.CoreRuntime/MCP.CoreRuntime.csproj 與 MCP.Contracts/。
/build-revit + /deploy-addon」並停止。MCP/Core/CommandExecutor.cs 或 MCP/Core/Commands/CommandExecutor.*.cs）。dotnet build -c Release.R{YY} MCP.CoreRuntime/MCP.CoreRuntime.csproj --nologo%APPDATA%\Autodesk\Revit\Addins\{year}\RevitMCP\runtime\RevitMCP.CoreRuntime.dll。
runtime\ 內沒有 MCP.Contracts.dll（型別衝突來源，需刪除）。node MCP-Server/scripts/core-reload-verify.js --auto --revit {year}。create_dimension 回傳的 CoreVersion before/after 是否遞增。依 domain/core-reload-boundary.md：
MCP/Application.cs、MCP/Commands/MCPCommands.csMCP.Contracts 介面簽章（IRevitMcpRuntime.cs）CoreRuntimeManager.cs / CoreLoadContext.cs.addin manifest / AddInId / 載入路徑MCP-Server/src/tools/*.ts → 不需重啟 Revit，重啟 MCP Server 即可。| Revit | Runtime | 卸載機制 |
|---|---|---|
| 2025–2026 | .NET 8 | AssemblyLoadContext.Unload() + GC（真正卸載） |
| 2022–2024 | .NET FX 4.8 | Assembly.Load(byte[]) 記憶體載入（舊 Assembly 留存，>20 次/日重載記憶體緩增，建議每日首次重新部署） |
| 症狀 | 對策 |
|---|---|
找不到 MCP.CoreRuntime.csproj | 非熱重載分支 → 改用 /build-revit |
| 啟動錯誤「方法 'SetReloadCallback' 沒有實作」 | Loader/Contracts 已更新但 runtime DLL 是舊版 → 重建並部署 CoreRuntime；刪 runtime\MCP.Contracts.dll |
| 命令 8s timeout | UI 執行緒被 modal 阻塞 → 確認 SocketService.StartAsync() 無 modal TaskDialog（main 已收編此修正） |
CoreVersion 重載後沒變 | runtime\ DLL 未更新或 shadow-copy 取到舊快照 → 確認部署時間戳；清 %TEMP%\RevitMCP\runtime-shadow\ |
| Port 8964 監聽=是但連線 timeout | HTTP.sys 孤兒 Queue → 重開機最可靠；或系統管理員 net stop http /y → net start http（勿改 port 8964） |
治理 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.