MO 填塞

功能概述

MO 填塞 是一個在 Revit 內部開啟的工具視窗（視窗標題為「MO填塞」）。它會自動連結你當前開啟的專案檔案，把「為每一樘門窗建立周邊填塞構件」的重複工作自動化：依照你勾選的門窗類型，自動在牆上建立對應的填塞（通用模型族元件），並把門窗的數值參數複製到填塞上，讓填塞尺寸與門窗保持一致。

簡單說：門窗放完後，填塞不用再一一手動放。工具會依門窗位置與面向自動放置填塞、可依牆體構造自動計算粉刷厚度（選用）、門窗參數變更後可批量同步——特別適合有大量外牆門窗、需要統一填塞細部的大型建築專案。

30 秒快速開始

在 Revit 中開啟要處理的專案檔案（需為可編輯的專案檔，家族編輯器中執行指令無效）。
執行 MO 填塞 指令（工具列上的「MO填塞」按鈕）。工具視窗出現在 Revit 主視窗旁並自動連結當前檔案（重複執行只會聚焦已開啟的視窗）。
在「製作」分頁勾選「階段」「樓層」與「門、窗」類型，選定「MO填塞樣板」並建立參數對應。
按「建立填塞」，在視窗標題列觀察處理訊息；完成後回 Revit 檢查填塞的位置與參數。

工具視窗長什麼樣？（2 個分頁導覽）

工具視窗以分頁（Tab）組織功能，頂部另有一個「設定」選單管理設定檔：

分頁	用途（一句話）	代表性功能
製作	批量建立門窗填塞的主作業區	階段/樓層/門窗範圍勾選、MO填塞樣板選擇、參數對應、粉刷厚設定、轉向反轉、「建立填塞」
調整	門窗參數變更後，把單一參數批量同步到已建立的填塞	窗類選擇、「挑選」、「更新參數」（實體參數 → 族群參數）

💡 找不到功能怎麼辦？

先翻上面的分頁導覽表，或到本頁最下方「快速查詢：遇到什麼狀況用什麼功能」對號入座。
「操作步驟」章節依分頁排列，每個功能都標明「在哪個分頁、哪個群組、按哪顆按鈕」。
介面文字與本手冊一致：「挑選」「重新讀取」「加入同名參數對應」「建立填塞」「更新參數」「清除快取」——看到相同文字就是找對了位置。

主要功能模組

✓ 八大類用途

批量填塞建立：依勾選的門窗類型在牆上自動建立填塞族元件（位置、朝向自動決定）
範圍縮小：以「階段」（建立階段）與「樓層」（所屬參考樓層）勾選限定處理範圍
參數對應：建立「門窗參數 → 填塞參數」的對應規則，支援同名批量對應與逐一手動對應
粉刷厚自動計算：依牆體複合構造（外層/結構層/內層厚度）與自訂公式計算填塞內外粉刷厚
朝向控制：填塞依門窗面向自動旋轉，「轉向反轉」可再加 180°
參數同步：門窗參數變更後，以「調整」分頁把單一參數批量同步到該類門窗的填塞
設定檔管理：把範圍勾選、對應、公式與「門窗 ↔ 填塞」對應紀錄存成 .mos 設定檔，多專案各自管理
快速定位：「挑選」在圖面點選門窗、雙擊列表在 Revit 中選取該類全部實例

使用情境

以下情境都附上實際要用的分頁與按鈕名稱，可以直接照著做：

情境一：新建專案為全部門窗批量建立填塞

建築師完成門窗配置後，要為所有門窗加上周邊填塞細節：在「製作」分頁勾選「階段」「樓層」與「門、窗」清單中的目標類型，選定「MO填塞樣板」，按「加入同名參數對應」建立參數對應，最後按「建立填塞」。（本情境會新增族類型與大量元件，先備份！詳見前置設定）

情境二：不同牆體構造自動計算粉刷厚

專案中有多種厚度的牆體（外牆厚、隔牆薄）：在「製作」分頁的「粉刷厚設定」群組勾選「啟用」，選好「內粉刷厚」「外粉刷厚」「窗框厚 a」「窗偏心 b」四個參數，保留或修改「內粉刷厚公式」「外粉刷厚公式」——工具會逐扇門窗從其安裝的牆體讀取各層厚度代入公式，自動寫入對應的填塞參數。

情境三：門窗尺寸變更後同步填塞

設計調整導致門窗參數變動，已建立的填塞不會自動更新，有兩條路：（一）重新按一次「製作」分頁的「建立填塞」——對已有對應紀錄的門窗只同步參數、不會再建新的；（二）只改單一參數時，切到「調整」分頁，選「窗類」、選好「實體參數」與「族群參數」，按「更新參數」（作用範圍是當前視圖）。

情境四：填塞朝向與預期相反

少數情況下填塞族的預設方向與門窗面向合成後朝向錯誤：勾選「製作」分頁的「轉向反轉」（填塞旋轉角度再加 180°），先對單一樓層測試確認後再擴大執行。注意：此選項只影響「新建立」的填塞。

