Revit MCP Server

{
  "type": "object",
  "properties": {
    "pipeId": {
      "type": "number",
      "description": "管件的元素 ID"
    },
    "familyName": {
      "type": "string",
      "description": "要安裝的管帽/法蘭族群名稱"
    }
  },
  "required": [
    "pipeId",
    "familyName"
  ]
}

{
  "title": "在管件的未連線端安裝管帽或法蘭",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "要調整的剖面視圖或剖面標記的 Element ID 列表"
    }
  },
  "required": [
    "viewIds"
  ]
}

{
  "title": "自動調整剖面視圖的網格線 (Grids) 與樓層線 (Levels) 2D 範圍與氣泡顯示",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "referenceSheetNumber": {
      "type": "string",
      "description": "參考 sheet 編號，會抓取此 sheet 上 titleblock 在 anchor 位置的座標作為 ground truth。不可與 referencePositionMm 同時使用"
    },
    "referencePositionMm": {
      "type": "object",
      "description": "直接給絕對座標（公釐，sheet 座標）。不可與 referenceSheetNumber 同時使用",
      "properties": {
        "x": {
          "type": "number",
          "description": "X 座標（mm）"
        },
        "y": {
          "type": "number",
          "description": "Y 座標（mm）"
        }
      },
      "required": [
        "x",
        "y"
      ]
    },
    "anchor": {
      "type": "string",
      "enum": [
        "top-left",
        "top-right",
        "bottom-left",
        "bottom-right",
        "center"
      ],
      "description": "對齊 titleblock bbox 的哪個角（預設 top-left）",
      "default": "top-left"
    },
    "targetSheetNumbers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "要對齊的 sheet 編號清單。省略 = 全部 sheets（會跳過沒有 titleblock 的）"
    },
    "toleranceMm": {
      "type": "number",
      "description": "若 delta 小於此公差（mm）則視為已對齊不移動，預設 0.1",
      "default": 0.1
    },
    "dryRun": {
      "type": "boolean",
      "description": "若 true 則只計算不實際移動，回傳預期 delta 供確認",
      "default": false
    }
  },
  "required": [
    "anchor"
  ]
}

{
  "title": "批次將多個 sheet 上的 titleblock 移動到同一個 anchor 座標",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "elementId": {
      "type": "number",
      "description": "要對齊的目標元素 ID（例如 Detail Group 的 ID）"
    },
    "viewId": {
      "type": "number",
      "description": "目標視圖 ID（選填）；不填則使用當前 active view"
    },
    "padding_mm": {
      "type": "number",
      "description": "向外擴大的邊距（公釐），預設 0",
      "default": 0
    }
  },
  "required": [
    "elementId"
  ]
}

{
  "title": "將指定視圖的 CropBox 對齊到目標元素（如 Detail Group 圖框）的 BoundingBox",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "beamId": {
      "type": "number",
      "description": "要分析的目標結構梁 Element ID"
    },
    "diameterParamNames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "可選。搜尋套管『直徑』的動態參數名稱清單（實體與類型自動 Fallback）。預設為 ['開孔直徑', '直徑', '管徑', 'Diameter', 'Size']"
    },
    "lengthParamNames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "可選。搜尋套管『長度』的動態參數名稱清單。預設為 ['長度', 'Length']"
    },
    "widthParamNames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "可選。搜尋梁『寬度』的動態參數名稱清單。預設為 ['b', '梁寬', 'Width']"
    },
    "sleeveIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "可選。指定檢核的套管 ID 清單，避免全區掃描"
    },
    "linkInstanceId": {
      "type": "number",
      "description": "可選。連結模型的 ID"
    }
  },
  "required": [
    "beamId"
  ]
}

{
  "title": "分析特定結構梁上的套管穿孔",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "roomId": {
      "type": "number",
      "description": "房間 Element ID（選填）"
    },
    "roomName": {
      "type": "string",
      "description": "房間名稱（選填）"
    },
    "minWidth": {
      "type": "number",
      "description": "最小寬度門檻（mm）",
      "default": 1200
    }
  }
}

{
  "title": "分析走廊寬度",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "elementIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "要分析的樓板 Element ID 陣列；省略則自動收集所有 Function=Exterior 樓板"
    },
    "paramName": {
      "type": "string",
      "description": "坡度回寫的目標參數名稱，預設 Comments"
    }
  }
}

{
  "title": "分析樓板頂面排水坡度：以 Solid→PlanarFace 法向量與 Z 軸夾角計算每片朝上頂面的坡度百分比，回傳每片樓",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "detectorKeywords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "偵煙探測器族群名稱關鍵字（預設：偵煙、smoke detector、探測器、感知器）"
    },
    "outletKeywords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "出風口族群名稱關鍵字（預設：FCU、冷風機、AHU、送風口、出風口、散流器）"
    }
  },
  "required": []
}

{
  "title": "偵煙探測器設置分析：掃描當前視圖的探測器、空調出風口（FCU/冷風機）、房間，回傳各探測器的距出風口距離、距牆/樑距離、",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "levels": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Level names to scan. Defaults to B-1F and B-3F unless autoDetectLevels is true."
    },
    "autoDetectLevels": {
      "type": "boolean",
      "description": "When true and levels is omitted, scan all placed-room levels and let tall TYPE walls identify candidates.",
      "default": false
    },
    "wallTypeContains": {
      "type": "string",
      "description": "Case-insensitive wall type name keyword for partition walls.",
      "default": "TYPE"
    },
    "minWallHeightMm": {
      "type": "number",
      "description": "Minimum wall height in millimeters. Default is 6000.",
      "default": 6000
    },
    "excludeRoomNameContains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Room name keywords to exclude. Defaults include shafts, stairs, and elevators."
    },
    "includeSingleRoomBoundaryWalls": {
      "type": "boolean",
      "description": "Include tall TYPE walls that only appear on one target room boundary. Set false to keep only walls shared by two or more target rooms.",
      "default": true
    },
    "includeRoomRayHeight": {
      "type": "boolean",
      "description": "Add ray-cast evidence from room bottom to the nearest floor underside above sampled points.",
      "default": true
    },
    "sampleGrid": {
      "type": "number",
      "description": "Room ray sample grid size, clamped to 1-7. Default 3.",
      "default": 3
    },
    "maxSearchDistanceMm": {
      "type": "number",
      "description": "Maximum upward/downward floor search distance used by the ray helper.",
      "default": 40000
    },
    "includeDetails": {
      "type": "boolean",
      "description": "Return wall-level and room-side details.",
      "default": true
    }
  }
}

{
  "title": "Find rooms on target levels that share or contain TYPE parti",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "elementId": {
      "type": "number",
      "description": "帷幕牆的 Element ID"
    },
    "typeMapping": {
      "type": "object",
      "description": "類型映射表（字母→面板類型 ID）"
    },
    "matrix": {
      "type": "array",
      "description": "面板排列矩陣，由上到下、由左到右",
      "items": {
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    }
  },
  "required": [
    "elementId",
    "typeMapping",
    "matrix"
  ]
}

{
  "title": "將面板排列模式套用到帷幕牆",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewNames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "依排列順序的 view 名稱陣列（與 viewportIds 二擇一）。工具會在圖紙上查找對應的 DraftingView viewport。"
    },
    "viewportIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "依排列順序的視埠 ID 陣列（與 viewNames 二擇一）"
    },
    "direction": {
      "type": "string",
      "enum": [
        "horizontal",
        "vertical"
      ],
      "description": "排列方向：horizontal（水平，預設）或 vertical（垂直）"
    },
    "gapMm": {
      "type": "number",
      "description": "視埠之間的間距（mm），預設 0（邊緣對齊）"
    },
    "alignY": {
      "type": "string",
      "enum": [
        "top",
        "center",
        "bottom"
      ],
      "description": "垂直對齊方式（水平排列時有效）：top / center（預設）/ bottom"
    },
    "sheetId": {
      "type": "number",
      "description": "圖紙的 Element ID（選填，不指定則使用當前作用圖紙）"
    }
  }
}

{
  "title": "依指定順序排列圖紙上的視埠（僅限 DraftingView）",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "typeIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "要套用材質的 Type Element ID 陣列"
    },
    "materialName": {
      "type": "string",
      "description": "既有材質名稱（必須已存在於專案中）"
    }
  },
  "required": [
    "typeIds",
    "materialName"
  ]
}

{
  "title": "將既有材質（透過名稱查找）套用到指定的 Type",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "Automatically fix fill patterns on rotated viewports so hatc",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewId": {
      "type": "number",
      "description": "目標平面視圖 ID（必須是 ViewPlan）"
    },
    "wallIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "要標註的牆 ElementId 列表（選填，預設為 view 範圍內所有牆）"
    },
    "mode": {
      "type": "string",
      "enum": [
        "overall_bbox",
        "chained",
        "per_wall"
      ],
      "description": "標註模式（預設 overall_bbox）"
    },
    "offsetMm": {
      "type": "number",
      "description": "標註線偏移距離 (mm)，預設 1500"
    }
  },
  "required": [
    "viewId"
  ]
}

{
  "title": "批次自動標註牆段尺寸（不需要 Room）",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "自動掃描專案中所有帶有 -1 後綴的圖紙（例如 ARB-D0417-1），並將其合併至主序列中（變成 ARB-D0418",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewTemplateId": {
      "type": "number",
      "description": "目標 ViewTemplate 的 ElementId（與 viewTemplateName 二擇一）"
    },
    "viewTemplateName": {
      "type": "string",
      "description": "目標 ViewTemplate 的名稱（與 viewTemplateId 二擇一；精確匹配）"
    },
    "sheetIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "圖紙 ElementId 清單 — 套用到這些圖紙上所有 viewport 對應的 views"
    },
    "sheetNumbers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "圖紙編號清單（如 ['A101', 'A102']）— 套用到這些圖紙上所有 viewport 對應的 views"
    },
    "viewIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "目標 view ElementId 清單（精確指定）"
    },
    "viewNames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "目標 view 名稱清單（精確匹配）"
    },
    "viewNameContains": {
      "type": "string",
      "description": "view 名稱包含此字串（substring match，case-insensitive）"
    },
    "viewTypeFilter": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "限定 view type，例: ['FloorPlan', 'CeilingPlan', 'Section', 'Elevation', 'ThreeD']"
    },
    "dryRun": {
      "type": "boolean",
      "description": "設為 true 時僅預覽變更清單，不實際修改。預設 false"
    },
    "skipIfSameTemplate": {
      "type": "boolean",
      "description": "若 view 已使用相同 template 則跳過。預設 true"
    }
  },
  "required": []
}

{
  "title": "批次將指定的 ViewTemplate 套用到多個 views",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Target view ElementIds to process."
    },
    "sheetNumbers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Sheet numbers whose placed viewports will each be processed."
    },
    "filledRegionTypeName": {
      "type": "string",
      "description": "Name of the FilledRegionType to use for the stickers.",
      "default": "深灰色"
    }
  }
}

{
  "title": "Batch-create RC filled-region stickers across multiple views",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "wallLinkId": {
      "type": "number",
      "description": "牆所在的連結模型 LinkInstanceId（來自 get_linked_models）"
    },
    "splitLongWalls": {
      "type": "boolean",
      "description": "相鄰開孔間距 > 3m 時自動分割為多個剖面，預設 true",
      "default": true
    },
    "viewNamePrefix": {
      "type": "string",
      "description": "視圖名稱前綴，預設「牆面套管剖面」",
      "default": "牆面套管剖面"
    },
    "autoCrop": {
      "type": "boolean",
      "description": "依開孔範圍自動裁剪剖面框，預設 true",
      "default": true
    },
    "directionLogic": {
      "type": "string",
      "enum": [
        "auto",
        "inside_out",
        "outside_in"
      ],
      "description": "剖面觀察方向，預設 auto（自動找房間側）",
      "default": "auto"
    },
    "scale": {
      "type": "number",
      "description": "視圖比例尺，預設 50（1:50）",
      "default": 50
    },
    "marginHorizontal": {
      "type": "number",
      "description": "剖面左右留白（mm），預設 500",
      "default": 500
    },
    "marginVertical": {
      "type": "number",
      "description": "剖面上下留白（mm），預設 200",
      "default": 200
    },
    "minWallLength": {
      "type": "number",
      "description": "最短牆長過濾（mm），過短的牆略過，預設 500",
      "default": 500
    },
    "sequentialNaming": {
      "type": "boolean",
      "description": "啟用流水號命名：依 sortOrder 排序後命名為 {prefix}-001、{prefix}-002…，預設 false（使用牆 ID 作為後綴）",
      "default": false
    },
    "sortOrder": {
      "type": "string",
      "enum": [
        "x_then_y",
        "y_then_x",
        "creation"
      ],
      "description": "流水號排序方式。x_then_y = 先左後右再由下往上；y_then_x = 先下後上再由左往右；creation = 依建立順序不重排。預設 x_then_y",
      "default": "x_then_y"
    }
  },
  "required": [
    "wallLinkId"
  ]
}

{
  "title": "批次建立牆面套管剖面：以當前視圖的 BoundingBox 範圍過濾指定連結模型中的牆，再比對所有 MEP 連結模型的管",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "typeIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "要修改材質的 Type Element ID 陣列（從 get_types_by_category 取得）"
    },
    "color": {
      "type": "object",
      "description": "目標 Appearance diffuse 顏色 RGB (0-255)",
      "properties": {
        "r": {
          "type": "number",
          "minimum": 0,
          "maximum": 255
        },
        "g": {
          "type": "number",
          "minimum": 0,
          "maximum": 255
        },
        "b": {
          "type": "number",
          "minimum": 0,
          "maximum": 255
        }
      }
    },
    "materialName": {
      "type": "string",
      "description": "材質名稱 suffix（後綴）。例如 '護眼白_MCP' 會把原材質 '鋼 AISI 1015' 複製成 '鋼 AISI 1015_護眼白_MCP'。預設 'White_MCP'。",
      "default": "White_MCP"
    },
    "roughness": {
      "type": "number",
      "description": "Appearance roughness（選填）。0.0=鏡面反射，1.0=完全啞光。若值 > 1 會被當成百分比（除以 100）。不設則維持原值。建議白模用 1.0 避免金屬感反光。"
    }
  },
  "required": [
    "typeIds",
    "color"
  ]
}

{
  "title": "批次修改指定 Type 的材質（複製原材質模式）",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "groups": {
      "type": "array",
      "description": "分組規則陣列。每個 group 指定一個房間名稱/用途關鍵字與目標高度(mm)。",
      "items": {
        "type": "object",
        "properties": {
          "nameMatch": {
            "type": "string",
            "description": "房間名稱/用途關鍵字（不區分大小寫，部分比對）。例：'居室'、'浴室'、'走廊'"
          },
          "heightMm": {
            "type": "number",
            "description": "目標高度（mm，絕對值）。即 Upper Limit 對應樓層之上的 Limit Offset。範圍 1~10000。"
          },
          "upperLevelName": {
            "type": "string",
            "description": "選填：指定 Upper Limit 要使用的樓層名稱。若留空則使用 Room 的 Base Level（房間高度 = Limit Offset = heightMm）。"
          }
        },
        "required": [
          "nameMatch",
          "heightMm"
        ]
      }
    },
    "levelName": {
      "type": "string",
      "description": "選填：限制只修改某一樓層的 Room。留空則全專案。"
    },
    "matchField": {
      "type": "string",
      "enum": [
        "name",
        "department"
      ],
      "description": "比對欄位：'name' (ROOM_NAME) 或 'department' (ROOM_DEPARTMENT)。預設 'name'。",
      "default": "name"
    },
    "summaryOnly": {
      "type": "boolean",
      "description": "true（預設）=只回計數與錯誤列表，避免 500+ Room 時 payload 爆炸；false=附帶每個 Room 的 OriginalValues 與 Modifications 明細（供 audit）。",
      "default": true
    }
  },
  "required": [
    "groups"
  ]
}

