自動接合

自動接合 — 1 個分頁、10 多項操作，批量找出並接合模型中相交的柱、樓板、樑、牆、天花

功能概述

自動接合 是一個在 Revit 內部開啟的工具視窗（視窗標題為「自動接合」），它會自動連結你當前開啟的檔案，只有一個分頁「主建物主體」。它的工作是批量處理建築元素之間的「接合」關係：你先勾選要處理的樓層、階段與元素類型，工具先列出所有需要接合的元素配對（接合候選），再分批執行接合，並自動把切削方向修正成你指定的優先順序。

簡單說：手動把成百上千個相交的柱、樓板、樑、牆、天花逐一接合，既費時又容易漏接、接反；自動接合一次找出候選、分批處理、自動校正切削方向，讓模型相交處顯示乾淨一致，剖面與視圖的切削關係也正確。

💡 為什麼需要接合？

在 Revit 中，兩個實體元素（如樓板與柱）相交時，若沒有建立「接合」關係，剖面與視圖中會出現互相穿插、重複顯示的幾何。接合讓元素彼此正確切削，是模型品質與出圖正確性的基礎。本工具批量建立這種關係，並依「順序」清單統一「誰切削誰」。

30 秒快速開始

  1. 在 Revit 中開啟要處理的專案檔案（家族編輯器中執行指令不會有任何反應）。
  2. 「自動接合」工具視窗出現在 Revit 主視窗旁，並自動連結當前檔案（重複執行指令只會把已開啟的視窗帶到前面，不會疊加第二個視窗）。
  3. 在分頁「主建物主體」中：確認「樓層」與各類型清單的勾選（預設全勾）→ 按「列出接合候選」→ 檢查候選清單後按「接合」，在候選清單狀態欄與日誌中觀察進度。

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

工具視窗只有一個分頁「主建物主體」，畫面分成左、中、右三個區塊：

分頁 用途（一句話） 代表性功能
主建物主體 指定處理範圍（樓層、階段、元素類型）並批量列出、執行元素接合 列出接合候選、接合、順序、同類型接合、解構群組(接合後重新群組)、設定（Open/Load/Save/SaveAs）

畫面三個區塊速查：

  • 左側：「樓層」清單（勾選式，列出模型中全部楼层，依高程由低到高）。
  • 中間（分頁內）：五個元素類型清單「柱」「樑」「天花」（上排）與「樓板」「牆」（下排），右上是「階段」與「階段狀態」清單，其下是「順序」清單；分頁底部有「同類型接合」勾選框與「列出接合候選」按鈕。
  • 右側：「接合候選」群組（fElem / sElem / 狀態清單），下方是「單次批次接合數量」「每批次完成後存檔」「解構群組(接合後重新群組)」「清除已成功列表」與直立的「接合」「取消」按鈕。

💡 找不到功能怎麼辦？

  • 先看上面的分頁導覽與區塊速查，或到本頁最下方「快速查詢：遇到什麼狀況用什麼功能」對號入座。
  • 「操作步驟」章節依工具視窗的實際區塊排列，每個功能都標明「在哪個清單、按哪顆按鈕」。
  • 介面文字與本手冊一致（例如「列出接合候選」「接合」「取消」「清除已成功列表」「從 Revit 挑選」），看到相同文字就是找對了位置。

主要功能模組

✓ 七類用途

  • 範圍指定：「樓層」清單、五種元素類型清單（柱/樑/樓板/牆/天花）、「階段」與「階段狀態」、右鍵「從 Revit 挑選」快速勾選類型
  • 候選發現：「列出接合候選」掃描相交配對、「接合候選」清單檢視、雙擊在 Revit 中定位兩元素
  • 批量接合：「接合」分批執行（每批一個交易）、失敗配對自動略過繼續、「取消」中斷
  • 切削順序：「順序」清單拖曳調整誰切削誰、「同類型接合」限制同類型配對
  • 群組處理：「解構群組(接合後重新群組)」自動解開含候選元素的群組、接合後重新群組
  • 結果整理：「清除已成功列表」只留失敗/未處理項目、狀態欄顏色快速判斷結果
  • 設定管理：「設定」選單 Open/Load/Save/SaveAs，以 .ajs 設定檔跨專案重利用

使用情境

以下情境都附上實際要用的清單與按鈕，可以直接照著做：

情境一：新專案結構與建築元素的初次接合

結構柱、樑與建築樓板、牆體、天花配置完成後，需要批量建立接合。預設狀態（全部楼层與類型全勾選）即可：按「列出接合候選」掃描 → 檢查候選清單 → 按「接合」分批完成。接合會改變模型切削關係，執行前請先備份檔案（詳見前置設定）。