情境五：多個專案各自管理設定

不同專案的牆體構造與門窗規格各異：完成配置後用頂部「設定」選單的「SaveAs」為每個專案獨立存一份 .mos 設定檔；換專案或重開工具時用「Open」「Load」載入對應設定（含範圍勾選、參數對應與已建立填塞的紀錄）。

情境六：誤刪填塞後重建

手動刪掉了某些填塞想重新建立：先到「設定」選單按「清除快取」清掉記憶中的「門窗 ↔ 填塞」紀錄，再按「建立填塞」重建。⚠️ 清除紀錄後若模型中還殘留其他填塞，重建會產生重複，務必先備份（詳見前置設定）。

情境七：快速盤點某類門窗

要確認某類門窗在模型中的數量與位置：在「製作」或「調整」分頁的清單中雙擊該列，Revit 會直接選取該類型的全部實例；反過來，不知道圖面某扇門窗屬於哪一類時，按「挑選」點它一下，清單會自動定位並勾選其類型。

前置設定

第一步：開啟並連結

在 Revit 中開啟目標專案檔案，並切換到方便檢查的平面視圖。
執行 MO 填塞 指令。工具視窗會自動連結當前檔案，不需要手動匯入或重新載入模型。
重複執行指令時，焦點會回到已開啟的視窗（單一執行個體），不會疊出第二個視窗；關閉 Revit 檔案時工具視窗也會自動關閉。

💡 連結狀態確認

若某些功能沒有反應，請確認：目前文件是專案檔案而非家族文件；檔案可編輯、不在外部編輯狀態；目標門窗有安裝在牆上、未被隱藏；「調整」分頁的功能需要當前視圖中確實看得見目標門窗與填塞。

第二步：選擇處理範圍

「製作」分頁有三個清單：「階段」「樓層」（勾選制）與「門、窗」（勾選類型）；「調整」分頁的「窗類」清單則是單一選取。
兩個分頁都有「挑選」按鈕：點下後到 Revit 圖面點一扇門或一扇窗（狀態列提示「挑選實體 (FamilyInstance)」，取消按 Esc），清單會自動找到對應類型。
在 Revit 中新增/刪除了門窗後，回「製作」分頁按「重新讀取」更新清單（清單勾選會被重設）。
「MO填塞樣板」清單上方的文字框可輸入關鍵字即時過濾樣板清單。

第三步：執行並觀察結果

執行前檢查勾選範圍：「階段」「樓層」「門、窗」是否都勾到；「MO填塞樣板」是否已選；參數對應與「粉刷厚設定」是否符合預期。
按「建立填塞」（製作）或「更新參數」（調整）開始處理。
處理中的訊息（目前處理的門窗、建立的類型、計算出的粉刷厚數值等）會即時顯示在工具視窗標題列，可隨時切換視圖檢查中間結果。
本工具不提供分批存檔選項；大型模型建議先只勾選單一樓層分批執行，出錯也比較好定位。

⚠️ 執行前一定先備份

「建立填塞」會新增族類型、建立新元件，並修改填塞族檔案本身（工具會開啟填塞族建立新類型並存檔）。批量執行前請先「另存新檔」建立檔案副本；執行完的設定檔也請記得用「設定 → Save」存好（裡面記錄了哪些門窗已建填塞，是避免重複建立的依據）。

操作步驟

本章依工具視窗的 2 個分頁排列（外加頂部「設定」選單）。每個功能都標明位置（📍 所在群組與按鈕）、一句話說明與操作步驟。介面常用「挑選」（到圖面選取門窗）、「重新讀取」（重新掃描清單）、「加入…對應」（建立參數對應）、「建立填塞」「更新參數」（執行）等按鈕，看到相同文字即為對應位置。

分頁 1：製作

批量建立填塞的主作業區：左側選範圍（階段/樓層）與門窗類型，中間選填塞樣板、建立參數對應，右側設定粉刷厚與朝向，最後按 建立填塞。

1.1 設定處理範圍（階段 / 樓層）

📍 左側群組「階段」與「樓層」：在清單中勾選要處理的階段與樓層

一句話：圈定「哪些階段建立、在哪一層」的門窗會被處理，兩邊都勾到才會被建立填塞。

在「階段」清單勾選要處理的設計階段（工具依門窗的「建立階段」過濾）。
在「樓層」清單勾選目標樓層（可一次勾多層）。
首次使用建議只勾單一樓層測試，確認位置、朝向與參數都正確再擴大。

💡 過濾條件說明

一扇門窗要「通過」處理，需同時滿足：類型在「門、窗」清單被勾選、安裝在牆上、其建立階段在「階段」清單被勾選、其所屬參考樓層在「樓層」清單被勾選。任何一項不滿足都會被悄悄略過（不報錯）。

1.2 選擇門窗類型（門、窗清單）

📍 群組「門、窗」：在「類」清單勾選類型；下方按鈕「挑選」「重新讀取」