{
  "title": "批次依房間名稱或用途分組，設定 Room 的 Upper Limit（ROOM_UPPER_LEVEL）與 Limit",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "levelName": {
      "type": "string",
      "description": "Optional Revit level name. When omitted, the active view filter is used if activeViewOnly is true."
    },
    "activeViewOnly": {
      "type": "boolean",
      "description": "Only analyze walls visible in the active view.",
      "default": true
    },
    "includeCurtainWalls": {
      "type": "boolean",
      "description": "Include curtain walls in the exterior perimeter calculation.",
      "default": true
    },
    "selectResult": {
      "type": "boolean",
      "description": "Select detected exterior walls in Revit after calculation so the user can review the result.",
      "default": true
    },
    "includeExcludedWalls": {
      "type": "boolean",
      "description": "Return every excluded wall instead of only the highest-scoring sample.",
      "default": false
    },
    "sampleCount": {
      "type": "number",
      "description": "Number of sample stations tested on each wall. Valid range is clamped to 3-9.",
      "default": 3
    },
    "minimumExposedRatio": {
      "type": "number",
      "description": "Minimum ratio of open-side samples required to classify a wall as exterior.",
      "default": 0.33
    },
    "rayAngleDegrees": {
      "type": "number",
      "description": "Fan angle on both sides of each wall normal for finding blocking walls.",
      "default": 25
    },
    "searchDepthMm": {
      "type": "number",
      "description": "Optional ray search depth. Defaults to twice the analyzed wall bounding diagonal."
    },
    "minWallLengthMm": {
      "type": "number",
      "description": "Ignore very short walls below this length.",
      "default": 300
    },
    "minWallHeightMm": {
      "type": "number",
      "description": "Ignore walls whose effective height is below this value. Effective height uses unconnected height first, then top/base constraints, then bounding box height.",
      "default": 2000
    },
    "endpointToleranceMm": {
      "type": "number",
      "description": "Tolerance used only for reporting connected exterior wall groups.",
      "default": 750
    },
    "includePerimeterBridgeWalls": {
      "type": "boolean",
      "description": "Add short exterior or retaining walls whose endpoints reconnect to the detected exterior wall network. This catches perimeter walls hidden by adjacent walls in ray tests.",
      "default": true
    },
    "bridgeEndpointToleranceMm": {
      "type": "number",
      "description": "Endpoint/network tolerance for perimeter bridge wall recovery.",
      "default": 750
    },
    "maxBridgeWallLengthMm": {
      "type": "number",
      "description": "Maximum wall length eligible for perimeter bridge recovery.",
      "default": 12000
    },
    "scaffoldHeightMm": {
      "type": "number",
      "description": "Optional scaffold height. When provided, the tool also returns perimeter x height area in square meters."
    }
  }
}

{
  "title": "Reliable scaffold takeoff mode",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "xGrids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "X 軸網格名稱清單 (例如 ['B23', 'B27'])"
    },
    "yGrids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Y 軸網格名稱清單 (例如 ['BE'])"
    },
    "offset_mm": {
      "type": "number",
      "description": "邊界向外偏移距離 (公釐)，預設 0",
      "default": 0
    }
  }
}

{
  "title": "計算給定 X 與 Y 網格範圍的邊界 BoundingBox 座標",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "level": {
      "type": "string",
      "description": "Optional level name or unambiguous partial level name. When omitted, all placed rooms are considered."
    },
    "levelName": {
      "type": "string",
      "description": "Alias of level."
    },
    "roomIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Optional explicit Room ElementId list. Overrides level filtering."
    },
    "includeUnnamed": {
      "type": "boolean",
      "description": "Whether unnamed placed rooms should be included.",
      "default": true
    },
    "includeRoomDetails": {
      "type": "boolean",
      "description": "Return per-room audit rows.",
      "default": true
    },
    "finishKeywords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Room name/number keywords classified as interior finish scaffold. Defaults include safety stairs, accessible stairs, stairs, elevators, freight elevators, lifts, and passenger elevators."
    },
    "excludeKeywords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Room name/number keywords excluded from general scaffold. Defaults include outdoor platforms, terraces, balconies, pipe shafts, and water tanks."
    },
    "excludeLevels": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Level suffixes/names excluded from the room scaffold takeoff. Defaults to FN and TF."
    },
    "minBoundarySegmentLengthMm": {
      "type": "number",
      "description": "Ignore tiny room boundary fragments shorter than this length.",
      "default": 1
    },
    "scaffoldHeightMm": {
      "type": "number",
      "description": "Optional scaffold height. For interior finish scaffold, this is the height used in length x width x height. If omitted, the tool attempts to use room bounding-box height."
    }
  }
}

{
  "title": "Indoor scaffold takeoff mode",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "includeFamilyGeometry": {
      "type": "boolean",
      "description": "Read measurable curve geometry from selected detail component family instances.",
      "default": true
    },
    "includeFilledRegions": {
      "type": "boolean",
      "description": "Include selected filled region boundary curves.",
      "default": true
    },
    "minCurveLengthMm": {
      "type": "number",
      "description": "Ignore tiny curve fragments shorter than this length.",
      "default": 1
    },
    "scaffoldHeightMm": {
      "type": "number",
      "description": "Optional scaffold height. When provided, the tool also returns perimeter x height area in square meters."
    }
  }
}

{
  "title": "Fast scaffold takeoff mode",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "elementId": {
      "type": "number",
      "description": "元素 ID"
    },
    "elementIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "元素 ID 列表（用於批量變更）"
    },
    "typeId": {
      "type": "number",
      "description": "目標類型的 Element ID"
    }
  },
  "required": [
    "typeId"
  ]
}

{
  "title": "變更 Revit 元素的類型（例如將牆從 Type A 改為 Type B）",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "checkArticle45": {
      "type": "boolean",
      "description": "檢查第45條",
      "default": true
    },
    "checkArticle110": {
      "type": "boolean",
      "description": "檢查第110條",
      "default": true
    },
    "colorizeViolations": {
      "type": "boolean",
      "description": "以顏色標示",
      "default": true
    },
    "exportReport": {
      "type": "boolean",
      "description": "匯出 JSON 報表",
      "default": false
    },
    "reportPath": {
      "type": "string",
      "description": "報表輸出路徑"
    }
  }
}

{
  "title": "依據台灣建築技術規則第45條及第110條檢討外牆開口",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "levelName": {
      "type": "string",
      "description": "樓層名稱"
    },
    "colorize": {
      "type": "boolean",
      "description": "是否自動上色開口",
      "default": true
    }
  },
  "required": [
    "levelName"
  ]
}

{
  "title": "無開口樓層判定：檢查樓層外牆有效開口面積是否 ≥ 樓地板面積 1/30",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "level": {
      "type": "string",
      "description": "Optional level name. If omitted, roomIds or all placed rooms matching filters are used."
    },
    "roomNameContains": {
      "type": "string",
      "description": "Optional Room name filter, useful for factory/building scopes such as C-1."
    },
    "roomNumberContains": {
      "type": "string",
      "description": "Optional Room number filter."
    },
    "buildingType": {
      "type": "string",
      "description": "Optional building type / occupancy group hint, such as C-1, C-1 factory, factory, or warehouse. If omitted, the tool detects from level/view/project/room context and defaults to C-1 because this package currently supports C-1 only."
    },
    "roomIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Optional explicit Room ElementId list. Overrides level/name/number filters."
    },
    "areaPerPersonM2": {
      "type": "number",
      "description": "Occupancy density in square meters per person.",
      "default": 10
    },
    "maleRatio": {
      "type": "number",
      "description": "Male side of male:female ratio. Default 1.",
      "default": 1
    },
    "femaleRatio": {
      "type": "number",
      "description": "Female side of male:female ratio. Default 1.",
      "default": 1
    },
    "excludeKeywords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional extra Room name/number keywords to exclude from occupancy area in addition to stairs, elevators, refuge/shelter, and parking defaults."
    }
  }
}

{
  "title": "Calculate sanitary fixture requirements by detecting the bui",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "levelName": {
      "type": "string",
      "description": "樓層名稱"
    },
    "ceilingHeightSource": {
      "type": "string",
      "enum": [
        "room_parameter",
        "ceiling_element"
      ],
      "description": "天花板高度來源",
      "default": "room_parameter"
    },
    "colorize": {
      "type": "boolean",
      "description": "是否自動上色窗戶",
      "default": true
    },
    "smokeZoneHeight": {
      "type": "number",
      "description": "有效帶高度（mm），預設 800",
      "default": 800
    },
    "excludeKeywords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "非居室排除關鍵字"
    }
  },
  "required": [
    "levelName"
  ]
}

{
  "title": "排煙窗檢討：檢查天花板下 80cm 內可開啟窗面積是否 ≥ 區劃面積 2%",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "stairId": {
      "type": "number",
      "description": "樓梯的 Element ID"
    },
    "finishThicknessCm": {
      "type": "number",
      "description": "裝修面厚度 (cm，預設 0)"
    },
    "headroomLimitCm": {
      "type": "number",
      "description": "法規最低淨高需求 (cm，預設 190)"
    }
  },
  "required": [
    "stairId"
  ]
}

{
  "title": "檢查樓梯淨高是否符合法規要求（190cm + 裝修厚度）",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "elementId": {
      "type": "number",
      "description": "要清除覆寫的元素 ID"
    },
    "elementIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "批次操作"
    },
    "viewId": {
      "type": "number",
      "description": "視圖 ID"
    }
  }
}

{
  "title": "清除元素在指定視圖中的圖形覆寫",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "clashData": {
      "type": "object",
      "description": "detect_clashes 的完整回傳物件（含 Clashes 陣列）"
    },
    "colorScheme": {
      "type": "string",
      "description": "配色方案：by_csa_category / by_system / by_severity",
      "default": "by_csa_category"
    },
    "viewId": {
      "type": "number",
      "description": "目標視圖 ID；省略則使用當前 active view"
    }
  },
  "required": [
    "clashData"
  ]
}

{
  "title": "將 detect_clashes 的結果視覺化上色到 CSA 元素",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "Convert drafting fill patterns to model fill patterns in the",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "sourceViewId": {
      "type": "number",
      "description": "來源視圖的 Element ID"
    },
    "targetViewIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "目標視圖的 Element ID 陣列"
    },
    "elementCategories": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "DetailCurves",
          "TextNotes",
          "FilledRegions",
          "DetailComponents",
          "Dimensions",
          "All"
        ]
      },
      "description": "要複製的詳圖項目類別，預設 [\"All\"]。可指定子集如 [\"DetailCurves\", \"Dimensions\"]。Dimensions 包含 Linear/Aligned/Radial/Angular/ArcLength/SpotElevation 等所有尺寸標註類型。",
      "default": [
        "All"
      ]
    },
    "sourceElementIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "指定要複製的元素 ID 清單（選填）。省略則複製來源視圖中符合 elementCategories 的所有詳圖項目。"
    },
    "offset": {
      "type": "object",
      "properties": {
        "x": {
          "type": "number",
          "description": "X 方向偏移量（公釐），預設 0"
        },
        "y": {
          "type": "number",
          "description": "Y 方向偏移量（公釐），預設 0"
        }
      },
      "description": "複製後的位置偏移（公釐）。預設 {x:0, y:0} 即原位置。"
    },
    "preserveGroups": {
      "type": "boolean",
      "description": "true=收集到的 group 成員會被替換成整個 group instance 一起複製，保留 detail group/model group 結構（推薦）；false=group 成員以個別元素複製，丟失 group 結構（舊行為）。注意：preserveGroups=true 時，若 group 內含其他類別的成員（不在 elementCategories 過濾範圍內），那些成員仍會隨 group 一起複製過去。",
      "default": true
    },
    "fallbackToIndividual": {
      "type": "boolean",
      "description": "true=當批次複製失敗時，自動 fallback 為逐個元素重試，記錄哪些成功哪些失敗（強烈推薦）；false=批次失敗則整批 rollback，回傳 Failed 狀態。Dimension 跨 view 複製常因 host element 引用遺失導致整批 fail，這個參數能自動繞過問題元素只保留可複製的部分。回傳結構新增 Mode（Batch/Individual）、FailedCount、FailedElements、BatchErrorReason 欄位。",
      "default": true
    },
    "dryRun": {
      "type": "boolean",
      "description": "若 true 則只回傳要複製的元素統計，不實際複製。",
      "default": false
    }
  },
  "required": [
    "sourceViewId",
    "targetViewIds"
  ]
}

{
  "title": "批次複製詳圖項目（DetailCurve、TextNote、FilledRegion、DetailComponent、D",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "sourceFilePath": {
      "type": "string",
      "description": "來源 .rvt 檔案的絕對路徑"
    },
    "sheetNumbers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "要複製的圖紙編號清單。省略則複製全部 sheets。"
    },
    "viewMatchStrategy": {
      "type": "string",
      "enum": [
        "match_only",
        "match_or_create"
      ],
      "description": "view 匹配策略。match_only: 只使用目標檔已存在的同名 view；match_or_create: 優先匹配，找不到時建立新 view（僅 Tier 1-2）。預設 match_or_create。",
      "default": "match_or_create"
    },
    "conflictResolution": {
      "type": "object",
      "description": "衝突解決設定。當 read_source_file_sheets 偵測到衝突時必須提供。",
      "properties": {
        "sheets": {
          "type": "object",
          "description": "Sheet 衝突解決。Key=圖紙編號, Value='skip'(跳過) 或 'rename'(自動加後綴)",
          "additionalProperties": {
            "type": "string",
            "enum": [
              "skip",
              "rename"
            ]
          }
        },
        "views": {
          "type": "object",
          "description": "View 衝突解決。Key=view 名稱, Value='use_existing'(使用現有) / 'overwrite'(刪除重建) / 'rename'(新 view 加後綴)",
          "additionalProperties": {
            "type": "string",
            "enum": [
              "use_existing",
              "overwrite",
              "rename"
            ]
          }
        },
        "schedules": {
          "type": "object",
          "description": "Schedule 衝突解決。Key=schedule 名稱, Value='use_existing'(使用現有) / 'skip'(不放置)",
          "additionalProperties": {
            "type": "string",
            "enum": [
              "use_existing",
              "skip"
            ]
          }
        },
        "typeConflicts": {
          "type": "string",
          "enum": [
            "use_destination",
            "use_source"
          ],
          "description": "CopyElements 時遇到同名 type 的全域處理策略。use_destination: 使用目標檔的 type（安全預設）；use_source: 使用來源檔的 type。",
          "default": "use_destination"
        }
      }
    },
    "copyDraftingContents": {
      "type": "boolean",
      "description": "是否複製 DraftingView 的內容（detail lines, text notes 等）。預設 true。",
      "default": true
    },
    "copySheetCustomParameters": {
      "type": "boolean",
      "description": "是否複製 sheet 上的 custom parameters（如 sheet folder/圖集、Discipline、繪圖人、Issue Date 等）。同名 + 同 StorageType 的 writable parameter 會被複製，ElementId 類型跳過（跨文件 ID 不可移植）。預設 true。",
      "default": true
    },
    "syncProperties": {
      "type": "object",
      "description": "控制同步哪些 view 屬性到目標。全部預設 true。",
      "properties": {
        "scale": {
          "type": "boolean",
          "description": "同步 Scale",
          "default": true
        },
        "cropBox": {
          "type": "boolean",
          "description": "同步 CropBox",
          "default": true
        },
        "viewTemplate": {
          "type": "boolean",
          "description": "同步 View Template（優先名稱匹配，若目標檔不存在則自動從來源複製）",
          "default": true
        },
        "detailLevel": {
          "type": "boolean",
          "description": "同步 Detail Level",
          "default": true
        },
        "displayStyle": {
          "type": "boolean",
          "description": "同步 Display Style",
          "default": true
        }
      }
    },
    "closeAfterCopy": {
      "type": "boolean",
      "description": "完成後是否關閉來源檔案。預設 true。",
      "default": true
    }
  },
  "required": [
    "sourceFilePath"
  ]
}