情境二：只處理特定樓層

模型很大、只需要處理某一層：在左側「樓層」清單中取消其他樓層的勾選，只留下目標樓層，再按「列出接合候選」→「接合」。未勾選樓層範圍內的元素不會被掃描與處理。

情境三：設計變更後恢復接合關係

元素位置調整後，原有接合可能失效或切削方向錯亂。重新按「列出接合候選」（已有接合的配對在「接合」執行時會自動偵測並跳過），再按「接合」：工具會把尚未接合的配對補上，並依「順序」清單校正切削方向。

情境四：修正「誰切削誰」的優先順序

相交處切削結果不符合預期（例如希望樓板切削樑，結果樑卻切了樓板）：在「順序」清單中把希望先切削的類型拖曳到前面（預設為 柱 → 樓板 → 樑 → 牆 → 天花 → 一般模型），再按「接合」——不需要重新列出候選，工具會自動交換接合順序。

情境五：接合群組內部的元素

需要接合的元素在群組裡，直接接合會受群組限制：勾選「解構群組(接合後重新群組)」後再「接合」。工具會只解開「含有候選元素」的群組，接合完成後以相同成員重新建立群組（注意：重新建立的是新群組，原群組名稱不會保留，詳見前置設定）。

情境六：大型模型的長時間批量處理

候選配對很多、跑很久：先縮小範圍（只勾必要樓層與類型），勾選「每批次完成後存檔」讓每批完成即存檔（中斷也保留進度），必要時調高「單次批次接合數量」減少批次開銷。執行中若需中斷，按「取消」即可（目前批次完成後生效）。

前置設定

第一步：開啟並連結

  1. 在 Revit 中開啟目標專案檔案（不要用家族編輯器）。
  2. 「自動接合」視窗出現在 Revit 主視窗旁並自動連結當前檔案，不需要手動匯入或重新載入模型；重複執行指令時，焦點會回到已開啟的視窗（單一執行個體設計），不會疊加第二個視窗。

💡 連結狀態確認

若指令執行後沒反應，請確認：(1) 目前不是家族編輯器（家族文件中指令直接忽略）；(2) 檔案不是唯讀/外部編輯狀態；(3) 授權登入有效（失效時會出現「登入」視窗）。視窗已開啟但覺得「沒連上」，可直接在視窗內操作——它連結的就是執行指令時的前台檔案，關閉 Revit 檔案時工具視窗也會自動關閉。

第二步：選擇處理範圍

  1. 樓層：左側「樓層」清單預設全部勾選。只勾選要處理的樓層即可；工具以元素的垂直位置判斷歸屬——元素落在「勾選樓層至其上一層樓」的區間（兩端各容許 15 公分）即被納入；若勾選的是模型最高樓層，區間上緣延至該樓層上方 5 公尺。
  2. 元素類型：五個清單「柱」「樑」「樓板」「牆」「天花」預設全部勾選，列出的是當前模型中實際存在的類型（族名＋類型名）。只處理部分類型時，取消其他項目的勾選。
  3. 階段：右上「階段」清單（單選，預選文件中的第一個階段）、「階段狀態」清單（「新建」預選／「現有」），把掃描範圍限定在特定設計階段。
  4. 快速挑選：在任一類型清單按右鍵 →「從 Revit 挑選」，到 Revit 視圖中點選元素（可連續點多個），按 Enter 結束、Esc 取消。注意：挑選會先清空該清單的所有勾選，只保留挑選到元素的類型——它是「重設並勾選」，不是「累加勾選」。

第三步：執行並觀察結果

  1. 設定選項：「同類型接合」（預設不勾）、「單次批次接合數量」（預設 15）、「每批次完成後存檔」（預設不勾）、「解構群組(接合後重新群組)」（預設不勾）。
  2. 按「列出接合候選」：出現「進度」視窗（進度條，最多 6 步）；掃描完成後候選清單填入配對，日誌顯示「預計接合:N次」。
  3. 按「接合」開始批量執行：每批完成日誌顯示「已完成第N批次」（勾選「每批次完成後存檔」時同時存檔）；候選清單狀態欄即時更新：空白＝尚未處理、綠色「成功」、紅色「失敗」。
  4. 要中斷時按「取消」（目前批次完成後生效，已完成的批次保留）。

⚠️ 執行前一定先備份