一句話：列出專案中已安裝在牆上的門窗類型，勾選要建立填塞的類型；也可到圖面挑選一樘門窗反向定位它的類型。

清單列出所有「已安裝在牆上」的門窗類型，顯示為「族名稱-類型名稱」（可勾選多類）。
剛在 Revit 中新增或刪除了門窗？按「重新讀取」更新清單（注意：清單勾選會被重設）。
按「挑選」，到 Revit 圖面點一扇門或窗（提示「挑選實體 (FamilyInstance)」，取消按 Esc），工具會自動在清單中找到並勾選該類型。
雙擊清單任一行，可在 Revit 中直接選取該類型的全部實例，方便盤點數量與檢查屬性。

💡 清單為什麼沒有我的門窗？

沒有安裝在牆上（Host 為空）的門窗不會列入。若門窗是自由放置在樓板或空間中的，本工具不會處理它。

1.3 選擇填塞樣板（MO填塞樣板）

📍 群組「MO填塞樣板」：上方文字框輸入關鍵字過濾，下方「類」清單選取樣板（僅能選一個）

一句話：選一個「一般模型」類別的族類型作為填塞的建立模板，工具會以它為基礎為各門窗建立專屬填塞類型。

清單列出目前專案中所有「一般模型」（Generic Model）類別的族類型，預設自動選中第一項。
清單太長時，在上方文字框輸入關鍵字，清單即時過濾。
單點選取目標 MO 填塞樣板（單選；換選樣板會切換該樣板專屬的參數對應與下拉內容）。

⚠️ 樣板族要有參數

模板族需已定義所需的數值型參數（如「內粉刷厚」「外粉刷厚」及窗框厚、偏心等），否則「對應屬性參考」與「粉刷厚設定」的下拉選單會沒有可選項目。工具只列出數值型參數，文字型參數不會出現。

1.4 建立參數對應（對應屬性參考）

📍 群組「對應屬性參考」：按鈕「加入同名參數對應」「加入參考對應」；子群組「窗參數」「MO填塞參數」的下拉選單；下方表格（欄「窗」「MO」與「刪除」按鈕）

一句話：告訴工具「門窗的哪個參數值要複製到填塞的哪個參數」；兩族參數同名時可一鍵批量建立。

先選好「MO填塞樣板」，並在「門、窗」清單單選一類門窗（下拉與表格內容以這兩個選擇為依據）。
兩族參數命名一致時：按「加入同名參數對應」，自動比對並加入所有同名數值參數的對應（此按鈕支援多選類型一次處理）。
個別對應時：在「窗參數」選門窗側參數、在「MO填塞參數」選填塞側參數，按「加入參考對應」。
要移除對應：在表格該列點「刪除」按鈕（僅單選一個門窗類型時可操作）。
對應是依「門窗類型 + MO樣板」組合分開管理的：換類型或換樣板，看到的是各自的一組對應。

💡 兩個容易卡的點

（一）對應表格只有在「門、窗」清單恰好單選一個類型時才顯示內容，多選時表格是空的（不代表對應沒建好）；（二）下拉選單只列「數值型」參數，找不到某個參數時先確認它的參數類型是不是數值。

1.5 粉刷厚自動計算（粉刷厚設定）

📍 群組「粉刷厚設定」（分頁右側上方）：勾選「啟用」；「內粉刷厚」「外粉刷厚」「窗框厚 a」「窗偏心 b」下拉選單；「內粉刷厚公式」「外粉刷厚公式」文字框

一句話：建立填塞時，工具自動讀取門窗所安裝牆體的厚度與填塞上的兩個參數，依公式算出內外粉刷厚寫入填塞。

勾選「啟用」開啟公式計算（不勾＝建立時不算粉刷厚）。
「內粉刷厚」「外粉刷厚」選填塞上要寫入結果的兩個參數（參數名稱以「內粉刷」「外粉刷」開頭時會自動選中）。
「窗框厚 a」「窗偏心 b」選填塞上的兩個參數（名稱以「窗框厚」「偏心」開頭時會自動選中）；這兩個值從填塞族讀取，模板族需先設定好數值。
查看或修改兩個公式文字框（預設：外 (c+d+f-a)/2+(c-f)/2+b、內 (c+d+f-a)/2-(c-f)/2-b）。

📐 公式變數說明

a＝「窗框厚 a」參數值、b＝「窗偏心 b」參數值（都從填塞族讀取）。
c＝牆外層厚：宿主牆複合構造「第一層」的寬度（該層功能不是結構層時才計入）。
d＝牆結構層厚：複合構造中所有「結構層」的寬度總和。
f＝牆內層厚：複合構造「最後一層」的寬度（該層功能不是結構層時才計入）。
c/d/f 由工具對每扇門窗從其實際安裝的牆自動讀取，不需手動輸入；公式結果為負數時自動以 0 記。

⚠️ 牆體構造要先定義好

若牆體類型沒有把任何一層標記為「結構」，d 會算成 0；第一層或最後一層本身就是結構層時，c 或 f 也會是 0——結果就會不正確。啟用此功能前，請先在牆體類型的複合構造中確認各層功能標記正確。