{
  "title": "從來源 .rvt 檔案複製圖紙到目前開啟的專案",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "layerName": {
      "type": "string",
      "description": "CAD 樑輪廓線條的圖層名稱（必填）"
    },
    "familyName": {
      "type": "string",
      "description": "指定使用的族群名稱（必填），例如「2_RC樑-矩形」。"
    },
    "typeName": {
      "type": "string",
      "description": "（選填）指定族群類型名稱（例如「60x80」）。有填此參數時為「快速模式」，該批次所有樑都用這個型別建立，忽略文字圖層。沒填時為「名稱對應模式」，依文字標注比對類型。"
    },
    "textLayerNameX": {
      "type": "string",
      "description": "（名稱對應模式必填其一）CAD 圖面上 X 軸向標注樑名稱（例如水平向的 B1）的文字圖層。文字僅會與 X 軸向的中心線進行配對，避免干擾。"
    },
    "textLayerNameY": {
      "type": "string",
      "description": "（名稱對應模式必填其一）CAD 圖面上 Y 軸向標注樑名稱（例如垂直向的 B1）的文字圖層。文字僅會與 Y 軸向的中心線進行配對，避免干擾。"
    },
    "beamRole": {
      "type": "string",
      "description": "（選填）標示此批次處理的樑角色，例如「大樑」、「次樑」、「地樑」。除回報顯示外，也用於設定樑的結構用途：大樑／地樑→大樑(Girder)、次樑→格柵樑(Joist)。"
    }
  },
  "required": [
    "layerName",
    "familyName"
  ]
}

{
  "title": "從 CAD 指定圖層建立 Revit 結構樑（必須搭配文字標注圖層）",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "x": {
      "type": "number",
      "description": "X 座標（公釐）"
    },
    "y": {
      "type": "number",
      "description": "Y 座標（公釐）"
    },
    "bottomLevel": {
      "type": "string",
      "description": "底部樓層名稱",
      "default": "Level 1"
    },
    "topLevel": {
      "type": "string",
      "description": "頂部樓層名稱（選填）"
    },
    "columnType": {
      "type": "string",
      "description": "柱類型名稱（選填）"
    }
  },
  "required": [
    "x",
    "y"
  ]
}

{
  "title": "在指定位置建立柱子",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "layerName": {
      "type": "string",
      "description": "CAD 圖層名稱，請從 get_dwg_column_layers 回傳的清單中選擇"
    },
    "columnType": {
      "type": "string",
      "enum": [
        "structural",
        "architectural"
      ],
      "default": "structural",
      "description": "柱類型：'structural'（結構柱，OST_StructuralColumns）或 'architectural'（建築柱，OST_Columns）。預設為 structural"
    },
    "familyName": {
      "type": "string",
      "description": "（選填）指定使用的族群名稱，例如「B1_RC柱-矩形」。指定後會從該族群現有類型中依尺寸比對，保留 C1/C2/C3 等原有柱名稱；尺寸無對應時才建立新類型。不指定則自動挑選最適族群。"
    },
    "textLayerName": {
      "type": "string",
      "description": "（選填）CAD 圖面上標注柱名稱（C1、C2 等）文字所在的圖層名稱。指定後會讀取該圖層的 TEXT/MTEXT 文字，依空間距離將最近的標注對應到每根柱，再以標注文字（如 C1）在 familyName 族群中尋找對應類型。DXF 格式可直接讀取；DWG 格式需安裝 ODA File Converter，未安裝時會回傳 labelReadStatus=no_oda 並附上安裝說明，柱仍會建立但不對應名稱。"
    }
  },
  "required": [
    "layerName"
  ]
}

{
  "title": "從 CAD 指定圖層自動建立 Revit 結構柱或建築柱",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "roomId": {
      "type": "number",
      "description": "走廊房間的 Element ID"
    },
    "viewId": {
      "type": "number",
      "description": "要建立標註的平面視圖 ID"
    }
  },
  "required": [
    "roomId",
    "viewId"
  ]
}

{
  "title": "走廊寬度標註 — 自動偵測房間邊界的平行牆對，建立精確的牆到牆尺寸標註",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "typeName": {
      "type": "string",
      "description": "新類型的名稱"
    },
    "color": {
      "type": "string",
      "description": "面板顏色（HEX 格式，如 '#5C4033'）"
    },
    "baseTypeId": {
      "type": "number",
      "description": "基礎類型 ID（選填）"
    }
  },
  "required": [
    "typeName",
    "color"
  ]
}

{
  "title": "建立新的帷幕牆面板類型，可指定顏色（HEX）和透明度",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "placementViewId": {
      "type": "number",
      "description": "放置 ElevationMarker 的 ViewPlan ElementId；優先於 placementViewName。"
    },
    "placementViewName": {
      "type": "string",
      "description": "放置 ElevationMarker 的 ViewPlan 名稱。"
    },
    "scale": {
      "type": "number",
      "description": "立面視圖比例，預設 50。",
      "default": 50
    },
    "offsetMm": {
      "type": "number",
      "description": "marker 放在牆外側的距離，單位 mm，預設 1500。",
      "default": 1500
    },
    "horizontalMarginMm": {
      "type": "number",
      "description": "crop 左右餘裕，單位 mm，預設 0；直線帷幕以 Wall.LocationCurve 端點為左右界，餘裕只擴張 crop，不影響尺寸端點。",
      "default": 0
    },
    "verticalMarginMm": {
      "type": "number",
      "description": "crop 上下餘裕，單位 mm，預設 0；剪裁範圍依 elevation view 內目標帷幕元素的 2D 可視範圍計算。",
      "default": 0
    },
    "depthMm": {
      "type": "number",
      "description": "自動深度計算失敗時的 fallback 遠剪裁深度，單位 mm，預設 1200；正常情況會剛好包住帷幕牆所有相關元素，遠端剪裁模式固定為剪裁含線。",
      "default": 1200
    },
    "viewTemplateName": {
      "type": "string",
      "description": "視圖樣板名稱，預設「帷幕立面」。",
      "default": "帷幕立面"
    },
    "applyViewTemplate": {
      "type": "boolean",
      "description": "是否建立/套用視圖樣板，預設 true。",
      "default": true
    },
    "nameSeparator": {
      "type": "string",
      "description": "樓層與標記之間的分隔字串，預設空字串。",
      "default": ""
    },
    "wallTagTypeId": {
      "type": "number",
      "description": "必須由使用者選擇的牆標籤 FamilySymbol ElementId。省略時工具不修改模型，並回傳 AvailableWallTagTypes 選單；應選擇具有[標記]參數的標籤類型。"
    },
    "addDimensions": {
      "type": "boolean",
      "description": "是否加入總寬、總高、帷幕底至所屬樓層線距離，以及水平／垂直帷幕網格尺寸，預設 true。",
      "default": true
    },
    "dimensionTypeSelectionMode": {
      "type": "string",
      "enum": [
        "auto",
        "prompt"
      ],
      "description": "標註類型選擇模式；auto 自動解析可用類型，prompt 則要求先指定類型。",
      "default": "auto"
    },
    "dimensionTypeId": {
      "type": "number",
      "description": "標註類型 DimensionType 的 ElementId。"
    },
    "dimensionTypeName": {
      "type": "string",
      "description": "標註類型 DimensionType 名稱；ID 無效或未提供時使用。"
    },
    "dimensionOffsetMm": {
      "type": "number",
      "description": "DimensionType 無法提供有效輔助線長度時使用的帷幕至內層網格尺寸線距離 fallback，單位 mm，預設 300。正常情況會採用（輔助線長度 + 圖紙 3 mm）乘以視圖比例。",
      "default": 300
    },
    "dimensionStackOffsetMm": {
      "type": "number",
      "description": "DimensionType 無法提供有效輔助線長度時使用的內外層尺寸間距 fallback，單位 mm，預設 250。正常情況會採用輔助線長度乘以視圖比例。",
      "default": 250
    },
    "dryRun": {
      "type": "boolean",
      "description": "只回報將建立的視圖，不修改模型，預設 false。",
      "default": false
    },
    "wallIds": {
      "type": "array",
      "description": "選填，只處理指定的帷幕牆 Element ID。未指定時處理專案內全部帷幕牆。給定但非帷幕牆或不存在的 ID 會列在回傳的 InvalidWallIds，不會被靜默略過。可與 maxWalls 併用（先套用 wallIds 過濾，再套用 maxWalls 上限）。",
      "items": {
        "type": "number"
      }
    },
    "maxWalls": {
      "type": "number",
      "description": "選填，單次呼叫處理的帷幕牆數量上限。專案帷幕牆數量多時（例如數百道）建議設定此參數分批處理，避免單次回應時間過長超過 MCP 回應時限。超過上限時只處理前 N 道，其餘 ID 會列在回傳的 RemainingWallIds 供下一輪呼叫續跑（可作為下一輪的 wallIds），並在 Truncated=true 與 Message 中說明本次處理與剩餘數量。"
    },
    "verbose": {
      "type": "boolean",
      "description": "是否回傳完整逐牆診斷欄位，預設 false。false 時只回統計與摘要：Created 逐牆明細只留 ViewId/ViewName/WallId，DimensionWarnings/WallTagWarnings/TemplateWarnings/Skipped 收斂為筆數；牆數多時可避免回應超過單次回傳上限。true 時維持既有完整輸出（含每道牆的 crop、標註、方向診斷欄位）。",
      "default": false
    }
  }
}

{
  "title": "批次建立每一道帷幕牆的永久外立面視圖，建立/套用名為「帷幕立面」的視圖樣板，保留 crop box 與 far clip",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "parentViewIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "母視圖的 Element ID 清單"
    },
    "min": {
      "type": "object",
      "description": "裁切框最小座標點",
      "properties": {
        "x": {
          "type": "number"
        },
        "y": {
          "type": "number"
        },
        "z": {
          "type": "number"
        }
      },
      "required": [
        "x",
        "y",
        "z"
      ]
    },
    "max": {
      "type": "object",
      "description": "裁切框最大座標點",
      "properties": {
        "x": {
          "type": "number"
        },
        "y": {
          "type": "number"
        },
        "z": {
          "type": "number"
        }
      },
      "required": [
        "x",
        "y",
        "z"
      ]
    },
    "suffixName": {
      "type": "string",
      "description": "視圖命名後綴 (例如 '-1')。若不指定則自動編號流水號。"
    }
  },
  "required": [
    "parentViewIds",
    "min",
    "max"
  ]
}

{
  "title": "依據指定的母視圖 ID 與 BoundingBox 邊界，批次建立並裁切從屬視圖 (Dependent View)",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "sheetNumber": {
      "type": "string",
      "description": "目標圖紙編號（如 A101）"
    },
    "detailName": {
      "type": "string",
      "description": "詳圖名稱（使用者輸入的新詳圖名稱）"
    },
    "familyName": {
      "type": "string",
      "description": "要複製的基礎詳圖項目族群名稱（選填，若未提供則預設尋找 'AE-圖號'）"
    },
    "detailNumber": {
      "type": "string",
      "description": "詳圖編號（選填，預設為 '1'）"
    }
  },
  "required": [
    "sheetNumber",
    "detailName"
  ]
}

{
  "title": "指定詳圖項目族群，複製並設定新名稱（圖紙編號-圖紙名稱-詳圖名稱），同時自動填寫 詳圖圖號、圖說名稱、詳圖名稱、詳圖編號",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewId": {
      "type": "number",
      "description": "目標視圖的 Element ID"
    },
    "lines": {
      "type": "array",
      "description": "線段陣列",
      "items": {
        "type": "object",
        "properties": {
          "startX": {
            "type": "number",
            "description": "起點 X（mm）"
          },
          "startY": {
            "type": "number",
            "description": "起點 Y（mm）"
          },
          "endX": {
            "type": "number",
            "description": "終點 X（mm）"
          },
          "endY": {
            "type": "number",
            "description": "終點 Y（mm）"
          },
          "color": {
            "type": "object",
            "properties": {
              "r": {
                "type": "number"
              },
              "g": {
                "type": "number"
              },
              "b": {
                "type": "number"
              }
            }
          },
          "lineStyle": {
            "type": "string",
            "description": "線條樣式（選填）"
          },
          "label": {
            "type": "string",
            "description": "標籤（選填）"
          }
        },
        "required": [
          "startX",
          "startY",
          "endX",
          "endY"
        ]
      }
    }
  },
  "required": [
    "viewId",
    "lines"
  ]
}

{
  "title": "在視圖上繪製詳圖線（天花板線、有效帶範圍線等），可指定顏色和標籤",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewId": {
      "type": "number",
      "description": "要建立標註的視圖 ID"
    },
    "startX": {
      "type": "number",
      "description": "起點 X 座標（公釐）"
    },
    "startY": {
      "type": "number",
      "description": "起點 Y 座標（公釐）"
    },
    "endX": {
      "type": "number",
      "description": "終點 X 座標（公釐）"
    },
    "endY": {
      "type": "number",
      "description": "終點 Y 座標（公釐）"
    },
    "offset": {
      "type": "number",
      "description": "標註線偏移距離（公釐）",
      "default": 500
    }
  },
  "required": [
    "viewId",
    "startX",
    "startY",
    "endX",
    "endY"
  ]
}

{
  "title": "在指定視圖中建立尺寸標註",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewId": {
      "type": "number",
      "description": "視圖 ID"
    },
    "roomId": {
      "type": "number",
      "description": "房間 ID"
    },
    "axis": {
      "type": "string",
      "description": "標註軸向：'X' 或 'Y'",
      "enum": [
        "X",
        "Y"
      ]
    },
    "offset": {
      "type": "number",
      "description": "標註線偏移距離 (mm)，默認 500"
    }
  },
  "required": [
    "viewId",
    "roomId",
    "axis"
  ]
}

{
  "title": "使用房間邊界框自動標註房間淨尺寸（保證100%覆蓋率）",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewId": {
      "type": "number",
      "description": "目標視圖 ID"
    },
    "origin": {
      "type": "object",
      "description": "射線原點 (通常為房間中心)",
      "properties": {
        "x": {
          "type": "number"
        },
        "y": {
          "type": "number"
        },
        "z": {
          "type": "number"
        }
      },
      "required": [
        "x",
        "y"
      ]
    },
    "direction": {
      "type": "object",
      "description": "正向射線方向向量",
      "properties": {
        "x": {
          "type": "number"
        },
        "y": {
          "type": "number"
        },
        "z": {
          "type": "number"
        }
      },
      "required": [
        "x",
        "y"
      ]
    },
    "counterDirection": {
      "type": "object",
      "description": "反向射線方向向量 (若未提供則自動取反)",
      "properties": {
        "x": {
          "type": "number"
        },
        "y": {
          "type": "number"
        },
        "z": {
          "type": "number"
        }
      }
    }
  },
  "required": [
    "viewId",
    "origin",
    "direction"
  ]
}

{
  "title": "使用射線偵測 (Ray-Casting) 建立尺寸標註",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "wallId": {
      "type": "number",
      "description": "要放置門的牆 ID"
    },
    "locationX": {
      "type": "number",
      "description": "門在牆上的位置 X 座標（公釐）"
    },
    "locationY": {
      "type": "number",
      "description": "門在牆上的位置 Y 座標（公釐）"
    },
    "doorType": {
      "type": "string",
      "description": "門類型名稱（選填）"
    },
    "sourceElementId": {
      "type": "number",
      "description": "來源門 ID（選填，用於複製其類型、參數與朝向）"
    }
  },
  "required": [
    "wallId",
    "locationX",
    "locationY"
  ]
}