「接合」會修改模型的幾何切削關係，且以「每批一個交易」分批執行——一次 Ctrl+Z 只能還原最後一批，無法還原整次批量結果。執行大量接合前，請先用「另存新檔」建立檔案副本。「每批次完成後存檔」是安全網，但不是備份的替代品。

操作步驟

本章依工具視窗唯一分頁「主建物主體」的實際區塊排列。每個功能都標明位置（📍 所在清單與按鈕）、一句話說明與操作步驟。介面常用詞彙：「列出接合候選」（掃描候選）、「接合」（執行）、「取消」（中斷）、「清除已成功列表」（移除成功列）、「從 Revit 挑選」（到圖面選取類型）、「設定」選單（儲存/載入設定）。

分頁 1：主建物主體

本工具唯一的分頁：左側「樓層」清單、中間元素類型與階段清單和「順序」清單、右側「接合候選」清單與執行控制。「接合」會修改模型切削關係，執行前請備份檔案（見前置設定）。

1.1 樓層清單（指定處理樓層範圍）

📍 視窗最左側「樓層」清單（勾選式，依高程由低到高排列）

一句話：指定要處理的垂直範圍——只有落在勾選樓層區間內的元素會參與掃描與接合。

  1. 清單開啟時載入模型中全部楼层，且預設全部勾選。
  2. 取消不需要處理的樓層勾選，或只勾選目標樓層。
  3. 設定完成後按「列出接合候選」，掃描就只涵蓋勾選樓層區間內的元素。

💡 樓層歸屬的判斷規則

每個勾選樓層的處理區間是「該樓層高程 → 其上一層樓層高程」，兩端各容許 15 公分；若勾選的是模型中的最高樓層，區間上緣延至該樓層上方 5 公尺。元素垂直位置落在任一勾選樓層區間內即被納入，否則不會被處理（這是「為什麼我的元素沒被接合」的常見原因）。

1.2 階段與階段狀態

📍 分頁右上方：「階段」清單（單選）與下方「階段狀態」清單（「新建」「現有」）

一句話：把掃描範圍限定在特定設計階段的元素；預選文件中的第一個階段與狀態「新建」。

  1. 在「階段」清單選取要處理的階段（單選，預選文件清單的第一個階段）。
  2. 在「階段狀態」清單選取「新建」（預選）或「現有」。
  3. 掃描時只納入「在該階段的狀態符合條件」的元素（見下方說明）。

💡 「新建」狀態元素永遠會被納入

掃描的判定是：元素在「所選階段」的狀態等於「階段狀態」所選值，或該狀態為「新建」，就納入。因此即使「階段狀態」選「現有」，該階段下狀態為「新建」的元素仍會被處理——這是刻意設計，避免漏掉新建元素。

1.3 元素類型清單（柱 / 樑 / 樓板 / 牆 / 天花）

📍 分頁中央五個勾選清單：「柱」（左上）、「樑」（上中）、「天花」（右上）、「樓板」（左下）、「牆」（下中）

一句話：列出當前模型中實際存在的五種元素類型（族名＋類型名），只有勾選類型的元素會參與處理；預設全部勾選。

  1. 開啟工具時，五個清單自動載入模型中實際存在的類型（重複類型只列一次，依名稱排序）。
  2. 取消不想處理的類型勾選（預設全勾，所以「不勾＝排除」）。
  3. （選用）在任一清單按右鍵 →「從 Revit 挑選」：到 Revit 視圖點選元素（可連續點多個），按 Enter 結束、Esc 取消——挑選會先清空該清單勾選，只保留挑選到元素的類型。

💡 清單內容與「一般模型」

「柱」「樑」列出族類型（族實例的符號）；「樓板」「天花」「牆」列出各自的元素類型。「牆」清單自動排除幕牆（Curtain 牆），所以幕牆不會被本工具處理。另外還有一個「一般模型」清單：它在畫面中預設隱藏，且目前的候選掃描未包含一般模型（它只保留在「順序」清單中）——若需要接合一般模型，目前版本無法由本工具處理。

1.4 順序清單（接合／切削優先順序）

📍 分頁右欄下方的「順序」清單（游標停留其上會顯示提示「按下左鍵後移動可調整順序」）

一句話：排列 柱、樓板、樑、牆、天花、一般模型 六個類別的優先順序——排在前面的類別對排在後面的類別「切削」，接合執行時工具會自動校正方向。

  1. 確認目前順序（預設：柱 → 樓板 → 樑 → 牆 → 天花 → 一般模型）。
  2. 按住左鍵把某一列拖曳到目標位置放開，完成重排。
  3. 之後按「接合」時，每對候選都會被校正成「清單中較前類別為切削方」；若現況相反，工具自動交換接合順序。