1.6 反轉填塞朝向（轉向反轉）

📍 核取方塊「轉向反轉」（分頁右側、「建立填塞」按鈕上方）

一句話：填塞預設依門窗面向自動旋轉；勾選此項會在計算出的朝向上再旋轉 180°。

預設不勾選：填塞朝向依門窗的面向自動決定，一般情況維持即可。
若建立後發現填塞方向與預期相反，勾選「轉向反轉」後先對單一樓層重新測試。
確認方向正確後再擴大範圍執行。

⚠️ 只影響新建立的填塞

「轉向反轉」只作用於本次「新建立」的填塞；已存在的填塞朝向要調整，得先刪除它再重建（重建前記得先「設定 → 清除快取」，見 1.8）。

1.7 執行：建立填塞

📍 按鈕「建立填塞」（製作分頁右下方、全寬大按鈕）

一句話：依勾選的範圍，為每扇符合條件的門窗建立一個填塞、複製參數值，並把填塞旋轉到正確朝向。

確認：已選「MO填塞樣板」；「階段」「樓層」「門、窗」有勾選；參數對應與「粉刷厚設定」符合預期。
按「建立填塞」：工具先開啟填塞族，為每扇門窗建立一個專屬類型（類型名稱格式「MO填塞-{門窗元件編號}」，編號是該門窗在模型中的內部元件 ID），再將族載回專案。
接著對每扇符合條件的門窗：在牆上該門窗的位置建立一個填塞、複製對應的參數值（含啟用時的粉刷厚公式結果），並依門窗面向旋轉填塞。
已有對應紀錄的門窗（之前建立過且紀錄仍在）：只同步參數，不會再建新填塞。
在工具視窗標題列觀察處理訊息（目前處理的門窗、建立的類型、計算出的粉刷厚數值等），完成後回 Revit 抽查填塞位置與參數。

⚠️ 重複填塞的風險

避免重複的依據是「門窗 ↔ 填塞對應紀錄」（存在設定檔與工具記憶體中）。若紀錄遺失——沒有 Load 本專案的設定檔、按過「清除快取」、或載入了別專案的設定檔——再按「建立填塞」會為已有填塞的門窗再建一個新的，造成重複。若已發生重複：手動刪除多餘的填塞，再用「設定 → Load」載入正確設定檔恢復紀錄。

💡 執行時會發生什麼

工具會自動開啟填塞族的家族編輯器視窗（短暫出現）、建立新類型並存檔家族檔案——所以執行後「填塞族檔案本身」會被修改，這是正常行為。個別門窗處理失敗時，標題列會出現該門窗的錯誤訊息，其餘門窗不受影響。

1.8 管理設定檔（設定選單）

📍 頂部選單「設定」：「Open」「Load」「Save」「SaveAs」「清除快取」

一句話：把本專案的範圍勾選、參數對應、公式設定與「門窗 ↔ 填塞」對應紀錄存成 .mos 設定檔，之後可反覆載入。

「Save」：存到目前的設定檔位置（第一次會跳出存檔對話框選位置，之後自動記住該位置）。
「SaveAs」：選擇新的位置與檔名另存一份（適合每專案一份）。
「Open」：挑一個 .mos 設定檔載入（取消選擇＝載入一個全空的設定檔，等同清空目前設定）。
「Load」：載入上次記住位置的設定檔（工具開啟時不會自動載入，需手動執行）。
「清除快取」：清除記憶體中的「門窗 ↔ 填塞」對應紀錄——重建已刪除填塞前必須先按；風險見 1.7。

⚠️ 建立完成後請記得 Save

設定檔裡記錄了「哪些門窗已建填塞」。若建立完成後沒有「Save」，下次開啟工具就不知道這些門窗已有填塞，重跑「建立填塞」會重複建立。建議把「建立 → Save」當成一個完整動作。

分頁 2：調整

批量參數同步的分頁：門窗參數變更後，選一類門窗，指定「從門窗讀哪個參數」與「寫入填塞哪個參數」，一次同步該類門窗的填塞。

2.1 選擇門窗類型（窗類清單）

📍 左側「窗類」清單（單選）＋下方「挑選」按鈕

一句話：選定要同步填塞的門窗類型（一次一個）；也可直接到圖面挑選。

在「窗類」清單單點選取目標門窗類型（清單內容與「製作」分頁的「門、窗」清單相同）。
或按「挑選」，到 Revit 圖面點一扇門或窗，清單自動定位到它的類型。
雙擊清單行可在 Revit 中選取該類型的全部實例，先盤點再同步。

2.2 批量同步參數（更新參數）

📍 右側標籤「實體參數」「族群參數」的下拉選單＋「更新參數」按鈕

一句話：把選定門窗「某一參數」的實例值，批量寫入當前視圖中該類門窗對應填塞的參數。