{
  "title": "在指定的牆上建立門",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "wallId": {
      "type": "number",
      "description": "目標牆的 Element ID"
    },
    "facadeLayers": {
      "type": "object",
      "description": "立面層級定義",
      "properties": {
        "outer": {
          "type": "object",
          "description": "外層面板定義",
          "properties": {
            "offset": {
              "type": "number",
              "description": "距牆偏移（mm），預設 200"
            },
            "panelTypes": {
              "type": "array",
              "description": "面板類型定義陣列",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "類型代號（如 'A'）"
                  },
                  "name": {
                    "type": "string",
                    "description": "類型名稱"
                  },
                  "width": {
                    "type": "number",
                    "description": "寬度（mm）"
                  },
                  "height": {
                    "type": "number",
                    "description": "高度（mm）"
                  },
                  "depth": {
                    "type": "number",
                    "description": "弧深（mm）"
                  },
                  "thickness": {
                    "type": "number",
                    "description": "板厚（mm）"
                  },
                  "curveType": {
                    "type": "string",
                    "enum": [
                      "concave",
                      "convex"
                    ]
                  },
                  "color": {
                    "type": "string",
                    "description": "顏色（HEX）"
                  },
                  "geometryType": {
                    "type": "string",
                    "enum": [
                      "curved_panel",
                      "beveled_opening",
                      "angled_panel",
                      "rounded_opening",
                      "flat_panel"
                    ]
                  }
                },
                "required": [
                  "id",
                  "width",
                  "color"
                ]
              }
            },
            "pattern": {
              "type": "array",
              "description": "排列矩陣（如 ['ABABAB', 'BABABA']）",
              "items": {
                "type": "string"
              }
            },
            "gap": {
              "type": "number",
              "description": "間距（mm），預設 20"
            },
            "horizontalBandHeight": {
              "type": "number",
              "description": "分隔帶高度（mm）"
            },
            "floorHeight": {
              "type": "number",
              "description": "層高（mm），預設 3600"
            }
          },
          "required": [
            "panelTypes",
            "pattern"
          ]
        }
      },
      "required": [
        "outer"
      ]
    }
  },
  "required": [
    "facadeLayers"
  ]
}

{
  "title": "根據分析結果批次建立整面立面",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "wallId": {
      "type": "number",
      "description": "參考牆的 Element ID"
    },
    "geometryType": {
      "type": "string",
      "enum": [
        "curved_panel",
        "beveled_opening",
        "angled_panel",
        "rounded_opening",
        "flat_panel"
      ],
      "description": "幾何類型"
    },
    "positionAlongWall": {
      "type": "number",
      "description": "沿牆位置（mm）"
    },
    "positionZ": {
      "type": "number",
      "description": "底部 Z 高度（mm）"
    },
    "width": {
      "type": "number",
      "description": "寬度（mm），預設 800"
    },
    "height": {
      "type": "number",
      "description": "高度（mm），預設 3400"
    },
    "depth": {
      "type": "number",
      "description": "弧深/凹入深度（mm），預設 150"
    },
    "thickness": {
      "type": "number",
      "description": "板厚（mm），預設 30"
    },
    "offset": {
      "type": "number",
      "description": "距牆偏移（mm），預設 200"
    },
    "color": {
      "type": "string",
      "description": "顏色（HEX）"
    },
    "name": {
      "type": "string",
      "description": "面板名稱"
    },
    "curveType": {
      "type": "string",
      "enum": [
        "concave",
        "convex"
      ],
      "description": "[curved_panel] 曲線類型"
    },
    "tiltAngle": {
      "type": "number",
      "description": "[angled_panel] 傾斜角度（度）"
    },
    "tiltAxis": {
      "type": "string",
      "enum": [
        "horizontal",
        "vertical"
      ],
      "description": "[angled_panel] 傾斜軸"
    },
    "bevelDirection": {
      "type": "string",
      "enum": [
        "center",
        "up",
        "down",
        "left",
        "right"
      ],
      "description": "[beveled_opening] 斜切方向"
    },
    "bevelDepth": {
      "type": "number",
      "description": "[beveled_opening] 斜切深度（mm）"
    },
    "openingWidth": {
      "type": "number",
      "description": "[opening] 開口寬度（mm）"
    },
    "openingHeight": {
      "type": "number",
      "description": "[opening] 開口高度（mm）"
    },
    "cornerRadius": {
      "type": "number",
      "description": "[rounded_opening] 圓角半徑（mm）"
    },
    "openingShape": {
      "type": "string",
      "enum": [
        "rounded_rect",
        "arch",
        "stadium",
        "rect"
      ],
      "description": "[rounded_opening] 開口形狀"
    }
  }
}

{
  "title": "建立單片立面面板（DirectShape）",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewId": {
      "type": "number",
      "description": "目標視圖的 Element ID"
    },
    "points": {
      "type": "array",
      "description": "多邊形頂點（至少 3 個點，自動封閉）",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          }
        },
        "required": [
          "x",
          "y"
        ]
      }
    },
    "color": {
      "type": "object",
      "properties": {
        "r": {
          "type": "number"
        },
        "g": {
          "type": "number"
        },
        "b": {
          "type": "number"
        }
      }
    },
    "transparency": {
      "type": "number",
      "description": "透明度 0-100，預設 50",
      "default": 50
    },
    "regionType": {
      "type": "string",
      "description": "填充區域類型名稱（選填）"
    }
  },
  "required": [
    "viewId",
    "points"
  ]
}

{
  "title": "建立填充區域（如排煙有效帶色塊），可設定顏色和透明度",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "legendName": {
      "type": "string",
      "description": "新 Legend 視圖名稱（選填，預設『粉刷圖例_yyyyMMdd』）"
    },
    "legendTemplateName": {
      "type": "string",
      "description": "指定要複製的 Legend 名稱（選填，預設取專案第一個 Legend）"
    }
  }
}

{
  "title": "在 Revit 中自動建立粉刷／油漆材料填滿圖例",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "points": {
      "type": "array",
      "description": "樓板邊界點陣列",
      "items": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          }
        }
      }
    },
    "levelName": {
      "type": "string",
      "description": "樓層名稱",
      "default": "Level 1"
    },
    "floorType": {
      "type": "string",
      "description": "樓板類型名稱（選填）"
    }
  },
  "required": [
    "points"
  ]
}

{
  "title": "在 Revit 中建立樓板",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "templateViewId": {
      "type": "number",
      "description": "要複製設定的範本 FloorPlan 視圖 ElementId（例：A-十層平面圖）"
    },
    "creations": {
      "type": "array",
      "description": "要建立的視圖清單；每一項指定 Level 名稱與新視圖名稱",
      "items": {
        "type": "object",
        "properties": {
          "levelName": {
            "type": "string",
            "description": "目標樓層名稱，需與專案 Level 名稱完全一致（例：11FL）"
          },
          "newName": {
            "type": "string",
            "description": "新視圖名稱；若已存在同名 view 則會跳過"
          }
        },
        "required": [
          "levelName",
          "newName"
        ]
      }
    },
    "applyViewTemplate": {
      "type": "boolean",
      "description": "是否套用範本的 View Template。預設 true。",
      "default": true
    }
  },
  "required": [
    "templateViewId",
    "creations"
  ]
}

{
  "title": "以指定的 FloorPlan 視圖作為範本，在多個 Level 上批次建立新的樓層平面視圖",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "names": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "要建立的 legend 視圖名稱清單，例如 ['A01','A02']"
    },
    "seedName": {
      "type": "string",
      "description": "指定 seed legend 名稱（選填）。未指定時優先找名稱以 _SEED_ 開頭的 legend，找不到再退到任一 legend。"
    },
    "duplicateMode": {
      "type": "string",
      "enum": [
        "empty",
        "withDetailing"
      ],
      "description": "複製模式：empty=只複製空 view（純框線/文字場景）；withDetailing=連同詳圖元件一起複製（預設）。"
    }
  },
  "required": [
    "names"
  ]
}

{
  "title": "⚠️ 若目的是把 Excel 內容繪製到 Revit view，**請改用 `import_excel_to_draft",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "elevation": {
      "type": "number",
      "description": "樓層標高（公釐，會自動轉成 Revit 內部單位 feet）"
    },
    "name": {
      "type": "string",
      "description": "樓層名稱（選填，例如 '3F'、'RF'）。未填則使用 Revit 預設名稱"
    }
  },
  "required": [
    "elevation"
  ]
}

{
  "title": "在 Revit 中建立一個新的樓層 (Level)",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "wallId": {
      "type": "number",
      "description": "目標牆的 Element ID"
    },
    "wallLinkId": {
      "type": "number",
      "description": "牆所在的連結模型 LinkInstanceId（來自 get_linked_models）。主模型的牆不需傳此參數。"
    },
    "offset": {
      "type": "number",
      "description": "剖面線距牆面的偏移量（mm），預設 1mm（緊貼牆面）",
      "default": 1
    },
    "splitLongWalls": {
      "type": "boolean",
      "description": "長牆分割：相鄰開孔間距 > 3m 時各自建立獨立剖面視圖",
      "default": true
    },
    "viewNamePrefix": {
      "type": "string",
      "description": "視圖名稱前綴，預設「牆面套管剖面」",
      "default": "牆面套管剖面"
    },
    "autoCrop": {
      "type": "boolean",
      "description": "是否依開孔實際範圍自動裁剪剖面框（上下加 marginVertical，左右加 marginHorizontal）",
      "default": true
    },
    "directionLogic": {
      "type": "string",
      "enum": [
        "auto",
        "inside_out",
        "outside_in"
      ],
      "description": "剖面觀察方向。auto = 自動找房間側朝外看；inside_out = 從內向外；outside_in = 從外向內",
      "default": "auto"
    },
    "scale": {
      "type": "number",
      "description": "視圖比例尺（如 50 = 1:50），預設 50",
      "default": 50
    },
    "marginHorizontal": {
      "type": "number",
      "description": "左右留白（mm），預設 500",
      "default": 500
    },
    "marginVertical": {
      "type": "number",
      "description": "上下留白（mm），預設 200",
      "default": 200
    }
  },
  "required": [
    "wallId"
  ]
}

{
  "title": "依牆面開孔位置自動建立平行剖面視圖",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "filledRegionTypeName": {
      "type": "string",
      "description": "Name of the FilledRegionType to use for the stickers.",
      "default": "深灰色"
    }
  }
}

{
  "title": "Create RC (reinforced-concrete) filled-region stickers in th",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewId": {
      "type": "number",
      "description": "Target view ElementId. Defaults to the active view when omitted."
    },
    "roomIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Optional explicit Room ElementId list. When omitted, rooms in the view are used."
    },
    "clearExisting": {
      "type": "boolean",
      "description": "Remove previously created room filled regions (matched by marker) before creating new ones."
    },
    "marker": {
      "type": "string",
      "description": "Marker/comment tag written onto created filled regions so they can be cleared later."
    },
    "filledRegionTypeName": {
      "type": "string",
      "description": "Name of the FilledRegionType to use."
    },
    "transparency": {
      "type": "number",
      "description": "Fill transparency, 0-100."
    },
    "color": {
      "type": "object",
      "description": "Fill colour as RGB components (0-255).",
      "properties": {
        "r": {
          "type": "number"
        },
        "g": {
          "type": "number"
        },
        "b": {
          "type": "number"
        }
      }
    }
  }
}

{
  "title": "Create filled regions covering rooms in a view (e.g. to colo",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "wallId": {
      "type": "number",
      "description": "目標牆的 Element ID"
    },
    "viewName": {
      "type": "string",
      "description": "視圖名稱",
      "default": "排煙檢討剖面"
    },
    "offset": {
      "type": "number",
      "description": "剖面距牆偏移（mm），預設 1000",
      "default": 1000
    },
    "scale": {
      "type": "number",
      "description": "比例尺（如 50 = 1:50），預設 50",
      "default": 50
    }
  },
  "required": [
    "wallId"
  ]
}

{
  "title": "建立剖面視圖，面向指定牆面",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "titleBlockId": {
      "type": "number",
      "description": "圖框類型的 Element ID"
    },
    "sheets": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "number": {
            "type": "string",
            "description": "圖紙編號（如 A101）"
          },
          "name": {
            "type": "string",
            "description": "圖紙名稱（如 一樓平面圖）"
          }
        },
        "required": [
          "number",
          "name"
        ]
      },
      "description": "要建立的圖紙清單"
    }
  },
  "required": [
    "titleBlockId",
    "sheets"
  ]
}

{
  "title": "依據指定的清單批次建立空的圖紙",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "stairId": {
      "type": "number",
      "description": "樓梯的 Element ID"
    },
    "viewName": {
      "type": "string",
      "description": "剖面視圖名稱（預設：樓梯檢核剖面）"
    },
    "offset": {
      "type": "number",
      "description": "剖面偏移距離（mm，預設 1500）"
    },
    "scale": {
      "type": "number",
      "description": "視圖比例（預設 50）"
    }
  },
  "required": [
    "stairId"
  ]
}

{
  "title": "建立樓梯法規檢核剖面視圖（自動判斷長向走向以顯示踏板剖面）",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewId": {
      "type": "number",
      "description": "目標視圖的 Element ID"
    },
    "x": {
      "type": "number",
      "description": "文字 X 座標 (mm)"
    },
    "y": {
      "type": "number",
      "description": "文字 Y 座標 (mm)"
    },
    "leaderX": {
      "type": "number",
      "description": "引線指向的 X 座標 (mm)"
    },
    "leaderY": {
      "type": "number",
      "description": "引線指向的 Y 座標 (mm)"
    },
    "text": {
      "type": "string",
      "description": "標註文字內容"
    }
  },
  "required": [
    "viewId",
    "x",
    "y",
    "leaderX",
    "leaderY",
    "text"
  ]
}

{
  "title": "建立帶有引線的文字標註 (專用於樓梯檢核標示違規位置)",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewId": {
      "type": "number",
      "description": "目標視圖的 Element ID"
    },
    "x": {
      "type": "number",
      "description": "X 座標（mm）"
    },
    "y": {
      "type": "number",
      "description": "Y 座標（mm）"
    },
    "text": {
      "type": "string",
      "description": "文字內容"
    },
    "textSize": {
      "type": "number",
      "description": "文字大小（mm），預設 2.5",
      "default": 2.5
    }
  },
  "required": [
    "viewId",
    "x",
    "y",
    "text"
  ]
}

{
  "title": "在視圖上建立文字標註",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "明細表名稱"
    },
    "category": {
      "type": "string",
      "description": "品類名稱（如：'Walls', 'Rooms', 'Pipes'）"
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "欄位名稱列表"
    }
  },
  "required": [
    "name"
  ]
}

{
  "title": "在 Revit 中建立一個新的視圖明細表（Schedule/Quantities）",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "startX": {
      "type": "number",
      "description": "起點 X 座標（公釐）"
    },
    "startY": {
      "type": "number",
      "description": "起點 Y 座標（公釐）"
    },
    "endX": {
      "type": "number",
      "description": "終點 X 座標（公釐）"
    },
    "endY": {
      "type": "number",
      "description": "終點 Y 座標（公釐）"
    },
    "height": {
      "type": "number",
      "description": "牆高度（公釐）",
      "default": 3000
    },
    "wallType": {
      "type": "string",
      "description": "牆類型名稱（選填）"
    }
  },
  "required": [
    "startX",
    "startY",
    "endX",
    "endY"
  ]
}

{
  "title": "在 Revit 中建立一面牆",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "wallId": {
      "type": "number",
      "description": "要放置窗的牆 ID"
    },
    "locationX": {
      "type": "number",
      "description": "窗在牆上的位置 X 座標（公釐）"
    },
    "locationY": {
      "type": "number",
      "description": "窗在牆上的位置 Y 座標（公釐）"
    },
    "windowType": {
      "type": "string",
      "description": "窗類型名稱（選填）"
    },
    "sourceElementId": {
      "type": "number",
      "description": "來源窗 ID（選填，用於複製其類型、參數與朝向）"
    }
  },
  "required": [
    "wallId",
    "locationX",
    "locationY"
  ]
}