💡 什麼時候要調整順序

相交處切削結果不符合預期（例如希望樓板切樑、結果樑切了樓板）時，把希望「做切削」的類型拖到前面，再按「接合」即可——不需要重新「列出接合候選」，切削方向的校正在接合執行時發生。

1.5 列出接合候選（掃描候選配對）

📍 分頁右下方「列出接合候選」按鈕

一句話：依照目前的樓層、階段與勾選類型，掃描出所有可能需要接合的元素配對，填入右側「接合候選」清單。

  1. 確認樓層、類型、階段設定無誤。
  2. 按「列出接合候選」：出現「進度」視窗（進度條最多 6 步），掃描期間「接合」「列出接合候選」按鈕停用。
  3. 掃描完成後候選清單填入配對，日誌顯示「預計接合:N次」。
  4. 要中斷掃描：按「進度」視窗上的「取消」（關閉該視窗效果相同）。

💡 沒有候選？先查這些

掃描結果為空（日誌可能顯示「無資料」）是正常的：可能沒有符合條件的元素、沒有相交配對，或元素沒有「上表面」幾何（掃描演算法以各元素的頂面幾何做碰撞判斷）。請先確認樓層/類型/階段範圍是否過窄、勾選是否被清空（「從 Revit 挑選」會先清空勾選）。

1.6 接合候選清單（檢視與定位）

📍 右側「接合候選」群組（三欄：fElem、sElem、狀態）

一句話：每列是一對候選元素——fElem／sElem 兩欄顯示兩個元素的 Revit 編號（數字），狀態欄顯示接合結果：空白＝尚未處理、綠色「成功」、紅色「失敗」。

  1. 「列出接合候選」後，瀏覽清單列數與內容，確認範圍符合預期。
  2. 雙擊任一列：該列的兩個元素會在目前 Revit 視圖中被選取，方便檢視空間關係。
  3. 要確認某列元素在哪：先切換到能看見它的視圖，再雙擊該列。

1.7 執行選項（批次 / 存檔 / 群組 / 同類型）

📍 右側下方「單次批次接合數量」數字框、「每批次完成後存檔」「解構群組(接合後重新群組)」勾選框；分頁底部「同類型接合」勾選框

一句話：控制「接合」怎麼跑的四個選項——每批處理幾對、是否每批存檔、是否自動解開含候選元素的群組、是否只接合同類型配對。

  1. 「單次批次接合數量」：預設 15（可設 1–5000），每批是一個 Revit 交易；調高＝批次較少、單次交易較大。
  2. 「每批次完成後存檔」：每批完成後自動儲存檔案（預設不勾；更安全但整體較慢）。
  3. 「解構群組(接合後重新群組)」：勾選後，接合前只解開「含有候選元素」的群組，接合完成後以相同成員重新建立群組。
  4. 「同類型接合」：勾選後，候選掃描只產生「相同類型」的元素配對（預設不勾，即不限同類）。

⚠️ 群組重新建立後，群組名稱不會保留

「解構群組(接合後重新群組)」完成後，被解開的群組會以「相同成員」重新建立為新群組——原群組名稱不會保留（會變成系統預設名稱）。若群組名稱重要，請在處理完成後手動重新命名。

1.8 接合（執行批量接合）

📍 右側直立的「接合」按鈕（「取消」旁邊）

一句話：對候選清單分批執行接合——尚未接合的配對建立接合、切削方向不對的自動校正、已接合與失敗的自動略過，必要時每批存檔。

  1. （強烈建議）先備份檔案，再按「接合」；處理中「接合」按鈕停用。
  2. 每批在一個交易中處理；批次完成時日誌顯示「已完成第N批次」（勾選「每批次完成後存檔」時同時存檔）。
  3. 觀察候選清單狀態欄：綠色「成功」＝已完成；紅色「失敗」＝該配對接合失敗（工具自動略過該列、繼續處理同批其餘配對）。
  4. 全部完成後日誌顯示「接合程序結束」；切換 Revit 視圖檢查相交處的切削結果。

⚠️ 執行期間請勿手動操作 Revit

批量接合過程中，Revit 可能彈出「可以忽略／不可以忽略」等警告視窗；工具會自動點擊「取消接合元素」「解除群組」等按鈕讓流程繼續。這段時間請不要手動點選或操作，以免干擾自動處理。

⚠️ 無法用一次 Ctrl+Z 還原

接合是「每批一個交易」分批執行的，一次 Ctrl+Z 只能還原最後一批的接合。整次批量結果無法一次復原，請在執行前備份檔案。

