高程更新

高程更新 — 單一視窗、5 個控制區、8 項功能，把結構樑與樓板頂/底高程批量寫入元素參數

功能概述

高程更新 是在 Revit 內部開啟的工具視窗（視窗標題為「高程更新」），會自動連結你當前開啟的 Revit 專案檔案。它針對檔案中的結構樑與樓板，計算每一根樑、每一塊樓板的頂面與底面相對於你指定「基準」的垂直距離，並將結果批量寫入你指定的元素參數。它只寫入參數數值，不會移動或修改元素幾何。

簡單說：把「量高程 → 換單位 → 寫參數」的重複工作一次做完，讓結構與機電專業擁有口徑一致的樑頂／樑底／樓板頂／樓板底高程資料，供排程表、淨高分析與管線配置使用。

30 秒快速開始

  1. 在 Revit 中開啟要處理的專案檔案（族檔案無法開啟此工具）。
  2. 執行 高程更新 指令（載入項／外掛指令列中的對應按鈕）。「高程更新」視窗會在 Revit 主視窗旁出現並自動連結當前檔案；同一時間只有一個視窗，重複執行指令只會把已開啟的視窗帶到前面。
  3. 完成設定：在「階段」「樓層」清單勾選處理範圍 → 在「應用元素」勾選目標樑/樓板類型（或按「自視圖挑選」）→ 在「更新至元素屬性」選好樑頂／樑底／樓板頂／樓板底四個參數 → 選擇基準「標記樓板」或「標記樓層」→（選用）設定「單位」與「工作面高度」偏移值。

工具視窗長什麼樣？（控制區導覽）

這個工具是單一視窗、沒有分頁：左側三欄是「範圍勾選」（階段／樓層／應用元素），右側是「設定」（參數、單位、偏移、基準）與執行按鈕，最上方有一列「Setting」選單。先熟悉各控制區：

控制區 用途（一句話） 代表性功能
階段（左欄） 限定只處理特定施工階段的元素 階段勾選清單
樓層（左欄） 限定只處理「所屬樓層」為這些樓層的元素 樓層勾選清單（依高程由低到高）
應用元素（左欄） 勾選要寫高程的樑／樓板類型 類型清單（「元件」欄，顯示「家族名-類型名」）、按鈕「自視圖挑選」
更新至元素屬性（右上） 指定高程寫入哪個參數、輸出單位、固定偏移 「樑頂」「樑底」「樓板頂」「樓板底」參數下拉、「單位」下拉、「工作面高度」數值與參數、按鈕「重新載入」
共用參數建立（右上、嵌在前一區內） 一次建立本工具所需的 5 個共用參數 5 個參數名稱輸入框、按鈕「建立所需參數」（參數群組「BIM-Watson」）
標記樓板／標記樓層＋「判別高程時使用樓層」清單（右中） 選擇高程「基準」的來源，並指定可當基準的樓層 兩個單選按鈕（預設「標記樓板」）、基準樓層勾選清單（含「GL」的樓層預設未勾）
更新 按鈕（視窗底部） 執行高程計算與參數寫入 按鈕「更新」（處理中變灰）
Setting 選單（視窗最上方） 管理本工具自己的設定檔（.fms） 「Open」「Load」「Save」「SaveAs」

💡 找不到功能怎麼辦？

  • 本工具沒有分頁：左側四個清單都是「範圍／基準勾選」，右側控制項是「參數與計算設定」，唯一的執行按鈕是底部的大「更新」。
  • 操作步驟依控制區排列，每個功能都標明「在哪個群組、按哪顆按鈕」（📍）；遇到症狀直接翻快速查詢：遇到什麼狀況用什麼功能。
  • 介面文字與本手冊一致：按鈕就寫著 更新、自視圖挑選、重新載入、建立所需參數，選單項是 Setting → Open／Load／Save／SaveAs（注意是「SaveAs」一個字）。看到相同文字就是找對了位置。

主要功能模組

✓ 十類用途

  • 結構樑高程標記：批量把樑頂／樑底高程寫入參數，供結構排程與鋼材表使用
  • 樓板工作面記錄：批量把樓板頂／底高程寫入參數，配合「工作面高度」偏移記錄實際工作面向機電提供淨高依據
  • 基準＝下方樓板：「標記樓板」模式，自動找元素正下方、平面重疊的樓板，取其頂面當基準
  • 基準＝指定樓層：「標記樓層」模式，以「判別高程時使用樓層」中元素下方最近的已勾選樓層當基準
  • 單位輸出：文字型參數可輸出 mm／cm／m／ft.（feet，英呎）數值
  • 固定偏移：「工作面高度」對所有結果加統一偏移（注意：是「減去」輸入值，見 4.3）
  • 共用參數準備：「建立所需參數」在「BIM-Watson」參數群組一次建立 5 個長度型共用參數
  • 快速選類型：「自視圖挑選」在圖面點一下樑或樓板，自動勾選對應類型
  • 範圍精確控制：用「階段」與「樓層」兩個清單把處理範圍收窄到特定階段／特定樓層
  • 設定檔重用：「Setting」選單把整組設定存成 .fms 檔，跨專案重複使用