{
  "title": "在指定的牆上建立窗",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "description": "'pipe' 或 'duct'（必填）。"
    },
    "segmentName": {
      "type": "string",
      "description": "target='pipe' 時必填,要精確到單一管段,例如 'Copper - K'。比對到多個會直接報錯要求更精確。"
    },
    "shape": {
      "type": "string",
      "description": "target='duct' 時必填:Round / Rectangular / Oval。"
    },
    "add": {
      "type": "array",
      "description": "要新增的尺寸。pipe 需 nominal_mm + inner_mm + outer_mm;duct 只需 nominal_mm。usedInSizeLists / usedInSizing 省略時預設 true。",
      "items": {
        "type": "object",
        "properties": {
          "nominal_mm": {
            "type": "number",
            "description": "公稱尺寸(mm)"
          },
          "inner_mm": {
            "type": "number",
            "description": "內徑(mm)。target='pipe' 時必填。"
          },
          "outer_mm": {
            "type": "number",
            "description": "外徑(mm)。target='pipe' 時必填。"
          },
          "usedInSizeLists": {
            "type": "boolean",
            "description": "是否出現在尺寸下拉選單,預設 true。"
          },
          "usedInSizing": {
            "type": "boolean",
            "description": "是否參與自動定尺寸,預設 true。"
          }
        },
        "required": [
          "nominal_mm"
        ]
      }
    },
    "remove": {
      "type": "array",
      "description": "要移除的公稱尺寸(mm)清單。模型中仍在使用的會被擋下並回報使用者。",
      "items": {
        "type": "number"
      }
    },
    "dryRun": {
      "type": "boolean",
      "description": "預設 true,只回傳計畫不改任何東西。確認清單無誤後才帶 false 執行。"
    },
    "ignoreUnattributedFittings": {
      "type": "boolean",
      "description": "管配件沒有 PipeSegment 屬性,只能比對直徑,預設會保守擋下相符的尺寸。設 true 可略過這層保護（僅在你確認過那些配件不屬於此 segment 時使用）。預設 false。"
    }
  },
  "required": [
    "target"
  ]
}

{
  "title": "增減 MEP 尺寸目錄（會修改模型設定）",
  "readOnlyHint": false,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "viewportId": {
      "type": "number",
      "description": "Viewport ElementId（直接指定 viewport）"
    },
    "viewId": {
      "type": "number",
      "description": "View ElementId（會自動找對應 viewport）"
    }
  }
}

{
  "title": "診斷工具：dump 一個 viewport 的所有座標資料（boxOutline、cropbox、view origin",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewId": {
      "type": "number",
      "description": "目標視圖 ID（選填，預設使用當前 active view）"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "All",
          "DetailComponent",
          "DetailCurve",
          "FilledRegion",
          "TextNote",
          "Dimension"
        ]
      },
      "description": "處理的類別清單（選填，預設 ['All']）"
    },
    "tolerance": {
      "type": "number",
      "description": "位置比對容差（公釐），預設 1.0",
      "default": 1
    },
    "dryRun": {
      "type": "boolean",
      "description": "true=只列清單不刪除（預設）；false=實際刪除 group 外的重複副本",
      "default": true
    }
  }
}

{
  "title": "找出當前視圖（或指定視圖）中重複的 detail element（同 Type + 位置量化後相同），保留 Detail",
  "readOnlyHint": false,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "elementId": {
      "type": "number",
      "description": "要刪除的元素 ID"
    }
  },
  "required": [
    "elementId"
  ]
}

{
  "title": "依 Element ID 刪除 Revit 元素",
  "readOnlyHint": false,
  "destructiveHint": true
}

{
  "type": "object",
  "properties": {
    "mepSource": {
      "type": "object",
      "description": "MEP 管線來源（通常來自連結模型）",
      "properties": {
        "linkInstanceId": {
          "type": "number",
          "description": "連結模型 ID；為 0 或省略時從主模型讀取"
        },
        "category": {
          "type": "string",
          "description": "單一品類名稱（例 Pipes）；與 categories 擇一"
        },
        "categories": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "品類清單（例 [Pipes, Ducts, CableTrays]）；預設為這三類"
        },
        "filters": {
          "type": "array",
          "description": "參數過濾（例 System Type contains 消防、Size greater_than 100）",
          "items": {
            "type": "object",
            "properties": {
              "field": {
                "type": "string"
              },
              "operator": {
                "type": "string"
              },
              "value": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "csaSource": {
      "type": "object",
      "description": "CSA 結構來源（通常為主模型）",
      "properties": {
        "linkInstanceId": {
          "type": "number",
          "description": "連結模型 ID；為 0 或省略時從主模型讀取"
        },
        "categories": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "結構品類清單；預設 [Walls, Floors, StructuralFraming, StructuralColumns]"
        }
      }
    },
    "options": {
      "type": "object",
      "description": "運算選項",
      "properties": {
        "useCoarseFilter": {
          "type": "boolean",
          "description": "是否啟用 BoundingBox 粗篩",
          "default": true
        },
        "tolerance": {
          "type": "number",
          "description": "公差（mm）",
          "default": 0
        },
        "levelFilter": {
          "type": "string",
          "description": "樓層名稱過濾（選填）"
        },
        "maxResults": {
          "type": "number",
          "description": "最大回傳碰撞數",
          "default": 1000
        }
      }
    }
  },
  "required": [
    "mepSource"
  ]
}

{
  "title": "執行 MEP 管線（連結模型）與 CSA 結構體（主模型）的碰撞偵測，使用 Curve-to-Solid 策略：MEP",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewId": {
      "type": "number",
      "description": "既有帷幕立面 ViewSection ElementId；未提供時使用目前作用中立面。"
    },
    "wallId": {
      "type": "number",
      "description": "帷幕牆 ElementId；level_offset 未提供時必須在作用中立面唯一選取一道帷幕牆，禁止使用第一道牆 fallback。其他模式維持既有 fallback。"
    },
    "dimensionTypeId": {
      "type": "number",
      "description": "供診斷使用的 DimensionType ElementId。"
    },
    "dimensionTypeName": {
      "type": "string",
      "description": "供診斷使用的 DimensionType 名稱。"
    },
    "testMode": {
      "type": "string",
      "enum": [
        "geometry_reference",
        "reference_plane_fallback",
        "both",
        "level_offset"
      ],
      "description": "level_offset 會測試 inactive/active 下的 Level plane、Invisible DetailCurve 兩／三 Reference 尺寸及完整 production path；預設 both。",
      "default": "both"
    },
    "rollback": {
      "type": "boolean",
      "description": "是否 rollback 診斷元素，預設 true；level_offset 固定強制 rollback，忽略 false。",
      "default": true
    },
    "dimensionOffsetMm": {
      "type": "number",
      "description": "DimensionType 無法提供有效輔助線長度時使用的帷幕至內層網格尺寸線距離 fallback，單位 mm，預設 300。正常情況會採用（輔助線長度 + 圖紙 3 mm）乘以視圖比例。",
      "default": 300
    },
    "dimensionStackOffsetMm": {
      "type": "number",
      "description": "DimensionType 無法提供有效輔助線長度時使用的內外層尺寸間距 fallback，單位 mm，預設 250。正常情況會採用輔助線長度乘以視圖比例。",
      "default": 250
    },
    "verifyAssociationByMove": {
      "type": "boolean",
      "description": "是否在 rollback transaction 內移動一條 CurtainGridLine 10 mm，驗證尺寸段值與 reference 關聯，預設 true。",
      "default": true
    },
    "verbose": {
      "type": "boolean",
      "description": "是否回傳完整逐筆診斷欄位，預設 false。false 時只回頂層統計與 AssociationMoveTest/Failures，CurtainGridLineReferenceSamples/CurtainGridLineReferenceFailures/BackgroundAttemptedDimensions/ActiveViewProfileAttempts/AttemptedDimensions 收斂為筆數（不逐筆展開）；true 時維持既有完整輸出。testMode=level_offset 的 runtime 矩陣不受此參數影響，一律回傳完整內容。",
      "default": false
    }
  }
}

{
  "title": "非破壞診斷帷幕立面的尺寸標示；可比較 CurtainGridLine profiles，或以 level_offset",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "wallId": {
      "type": "number",
      "description": "要診斷的帷幕牆 Wall ElementId。"
    },
    "placementViewId": {
      "type": "number",
      "description": "放置暫時 ElevationMarker 的 ViewPlan ElementId；優先於 placementViewName。"
    },
    "placementViewName": {
      "type": "string",
      "description": "放置暫時 ElevationMarker 的 ViewPlan 名稱。"
    },
    "scale": {
      "type": "number",
      "description": "暫時立面視圖比例，預設 50。",
      "default": 50
    },
    "offsetMm": {
      "type": "number",
      "description": "暫時 marker 放在 wall.Orientation 側的距離，單位 mm，預設 1500。",
      "default": 1500
    },
    "includeCropDiagnostics": {
      "type": "boolean",
      "description": "Include non-mutating crop diagnostics for the temporary elevation view. Default: false",
      "default": false
    }
  },
  "required": [
    "wallId"
  ]
}

{
  "title": "非破壞診斷指定帷幕牆的立面方向判定流程；以 rollback transaction 建立暫時 ElevationMar",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "wallIds": {
      "type": "array",
      "description": "Optional curtain wall ElementIds. When omitted, all walls with CurtainGrid != null are diagnosed.",
      "items": {
        "type": "number"
      }
    },
    "placementViewId": {
      "type": "number",
      "description": "Optional ViewPlan ElementId used for temporary ElevationMarker placement."
    },
    "placementViewName": {
      "type": "string",
      "description": "Optional ViewPlan name used for temporary ElevationMarker placement."
    },
    "scale": {
      "type": "number",
      "description": "Temporary elevation scale. Default: 50",
      "default": 50
    },
    "offsetMm": {
      "type": "number",
      "description": "Candidate marker offset from wall centerline in millimeters. Default: 1500",
      "default": 1500
    },
    "includeTemporaryMarker": {
      "type": "boolean",
      "description": "Create temporary ElevationMarker/ViewSection inside rollback transactions to read ViewDirection. Default: true",
      "default": true
    },
    "includeCropDiagnostics": {
      "type": "boolean",
      "description": "Include non-mutating crop diagnostics for the auto-resolved temporary elevation view. Requires includeTemporaryMarker. Default: false",
      "default": false
    },
    "knownExteriorSideByWallId": {
      "type": "object",
      "description": "Optional truth labels by wall id. Value must be 'api_orientation' or 'opposite_orientation'.",
      "additionalProperties": {
        "type": "string",
        "enum": [
          "api_orientation",
          "opposite_orientation"
        ]
      }
    }
  }
}

{
  "title": "Batch, non-destructive curtain wall elevation direction diag",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "targetType": {
      "type": "string",
      "enum": [
        "door",
        "window"
      ],
      "description": "目標類型：door 產生門圖例，window 產生窗圖例。"
    },
    "mode": {
      "type": "string",
      "enum": [
        "list",
        "create",
        "update"
      ],
      "description": "list 列出型別；create 建立新 Legend；update 更新既有 Legend。"
    },
    "layoutDirection": {
      "type": "string",
      "enum": [
        "horizontal",
        "vertical"
      ],
      "description": "create/update 的排列方向。"
    },
    "maxPerLine": {
      "type": "number",
      "minimum": 1,
      "description": "create/update 每列或每欄最多放幾個項目，必須大於等於 1。"
    },
    "seedLegendViewId": {
      "type": "number",
      "description": "create 使用的 seed Legend 視圖 ID。若缺少，工具會要求先呼叫 list_seeds 讓使用者選擇。"
    },
    "legendViewId": {
      "type": "number",
      "description": "update 要更新的既有 Legend 視圖 ID。若缺少，工具會要求先呼叫 list_legend_views 讓使用者選擇。"
    },
    "dimensionTypeId": {
      "type": "number",
      "description": "門窗圖例尺寸標註使用的 DimensionType ID。若缺少，工具會要求先呼叫 list_dimension_types 讓使用者選擇。"
    }
  },
  "required": [
    "mode"
  ]
}

{
  "title": "門窗圖例工具",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "sourceViewIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Source view ElementId(s) to duplicate. Accepts aliases 'viewIds' or a single 'sourceViewId'. Required (the tool errors if none resolve)."
    },
    "targetNames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional new names for the duplicated views, positionally matched to sourceViewIds. Accepts aliases 'newNames' / 'targetName'."
    },
    "suffix": {
      "type": "string",
      "description": "Name suffix appended when a target name is not supplied for a view.",
      "default": "高於6m牆標示(W)"
    },
    "copyCropFromSource": {
      "type": "boolean",
      "description": "Copy the crop box / crop region from the source view onto the duplicate.",
      "default": true
    },
    "setActiveLast": {
      "type": "boolean",
      "description": "Activate the last duplicated view when finished.",
      "default": false
    }
  }
}

{
  "title": "Duplicate one or more views with detailing (ViewDuplicateOpt",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "clashData": {
      "type": "object",
      "description": "detect_clashes 的完整回傳物件（含 Clashes 陣列）"
    },
    "format": {
      "type": "string",
      "description": "輸出格式：csv / json / both",
      "default": "csv"
    },
    "outputPath": {
      "type": "string",
      "description": "自訂輸出路徑（不含副檔名）；省略則輸出到桌面"
    },
    "reportTitle": {
      "type": "string",
      "description": "報表標題",
      "default": "MEP-CSA 碰撞偵測報告"
    }
  },
  "required": [
    "clashData"
  ]
}

{
  "title": "匯出 detect_clashes 結果為報表",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "outputFolder": {
      "type": "string",
      "description": "輸出根資料夾絕對路徑,例如 C:\\Users\\xxx\\Desktop\\MEP管元件庫。不存在會自動建立。"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "要匯出的 BuiltInCategory 名稱清單(如 OST_PipeFitting、OST_PipeAccessory)。省略則預設這兩類。"
    },
    "subFolderBySeries": {
      "type": "boolean",
      "description": "是否在類別資料夾下再依族群名稱系列建立子資料夾(預設 false,只依類別分層)。"
    },
    "overwrite": {
      "type": "boolean",
      "description": "目標 .rfa 已存在時是否覆寫(預設 true)。"
    }
  },
  "required": [
    "outputFolder"
  ]
}

{
  "title": "把專案中已載入的可編輯族群另存為 .rfa 檔到指定資料夾,建立可重用元件庫",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "levelName": {
      "type": "string",
      "description": "樓層名稱"
    },
    "ceilingHeightSource": {
      "type": "string",
      "enum": [
        "room_parameter",
        "ceiling_element"
      ],
      "default": "room_parameter"
    },
    "outputPath": {
      "type": "string",
      "description": "輸出路徑（選填）"
    }
  },
  "required": [
    "levelName"
  ]
}

{
  "title": "匯出排煙窗檢討 Excel 報告（.xlsx），含樓層總覽、房間明細、窗戶明細、改善建議、§101補充檢討（排風量提醒+",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "elementId": {
      "type": "number",
      "description": "要翻轉的元素 ID"
    },
    "flipType": {
      "type": "string",
      "description": "翻轉類型: 'facing' (預設，依牆為軸翻轉) 或是 'hand' (左右翻轉)",
      "default": "facing"
    }
  },
  "required": [
    "elementId"
  ]
}

{
  "title": "翻轉指定的 Revit 建築元素（例如門或窗）",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewId": {
      "type": "number",
      "description": "The view Element ID (Optional, defaults to active view)"
    }
  }
}

{
  "title": "[Phase 1: Exploration] Get all categories and their element",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "取得目前開啟的視圖資訊，包含視圖名稱、類型、樓層等",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "取得專案中所有網格線（Grid）的資訊",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "取得專案中所有樓層的清單，包括樓層名稱和標高",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "取得專案中所有的圖紙清單，包含 ID、編號與名稱",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewType": {
      "type": "string",
      "description": "視圖類型篩選：FloorPlan、CeilingPlan、ThreeD、Section、Elevation"
    },
    "levelName": {
      "type": "string",
      "description": "樓層名稱篩選（選填）"
    }
  }
}

{
  "title": "取得專案中所有視圖的清單，包含平面圖、天花圖、3D視圖、剖面圖等",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "The category internal name (e.g., 'Walls', 'Windows')"
    }
  },
  "required": [
    "category"
  ]
}

{
  "title": "[Phase 2: Alignment] Get all parameter names for a specific",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "material": {
      "type": "string",
      "description": "篩選材質（選填）"
    }
  }
}

{
  "title": "取得專案中所有可用的柱類型",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "elementId": {
      "type": "number",
      "description": "要查詢的 MEP 元素 ID"
    }
  },
  "required": [
    "elementId"
  ]
}

{
  "title": "取得 MEP 元素（管、風管、線管等）的接頭（Connector）資訊，包含座標、連接狀態、形狀等",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "取得專案中所有可用的帷幕牆面板類型",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "elementId": {
      "type": "number",
      "description": "帷幕牆的 Element ID（選填，若不指定則使用目前選取的元素）"
    }
  }
}