1.9 取消 與 清除已成功列表

📍 右側「取消」按鈕（直立）、「清除已成功列表」按鈕

一句話：「取消」中止進行中的接合（目前批次完成後生效，已完成的批次保留）；「清除已成功列表」把成功列移出候選清單，只留失敗與未處理的列。

  1. 進行中要停止：按「取消」，日誌顯示「接合取消」，目前批次處理完後即停止。
  2. 執行完成（或中斷）後：按「清除已成功列表」，清單只剩失敗與未處理列，集中檢視問題。
  3. 修正問題（例如移動元素、調整幾何）後直接再按「接合」：已成功與已接合的配對會自動略過。

1.10 設定選單（Open / Load / Save / SaveAs）

📍 視窗上方「設定」選單：Open、Load、Save、SaveAs

一句話：把目前設定（階段、階段狀態、樓層、各類型勾選、順序、同類型接合、批次數量、群組/存檔選項）存成 .ajs 設定檔，或從設定檔載入，方便跨專案重複利用。

  1. 第一次儲存：「設定」→「SaveAs」，在對話框指定位置與檔名（.ajs 格式）。
  2. 之後「設定」→「Save」：直接覆蓋存到目前使用的設定檔。
  3. 載入別人的設定：「設定」→「Open」選擇 .ajs 檔案，選完立即載入。
  4. 重新載入目前使用的設定檔：「設定」→「Load」。

💡 設定檔跨專案載入時請重新確認

設定檔記錄的是元素編號（樓層、類型、順序），不同專案的編號通常不同——載入到其他專案後，對應勾選可能不會生效。載入後請重新檢查各清單的勾選與順序。

使用技巧與注意事項

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

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

名詞 是什麼 在本工具中的出現位置
階段（Phase） 專案的建造/使用階段（如新建、拆除、保留），元素可歸屬不同階段 分頁右上方「階段」清單（單選，限定掃描階段）
階段狀態 元素在某階段的身份：「新建」（該階段新增）或「現有」（早於該階段） 「階段狀態」清單（預選「新建」；「新建」狀態元素永遠被納入）
樓層（Level） 水平基準面，有高程；本工具以「樓層到上一層」的垂直區間決定元素歸屬 左側「樓層」清單（預設全勾）
接合（Join） 兩個相交的實體元素「接在一起」並互相切削的關係；可解除（unjoin） 「接合」按鈕、候選清單的狀態
切削關係 相交元素中「誰切到誰」的優先順序；影響剖面與視圖顯示 由「順序」清單決定，「接合」時自動校正
接合候選 掃描出的「可能需要接合」的元素配對清單，尚未接合 右側「接合候選」群組清單
fElem / sElem 候選配對中兩個元素的 Revit 元素編號（數字），不是元素名稱 「接合候選」清單的前兩欄
順序 六個元素類別的優先順序；排在前面的類別切削排在後面的類別 「順序」清單（可拖曳重排，預設 柱→樓板→樑→牆→天花→一般模型）
同類型接合 選項：只讓「相同類型」的元素配對成為候選 分頁底部「同類型接合」勾選框
批次（chunk） 一次「接合」把候選分成多批執行，每批是一個交易；數量由「單次批次接合數量」決定（預設 15） 「單次批次接合數量」數字框、「每批次完成後存檔」
進度視窗 「列出接合候選」時彈出的「進度」視窗（進度條最多 6 步，有「取消」鈕）；關閉即中止掃描 掃描候選期間
設定檔（.ajs） 儲存階段、樓層、類型勾選、順序與各選項的檔案，可用「設定」選單 Open/Load/Save/SaveAs 管理 「設定」選單
群組（Group） 把多個元素打包一起管理；可解散（解除群組）或重建（重新群組） 「解構群組(接合後重新群組)」選項（重新建立的群組不保留原名稱）
通用模型／一般模型（Generic Model） 無特定類別的自訂族實例；本工具的「一般模型」清單預設隱藏，且目前掃描不包含它 「一般模型」清單（隱藏）、「順序」清單中的一列
族（Family）／類型 族 = Revit 元件的模板；類型 = 元素的型式（如某柱族、某牆體類型）；清單顯示「族名＋類型名」 五個元素類型清單、「從 Revit 挑選」
幕牆（Curtain Wall） 牆的一種（由格柵與面板組成）；本工具不處理幕牆 「牆」清單自動排除幕牆類型
上表面（頂面） 元素幾何中朝上的面；候選掃描以各元素的上表面幾何做碰撞判斷 「列出接合候選」的內部判斷（無頂面的元素不產生候選）