使用情境

以下情境都標出實際要用的控制區與按鈕，可以直接照著做：

情境一：結構樑頂/底高程批量標記（以樓板為基準）

結構圖階段要給所有樑標高程：在「階段」與「樓層」勾選目標範圍 → 在「應用元素」勾選樑類型（或用「自視圖挑選」）→ 在「更新至元素屬性」選「樑頂」「樑底」參數 → 保持預設的「標記樓板」→ 按「更新」。每根樑的頂/底相對「正下方樓板頂面」的高程就會寫進參數。

情境二：樓板工作面高程記錄（含完成層偏移）

機電需要樓板「完成面」高程：在「應用元素」勾選樓板類型 → 在「更新至元素屬性」選「樓板頂」「樓板底」參數 → 在「工作面高度」輸入完成層厚度（例如 50）→ 選基準 → 按「更新」。注意：輸入的偏移會從計算結果中減去（輸入 50，寫入值比原始高程低 50mm），輸入前請先小範圍試跑確認口徑。

情境三：依指定樓層統一換算（標記樓層模式）

需要「相對某樓層」的統一高程（例如所有高程都相對 1F）：在「判別高程時使用樓層」清單中只保留要當基準的樓層 → 選「標記樓層」→ 在「階段」「樓層」「應用元素」勾好處理範圍 → 按「更新」。元素的基準是「判別清單中、低於元素所屬樓層的最近一個已勾選樓層」；所屬樓層沒勾選或已是最低已勾選樓層的元素會被跳過。

情境四：新專案先準備共用參數

專案裡還沒有 5 個高程參數時：在「共用參數建立」確認 5 個參數名稱（預設「標記頂」「標記底」「標記頂」「標記底」「工作面高度」）→ 按「建立所需參數」（首次會請你指定共用參數檔 *.txt 的位置）→ 看到「建立完成」後按「重新載入」→ 回到「更新至元素屬性」選好剛建立的參數即可。

情境五：同一套設定跨專案重用

多個同類專案要用一樣的高程口徑：第一案設定完成後，用選單「Setting → SaveAs」把整組設定存成 .fms 檔（關閉視窗時也會自動存檔）；到下一案時「Setting → Open」選該檔載入，再按「更新」。

情境六：只處理單一階段的元素

設計變更只影響「新建」階段的結構：在「階段」清單只勾「新建」→ 其餘照常勾選 → 按「更新」。其他階段的元素完全不受影響。本工具是「覆蓋寫入參數」，執行前建議先備份檔案（詳見前置設定）。

前置設定

第一步：開啟並連結

  1. 在 Revit 中開啟目標專案檔案（不需要手動匯入或重新載入模型）。
  2. 執行 高程更新 指令，工具視窗出現並自動連結當前檔案：階段、樓層、應用元素與參數清單都會依該檔案的內容自動載入。
  3. 重複執行指令時，焦點回到已開啟的視窗（單一執行個體設計），不會疊加第二個視窗。

第二步：選擇處理範圍

  1. 在「階段」清單勾選要處理的施工階段、在「樓層」清單勾選元素所屬的樓層。注意：三個清單（階段／樓層／應用元素）預設全部未勾選，不勾選就按「更新」等於什麼都不處理。
  2. 在「應用元素」勾選要處理的樑/樓板類型；清單太長時直接按「自視圖挑選」，到 Revit 圖面點一個樑或樓板即可自動勾選（按 Esc 可取消挑選）。
  3. 「樓層」清單（範圍）與「判別高程時使用樓層」清單（基準）是兩個不同的清單：前者決定「處理誰」，後者決定「高程算到哪」，兩者要分開確認。

第三步：執行並觀察結果

  1. 在「更新至元素屬性」為「樑頂」「樑底」「樓板頂」「樓板底」選好目標參數（下拉為空代表檔案中沒有結構樑或樓板）；需要時設定「單位」與「工作面高度」。
  2. 在右側選擇基準方式：「標記樓板」（預設）或「標記樓層」。
  3. 按視窗底部的「更新」。處理中按鈕變灰、不可重複點擊；每個符合條件的元素會逐個計算並寫入參數。

⚠️ 執行前一定先備份

「更新」是覆蓋寫入：目標參數裡原有的數值會被直接覆蓋，工具不會保留舊值。首次使用或處理整個專案前，請先「另存新檔」建立檔案副本；範圍勾錯時，參數值無法用本工具恢復。