先在「製作」分頁選好「MO填塞樣板」（「族群參數」下拉的內容來自該樣板的數值參數）。
在「調整」分頁選取門窗類型後，「實體參數」下拉會列出該門窗的數值參數（要讀取的來源）。
在「族群參數」選取填塞側要寫入的參數。
把 Revit 當前視圖切到含門窗與填塞的視圖，按「更新參數」。
工具逐扇門窗找出其專屬填塞類型（「MO填塞-{該門窗元件編號}」）的填塞實例，把門窗的參數值寫入。

⚠️ 作用範圍是「當前視圖」

「更新參數」只處理當前視圖內的門窗與填塞。若目前視圖沒有顯示填塞（例如在另一個樓層平面），按了也不會有任何變化——請先切到含填塞的視圖。

💡 找不到對應填塞時

某扇門窗若沒有找到名為「MO填塞-{元件編號}」的填塞類型（從未建立、或族已被刪除），該扇會直接略過。要重建請回「製作」分頁按「建立填塞」（若門窗已有殘留填塞且未清除紀錄，先評估重複風險，見 1.7）。

使用技巧與注意事項

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

本工具介面沿用 Revit 中文術語，下列是最常遇到、也最容易混淆的：

名詞	是什麼	在本工具中的出現位置
填塞（Padding）	門窗周邊的收邊/防水/隔熱構件；本工具以「通用模型」族元件表示並批量建立	「建立填塞」產生的所有新元件
MO填塞樣板	專案中「一般模型」類別的族類型，作為建立填塞的模板（單選）	「製作」分頁群組「MO填塞樣板」
填塞專屬類型	工具為每扇門窗自動建立的族類型，名稱「MO填塞-{門窗元件編號}」（編號＝該門窗的內部元件 ID，不是門窗類型編號）	「建立填塞」新增的族類型；「調整」分頁依此名稱找填塞
階段（Phase）	專案的建造/使用階段；本工具以門窗的「建立階段」過濾	「製作」分頁群組「階段」
樓層（Level）	水平基準面；本工具以門窗的「所屬參考樓層」過濾	「製作」分頁群組「樓層」
族 / 族類型 / 族實例	族＝元件模板；族類型＝族中可調整尺寸/參數的變體；族實例＝放在模型中的具體元件	「門、窗」「窗類」清單列「類」（顯示「族名稱-類型名稱」）
通用模型（Generic Model）	無特定用途類別的族；填塞樣板與填塞元件都屬於此類別	「MO填塞樣板」清單的來源範圍
參數（數值參數）	元件的屬性欄位；本工具的各下拉選單只列「數值型」參數	「窗參數」「MO填塞參數」「實體參數」「族群參數」下拉
對應（參數對應）	「門窗的哪個參數值 → 複製到填塞的哪個參數」的規則；依「門窗類型 + 樣板」分開管理	群組「對應屬性參考」的表格（欄「窗」「MO」＋「刪除」）
粉刷厚（內/外）	填塞內側/外側粉刷層的厚度，可由公式依牆體構造自動計算	群組「粉刷厚設定」的下拉與公式框
公式變數 a/b/c/d/f	a＝窗框厚、b＝窗偏心（從填塞族讀取）；c＝牆第一層寬度（非結構層時）、d＝牆結構層寬度總和、f＝牆最後一層寬度（非結構層時）	「粉刷厚設定」的標籤「窗框厚 a」「窗偏心 b」「牆外層厚 c」「牆結構層厚 d」「牆內層厚 f」與兩個公式框
轉向反轉	易誤解標籤：不是「逆時針旋轉」，勾選＝在自動計算的朝向上再加 180°；只影響新建立的填塞	「製作」分頁核取方塊「轉向反轉」
重新讀取	易誤解標籤：是重新掃描模型中「已安裝在牆上」的門窗類型清單，不是載入設定檔	「門、窗」群組按鈕「重新讀取」
清除快取	清除「門窗 ↔ 填塞」對應紀錄；重建已刪填塞前必按，但誤按會導致重複建立	選單「設定」→「清除快取」
設定檔（.mos）	記錄範圍勾選、參數對應、粉刷厚設定、轉向反轉與已建填塞紀錄的檔（.mos）	選單「設定」→「Open」「Load」「Save」「SaveAs」
實體參數	從一扇門窗「實例」上讀取的參數（來源端）	「調整」分頁標籤「實體參數」
族群參數	易誤解標籤：指填塞「族/類型」上要寫入的參數（目的端），不是 Revit 的「族」管理功能；內容來自「製作」分頁選的樣板	「調整」分頁標籤「族群參數」
標題列進度	執行時的處理訊息顯示在工具視窗標題列（目前門窗、建立類型、粉刷厚數值等）	「建立填塞」「更新參數」執行期間
挑選	到 Revit 圖面點選一扇門或窗（狀態列提示「挑選實體 (FamilyInstance)」，Esc 取消），清單自動定位該類型	「門、窗」群組與「調整」分頁的「挑選」按鈕

高效作業建議

✓ 這樣做更快更穩