{
  "title": "取得帷幕牆詳細資訊，包含 Grid 排列、面板尺寸、面板類型分佈等",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "familyName": {
      "type": "string",
      "description": "族群名稱篩選（選填，模糊比對）"
    }
  }
}

{
  "title": "查詢專案中的詳圖元件（Detail Components）實例",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "掃描目前 Revit 平面視圖中所有 CAD 匯入/連結的圖層名稱，回傳圖層清單並自動推薦可能包含樑、標註文字的圖層",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "掃描目前 Revit 平面視圖中所有 CAD 匯入/連結的圖層名稱，回傳圖層清單並自動推薦可能包含柱子的圖層",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "elementId": {
      "type": "number",
      "description": "元素 ID"
    },
    "linkInstanceId": {
      "type": "number",
      "description": "若為連結模型元素，需提供連結實體 ID（選填）"
    },
    "geometryType": {
      "type": "string",
      "description": "幾何類型：centerline / boundingbox / solid / all",
      "default": "centerline"
    },
    "applyTransform": {
      "type": "boolean",
      "description": "是否套用連結模型 Transform",
      "default": true
    }
  },
  "required": [
    "elementId"
  ]
}

{
  "title": "抽取元素的幾何資訊，支援主模型或連結模型元素",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "elementId": {
      "type": "number",
      "description": "元素 ID"
    }
  },
  "required": [
    "elementId"
  ]
}

{
  "title": "取得指定元素的詳細資訊，包括參數、幾何資訊等",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "The category internal name"
    },
    "fieldName": {
      "type": "string",
      "description": "The parameter name"
    },
    "maxSamples": {
      "type": "number",
      "description": "Max samples to analyze (Default: 500)",
      "default": 500
    }
  },
  "required": [
    "category",
    "fieldName"
  ]
}

{
  "title": "[Optional Phase 2.5] Get the distribution of existing values",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "家具類別篩選（選填）"
    }
  }
}

{
  "title": "取得專案中已載入的家具類型清單",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "取得目前專案中可用的線型 (GraphicsStyles)，例如：虛線、細線等",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "列出當前專案中所有連結模型（RevitLinkInstance），含 LinkInstanceId、檔名、路徑、載入狀態",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "summaryOnly": {
      "type": "boolean",
      "description": "只回傳每個管段/風管形狀的統計（尺寸筆數、勾選筆數），不逐筆列出尺寸，預設 false。全案盤點建議先用這個。"
    },
    "segmentName": {
      "type": "string",
      "description": "只回傳名稱含此字串的管段（不分大小寫），例如 'Copper'、'PVC'、'Copper - K'。給了這個參數時 includeDuct 預設變 false。"
    },
    "includeDuct": {
      "type": "boolean",
      "description": "是否一併回傳風管尺寸表（Round / Rectangular / Oval）。預設 true；但有給 segmentName 時預設 false。"
    },
    "usedOnly": {
      "type": "boolean",
      "description": "只列出有勾選 Used in Size Lists 或 Used in Sizing 的尺寸，預設 false（全列）。"
    }
  }
}

{
  "title": "一次盤點整個專案的 MEP Segment 與 Size 目錄（唯讀）",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "includeFluids": {
      "type": "boolean",
      "description": "是否回傳流體類型清單（含是否被使用、溫度筆數），預設 true。"
    },
    "includeFluidTemperatures": {
      "type": "boolean",
      "description": "是否逐筆列出每個流體的溫度/黏度/密度表，預設 false（表可能很長，預設只給筆數）。"
    }
  }
}

{
  "title": "讀取 Manage → MEP Settings 裡「尺寸目錄以外」的所有設定頁（唯讀）：Duct/Pipe 的 Ang",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "scope": {
      "type": "string",
      "description": "'both'（預設）、'duct' 或 'pipe'。"
    },
    "shape": {
      "type": "string",
      "description": "只看某個風管形狀：Round / Rectangular / Oval（選填）。"
    },
    "segmentName": {
      "type": "string",
      "description": "只看名稱含此字串的管段，例如 'Copper'（選填）。"
    },
    "includeUnused": {
      "type": "boolean",
      "description": "是否一併列出用量為 0 的目錄尺寸（可刪候選），預設 true。"
    },
    "includeElementIds": {
      "type": "boolean",
      "description": "是否附上使用該尺寸的元件 ID 樣本，方便追查是誰擋住刪除，預設 false。"
    },
    "maxElementIdsPerSize": {
      "type": "number",
      "description": "每個尺寸最多附幾個元件 ID 樣本，預設 5。"
    }
  }
}

{
  "title": "盤點模型裡「真的有元件在用」哪些 MEP 尺寸（唯讀）",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "取得目前開啟的 Revit 專案基本資訊，包括專案名稱、建築物名稱、業主等",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "level": {
      "type": "string",
      "description": "樓層名稱（選填）"
    }
  }
}

{
  "title": "取得房間的採光資訊，包含居室面積、外牆開口面積、採光比例",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "level": {
      "type": "string",
      "description": "Optional level name or unambiguous partial level name. If omitted, all placed rooms are considered."
    },
    "roomIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Optional explicit Room ElementId list. Overrides level filtering for rooms."
    },
    "includeUnnamed": {
      "type": "boolean",
      "description": "Whether unnamed placed rooms should be included.",
      "default": true
    },
    "includeDoorDetails": {
      "type": "boolean",
      "description": "Whether to include door-level detail rows under each room.",
      "default": true
    },
    "primaryRoomSource": {
      "type": "string",
      "enum": [
        "toRoom",
        "fromRoom",
        "auto"
      ],
      "description": "Which Revit door room relationship counts as the primary room. Default toRoom counts each door once using ToRoom, then falls back to FromRoom.",
      "default": "toRoom"
    }
  }
}

{
  "title": "Count doors by room",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "roomId": {
      "type": "number",
      "description": "房間 Element ID（選填）"
    },
    "roomName": {
      "type": "string",
      "description": "房間名稱（選填）"
    }
  }
}

{
  "title": "取得房間詳細資訊，包含中心點座標和邊界範圍",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "roomId": {
      "type": "number",
      "description": "房間 Element ID（選填）"
    },
    "roomName": {
      "type": "string",
      "description": "房間名稱篩選（選填）"
    },
    "level": {
      "type": "string",
      "description": "樓層名稱 — 計算該層所有房間（選填）"
    },
    "includeBreakdown": {
      "type": "boolean",
      "description": "是否包含各牆面詳細資訊（預設 true）",
      "default": true
    },
    "subtractOpenings": {
      "type": "boolean",
      "description": "是否扣除門窗開口面積（預設 true）",
      "default": true
    },
    "includeFinishLayers": {
      "type": "boolean",
      "description": "是否偵測房間內的粉刷層/面飾層並建立明細表、匯出 Excel。必須明確指定 true 或 false。"
    },
    "outputPath": {
      "type": "string",
      "description": "Excel 匯出路徑（選填，預設為專案目錄）"
    },
    "defaultFloorFinish": {
      "type": "string",
      "description": "未偵測到地板粉刷層時的預設類型標記（Type Mark）。留空表示不填。"
    },
    "defaultWallFinish": {
      "type": "string",
      "description": "未偵測到牆面粉刷層時的預設類型標記（Type Mark）。留空表示不填。"
    },
    "defaultCeilingFinish": {
      "type": "string",
      "description": "未偵測到天花粉刷層時的預設類型標記（Type Mark）。留空表示不填。"
    }
  },
  "required": [
    "includeFinishLayers"
  ]
}

{
  "title": "計算房間內部表面積（牆面、地板、天花板），支援門窗開口扣除",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "level": {
      "type": "string",
      "description": "Optional level name or unambiguous partial level name. If omitted, all placed rooms are considered."
    },
    "roomIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Optional explicit Room ElementId list. Overrides level filtering for rooms."
    },
    "includeUnnamed": {
      "type": "boolean",
      "description": "Whether unnamed placed rooms should be included.",
      "default": true
    },
    "includeWindowDetails": {
      "type": "boolean",
      "description": "Whether to include window-level detail rows under each room.",
      "default": true
    },
    "primaryRoomSource": {
      "type": "string",
      "enum": [
        "toRoom",
        "fromRoom",
        "auto"
      ],
      "description": "Which Revit window room relationship counts as the primary room. Default toRoom counts each window once using ToRoom, then falls back to FromRoom.",
      "default": "toRoom"
    }
  }
}

{
  "title": "Count windows by room",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "level": {
      "type": "string",
      "description": "樓層名稱（如：1F、Level 1）"
    },
    "includeUnnamed": {
      "type": "boolean",
      "description": "是否包含未命名的房間",
      "default": true
    }
  },
  "required": [
    "level"
  ]
}

{
  "title": "取得指定樓層的所有房間清單，包含名稱、編號、面積、用途等",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "取得使用者目前在 Revit 中選取的所有元素的基本資訊（ID、名稱、品類）",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "sheetId": {
      "type": "number",
      "description": "圖紙的 Element ID（選填，不指定則使用當前作用圖紙）"
    }
  }
}

{
  "title": "取得指定圖紙上所有視埠的詳細資訊，包含中心點座標、邊界框（MinX/MinY/MaxX/MaxY）、寬度與高度（mm）",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "stairId": {
      "type": "number",
      "description": "樓梯的 Element ID"
    }
  },
  "required": [
    "stairId"
  ]
}

{
  "title": "取得樓梯梯段的真實實測寬度（透過 StairsRun.ActualRunWidth 屬性）",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "取得專案中所有可用的圖框（Title Blocks）類型",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "類別名稱：Walls, Floors, Columns, StructuralFraming"
    },
    "excludeCurtainWalls": {
      "type": "boolean",
      "description": "是否排除帷幕牆（預設 true，僅對 Walls 類別有效）",
      "default": true
    }
  },
  "required": [
    "category"
  ]
}

{
  "title": "查詢指定類別中所有元素類型及其目前材質資訊",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "includeDetails": {
      "type": "boolean",
      "description": "是否包含詳細設定",
      "default": true
    }
  }
}

{
  "title": "取得專案中所有視圖樣版的完整設定",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "取得專案中所有視埠（Viewport）與圖紙（Sheet）的對應關係",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "wallId": {
      "type": "number",
      "description": "牆的 Element ID"
    }
  },
  "required": [
    "wallId"
  ]
}

{
  "title": "取得牆的詳細資訊，包含厚度、長度、高度、位置線座標等",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "search": {
      "type": "string",
      "description": "關鍵字篩選（選填）"
    }
  }
}

{
  "title": "取得專案中所有可用的牆類型，包含名稱和 Element ID",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "toposolidId": {
      "type": "integer",
      "description": "要整地的 Toposolid 元素 ID"
    },
    "floorIds": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "integer"
      },
      "description": "作為整地範圍來源的樓板元素 ID；至少提供一筆"
    },
    "mode": {
      "type": "string",
      "enum": [
        "footprint_only"
      ],
      "default": "footprint_only",
      "description": "整地模式；本次只接受 footprint_only"
    },
    "targetFace": {
      "type": "string",
      "enum": [
        "bottom"
      ],
      "default": "bottom",
      "description": "樓板目標面；本次只接受 bottom"
    },
    "allowPhaseSetup": {
      "type": "boolean",
      "default": true,
      "description": "是否自動設定整地所需階段（預設 true）：原地形會改為較早階段建立、於目前階段拆除，設計副本建立於目前階段——與 Revit 原生整地行為一致。設為 false 時不修改階段，僅回報所需變更。"
    },
    "updateExisting": {
      "type": "boolean",
      "enum": [
        false
      ],
      "default": false,
      "description": "是否更新既有整地結果；本次只接受 false"
    }
  },
  "required": [
    "toposolidId",
    "floorIds"
  ]
}

{
  "title": "依指定樓板底面的水平投影範圍整平 Toposolid；本次僅支援 footprint_only 模式",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "elementId": {
      "type": "number",
      "description": "要隱藏的單一元素 ID"
    },
    "elementIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "批次隱藏的元素 ID 陣列"
    },
    "viewId": {
      "type": "number",
      "description": "視圖 ID（若不指定則使用當前視圖）"
    }
  }
}

{
  "title": "在指定視圖中隱藏元素",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "filePath": {
      "type": "string",
      "description": "Excel 檔案絕對路徑（.xlsx）"
    },
    "sheets": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "選填：只匯入指定名稱的 worksheet（不分大小寫）。不給=匯入所有有列印範圍的 sheet。"
    },
    "namingPattern": {
      "type": "string",
      "description": "Drafting View 命名樣式，可用 {name} 取代為 worksheet 名。預設 '{name}'。例：'面積計算表_{name}'。"
    },
    "overwrite": {
      "type": "boolean",
      "description": "同名 view 已存在時是否刪除重建。預設 true。",
      "default": true
    }
  },
  "required": [
    "filePath"
  ]
}

{
  "title": "原子化命令：讀 Excel → 對每張有列印範圍的 worksheet 建立 Drafting View → 畫框線（m",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "levels": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "要處理的樓層名稱列表，例如 [\"2F\", \"3F\"]。省略或空陣列代表處理全部樓層。"
    }
  }
}

{
  "title": "將指定樓層的牆，其頂部與上方的樓板、天花板、結構樑做幾何接合 (JoinGeometry)",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "filePath": {
      "type": "string",
      "description": "CAD 檔案絕對路徑（.dwg 或 .dxf）"
    },
    "viewId": {
      "type": "number",
      "description": "目標視圖的 Element ID（與 viewName 二擇一）"
    },
    "viewName": {
      "type": "string",
      "description": "目標視圖名稱（與 viewId 二擇一）。找不到完全相符時會自動 fallback 到包含搜尋；多筆相符會回傳候選清單。"
    },
    "thisViewOnly": {
      "type": "boolean",
      "default": true,
      "description": "true=連結僅在指定視圖可見（最常見的「連結到指定視圖」語意）；false=全模型可見，View 僅用於 Level 參考。3D 視圖必須設 false。"
    },
    "placement": {
      "type": "string",
      "enum": [
        "Origin",
        "Centered",
        "Site",
        "Shared",
        "DefaultLocation"
      ],
      "default": "Origin",
      "description": "對齊模式。Origin=自動原點對原點；Centered=置中；Site=站點；Shared=共用座標。"
    },
    "unit": {
      "type": "string",
      "enum": [
        "Default",
        "Foot",
        "Inch",
        "Meter",
        "Decimeter",
        "Centimeter",
        "Millimeter",
        "Custom"
      ],
      "default": "Default",
      "description": "DWG 單位。Default=使用 DWG 內定單位。"
    },
    "colorMode": {
      "type": "string",
      "enum": [
        "BlackAndWhite",
        "Preserved",
        "InvertColors"
      ],
      "default": "BlackAndWhite",
      "description": "顏色模式。BlackAndWhite 為 CAD 底圖最常見設定。"
    },
    "visibleLayersOnly": {
      "type": "boolean",
      "default": false,
      "description": "true=只匯入 DWG 中可見的圖層。"
    },
    "orientToView": {
      "type": "boolean",
      "default": false,
      "description": "true=方向對齊視圖。需要 thisViewOnly=false。"
    },
    "autoCorrectAlmostVHLines": {
      "type": "boolean",
      "default": true,
      "description": "自動將近似水平/垂直的線校正為精準水平/垂直。"
    },
    "customScale": {
      "type": "number",
      "description": "自訂縮放係數（>0），會覆蓋 unit。不填或 ≤0 則沿用 unit。"
    },
    "referencePoint": {
      "type": "object",
      "description": "插入點（公釐，會自動轉換為 Revit 內部單位英尺）。",
      "properties": {
        "x": {
          "type": "number"
        },
        "y": {
          "type": "number"
        },
        "z": {
          "type": "number"
        }
      }
    }
  },
  "required": [
    "filePath"
  ]
}