💡 連結狀態確認

若「樑頂／樑底」下拉是空的，代表檔案中找不到結構樑（或找不到任何可編輯的數值/文字參數）；「樓板頂／樓板底」為空同理。若按了「更新」卻沒有元素被寫入，多半是：階段/樓層/類型清單有項未勾選、元素找不到基準（下方無樓板或基準清單未勾）、或元素缺少所选參數——這些元素會被靜默跳過，屬正常保護行為。

操作步驟

本工具是單一視窗（沒有分頁），本章依控制區排列，每個功能都標明位置（📍 所在群組與按鈕）、一句話說明與操作步驟。介面中重複出現的動詞：自視圖挑選＝到 Revit 圖面點選元素、重新載入＝重建參數清單、更新＝執行計算與寫入、Setting → Open／Load／Save／SaveAs＝設定檔管理。

控制區 1：階段

位於視窗左側第一欄的勾選清單，列出專案的全部施工階段（依內部編號排序）。

1.1 勾選要處理的階段

📍 群組「階段」：階段勾選清單（無按鈕，直接勾選）

一句話：限定只有「建立於這些階段」的樑與樓板會參與本次更新，其他階段的元素完全不碰。

  1. 展開「階段」清單，勾選本次要處理的施工階段（可多選）。
  2. 確認勾選後再往下設定其他項目（預設全部未勾選）。

💡 預設全部未勾選

「階段」「樓層」「應用元素」三個範圍清單預設都沒有任何勾選：什麼都沒勾就按「更新」，工具跑完但不會寫入任何元素。這是最常見的「沒反應」原因。

控制區 2：樓層

左側第二欄的勾選清單，列出檔案的全部樓層，依樓層高程由低到高排列。

2.1 勾選要處理的樓層

📍 群組「樓層」：樓層勾選清單（無按鈕，直接勾選）

一句話：限定只處理「所屬樓層」在你勾選範圍內的元素（樑取其歸屬樓層、樓板取其排程樓層）。

  1. 在清單勾選目標樓層（可多選）。
  2. 與右側「判別高程時使用樓層」清單分開確認——後者只影響「高程算到哪」，不影響「處理誰」。

控制區 3：應用元素

左側第三欄：「元件」欄的勾選清單＋底部的「自視圖挑選」按鈕。

3.1 勾選要處理的樑/樓板類型

📍 群組「應用元素」：清單（欄名「元件」，每項顯示「家族名-類型名」，勾選框）

一句話：勾選要寫高程的結構樑類型與樓板類型；清單包含檔案中「全部」的這兩類類型（不只是目前視圖看得到的），依名稱排序。

  1. 在「元件」欄瀏覽類型名稱（格式：家族名-類型名，例如「结构梁-300x600」）。
  2. 勾選本次要處理的類型（可多選；預設全部未勾選）。

3.2 自視圖挑選

📍 群組「應用元素」→ 按 自視圖挑選

一句話：清單太長不好找時，直接到 Revit 圖面點一個樑或樓板，工具自動幫你在清單勾選它對應的類型。

  1. 按 自視圖挑選，游標會進入挑選狀態（提示「挑選」）。
  2. 在 Revit 圖面點選一個結構樑或樓板（其他類別選不中）。
  3. 該元素對應的類型會在清單自動勾選；要取消挑選按 Esc（取消的訊息會記入日誌）。

💡 挑選只「加勾」不「取消」

「自視圖挑選」只會把挑到的類型加勾，不會取消你已勾選的項目；要縮小範圍請手動取消多勾的類型。

控制區 4：更新至元素屬性

右側上方的主設定群組：四個目標參數下拉、「單位」下拉、「工作面高度」數值與參數、「重新載入」按鈕，以及嵌在群組下半部的「共用參數建立」群組。

4.1 選擇目標參數

📍 群組「更新至元素屬性」：「樑頂」「樑底」「樓板頂」「樓板底」四個下拉框

一句話：指定高程數值要寫進元素的哪個參數；「樑頂／樑底」清單來自檔案中第一根結構樑的參數，「樓板頂／樓板底」來自第一塊樓板的參數（都只列出可編輯的數值型或文字型參數）。

  1. 在「樑頂」下拉選擇樑頂面高程的存放參數，「樑底」同理。
  2. 在「樓板頂」「樓板底」下拉選擇樓板對應的存放參數。
  3. （選用）在下方的「工作面高度」參數下拉，選擇用來記錄偏移值的參數。

⚠️ 清單來源與空清單

參數清單是「取檔案中第一根結構樑／第一塊樓板」讀出來的：檔案裡沒有結構樑，「樑頂／樑底」與「工作面高度」參數下拉就是空的；沒有樓板則「樓板頂／樓板底」為空。元素若沒有你所選的參數（例如參數只綁定了樑、但你套用到樓板），該元素會被跳過。新增參數後記得按「重新載入」刷新清單。