高效作業建議

✓ 這樣做更快更穩

  • 先備份再接合：「接合」修改模型切削關係且無法一次 Ctrl+Z 還原，批量執行前一律「另存新檔」。
  • 預設全勾是優點：首次開啟時樓層與類型全勾選，直接「列出接合候選」就能看全模型候選；再決定要不要縮小範圍。
  • 用「從 Revit 挑選」快速定類型：比手動勾選快得多；記得它會先清空該清單勾選，只保留挑選到的類型。
  • 大模型勾「每批次完成後存檔」：每批完成即存檔，中斷也不至於白跑；檔案大、批次多時會較慢，取捨自行決定。
  • 縮小範圍再跑：只勾需要的樓層與類型，掃描與接合都快得多；樓層區間是「樓層→上一層」，勾法比直覺的寬 15 公分、最高樓層多 5 公尺。
  • 失敗處理循環：「清除已成功列表」只留失敗列 → 雙擊在 Revit 定位 → 修正幾何 → 再按「接合」（成功的自動略過）。
  • 調整順序不用重掃：改「順序」清單後直接再按「接合」即可校正切削方向，不必重新「列出接合候選」。
  • 跨專案重用設定：把常用設定（階段、類型、順序、批次數）用「設定」→「SaveAs」存檔，下一個專案 Open/Load 後重新確認勾選即可。

重要注意事項

⚠️ 請務必留意

  • 接合無法一次復原：每批一個交易，一次 Ctrl+Z 只還原最後一批；執行前備份是必要動作，不是可選項。
  • 執行中不要碰 Revit：批量接合時工具會自動點擊 Revit 警告視窗上的「取消接合元素」「解除群組」等按鈕，手動操作會干擾流程。
  • 「取消」不是立即的：要等目前批次完成才生效，已完成的批次會保留。
  • 一般模型不會被處理：「一般模型」清單預設隱藏，目前候選掃描不包含一般模型；需要接合一般模型時本工具無法協助。
  • 幕牆不會被處理：「牆」清單自動排除幕牆類型，幕牆與其它元素的相交不會被接合。
  • 群組名稱會變：勾選「解構群組(接合後重新群組)」後，重新建立的是新群組，原名稱不保留；需要時請事後重新命名。
  • 家族編輯器無效：在家族編輯器中執行指令不會有任何反應，請在專案文件中執行。
  • 接合副程式依賴：需要 VC++ 可再發行套件（x64）；報「DLL missing.」或「接合副程式無效」時見常見疑難排解。

進階應用提示

💡 工作流組合

  • 改建案的階段化接合：「階段」選目标階段、「階段狀態」選「現有」，把接合範圍限制在既有元素（注意「新建」狀態元素仍會被納入，見 1.2）。
  • 專案切削慣例標準化：為專案訂定「順序」清單慣例（例如 柱 一定在 樓板 前、樓板 在 樑 前），用「設定」→「SaveAs」存成專案範本設定檔，全組共用。
  • 超大型模型分層跑：一次只勾一個樓層：列出候選 → 接合（勾「每批次完成後存檔」）→ 存檔 → 換下一層；比一次跑全模型更容易中斷恢復。
  • 失敗分診：跑完用「清除已成功列表」，把紅色「失敗」列逐一雙擊定位、記錄原因（幾何不相交、被群組/接合限制），修正後再「接合」。
  • 變更後快速修復：設計變更後直接「列出接合候選」→「接合」：已有接合的配對自動略過，只有斷掉或新增的配對被處理。
  • 配合批次數調速：檔案大、候選多時調高「單次批次接合數量」減少交易開銷；若 Revit 變卡或不穩，調回預設 15 或更低。

常見疑難排解