{
  "title": "將指定的 CAD 檔案（.dwg / .dxf）連結（Link，非 Import）到 Revit 中的指定視圖",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "description": "要連結的 CAD 清單，每筆指定檔案與在 CAD 內的對齊錨點座標。",
      "items": {
        "type": "object",
        "properties": {
          "filePath": {
            "type": "string",
            "description": "CAD 檔案絕對路徑（.dwg / .dxf）。檔名須含可辨識樓層代碼。"
          },
          "cadAnchorPoint": {
            "type": "object",
            "description": "CAD 內對應 Grid 交點的座標（公釐）。",
            "properties": {
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              }
            },
            "required": [
              "x",
              "y"
            ]
          }
        },
        "required": [
          "filePath",
          "cadAnchorPoint"
        ]
      }
    },
    "gridLabelX": {
      "type": "string",
      "description": "Revit Grid 標籤（X 方向那條），例如「X1」或「A」。"
    },
    "gridLabelY": {
      "type": "string",
      "description": "Revit Grid 標籤（Y 方向那條），例如「Y1」或「1」。"
    },
    "thisViewOnly": {
      "type": "boolean",
      "default": true,
      "description": "true=連結只在對應 FloorPlan 可見。"
    },
    "unit": {
      "type": "string",
      "enum": [
        "Default",
        "Foot",
        "Inch",
        "Meter",
        "Decimeter",
        "Centimeter",
        "Millimeter",
        "Custom"
      ],
      "default": "Default"
    },
    "colorMode": {
      "type": "string",
      "enum": [
        "BlackAndWhite",
        "Preserved",
        "InvertColors"
      ],
      "default": "BlackAndWhite"
    },
    "visibleLayersOnly": {
      "type": "boolean",
      "default": false
    },
    "autoCorrectAlmostVHLines": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "items",
    "gridLabelX",
    "gridLabelY"
  ]
}

{
  "title": "批次將多個 CAD 檔連結到對應樓層的平面視圖，並把每個 CAD 平移對齊到指定的 Revit Grid 交點",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "categoryType": {
      "type": "string",
      "description": "只列出指定 CategoryType 的品類 (Model / Annotation / Internal / AnalyticalModel / Invalid)；省略則全部列出。"
    },
    "includeSubcategories": {
      "type": "boolean",
      "description": "是否連同各品類的子品類名稱一併回傳 (預設 false，僅回傳子品類數量)。"
    }
  }
}

{
  "title": "列舉專案中所有品類 (Category) 及其 CategoryType (Model / Annotation / I",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {},
  "required": []
}

{
  "title": "列出目前 Revit 專案可用的 DimensionType",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "filter": {
      "type": "string",
      "description": "名稱篩選關鍵字（選填，模糊比對族群名稱或類型名稱）"
    }
  }
}

{
  "title": "列出專案中的 FamilySymbol（族群類型）",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {},
  "required": []
}

{
  "title": "列出目前 Revit 專案中的 Legend 視圖與其中的門窗 legend component 數量",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "列出目前專案中所有可讀取的明細表（排除樣板、圖框修訂表）",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "seedType": {
      "type": "string",
      "enum": [
        "legend"
      ],
      "description": "seed 類型，目前僅支援 legend。"
    }
  },
  "required": [
    "seedType"
  ]
}

{
  "title": "列出 seed 候選資料",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "point1X": {
      "type": "number",
      "description": "第一點 X 座標（公釐）"
    },
    "point1Y": {
      "type": "number",
      "description": "第一點 Y 座標（公釐）"
    },
    "point1Z": {
      "type": "number",
      "description": "第一點 Z 座標（公釐），預設 0",
      "default": 0
    },
    "point2X": {
      "type": "number",
      "description": "第二點 X 座標（公釐）"
    },
    "point2Y": {
      "type": "number",
      "description": "第二點 Y 座標（公釐）"
    },
    "point2Z": {
      "type": "number",
      "description": "第二點 Z 座標（公釐），預設 0",
      "default": 0
    }
  },
  "required": [
    "point1X",
    "point1Y",
    "point2X",
    "point2Y"
  ]
}

{
  "title": "測量兩個點之間的距離",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "elementId": {
      "type": "number",
      "description": "元素 ID"
    },
    "parameterName": {
      "type": "string",
      "description": "參數名稱"
    },
    "value": {
      "type": "string",
      "description": "新的參數值"
    }
  },
  "required": [
    "elementId",
    "parameterName",
    "value"
  ]
}

{
  "title": "修改 Revit 元素的參數值",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "elementId": {
      "type": "number",
      "description": "要移動的元素 ID"
    },
    "dx": {
      "type": "number",
      "description": "X 軸移動距離 (mm)",
      "default": 0
    },
    "dy": {
      "type": "number",
      "description": "Y 軸移動距離 (mm)",
      "default": 0
    },
    "dz": {
      "type": "number",
      "description": "Z 軸移動距離 (mm)",
      "default": 0
    }
  },
  "required": [
    "elementId"
  ]
}

{
  "title": "移動指定的 Revit 元素（依 dx, dy, dz 指定位移量）",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "textMatch": {
      "type": "string",
      "description": "要搜尋的 TextNote 文字內容（子字串比對，不區分大小寫）"
    },
    "deltaXMm": {
      "type": "number",
      "description": "水平位移量（mm），正值向右、負值向左。預設 0"
    },
    "deltaYMm": {
      "type": "number",
      "description": "垂直位移量（mm），正值向上、負值向下。預設 0"
    },
    "viewNames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "只在指定名稱的 DraftingView 中搜尋（選填，不指定則搜尋全部 DraftingView）"
    },
    "dryRun": {
      "type": "boolean",
      "description": "設為 true 時僅搜尋並回報結果，不實際移動。預設 false"
    }
  },
  "required": [
    "textMatch"
  ]
}

{
  "title": "在多個 DraftingView 中，依文字內容子字串搜尋 TextNote 並批次平移",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "below-view-center",
        "reset"
      ],
      "description": "below-view-center: 標題置中於 view 正下方（透過 cropbox 計算）；reset: 還原預設位置",
      "default": "below-view-center"
    },
    "gapMm": {
      "type": "number",
      "description": "標題距離 view cropbox 底邊的距離（mm，僅 below-view-center 模式有效）",
      "default": 5
    },
    "viewportIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "目標 Viewport ElementId 清單（最精確識別方式）"
    },
    "viewIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "目標 View ElementId 清單（會找對應的 viewport）"
    },
    "viewNames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "目標 view 名稱清單（精確匹配）"
    },
    "viewNameContains": {
      "type": "string",
      "description": "view 名稱包含此字串（substring match, case-insensitive）"
    },
    "sheetNumbers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "限定 sheet 編號清單（與其他識別方式組合使用）"
    },
    "viewTypeFilter": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "限定 view type, 例: ['FloorPlan', 'CeilingPlan']"
    },
    "dryRun": {
      "type": "boolean",
      "description": "若 true 則只計算不實際移動，回傳預期 delta 供確認",
      "default": false
    }
  }
}

{
  "title": "批次移動 viewport 標題（label line + text）的位置",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "elementId": {
      "type": "number",
      "description": "要覆寫的元素 ID"
    },
    "viewId": {
      "type": "number",
      "description": "視圖 ID（若不指定則使用當前視圖）"
    },
    "surfaceFillColor": {
      "type": "object",
      "description": "表面填滿顏色 RGB (0-255)",
      "properties": {
        "r": {
          "type": "number",
          "minimum": 0,
          "maximum": 255
        },
        "g": {
          "type": "number",
          "minimum": 0,
          "maximum": 255
        },
        "b": {
          "type": "number",
          "minimum": 0,
          "maximum": 255
        }
      }
    },
    "surfacePatternId": {
      "type": "number",
      "description": "表面填充圖樣 ID（-1 = 實心填滿）",
      "default": -1
    },
    "lineColor": {
      "type": "object",
      "description": "線條顏色 RGB（可選）",
      "properties": {
        "r": {
          "type": "number",
          "minimum": 0,
          "maximum": 255
        },
        "g": {
          "type": "number",
          "minimum": 0,
          "maximum": 255
        },
        "b": {
          "type": "number",
          "minimum": 0,
          "maximum": 255
        }
      }
    },
    "transparency": {
      "type": "number",
      "description": "透明度 (0-100)",
      "minimum": 0,
      "maximum": 100,
      "default": 0
    },
    "patternMode": {
      "type": "string",
      "enum": [
        "auto",
        "surface",
        "cut"
      ],
      "description": "填滿層：auto（依視圖類型自動，樓板/屋頂於平面圖自動用表面）、surface（強制表面樣式，立面/剖面/3D 或平面圖樓板）、cut（強制切割樣式，平面圖被剖切的牆/柱/門窗）",
      "default": "auto"
    }
  },
  "required": [
    "elementId"
  ]
}

{
  "title": "在指定視圖中覆寫元素的圖形顯示（填滿顏色、圖樣、線條顏色等）",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "x": {
      "type": "number",
      "description": "X 座標（公釐）"
    },
    "y": {
      "type": "number",
      "description": "Y 座標（公釐）"
    },
    "furnitureType": {
      "type": "string",
      "description": "家具類型名稱"
    },
    "level": {
      "type": "string",
      "description": "樓層名稱",
      "default": "Level 1"
    },
    "rotation": {
      "type": "number",
      "description": "旋轉角度（度）",
      "default": 0
    }
  },
  "required": [
    "x",
    "y",
    "furnitureType"
  ]
}

{
  "title": "在指定位置放置家具實例",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewAnchor": {
      "type": "string",
      "enum": [
        "top-left",
        "top-right",
        "bottom-left",
        "bottom-right",
        "center"
      ],
      "description": "View 上的錨點（哪一角/中心會被定位到目標位置）"
    },
    "sheetReference": {
      "type": "string",
      "enum": [
        "titleblock-top-left",
        "titleblock-top-right",
        "titleblock-bottom-left",
        "titleblock-bottom-right",
        "sheet-top-left",
        "sheet-top-right",
        "sheet-bottom-left",
        "sheet-bottom-right"
      ],
      "description": "Sheet 上的參考點。titleblock-* 用 title block 邊界；sheet-* 用 sheet 印刷區域邊界"
    },
    "offsetRightMm": {
      "type": "number",
      "description": "X 方向 offset（公釐）。正值往右、負值往左",
      "default": 0
    },
    "offsetDownMm": {
      "type": "number",
      "description": "Y 方向 offset（公釐）。正值往下、負值往上（直覺 sheet layout 慣例）",
      "default": 0
    },
    "viewportIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "目標 Viewport ElementId 清單（最精確識別方式）"
    },
    "viewIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "目標 View ElementId 清單（會找對應的 viewport）"
    },
    "viewNames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "目標 view 名稱清單（精確匹配）"
    },
    "viewNameContains": {
      "type": "string",
      "description": "view 名稱包含此字串（substring match, case-insensitive）"
    },
    "sheetNumbers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "限定 sheet 編號清單（與其他識別方式組合使用）"
    },
    "viewTypeFilter": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "限定 view type, 例: ['FloorPlan', 'CeilingPlan']"
    },
    "dryRun": {
      "type": "boolean",
      "description": "若 true 則只計算不實際移動，回傳預期 delta 供確認",
      "default": false
    }
  },
  "required": [
    "viewAnchor",
    "sheetReference"
  ]
}

{
  "title": "批次將 viewports 移動到 sheet 上的指定位置",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "layerName": {
      "type": "string",
      "description": "CAD 圖層名稱，請從 get_dwg_beam_layers 回傳的清單中選擇樑輪廓圖層"
    }
  },
  "required": [
    "layerName"
  ]
}

{
  "title": "解析 CAD 指定圖層中的雙線幾何，預覽識別到的樑中心線資訊（區分 X 向與 Y 向）",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "layerName": {
      "type": "string",
      "description": "CAD 圖層名稱，請從 get_dwg_column_layers 回傳的清單中選擇"
    }
  },
  "required": [
    "layerName"
  ]
}

{
  "title": "解析 CAD 指定圖層中的矩形幾何，預覽識別到的柱資訊（位置、寬度、深度、旋轉角）",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "元素類別（如：Walls, Rooms, Doors, Windows, Floors, Columns）"
    },
    "family": {
      "type": "string",
      "description": "族群名稱（選填）"
    },
    "type": {
      "type": "string",
      "description": "類型名稱（選填）"
    },
    "level": {
      "type": "string",
      "description": "樓層名稱（選填）"
    },
    "maxCount": {
      "type": "number",
      "description": "最大回傳數量（預設 100）",
      "default": 100
    }
  },
  "required": [
    "category"
  ]
}

{
  "title": "查詢 Revit 專案中的元素",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "The category internal name"
    },
    "viewId": {
      "type": "number",
      "description": "The view Element ID (Optional)"
    },
    "filters": {
      "type": "array",
      "description": "List of filter conditions",
      "items": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string",
            "description": "Parameter name (MUST be from get_category_fields)"
          },
          "operator": {
            "type": "string",
            "enum": [
              "equals",
              "contains",
              "less_than",
              "greater_than",
              "not_equals"
            ]
          },
          "value": {
            "type": "string",
            "description": "Comparison value"
          }
        },
        "required": [
          "field",
          "operator",
          "value"
        ]
      }
    },
    "returnFields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "指定要回傳的參數欄位清單"
    },
    "maxCount": {
      "type": "number",
      "description": "最大回傳數量 (預設 100)",
      "default": 100
    }
  },
  "required": [
    "category"
  ]
}

{
  "title": "[Phase 3: Retrieval] Query elements with multi-filter suppor",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "linkInstanceId": {
      "type": "number",
      "description": "連結模型實體 ID（來自 get_linked_models）"
    },
    "category": {
      "type": "string",
      "description": "Revit 品類名稱，例如 Pipes、Ducts、CableTrays、Walls、StructuralFraming"
    },
    "filters": {
      "type": "array",
      "description": "參數過濾條件",
      "items": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string",
            "description": "參數名（例 System Type、Size）"
          },
          "operator": {
            "type": "string",
            "description": "equals / contains / not_equals / less_than / greater_than"
          },
          "value": {
            "type": "string",
            "description": "比對值"
          }
        }
      }
    },
    "returnFields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "額外回傳的參數欄位名（選填）"
    },
    "maxCount": {
      "type": "number",
      "description": "最大回傳數量",
      "default": 500
    }
  },
  "required": [
    "linkInstanceId",
    "category"
  ]
}

{
  "title": "查詢指定連結模型中的元素，支援品類篩選、參數過濾、自訂回傳欄位",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "x": {
      "type": "number",
      "description": "搜尋中心 X 座標"
    },
    "y": {
      "type": "number",
      "description": "搜尋中心 Y 座標"
    },
    "searchRadius": {
      "type": "number",
      "description": "搜尋半徑 (mm)"
    },
    "level": {
      "type": "string",
      "description": "樓層名稱 (選填)"
    }
  },
  "required": [
    "x",
    "y",
    "searchRadius"
  ]
}

{
  "title": "查詢指定座標附近的牆體，回傳牆厚度、位置線與牆面座標",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "filePath": {
      "type": "string",
      "description": "Excel 檔案的絕對路徑（.xlsx）"
    },
    "mode": {
      "type": "string",
      "enum": [
        "named_table",
        "worksheet"
      ],
      "description": "named_table=讀取每個 worksheet 內的命名 table（預設）；worksheet=每個 worksheet 視為一張表，名稱為 worksheet 名稱。兩種模式皆只讀列印範圍。"
    },
    "tableNames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "選填：只讀取指定名稱的 table（不分大小寫）"
    },
    "includeBorders": {
      "type": "boolean",
      "description": "是否回傳每格的 borders 陣列（[top,right,bottom,left]）。預設 false（不回，節省 token）。",
      "default": false
    },
    "summary": {
      "type": "boolean",
      "description": "summary 模式：每張表只回 {name, rowCount, colCount, mergeCount, hasNonThinBorders, clippedByPrintArea}，不含 rows/borders。預設 false。",
      "default": false
    }
  },
  "required": [
    "filePath"
  ]
}

{
  "title": "⚠️ 若目的是把 Excel 內容繪製到 Revit Drafting View，**請改用 `import_excel",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "scheduleId": {
      "type": "number",
      "description": "明細表 ElementId（建議；由 list_schedules 取得）"
    },
    "scheduleName": {
      "type": "string",
      "description": "明細表名稱（scheduleId 未提供時使用，支援部分比對）"
    },
    "maxRows": {
      "type": "number",
      "description": "最多回傳的資料列數（預設 2000，避免回應過大）"
    }
  }
}