先備份再處理：「建立填塞」會新增族類型、新增元件並修改填塞族檔案，大批執行前先「另存新檔」。
單樓層測試再擴大：先只勾一個樓層、一兩類門窗跑一次，確認位置、朝向與參數正確後再全案執行。
參數命名統一：門窗族與 MO 填塞族採一致的參數命名，「加入同名參數對應」才能一鍵建好全部對應。
每專案一份設定檔：用「SaveAs」為每個專案存 .mos；重開工具時先「Load」，避免重複建立填塞。
新增門窗後先「重新讀取」：在 Revit 中加完新門窗類型，先按「重新讀取」更新清單再勾選。
用「挑選」與雙擊定位：找不到某扇門窗的類型用「挑選」；要盤點某類全部實例就雙擊清單行。
盯住標題列：處理訊息即時顯示在標題列，可切到 Revit 視圖同步檢查中間結果。
定期同步：施工過程門窗尺寸有異動時，回「調整」分頁同步關鍵參數，或重跑「建立填塞」（對已有紀錄的門窗只同步參數）。

重要注意事項

⚠️ 請務必留意

重複建立風險：對應紀錄遺失（未 Load 設定檔、按過「清除快取」、載入別專案設定檔）後再跑「建立填塞」會產生重複填塞——見 1.7 的處理方式。
清除快取是雙面刃：重建「已刪除的填塞」前必須先清除；但若模型中還有其他填塞，清除後重跑會重複建立，務必先備份。
族檔案會被修改：「建立填塞」會開啟並存檔填塞族檔案（新增專屬類型）；執行後族檔案內容已變動，屬正常行為。
「更新參數」只看當前視圖：當前視圖沒有顯示填塞時，「調整」分頁的同步不會有任何效果。
「轉向反轉」預設關閉：除非確認朝向真的相反，否則不要勾選；且只影響新建立的填塞。
非安裝在牆上的門窗不處理：清單不含、也不會建立；門窗移動後填塞不會跟隨（填塞是自由元件）。

進階應用提示

💡 工作流組合技

標準建立流程：勾「階段」「樓層」→ 勾「門、窗」→ 選「MO填塞樣板」→「加入同名參數對應」→（啟用「粉刷厚設定」）→「建立填塞」→「設定 → Save」存檔設定。
多牆體構造自動粉刷厚：事先在牆體類型中把複合構造各層功能標記正確（結構層、外層、內層）→ 設定「粉刷厚設定」的四個參數與公式 → 不同牆厚的門窗各自算出對應粉刷厚。
兩級參數同步：門窗全面異動＝重跑「建立填塞」（已有紀錄的門窗只同步參數）；只動單一參數＝「調整」分頁「更新參數」，較輕量。
多專案設定庫：每專案「SaveAs」一份 .mos 集中放同一資料夾；換專案時「Open」對應檔即可帶入範圍、對應與填塞紀錄。
填塞重建流程：手動刪除填塞 →「設定 → 清除快取」→「建立填塞」，填塞會依原門窗位置重建（門窗位置若有異動，新填塞會落在門窗現位置）。
批量盤點：雙擊清單行在 Revit 選取該類全部實例 → 搭配 Revit 內建排程或屬性面板核對數量、尺寸與參數是否與填塞一致。

常見疑難排解