4.2 設定單位

📍 群組「更新至元素屬性」：「單位」下拉，選項「mm」「cm」「m」「ft.」（預設「mm」）

一句話：決定文字型參數輸出的單位與後綴（例如 3500mm、35cm、3.5m、11.48ft.）；注意「ft.」是英呎（feet），不是英吋。

  1. 在「單位」下拉選擇輸出單位（預設「mm」）。
  2. 數值會四捨五入到小數第 2 位（例如 3500.48mm）。

💡 數值型參數不受單位影響

若目標參數是「數值型（Double）」，工具直接寫入 Revit 內部單位（英呎，feet）的原始值、不加單位後綴——「單位」下拉對它不生效。要在圖面看到帶 mm 的數字，請選「文字型（String）」參數。

4.3 設定工作面高度（偏移）

📍 群組「更新至元素屬性」：「工作面高度」數值輸入框（右側固定標示「mm」，範圍 −99999 至 99999，預設 0）＋「工作面高度」參數下拉

一句話：對所有計算結果加一個統一的固定偏移（例如完成層厚度）——請注意輸入值會從結果中「減去」：輸入 50，寫入值會比原始計算高程低 50mm。

  1. 在「工作面高度」數值框輸入偏移值（單位固定為 mm；不需要偏移就保持 0）。
  2. 在「工作面高度」參數下拉選擇記錄這個偏移值的元素參數（可留空，則不寫入偏移參數）。
  3. （建議）先用小範圍試跑一次，確認偏移方向符合你的口徑。

⚠️ 偏移是「減」不是「加」

結果＝（元素面高程 − 基準高程）− 輸入值。同時，偏移值也會寫入元素的「工作面高度」參數：文字型參數寫入負值的毫米數（例如「-50」，無單位後綴）；數值型參數寫入正值的英呎數。若你的口徑是「加」，請在輸入時自行換算成負值（例如輸入 −50）。

4.4 重新載入

📍 群組「更新至元素屬性」→ 按 重新載入

一句話：重新從檔案中第一根結構樑／第一塊樓板讀取參數，重建 5 個參數下拉清單。

  1. 在專案建立或變更參數後（例如按完「建立所需參數」），按 重新載入。
  2. 重新選好「樑頂／樑底／樓板頂／樓板底／工作面高度」參數（重新載入會重設選擇）。

控制區 5：共用參數建立

嵌在「更新至元素屬性」群組下半部的巢狀群組：5 個參數名稱輸入框＋「建立所需參數」按鈕。

5.1 建立所需參數

📍 群組「共用參數建立」：「樑頂」（預設文字「標記頂」）、「樑底」（預設「標記底」）、「樓板頂」（預設「標記頂」）、「樓板底」（預設「標記底」）、「工作面高度」（預設「工作面高度」）五個輸入框 → 按 建立所需參數

一句話：在共用參數檔的「BIM-Watson」參數群組中，一次建立這 5 個長度型共用參數（同時綁定到「結構樑」與「樓板」類別，實例與類型皆可），只建立「尚不存在」的項目。

  1. 確認 5 個輸入框中的參數名稱（可直接用預設：標記頂／標記底／標記頂／標記底／工作面高度；不需要的可留空）。
  2. 按 建立所需參數；若專案還沒設定共用參數檔，先會跳出「共用參數設定檔(*.txt)」對話框，指定檔的位置與名稱。
  3. 看到「建立完成」提示後，回到上方按「重新載入」，再在「更新至元素屬性」選好剛建立的參數。

⚠️ 「已存在」的判定

工具以「專案中是否已有同名參數綁定」判斷：任何類別上已存在同名參數時，該名稱會被跳過（視為已存在），不會重複建立。建立完成後新參數才能出現在 4.1 的下拉清單中（需「重新載入」）。

控制區 6：高程基準（標記樓板／標記樓層）

右側中部：兩個單選按鈕＋下方的「判別高程時使用樓層」清單。

6.1 標記樓板（預設基準）

📍 單選按鈕 標記樓板（預設已選）

一句話：對每個元素，找出「正下方、水平範圍有重疊」的樓板，取其中頂面最高的那塊的頂面高程當基準；樑/樓板頂/底高程＝該面與這塊樓板頂面的距離。

  1. 保持單選「標記樓板」。
  2. 確認「階段」清單已勾選（下方候選樓板只會考慮「建立於已勾選階段」的樓板）。
  3. 按「更新」執行；每個元素的日誌會寫出當它的基準樓板（「標記樓板:樓板名 Id:…」）。

💡 重疊判定與跳過