問題現象 可能原因 解決方法
執行「自動接合」指令完全沒反應目前處於家族編輯器（家族文件中指令直接忽略）在專案檔案（.rvt 模型文件）中執行指令
指令又執行一次，視窗沒多出來單一執行個體設計：已有視窗時只把焦點帶回正常現象；視窗在任務欄或 Revit 旁找回
出現「登入」視窗尚未登入 Wylin 授權系統（系統已先自動嘗試過）輸入「登入ID」按「登入」；持續失敗請聯絡授權管理
報錯「DLL missing.」接合副程式 JoinCheckProc.dll 不在安裝目錄重新安裝/修復本工具，確認 apps\Revit_AutoJoin 目錄下存在該 DLL
報錯「接合副程式無效,請安裝 https://aka.ms/vs/17/release/vc_redist.x64.exe」缺少 Microsoft Visual C++ 可再發行套件（x64）安裝該連結的 vc_redist.x64.exe，重新啟動 Revit 後再執行
「列出接合候選」很久都沒完成模型大、勾選範圍大，原生碰撞檢查耗時「進度」視窗會走到 6 步；縮小樓層/類型範圍重跑；必要時關閉「進度」視窗中止
列出候選後清單是空的、日誌「無資料」沒有符合條件的元素，或符合條件的元素沒有相交配對／沒有上表面幾何確認樓層/類型/階段勾選非空；放大樓層範圍再試；注意最高樓層只延 5 公尺
某些類型怎麼選都進不了候選「一般模型」目前不參與掃描；「牆」清單不含幕牆一般模型/幕牆目前無法由本工具處理，需手動接合
「階段狀態」選「現有」，但「新建」元素也被處理了設計如此：所選階段中狀態為「新建」的元素永遠被納入正常行為，無法關閉；若要排除，請改挑「階段」或類型範圍
勾選樓層 A，但 B 樓層附近的元素也被處理了樓層區間是「樓層→上一層」且兩端各容 15 公分；最高樓層再延 5 公尺正常行為；對精確範圍要求高時，縮小勾選樓層數量重跑
右鍵「從 Revit 挑選」後，原本的勾選都不見了挑選會先清空該清單勾選，只保留挑選到元素的類型正常行為；若是要「加上」類型，請挑選完再手動勾回其餘類型
「從 Revit 挑選」選的元素沒有被勾選挑選過濾條件：元素「類型」的類別必須與該清單相同確認挑的元素確實屬於該清單的類別（柱/樑/樓板/牆/天花）
「接合」後某些列是紅色「失敗」該配對接合失敗（幾何不相交、受既有接合/群組限制等），工具已自動略過並繼續雙擊該列在 Revit 檢視兩元素；修正後「清除已成功列表」→再按「接合」
「接合」跑到一半卡住、Revit 彈出一堆警告批量接合中 Revit 的「可以忽略/不可以忽略」警告，工具正在自動點按處理不要手動操作，等自動點按完成；若長時間停滯，檢查是否被其他對話框擋住
按「取消」後還在跑「取消」在目前批次完成後才生效等待目前批次結束；批次很大時可能需要一點時間
中斷後想確認做到哪——看候選清單狀態欄（綠色＝已完成）與日誌「已完成第N批次」；勾選「每批次完成後存檔」時檔案保留到最後完成批次
接合後切削方向反了（不該切的人切了）「順序」清單中該類別排在被切削方之後把希望先切削的類型拖到前面，直接再按「接合」（會自動交換接合順序，不必重掃）
「解構群組(接合後重新群組)」跑完，群組名稱全變了重新建立的是新群組，原名稱不保留正常行為；需要名稱時事後手動重新命名
勾了群組選項，但有些群組沒有被解開只有「含有候選元素」的群組會被解開正常行為：與候選無關的群組不受影響
候選清單的 fElem/sElem 是數字，不知道是哪個元素那是 Revit 元素編號，不是名稱雙擊該列直接在 Revit 選取這兩個元素確認
雙擊候選列，Revit 沒有選取到東西目前視圖看不見該元素（被隱藏/不在視圖範圍）切換到能看見該元素的視圖再雙擊
想只接合「同一種樓板」配對，結果全類型都接了沒勾選「同類型接合」勾選「同類型接合」後重新「列出接合候選」再「接合」
「單次批次接合數量」調很大後 Revit 變卡/報錯每批是一個交易，批次越大單次交易越重調回預設 15 或更低；大檔案建議搭配縮小範圍
整個跑很久，想要更快範圍大、批次多、每批存檔縮小樓層/類型範圍；調高批次數；不需要保護時取消「每批次完成後存檔」（權衡：中斷進度）
想復原整次接合結果，Ctrl+Z 沒用每批一個交易，一次 Ctrl+Z 只還原最後一批無法一次復原整次結果；用執行前的備份檔還原
想沿用上次專案的設定——「設定」→「Open」選擇 .ajs 設定檔（或 Load 重新載入目前檔）；載入後重新確認勾選
設定檔載入後勾選好像沒生效設定檔記錄元素編號，跨專案編號通常不同載入後逐一檢查樓層/類型/順序勾選，必要時重設

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