問題現象	可能原因	解決方法
按「建立填塞」完全沒反應	「MO填塞樣板」沒有選取（工具先檢查這一項），或沒有任何門窗同時符合勾選的階段/樓層/類型條件	確認已選樣板；逐項檢查「階段」「樓層」「門、窗」的勾選，先只勾單一樓層試跑
「門、窗」清單是空的或缺少某些門窗	清單只列「已安裝在牆上」的門窗；或 Revit 中新增了門窗但尚未刷新清單	確認門窗有安裝在牆上；按「重新讀取」重新掃描
清單勾選被重設了	按過「重新讀取」會重設清單勾選	重新勾選需要的類型（重要設定請用「設定 → Save」存檔）
建立的填塞數量比預期少	部分門窗的「建立階段」或「所屬參考樓層」不在勾選範圍內（被悄悄略過，不報錯）	在 Revit 中檢查被略過門窗的階段與樓層屬性，補勾對應的階段/樓層
某扇門窗在標題列出現錯誤訊息、沒有填塞	該門窗處理時發生例外（宿主牆異常、參數讀取失敗等），該扇被略過	查看標題列訊息；到 Revit 檢查該門窗的宿主牆與參數；先以單扇門窗測試定位問題
已有填塞的門窗又長出第二個填塞	「門窗 ↔ 填塞」對應紀錄遺失（未 Load 本專案設定檔、按過「清除快取」、或載入了別專案的設定檔）後重跑「建立填塞」	手動刪除多餘填塞；用「設定 → Load」載入正確設定檔恢復紀錄；之後每次建立完成都要「Save」
手動刪掉填塞後，按「建立填塞」沒有重建	對應紀錄還在，工具對「已有紀錄」的門窗只做參數同步、不重建	先到「設定 → 清除快取」清紀錄，再按「建立填塞」（注意重複風險，見 1.7）
「對應屬性參考」表格是空的	表格只在「門、窗」清單「恰好單選一個類型」時顯示內容	單選一個門窗類型查看；多選時對應仍可建立，只是表格不顯示
「窗參數」/「MO填塞參數」下拉是空的	「MO填塞樣板」尚未選取，或樣板沒有數值型參數	先選一個 MO 填塞樣板；確認樣板族有數值型參數
「加入同名參數對應」沒有加入任何對應	兩側參數名稱必須完全相同，且都是數值型參數	核對兩族的參數命名是否一致（含大小寫與空格）；名稱不同的改用「加入參考對應」
建立後發現對應的參數值沒有變	參數查找未命中而被靜默略過（以 Revit 內部參數 ID 查找，自訂參數是否可被查找需實測確認），或兩側數值本就相同	先以單扇門窗實測確認對應是否生效；填塞自訂的厚度參數建議改走「粉刷厚設定」公式機制（以名稱查找，較可靠）
粉刷厚計算結果是 0	牆體複合構造沒有標記結構層（d＝0），或第一層/最後一層本身就是結構層（c 或 f＝0）	到牆體類型檢查複合構造各層的「功能」標記，修正後重跑
粉刷厚比預期小	公式結果為負數時自動以 0 取代；或牆層/參數值不符合預期	在標題列查看工具記錄的窗框厚、偏心、各牆層厚數值，核對公式與參數
「內粉刷厚」/「外粉刷厚」下拉自動選錯了參數	工具會依名稱開頭（「內粉刷」「外粉刷」「窗框厚」「偏心」）自動選取符合的參數，同前綴有多個時可能選到非預想的那個	手動改選正確的參數（選取會被保存進設定檔）
建立的填塞朝向相反	樣板族預設方向與門窗面向合成後朝向不符	勾選「轉向反轉」（加 180°）後先單樓層測試；已建填塞需刪除重建（先「清除快取」）
填塞類型（MO填塞-xxx）建立了，但模型中沒有填塞	該門窗處理時發生例外被略過，或找不到對應類型	查看標題列錯誤訊息；檢查該門窗的宿主牆是否正常；單扇測試定位
門窗在牆中移動後，填塞沒有跟隨	填塞是自由元件，建立後位置固定，不會隨門窗移動	手動移動填塞到門窗現位置；或刪除後「清除快取」再重建（會落在門窗現位置）
「調整」分頁按「更新參數」沒有變化	作用範圍是「當前視圖」：當前視圖沒有該類門窗、或沒有對應填塞；或兩下拉尚未選	切到含門窗與填塞的視圖；確認已選門窗類型且「實體參數」「族群參數」都已選
「調整」分頁「族群參數」下拉是空的	其內容來自「製作」分頁目前選取的「MO填塞樣板」	先在「製作」分頁選一個 MO 填塞樣板
「調整」分頁「實體參數」下拉是空的	尚未選門窗類型，或該類門窗的數值參數清單為空	重新單選一個門窗類型（清單會重新載入其參數）
「更新參數」後部分填塞沒有更新	該門窗找不到名為「MO填塞-{元件編號}」的填塞類型（從未建立或族已刪除），該扇被略過	回「製作」分頁確認/重建該門窗的填塞（注意重複風險）
第一次「Save」要選位置、之後就不用	首次存檔需指定設定檔位置，工具會記住該位置供之後「Save」「Load」使用	首次選一個固定位置；要改位置用「SaveAs」或「Open」
「設定 → Open」取消後設定變空了	取消 Open 對話框＝載入一個全空的設定檔（預期行為）	重新「Open」挑回原本的設定檔；若本意就是重設則無須處理
工具開啟時設定沒有自動載入	工具啟動時不會自動載入設定檔，需手動「Load」或「Open」	每次開啟工具、開始建立前，先「設定 → Load」載入本專案的設定檔
「登入」視窗按「取消」後工具消失了	「取消」會連同工具視窗一起關閉（設計行為）	重新執行「MO 填塞」指令，並在「登入」視窗完成登入
執行指令後沒有視窗出現	在家族編輯器中執行（不支援），或工具視窗已開啟（單一執行個體，焦點應已回到既有視窗）	切換到專案檔案重試；查看 Revit 主視窗旁是否已有工具視窗
關閉 Revit 檔案後工具不見了	文件關閉時工具視窗會自動關閉（設計行為）	重新開啟檔案並執行指令；開始前先「Load」設定檔
想確認執行進度 / 現在處理到哪	（非故障）進度訊息顯示在工具視窗標題列	隨時看「MO填塞」視窗標題列的最新訊息；也可切換視圖檢查中間結果

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