「正下方」指樓板頂面低於元素底面，且兩者在水平（XY）的包圍矩形有交集；若多個樓板符合，取頂面最高者。找不到任何符合樓板的元素會被靜默跳過（不寫入、不報錯），這是保護邏輯不是漏算。

6.2 標記樓層

📍 單選按鈕 標記樓層＋「判別高程時使用樓層」清單（欄名即「判別高程時使用樓層」）

一句話：以樓層當基準：取「判別高程時使用樓層」清單中、低於元素所屬樓層的最近一個已勾選樓層的高程當基準。

  1. 選單選「標記樓層」。
  2. 在「判別高程時使用樓層」清單調整勾選：要當基準的樓層保持勾選，不需要的（例如屋頂、設備層）取消勾選。清單預設全部勾選，只有第一個名稱含「GL」的樓層預設未勾選。
  3. 按「更新」執行。

⚠️ 什麼情況會沒有基準

「標記樓層」模式下，元素的所屬樓層若「沒在勾選清單中」或「已是勾選清單中最低的樓層」（下面沒有可當基準的樓層），該元素會被跳過。要處理最底層的元素，請把它的樓層本身也勾進清單並確保下方另有勾選的基準樓層。

執行：更新

視窗底部的寬大按鈕，是全工具唯一的「執行」入口。

7.1 更新

📍 視窗底部按鈕 更新

一句話：對檔案中所有「符合階段＋樓層＋類型勾選」的結構樑與樓板，逐一計算頂/底高程並寫入 4.1 選擇的參數（文字型帶單位後綴、數值型寫原始英尺值），同時寫入「工作面高度」偏移參數（若已選）。

  1. 確認三個範圍清單（階段／樓層／應用元素）與基準設定（6.1 或 6.2）正確。
  2. 確認 4.1 的參數已選好、4.2 單位與 4.3 偏移符合口徑（建議先小範圍試跑）。
  3. 看到「更新完成」後，回 Revit 選取已處理元素，在屬性面板抽查參數值。

⚠️ 寫入方式與還原

每個元素是「獨立一筆交易（transaction）」：按 Ctrl+Z 會以「單個元素」為單位逐步還原，大量元素需要按很多次——範圍或口徑設錯時，用備份檔還原是比較快的做法。處理中請不要關閉視窗或切換檔案（視窗關閉時會先自動存檔）。

視窗最上方的選單「Setting」，管理本工具自己的設定檔（.fms）：包含四組清單勾選、參數選擇、單位、偏移值與 5 個參數名稱。

8.1 Open／Load（載入設定）

📍 選單 Setting → Open（選取 .fms 檔後套用）／Setting → Load（套用目前記錄的設定檔）

一句話：把之前存好的一組設定套用到目前視窗，跨專案重用口徑最方便。

  1. 選 Setting → Open，在對話框（過濾「設定檔(*.fms)」）選取要載入的設定檔。
  2. 或選 Setting → Load 直接套用目前記錄的設定檔；若之前還沒存過檔，會先跳出對話框讓你指定位置。

8.2 Save／SaveAs（儲存設定）

📍 選單 Setting → Save（寫入目前記錄的位置）／Setting → SaveAs（選新位置與檔名後寫入）

一句話：把整組當前設定存成 .fms 檔；關閉工具視窗時也會自動存檔一次（首次存檔會先請你指定位置）。

  1. 完成一組滿意的設定後，選 Setting → SaveAs，在對話框（過濾「設定檔(*.fms)」）指定檔名與位置。
  2. 之後同一位置的更新用 Setting → Save 即可；取消對話框時，設定會寫入臨時檔案（不會丟失，但位置不固定）。

💡 存檔 ≠ 自動載入

設定會在「關閉視窗時自動保存」，但下次開啟視窗不會自動載入（每次開啟都是預設狀態）：要用舊設定，請先做「Setting → Load」或「Setting → Open」再按「更新」。

使用技巧與注意事項

名詞對照表（先花 2 分鐘看這個）

本工具介面沿用 Revit 中文術語，以下是本工具語境中最常遇到、也最容易誤會的：