我想要… 用這個功能（所在分頁）
把整個模型該接的都接上預設全勾 →「列出接合候選」→「接合」（主建物主體）
只接某一樓層「樓層」清單只勾該樓層 → 列出候選 → 接合（主建物主體）
只接特定幾種元素類型清單取消其他勾選 → 列出候選 → 接合（主建物主體）
快速勾選我手邊看到的類型右鍵類型清單 →「從 Revit 挑選」（先清空再勾選）（主建物主體）
只讓同類型元素互相接合勾選「同類型接合」→ 重新列出候選 → 接合（主建物主體）
改成「樓板切樑」的優先順序「順序」清單把 樓板 拖到 樑 前面 → 直接「接合」（自動校正）
先看看有哪些配對要接、多少筆「列出接合候選」→ 看候選清單與日誌「預計接合:N次」
確認某筆候選是哪兩個元素雙擊候選列 → 兩元素在 Revit 被選取
看某筆配對接合成功沒候選清單狀態欄：空白＝未處理、綠「成功」、紅「失敗」
失敗的配對不想擋住整批不用做任何事：工具自動略過失敗列並繼續（接合執行中）
修完問題後只重跑失敗的「清除已成功列表」→ 再按「接合」（成功列自動略過）
接合跑太久，想停掉「取消」（目前批次完成後生效，已完成批次保留）
掃描候選跑到一半想停「進度」視窗上的「取消」
怕跑到一半檔案壞掉/進度丟失勾選「每批次完成後存檔」
群組裡的元素也要接勾選「解構群組(接合後重新群組)」（群組名稱事後要重命名）
讓 Revit 比較不卡調低「單次批次接合數量」（預設 15）
讓大型模型跑快一點調高「單次批次接合數量」＋縮小樓層/類型範圍
只處理某個設計階段的元素「階段」清單選該階段（＋「階段狀態」）
保存這套設定給下一個專案用「設定」→「SaveAs」（第一次）/「Save」（之後覆蓋存）
載入之前存的設定「設定」→「Open」選 .ajs 檔（選完即載入）；「Load」重新載入目前檔
知道為什麼幕牆沒被接「牆」清單自動排除幕牆——本工具不處理幕牆
知道為什麼一般模型沒被接「一般模型」清單預設隱藏且目前不參與掃描
接合後整個想復原本工具無法一次復原——請用執行前的備份檔
設計變更後快速修復接合重新「列出接合候選」→「接合」（已接的自動略過）
超大型模型分層處理一次只勾一層：列出候選 → 接合（每批存檔）→ 換下一層
確認某元素有沒有被納入掃描檢查它是否落在勾選樓層區間、類型有無勾選、階段狀態是否符合（「新建」永遠納入）
找出「為什麼沒候選」查勾選是否被清空（「從 Revit 挑選」副作用）、樓層區間、上表面幾何（見名詞對照表）
看批量跑到第幾批了日誌「已完成第N批次」與候選清單狀態欄顏色

功能索引表（依分頁）

分頁 包含功能 典型產出
主建物主體 樓層清單（範圍）、階段／階段狀態、五種元素類型清單（柱/樑/樓板/牆/天花）＋從 Revit 挑選、順序清單、列出接合候選、接合候選清單（雙擊定位）、同類型接合、單次批次接合數量、每批次完成後存檔、解構群組(接合後重新群組)、接合、取消、清除已成功列表、設定（Open/Load/Save/SaveAs） 建立好接合關係、切削方向一致的模型；.ajs 設定檔；失敗配對清單（可定位處理）

常用工作流卡片

標準接合流程

備份檔案 → 確認「樓層」與類型清單勾選（預設全勾）→「列出接合候選」→ 檢查候選清單 →「接合」→ 完成後「清除已成功列表」處理失敗列。

精確範圍接合

右鍵類型清單「從 Revit 挑選」鎖定目標類型（注意會先清空勾選）→「樓層」只勾目標層 →「列出接合候選」→「接合」。適合只處理局部區域的專案。

切削方向修正

發現相交處切反：「順序」清單拖曳調整類別優先順序 → 直接「接合」（自動交換接合順序，不必重新列出候選）。

含群組的接合

勾選「解構群組(接合後重新群組)」→「列出接合候選」→「接合」。工具只解開含候選元素的群組，完成後重新群組；記得事後檢查並重新命名群組。

大型模型安全跑法

備份 → 縮小樓層/類型範圍 → 勾選「每批次完成後存檔」→ 必要時調高「單次批次接合數量」→ 分批執行，中斷後再按「接合」即可續跑（成功列自動略過）。

設定檔跨專案重用

把專案慣例（階段、類型勾選、「順序」清單、批次數）用「設定」→「SaveAs」存成 .ajs；新專案「設定」→「Open」載入，重新確認勾選後直接列出候選與接合。