{
  "title": "讀取單一明細表的完整表格內容（欄位標頭 + 逐格 body 資料，忠實呈現 Revit 畫面顯示的文字）",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "sourceFilePath": {
      "type": "string",
      "description": "來源 .rvt 檔案的絕對路徑"
    },
    "sheetNumbers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "要讀取的圖紙編號清單。省略則讀取全部 sheets。"
    },
    "keepOpen": {
      "type": "boolean",
      "description": "讀取完成後是否保持來源檔開啟（供後續 copy_sheets_from_file 使用，避免重複開啟）。預設 true。",
      "default": true
    }
  },
  "required": [
    "sourceFilePath"
  ]
}

{
  "title": "開啟來源 .rvt 檔案並讀取所有圖紙 (sheets)、視埠 (viewports)、視圖 (views) 與 Sch",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "恢復先前由 unjoin_wall_joins / unjoin_column_joins / unjoin_eleme",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "mapping": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Required code mapping, e.g. { \"F11\": \"F10\", \"W4\": \"W3\" }."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Room parameter names to update. Defaults to 樓板塗層, 踢腳, 牆面塗層, 天花板塗層."
    },
    "apply": {
      "type": "boolean",
      "description": "Set true to write changes to Revit. When omitted, the tool previews only.",
      "default": false
    },
    "dryRun": {
      "type": "boolean",
      "description": "When true, preview planned changes without writing. Defaults to true unless apply=true.",
      "default": true
    },
    "level": {
      "type": "string",
      "description": "Optional level name or unique partial name filter."
    },
    "roomName": {
      "type": "string",
      "description": "Optional room name contains filter."
    },
    "roomNumber": {
      "type": "string",
      "description": "Optional room number contains filter."
    },
    "roomIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Optional explicit Room ElementId list. Overrides all-room collection before filters are applied."
    },
    "includeUnplaced": {
      "type": "boolean",
      "description": "Whether unplaced or zero-area rooms should be included.",
      "default": false
    },
    "maxChangedRooms": {
      "type": "number",
      "description": "Maximum changed room detail rows returned in the response. Summary counts are always complete.",
      "default": 200
    }
  },
  "required": [
    "mapping"
  ]
}

{
  "title": "Batch-remap room finish code parameters in one Revit transac",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewId": {
      "type": "number",
      "description": "視圖的 Element ID"
    },
    "newName": {
      "type": "string",
      "description": "新的視圖名稱"
    }
  },
  "required": [
    "viewId",
    "newName"
  ]
}

{
  "title": "重新命名指定的 Revit 視圖（包含剖面圖、平面圖等），此工具不受軟體語系本地化影響",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "level": {
      "type": "string",
      "description": "Level name or unambiguous partial level name, e.g. B1F or C-B1F."
    },
    "startNumber": {
      "type": "string",
      "description": "First room number to assign, e.g. B134. The trailing digit width is preserved."
    },
    "dryRun": {
      "type": "boolean",
      "description": "true previews the planned order without writing to Revit.",
      "default": false
    },
    "includeUnnamed": {
      "type": "boolean",
      "description": "Whether unnamed placed rooms should be included.",
      "default": true
    },
    "yToleranceMm": {
      "type": "number",
      "description": "Y-axis grouping tolerance in millimeters for row detection.",
      "default": 3000
    },
    "parameterName": {
      "type": "string",
      "description": "Optional explicit room number parameter name. If omitted, the Revit built-in room number parameter is used."
    },
    "allowExistingNumberConflicts": {
      "type": "boolean",
      "description": "Allow proposed numbers even when the same room numbers already exist outside the target level.",
      "default": false
    }
  },
  "required": [
    "level",
    "startNumber"
  ]
}

{
  "title": "Batch-renumber placed rooms on one level in a single Revit t",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "scaleFactor": {
      "type": "number",
      "description": "行高縮放比例（例如 1.1 表示放大到 110%，0.9 表示縮小到 90%）。預設 1.1"
    },
    "viewNames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "只處理指定名稱的 DraftingView（選填，不指定則處理圖紙上所有 DraftingView）"
    },
    "sheetId": {
      "type": "number",
      "description": "圖紙的 Element ID（選填，不指定則使用當前作用圖紙）"
    }
  }
}

{
  "title": "縮放圖紙上所有 DraftingView 中表格的行高（僅 Y 軸），寬度不變",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "scaleFactor": {
      "type": "number",
      "description": "寬度縮放比例（例如 0.9 表示縮小到 90%，1.1 表示放大到 110%）。預設 0.9"
    },
    "viewNames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "只處理指定名稱的 DraftingView（選填，不指定則處理圖紙上所有 DraftingView）"
    },
    "sheetId": {
      "type": "number",
      "description": "圖紙的 Element ID（選填，不指定則使用當前作用圖紙）"
    }
  }
}

{
  "title": "縮放圖紙上所有 DraftingView 中表格的寬度（僅 X 軸），高度不變",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "掃描目前視圖中所有被套管（Sleeves）穿過的結構梁",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "elementId": {
      "type": "number",
      "description": "要選取的元素 ID (單選)"
    },
    "elementIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "要選取的元素 ID 列表 (多選)"
    }
  }
}

{
  "title": "在 Revit 中選取指定的元素，讓使用者可以視覺化確認目標元素",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewId": {
      "type": "number",
      "description": "要切換的視圖 Element ID"
    }
  },
  "required": [
    "viewId"
  ]
}

{
  "title": "切換至指定的視圖",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "類別名稱（如 Planting, Furniture, Doors, 或 OST_Planting）"
    },
    "hidden": {
      "type": "boolean",
      "description": "true = 隱藏, false = 顯示",
      "default": true
    },
    "viewId": {
      "type": "number",
      "description": "視圖 ID（若不指定則使用當前視圖）"
    }
  },
  "required": [
    "category"
  ]
}

{
  "title": "在指定視圖中隱藏或顯示整個類別（同時影響主模型與連結模型）",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "description": "預設模式：'taiwan'（公制+Air Flow m³/h，推薦台灣 MEP）、'metric'、'imperial'。與 system 擇一。"
    },
    "system": {
      "type": "string",
      "description": "基底單位系統：'metric' 或 'imperial'（未給 mode 時使用；預設 metric）。"
    },
    "length": {
      "type": "string",
      "description": "長度單位覆寫：m / mm / cm / ft / ft-in（選填）"
    },
    "area": {
      "type": "string",
      "description": "面積單位覆寫：m2 / sf（選填）"
    },
    "volume": {
      "type": "string",
      "description": "體積單位覆寫：m3 / l / cf（選填）"
    },
    "airFlow": {
      "type": "string",
      "description": "風量單位覆寫：m3/h / l/s / cfm（選填）"
    }
  }
}

{
  "title": "一次把整個專案的顯示單位切換到指定系統/模式（全案性動作，單一 Transaction 可 Ctrl+Z 還原）",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "scopeBoxName": {
      "type": "string",
      "description": "目標 ScopeBox 的名稱（須與 Revit 中 ScopeBox 名稱完全一致；找不到時會列出所有可用名稱）"
    },
    "viewIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "目標 view ElementId 清單（最精確的識別方式）"
    },
    "viewNames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "目標 view 名稱清單（精確匹配）"
    },
    "viewNameContains": {
      "type": "string",
      "description": "view 名稱包含此字串（substring match，case-insensitive）"
    },
    "viewTypeFilter": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "限定 view type, 例: ['FloorPlan', 'CeilingPlan']"
    }
  },
  "required": [
    "scopeBoxName"
  ]
}

{
  "title": "批次將 ScopeBox 套用到一組 views（透過設定 view 的 VIEWER_VOLUME_OF_INTERE",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "viewId": {
      "type": "number",
      "description": "目標視圖 ID（選填）；不填則使用當前 active view"
    },
    "dx_mm": {
      "type": "number",
      "description": "X 方向位移（公釐，正值往右）",
      "default": 0
    },
    "dy_mm": {
      "type": "number",
      "description": "Y 方向位移（公釐，正值往上）",
      "default": 0
    }
  }
}

{
  "title": "在 CropBox 自身座標系中平移視圖的 CropBox",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "自動同步所有詳圖元件的類型參數（詳圖圖號、圖說名稱）與其所在圖紙的編號和名稱",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "linkInstanceId": {
      "type": "number",
      "description": "ElementId of the linked IFC model instance to read structural elements from."
    },
    "apply": {
      "type": "boolean",
      "description": "Actually create the native elements. When false the tool behaves as a preview."
    },
    "dryRun": {
      "type": "boolean",
      "description": "Preview only; analyse and report without modifying the model."
    },
    "replaceExisting": {
      "type": "boolean",
      "description": "Replace native elements previously created by a prior sync."
    },
    "includeFraming": {
      "type": "boolean",
      "description": "Include structural framing (beams) in the sync."
    },
    "includeColumns": {
      "type": "boolean",
      "description": "Include structural columns in the sync."
    },
    "maxFraming": {
      "type": "number",
      "description": "Cap the number of framing members processed (omit / 0 for no cap)."
    },
    "maxColumns": {
      "type": "number",
      "description": "Cap the number of columns processed (omit / 0 for no cap)."
    },
    "batchSize": {
      "type": "number",
      "description": "Number of elements created per transaction batch."
    },
    "minLengthMm": {
      "type": "number",
      "description": "Ignore framing shorter than this length (mm)."
    },
    "sizeRoundMm": {
      "type": "number",
      "description": "Rounding granularity (mm) applied when matching section sizes to family types."
    },
    "framingCategory": {
      "type": "string",
      "description": "Override the IFC category treated as framing."
    },
    "columnCategory": {
      "type": "string",
      "description": "Override the IFC category treated as columns."
    },
    "baseFramingType": {
      "type": "string",
      "description": "Base family type name used as the framing template."
    },
    "baseColumnType": {
      "type": "string",
      "description": "Base family type name used as the column template."
    },
    "baseSteelColumnType": {
      "type": "string",
      "description": "Base family type used for steel (H / wide-flange) columns."
    },
    "baseShsColumnType": {
      "type": "string",
      "description": "Base family type used for square-hollow-section (SHS) columns."
    },
    "baseRcColumnType": {
      "type": "string",
      "description": "Base family type used for RC (rectangular concrete) columns."
    },
    "autoColumnBaseType": {
      "type": "boolean",
      "description": "Auto-select the column base family type per detected section instead of always using baseColumnType."
    },
    "shsColumnMinSizeMm": {
      "type": "number",
      "description": "Minimum square size (mm) for a section to be classified as SHS."
    },
    "shsSquareToleranceMm": {
      "type": "number",
      "description": "Width/depth tolerance (mm) used when deciding if a section is square (SHS)."
    },
    "alignColumnTopsToFloorBottom": {
      "type": "boolean",
      "description": "Align created column tops to the bottom of the floor above, detected by ray/geometry probing."
    },
    "maxColumnTopSearchDistanceMm": {
      "type": "number",
      "description": "Maximum upward search distance (mm) when aligning column tops to the floor bottom."
    },
    "sourceTagPrefix": {
      "type": "string",
      "description": "Prefix written to Mark / Comments to tag synced elements by their IFC source."
    }
  }
}

{
  "title": "Convert structural framing (beams) and columns from a linked",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "level": {
      "type": "string",
      "description": "樓層名稱篩選（選填）。"
    },
    "roomName": {
      "type": "string",
      "description": "房間名稱或房間編號部分匹配（選填）。"
    },
    "roomIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "指定房間 ElementId 清單（選填，優先於 level/roomName）。"
    },
    "targetParameter": {
      "type": "string",
      "description": "要寫入的房間參數名稱。粉刷明細表的天花板欄位預設為「天花板塗層」。",
      "default": "天花板塗層"
    },
    "apply": {
      "type": "boolean",
      "description": "false 只預覽，true 實際寫回房間參數。",
      "default": false
    },
    "overwrite": {
      "type": "boolean",
      "description": "是否覆寫已有值的房間參數。",
      "default": false
    },
    "sampleGrid": {
      "type": "number",
      "description": "在天花板與房間 BoundingBox 重疊區內取樣確認是否位於房間內，範圍 1-7，預設 3。",
      "default": 3
    },
    "multiMatchStrategy": {
      "type": "string",
      "enum": [
        "largestOverlap",
        "join"
      ],
      "description": "多個天花板類型命中同一房間時，取最大重疊類型標記或用 + 合併。",
      "default": "largestOverlap"
    }
  }
}

{
  "title": "依房間範圍偵測同樓層天花板，讀取天花板類型標記，預覽或寫回房間參數（預設：天花板塗層）以更新粉刷明細表",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "sourceFilePath": {
      "type": "string",
      "description": "來源 .rvt 檔案的絕對路徑"
    },
    "sheetNumbers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "限定要補的 sheet 編號清單。省略 = 所有 source 中能在 target 找到同號的 sheet。"
    },
    "closeAfterSync": {
      "type": "boolean",
      "description": "完成後是否關閉來源檔案。預設 true。",
      "default": true
    }
  },
  "required": [
    "sourceFilePath"
  ]
}

{
  "title": "補丁工具：為 target 中已存在的 sheets 從 source 同號 sheet 補齊 custom param",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "自動分析視圖中的樓梯幾何，偵測被牆、版等物件遮擋的邊緣線段，回傳座標以供後續繪製虛線",
  "readOnlyHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "elementId": {
      "type": "number",
      "description": "要取消隱藏的單一元素 ID"
    },
    "elementIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "批次取消隱藏的元素 ID 陣列"
    },
    "viewId": {
      "type": "number",
      "description": "視圖 ID（若不指定則使用當前視圖）"
    }
  }
}

{
  "title": "在指定視圖中取消隱藏元素",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "columnIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "要處理的柱子 Element ID 列表（選填，預設為全部柱）"
    },
    "viewId": {
      "type": "number",
      "description": "視圖 ID（選填，未給 columnIds 時用來限縮範圍）"
    }
  }
}

{
  "title": "以柱子為中心解除其與鄰近元素的幾何接合，涵蓋牆、樓板、結構樑",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "sourceCategory": {
      "type": "string",
      "description": "來源類別名稱（不含 OST_ 前綴，例如 StructuralFraming、Walls、Floors）"
    },
    "targetCategories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "目標類別名稱陣列（選填，預設 8 類：Walls、Floors、Columns、StructuralColumns、StructuralFraming、StructuralFoundation、Roofs、Ceilings）"
    },
    "elementIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "要處理的來源 Element ID 列表（選填，預設為該類別全部）"
    },
    "viewId": {
      "type": "number",
      "description": "視圖 ID（選填，未給 elementIds 時用來限縮範圍）"
    }
  },
  "required": [
    "sourceCategory"
  ]
}

{
  "title": "通用版：以任一類別為中心解除其與指定 target 類別的幾何接合",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "wallIds": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "要取消接合的牆體 Element ID 列表"
    },
    "viewId": {
      "type": "number",
      "description": "視圖 ID"
    }
  }
}

{
  "title": "取消牆體與柱子等元素的幾何接合關係",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "description": "判定結果陣列，每筆含 DetectorId、IsOk、IsWarn",
      "items": {
        "type": "object",
        "properties": {
          "DetectorId": {
            "type": "number",
            "description": "探測器 Element ID"
          },
          "IsOk": {
            "type": "boolean",
            "description": "是否通過"
          },
          "IsWarn": {
            "type": "boolean",
            "description": "是否為警告（非嚴格 FAIL）"
          },
          "Message": {
            "type": "string",
            "description": "違規說明"
          }
        },
        "required": [
          "DetectorId",
          "IsOk"
        ]
      }
    }
  },
  "required": [
    "results"
  ]
}

{
  "title": "依照法規判定結果對偵煙探測器上色：綠=PASS、紅=FAIL、橙=WARN（出風口資料缺失）",
  "readOnlyHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "properties": {
    "elementId": {
      "type": "number",
      "description": "要縮放至的元素 ID"
    }
  },
  "required": [
    "elementId"
  ]
}

{
  "title": "將視圖縮放至指定元素，讓使用者可以快速定位",
  "readOnlyHint": true,
  "destructiveHint": false
}