名詞 是什麼 在本工具中的出現位置
階段（Phase） 專案的建造/使用階段（如新建、拆除、保留），元素可歸屬不同階段 左欄「階段」清單；限定處理範圍
樓層（Level）／樓層高程 水平基準面，有自己的高程值；是「標記樓層」模式的基準來源 左欄「樓層」清單、右側「判別高程時使用樓層」清單
所屬樓層（基準樓層） 元素歸屬的樓層：樑取其實例/族層級參數，樓板取其排程樓層參數 決定元素算不算在處理範圍內、以及「標記樓層」時往哪找基準
結構樑（Structural Framing） 類別為「結構樑」的族實例（結構用的樑）；本工具只處理這類樑 「應用元素」清單、「樑頂／樑底」參數
樓板（Floor） 類別為「樓板」的樓板元素；同時是「標記樓板」模式的基準來源 「應用元素」清單、「樓板頂／樓板底」參數
元素類型 「家族名稱-類型名稱」（如「结构梁-300x600」），清單按名稱排序 「應用元素」清單的「元件」欄
共用參數／參數群組 存在共用參數檔（.txt）中、可綁定到類別的參數；群組是參數的分類 「共用參數建立」；群組名固定為「BIM-Watson」
工作面高度（介面用詞） 同一個名字出現三處：①數值輸入框＝偏移量（mm，會從結果減去）②參數下拉＝記錄偏移量的元素參數 ③「共用參數建立」的輸入框＝要建立的共用參數名稱 「更新至元素屬性」與「共用參數建立」群組
標記樓板／標記樓層 兩種高程基準方式：取「下方重疊樓板的頂面」或「下方最近勾選樓層的高程」 右側兩個單選按鈕（預設「標記樓板」）
包圍盒／重疊 元素的三維包圍矩形；「標記樓板」以水平（XY）矩形是否有交集判定「正下方」 6.1 基準邏輯（自動，無對應該設定項）
單位「ft.」 ft.＝feet（英呎）不是英吋；數值型（Double）參數則一律寫 Revit 內部英尺值 「單位」下拉
標記頂／標記底 「共用參數建立」五個輸入框的預設參數名稱文字（不是按鈕或功能） 「共用參數建立」群組
.fms 設定檔 本工具自己的設定檔（JSON 內容），記錄四組勾選、參數選擇、單位、偏移與參數名稱 「Setting → Open／Load／Save／SaveAs」；關閉視窗時自動存檔
交易（transaction） Revit 的最小改動單位；本工具「每個元素一筆交易」，Ctrl+Z 以單個元素為單位還原 「更新」完成後需要回滾時

高效作業建議

✓ 這樣做更快更穩

  • 先小範圍試跑：先只勾一個階段＋一兩個類型執行，抽查參數值正確後，再擴大範圍重跑（重跑就是覆蓋，安全）。
  • 善用「自視圖挑選」：類型清單上百項時，直接到圖面點一個代表元素勾選類型，比翻清單快得多。
  • 口徑一次定好就存檔：第一案把參數對映、單位、偏移定好後「Setting → SaveAs」，之後每案「Setting → Open」即可，避免每案重設。
  • 參數命名保持一致：「建立所需參數」的名稱（標記頂/標記底/工作面高度）全公司統一，跨專案排程表才對得上。
  • 要 mm 數字就選文字型參數：數值型參數寫的是英尺原始值，人眼難讀；圖面要顯示的欄位用 String 參數（自動帶單位後綴）。
  • 基準清單常態化：「判別高程時使用樓層」預設已排除 GL 類樓層；把不該當基準的屋頂/設備層也固定取消勾選並存進設定檔。

重要注意事項

⚠️ 請務必留意

  • 覆蓋寫入、沒有舊值：「更新」直接覆蓋目標參數的原值，工具不保留歷史；首次或大批量執行前先備份檔案。
  • 偏移方向是「減」：「工作面高度」輸入值會從結果中減去（輸入 50 → 結果低 50mm）；要「加」請輸入負值。
  • ft. 是英呎不是英吋；Double 參數是英尺：兩種「單位陷阱」都會讓數字看起來差 12 倍或 304.8 倍。
  • 三個範圍清單預設全空：階段／樓層／應用元素不勾選＝什麼都不處理。
  • Ctrl+Z 以單個元素為單位還原：大量元素回不來時用備份，不要試圖連按上千次。
  • 跳過是靜默的：找不到基準、缺參數、不在勾選範圍的元素會被跳過且不在視窗內提示，請以日誌與抽查確認覆蓋率。
  • 族檔案無法開啟：在族編輯環境執行指令不會出現視窗，請回到專案檔案。

進階應用提示

💡 工作流組合技

  • 結構標高完整流程：「建立所需參數」準備 5 個共用參數 →「重新載入」→ 選參數 →「標記樓板」＋「更新」→ 結構排程表直接引用「標記頂/標記底」欄。
  • 機電淨高口徑：樓板用「標記樓層」（相對結構樓層）＋「工作面高度」記錄完成層偏移，機電側以「樓板頂−偏移」取得實際工作面向。
  • 雙基準對帳：同一批元素先用「標記樓板」跑一次、改「標記樓層」再跑一次（用不同參數欄），兩欄差值就是「樓板頂面與樓層高程」的差異，可用來稽核模型一致性。
  • 階段分批交付：依「階段」分批執行並各存一份 .fms（如 新建.fms／保留.fms），交付不同業主時口徑可追溯。
  • 與排程表連動：5 個參數都綁定了「結構樑＋樓板」且屬「Data」群組，建立後直接加進樑/樓板排程表的欄位即可批量檢視。