我想要…	用這個功能（所在分頁）
為全案門窗一次建立填塞	「建立填塞」（製作，先勾好範圍與對應）
只為單一樓層建立填塞	「樓層」清單只勾該樓層 →「建立填塞」（製作）
只處理特定建造階段的門窗	「階段」清單勾選 →「建立填塞」（製作）
Revit 新增了門窗，清單沒更新	「重新讀取」（製作）
不知道圖面某扇門窗屬於哪一類	「挑選」點它一下（製作或調整）
把某類門窗在 Revit 中全部選起來盤點	雙擊清單行（製作的「門、窗」或調整的「窗類」）
填塞樣板清單太長找不到	「MO填塞樣板」上方的關鍵字框（製作）
兩族參數同名，快速建好對應	「加入同名參數對應」（製作）
兩個不同名的參數要配對	「窗參數」「MO填塞參數」＋「加入參考對應」（製作）
移除一條建錯的參數對應	對應表格該列的「刪除」按鈕（製作，需單選門窗類型）
內外粉刷厚自動依牆算	「粉刷厚設定」勾「啟用」（製作）
改粉刷厚的計算公式	「內粉刷厚公式」「外粉刷厚公式」文字框（製作）
填塞朝向反了	勾選「轉向反轉」後重建（製作，只影響新建立的填塞）
門窗尺寸變了，把對應參數同步回填塞	重跑「建立填塞」（製作，已有紀錄的門窗只同步）或「更新參數」（調整，單參數）
只批量同步一個參數到該類門窗的填塞	「實體參數」「族群參數」＋「更新參數」（調整，注意當前視圖範圍）
存好本專案的設定（含已建填塞紀錄）	「設定 → Save」（首次用 SaveAs 選位置）
換專案 / 重開工具後恢復設定	「設定 → Load」（記住位置）或「Open」（挑檔）
為每個專案各存一份設定	「設定 → SaveAs」
誤刪了填塞，要重建	「設定 → 清除快取」→「建立填塞」（製作，先備份）
防止重跑時重複建立填塞	每次建立後「設定 → Save」；重開工具先「Load」
MO 樣板清單是空的	專案尚未載入「一般模型」族 → 先從庫載入填塞族再重開工具
某些門窗永遠不出現在清單	未安裝在牆上的門窗不處理 → 讓門窗安裝到牆上
想確認建立時的計算過程	看工具視窗標題列訊息（窗框厚/偏心/各牆層厚/粉刷厚結果）
彈出「登入」視窗進不去工具	「登入ID」輸入登入碼 →「登入」；「取消」會關閉工具，需重新執行指令
指令沒反應、視窗沒出現	確認是專案檔案（非家族文件）；或視窗已開啟（單執行個體）

功能索引表（依分頁）

分頁	包含功能	典型產出
製作	階段/樓層範圍勾選、門、窗清單（挑選、重新讀取、雙擊選取）、MO填塞樣板（關鍵字過濾、單選）、對應屬性參考（加入同名參數對應、加入參考對應、窗參數/MO填塞參數、對應表格與刪除）、粉刷厚設定（啟用、四參數下拉、兩公式）、轉向反轉、建立填塞、設定選單（Open/Load/Save/SaveAs/清除快取）	與門窗尺寸一致的批量填塞、專屬填塞族類型（MO填塞-{編號}）、參數對應與 .mos 設定檔
調整	窗類清單（單選、挑選、雙擊選取）、實體參數/族群參數下拉、更新參數	與門窗最新參數一致的填塞參數值（當前視圖範圍）

常用工作流卡片

新專案首批填塞

「製作」：勾「階段」「樓層」→ 勾「門、窗」類型 → 選「MO填塞樣板」→「加入同名參數對應」→（勾「粉刷厚設定 → 啟用」）→「建立填塞」→「設定 → Save」存好設定檔。先單樓層測試再全案。

粉刷厚自動計算

事先把牆體類型的複合構造各層功能標記正確 →「粉刷厚設定」勾「啟用」、選好「內粉刷厚」「外粉刷厚」「窗框厚 a」「窗偏心 b」→ 保留或調整兩個公式 →「建立填塞」時逐扇門窗依其實裝牆自動計算。

門窗異動後同步

全面異動：重跑「建立填塞」（已有紀錄的門窗只同步參數、不新建）。單參數異動：「調整」分頁選「窗類」→ 選「實體參數」「族群參數」→ 切到含填塞的視圖 →「更新參數」。

多專案設定管理

每專案「設定 → SaveAs」一份 .mos 集中存放 → 換專案「Open」對應檔 → 開始前確認範圍與對應正確。切勿拿 A 專案的設定檔去跑 B 專案的門窗（會造成重複建立）。

填塞誤刪重建

備份檔案 →「設定 → 清除快取」→「建立填塞」重建（落在門窗現位置）→「Save」恢復紀錄。注意：只清除「要重建」的專案才安全；模型中殘留其他填塞時會重複。

批量盤點驗證

雙擊「門、窗」清單行 → Revit 選取該類全部實例 → 抽查填塞位置與參數；「調整」分頁同樣可用雙擊盤點。配合標題列的計算訊息（各牆層厚、粉刷厚結果）核對公式是否符合預期。