常見疑難排解

問題現象 可能原因 解決方法
按「更新」跑完但沒有任何元素被寫入 「階段」「樓層」「應用元素」三個清單預設全未勾選 確認三個清單都有勾選；先小範圍（一個階段＋一兩個類型）試跑
「樑頂／樑底」下拉是空的 檔案中沒有結構樑，或找不到可編輯的數值/文字參數 確認模型確有結構樑；先用「共用參數建立」建立參數後按「重新載入」
「樓板頂／樓板底」下拉是空的 檔案中沒有樓板元素 確認模型有樓板；若樓板以其他方式建立，檢查其類別是否為「樓板」
下拉裡找不到要用的參數 參數是唯讀、不是數值/文字型，或「第一根樑/第一塊樓板」上沒有該參數 檢查參數定義（可編輯、數值或文字型）；確認參數有綁定到結構樑/樓板類別後「重新載入」
按「重新載入」後之前選的參數不見了 重新載入會重建清單並重設選擇 重新選好 5 個參數（設計如此，非異常）
「標記樓板」模式：部分樑沒有被寫入 該樑正下方沒有「已勾選階段」的樓板，或兩者水平包圍矩形不重疊 到日誌確認該元素是否出現；檢查樑下方樓板的位置/階段；屬保護邏輯，非漏算
「標記樓層」模式：部分元素被跳過 元素所屬樓層未勾選在「判別高程時使用樓層」，或該樓層已是勾選清單中最低者 把元素所屬樓層及其下方基準樓層都勾進清單後重跑
寫入值比預期低（或高）一個固定數值 「工作面高度」偏移生效中（輸入值被減去） 不需要偏移就歸零；需要「加」口徑就輸入負值
數值帶兩位小數（例如 3500.48mm） 工具固定四捨五入到小數第 2 位（不是取整） 屬正常行為；若口徑要整數，請在下游（排程表）自行取整
數值型（Double）參數的值很小（如 0.33 而非 100） Double 參數寫入的是 Revit 內部單位（英呎）原始值 要毫米請改選「文字型（String）」參數（會帶 mm 後綴）
「ft.」單位的值比預期小 12 倍 ft.＝英呎，不是英吋 換用「mm」「cm」或「m」單位輸出
文字型參數值沒有單位後綴 該參數其實是數值型，或「單位」未選 確認參數為 String 型；「單位」下拉保持有選取（預設 mm）
「工作面高度」參數值是負數（如 -50） 文字型記錄的是「−偏移量（mm）」；數值型記錄的是「+偏移量（英尺）」 屬設計行為；需要正數口徑請在下游取負
重新開啟視窗，之前的設定不在 設定只在關閉時自動「存檔」，開啟時不會自動「載入」 先「Setting → Load」（或 Open 選 .fms）再執行
第一次關閉視窗時跳出檔案對話框 首次存檔時尚未設定 .fms 位置（系統請你指定） 選一個固定位置存檔；取消則寫入臨時檔案（之後可用 SaveAs 轉正）
「Setting → Load」時跳出開啟對話框 目前還没有記錄有效的設定檔路徑 在對話框選取既有 .fms 檔（或先 SaveAs 建立一個）
載入設定檔後「樓板頂／樓板底」的參數選擇不對 設定檔記錄的樓板參數實際是「樑頂／樑底」的選值（已知行為） 手動重選樓板頂/底參數後再「Setting → Save」存一次修正
「建立所需參數」先跳出「共用參數設定檔(*.txt)」對話框 專案尚未設定共用參數檔 指定 .txt 位置與名稱即可（工具會自動建立空檔並設為專案的共用參數檔）
「建立所需參數」後某些參數沒出現 專案中已有同名參數綁定，被視為「已存在」而跳過 直接用現有參數（在「更新至元素屬性」下拉選它）；或換一個名稱再建
在族檔案裡執行指令沒反應 本工具不支援族文件 回到專案檔案再執行
重複執行指令，沒有第二個視窗出現 單一執行個體設計，焦點回到已開啟的視窗 到任務列/Revit 旁找回「高程更新」視窗即可
「自視圖挑選」在圖面選不中想要的元素 只能挑選「結構樑」或「樓板」類別的實例；其他元素被過濾 改選對應類別的元素；按 Esc 取消挑選（取消會記入日誌）
「判別高程時使用樓層」清單裡 GL 樓層沒勾選 第一個名稱含「GL」的樓層預設被取消勾選（避免地面標高當基準） 需要時手動勾回；這只影響「標記樓層」模式的基準
某元素高程寫出 0 該元素的面正好與基準面同高（如樓板底面就在樓層面上） 屬正常計算結果；檢查基準選擇是否符合預期
高程值是負數 該元素的面低於基準面（如樑底低於下方樓板頂面） 屬正常計算結果；若批量出現，請檢查基準方式（標記樓板/標記樓層）選對沒有

快速查詢：遇到什麼狀況用什麼功能

我想要… 用這個功能（所在位置）
一次把全部結構樑的頂/底高程寫進參數勾選範圍＋選「樑頂／樑底」→ 按「更新」（更新至元素屬性＋更新）
記錄樓板頂/底高程勾選樓板類型＋選「樓板頂／樓板底」→ 按「更新」（應用元素＋更新至元素屬性）
高程「相對下方那塊樓板」單選「標記樓板」（預設）→「更新」（高程基準）
高程「相對指定樓層」單選「標記樓層」＋調整「判別高程時使用樓層」勾選 →「更新」（高程基準）
把完成層厚度算進工作面高程「工作面高度」輸入偏移值（注意是減去）→「更新」（更新至元素屬性）
讓所有結果統一偏移「工作面高度」數值框（可輸入負值當「加」）（更新至元素屬性）
輸出 mm / cm / m / 英呎數字「單位」下拉（注意 ft.＝英呎）（更新至元素屬性）
圖面顯示「3500mm」這種帶單位文字目標參數選「文字型（String）」（更新至元素屬性 4.1）
專案還沒有這些高程參數「建立所需參數」（BIM-Watson 群組）→「重新載入」（共用參數建立）
類型清單太長找不到「自視圖挑選」，圖面點一下就勾選（應用元素）
參數清單缺少剛建立的參數「重新載入」（更新至元素屬性）
只處理某個施工階段的元素「階段」清單只勾該階段（階段）
只處理某些樓層的元素「樓層」清單勾選（樓層）
把這套口徑存起來下次用「Setting → SaveAs」（或 Save；關閉視窗也會自動存）
在新專案套用舊口徑「Setting → Open」選 .fms → 再「更新」
確認某樑到底以哪塊樓板當基準「標記樓板」模式的日誌訊息「標記樓板:樓板名 Id:…」
抽查寫入結果Revit 中選取元素 → 屬性面板看「標記頂/標記底」等參數
跑錯範圍要回滾小範圍：Ctrl+Z 逐元素還原；大範圍：用備份檔還原

功能索引表（依控制區）

控制區 包含功能 典型產出
階段 施工階段勾選清單 依階段限定的處理範圍
樓層 樓層勾選清單（依高程排序） 依樓層限定的處理範圍
應用元素 樑/樓板類型勾選清單、「自視圖挑選」 要寫高程的類型範圍
更新至元素屬性 樑頂/樑底/樓板頂/樓板底參數選擇、「單位」、工作面高度（數值＋參數）、「重新載入」 高程寫入的參數對映與口徑（單位、偏移）
共用參數建立 5 個參數名稱輸入框、「建立所需參數」（BIM-Watson 群組） 專案中新增的長度型共用參數（綁定結構樑＋樓板）
標記樓板／標記樓層＋「判別高程時使用樓層」 兩種基準方式的單選、基準樓層勾選清單 每個元素的「基準高程」來源
更新 「更新」按鈕（逐元素計算與寫入） 元素參數中的頂/底高程數值＋偏移參數
Setting 選單 Open／Load／Save／SaveAs（.fms 設定檔） 可跨專案重用的整組設定

常用工作流卡片

第一次使用：先建參數

「共用參數建立」確認 5 個參數名稱 →「建立所需參數」（首次指定 *.txt 位置）→「重新載入」→ 在「更新至元素屬性」選好剛建的參數。之後所有專案都可以重複這組對映。

結構樑標高（樓板基準）

勾「階段」「樓層」＋「應用元素」勾樑類型 → 選「樑頂／樑底」→ 保持「標記樓板」→「更新」。日誌會逐根顯示「標記樓板:…」，完成後抽查樑參數。

樓板工作面（樓層基準＋偏移）

「應用元素」勾樓板類型 → 選「樓板頂／樓板底」→「工作面高度」輸入完成層厚度（注意是減去）→ 選「標記樓層」並調整基準清單 →「更新」。

跨專案重用口徑

第一案完成設定 →「Setting → SaveAs」存 .fms；下一案「Setting → Open」載入 → 確認範圍勾選 →「更新」。關閉視窗時會自動存檔，但開啟不會自動載入。

安全試跑

先只勾「一個階段＋一兩個類型」執行 → 抽查參數值與偏移方向 → 正確後擴大勾選範圍重跑（覆蓋寫入，重跑安全）；跑錯用備份還原。

結果稽核

同一批元素分別用「標記樓板」與「標記樓層」寫入兩個參數欄 → 在排程表看兩欄差值，稽核「樓板頂面 vs 樓層高程」的一致性；差值異常的樓層回到模型檢查。