結構異動比對

基本邏輯

結構異動比對工具是一個基於雲端伺服器架構的專案版本管理系統，專門用於偵測與追蹤 BIM 模型中的結構元素變更。系統透過將本地模型的關鍵數據上傳至遠端伺服器，並與歷史版本進行比對，自動識別新增、刪除、移動或屬性修改的元素，提供完整的變更記錄與可視化報告。

此工具採用 JSON + GZip 壓縮傳輸機制確保資料效率，支援柱、樑、牆、樓板、天花板及房間等多種類型的結構元素追蹤，是大型專案協作管理與版本控制的核心工具。

前置設定

第一步：帳號登入與授權驗證

1. 首次使用需至伺服器網站註冊帳號並取得 API Key
2. 在工具介面中輸入帳號憑證進行登入
3. 系統自動驗證權限並載入可操作的專案群組清單

第二步：選擇專案群組

在「專案群組」樹狀清單中：

1. 載入現有群組：點擊「載入群組」按鈕，伺服器將回傳您有權限存取的所有專案群組
2. 建立新群組：首次使用可點擊「建立專案」创建新的專案管理空間
3. 選擇目標群組：單擊展開並選擇要操作的特定專案

第三步：檢視版本記錄（Revision）清單

在「比對」樹狀清單中查看該專案的所有歷史版本：

第四步：設定上傳參數（新增版本時）

第五步：設定比對參數（版本比較時）

選擇比對基準

樓層關鍵字過濾

• 在「樓層關鍵字」輸入框中設定（如："1F,2F,3F"）
• 系統只會比對名稱包含該關鍵字的樓層元素
• 適用於大型專案中只關注特定區域變更的情況

比對項目選擇

勾選需要追蹤的變更類型：

略過唯讀參數

勾選「略過唯讀參數比對」後，系統不會將系統自動生成的只讀屬性（如 Element ID、Created Date）納入變更檢測，避免產生大量無意義的差異報告。

第六步：來源文件設定（新增元素時）

當需要從外部檔案導入新元素：

1. 點擊「設定來源 RVT 檔案」按鈕
2. 選擇包含目標元素的 Revit 專案檔案 (.rvt)
3. 系統將該檔案路徑顯示在「來源文件」輸入框中
4. 比對時，可從來源檔複製新增的元素至本專案

第七步：確認網路與伺服器狀態

執行任何操作前，請確認：

• 連線測試：工具自動偵測至 API 伺服器的網路狀況
• 權限驗證：確認帳號具有該專案的讀/寫權限
• 伺服器時間：與本地電腦時鐘同步（避免版本時間戳混亂）
• 儲存空間：確認雲端帳戶足夠的空間容納新版本資料

第八步：資料備份與安全措施

操作步驟

功能一：上傳目前專案狀態至伺服器

1. 確認專案群組與版本名稱

   在「專案群組」清單中選擇目標專案，並在「版本名稱」輸入框填寫有意義的識別名稱。

2. 設定元素篩選條件

   勾選要上傳的元素類別（牆、柱、樑等）與階段範圍。如需精確控制，可在各類型清單中進一步篩選型式。

3. 執行上傳命令

   點擊「上傳目前狀態」按鈕開始處理。系統將：

   • 步驟 1：掃描本地 Revit 專案，收集所有符合條件的元素
   • 步驟 2：提取每個元素的關鍵數據：
       - Element ID 與 GUID
       - 幾何位置（XYZ 座標、旋轉角度）
       - 尺寸參數（長度、寬度、厚度等）
       - 型別資訊（Family 與 Type 名稱）
       - 共用參數與專案參數值
       - 所屬樓層與階段
   • 步驟 3：將資料序列化為 JSON 格式結構
   • 步驟 4：使用 GZip 演算法壓縮數據以減少傳輸量
   • 步驟 5：透過 HTTP POST 上傳至 API 伺服器
   • 步驟 6：伺服器驗證並儲存新版本，回傳成功確認訊息

   ⏱️ 上傳時間估算

   元素數量	壓縮後大小	5Mbps 網路	50Mbps 網路
   <1,000	<10MB	3-5 秒	<1 秒
   1,000-5,000	10-50MB	10-20 秒	2-5 秒
   >5,000	>50MB	30-60 秒	5-10 秒

4. 確認上傳成功

   系統顯示完成訊息，包含：
   • 上傳的元素總數
   • 壓縮後資料大小
   • 伺服器分配的版本編號（如 v1.3）
   • 時間戳記（伺服器時間）

5. 在「版本記錄」中驗證

   刷新「比對」樹狀清單，確認新版本已出現在列表中，且元素計數與預期相符。

功能二：下載指定版本並與目前專案比對

1. 選擇要比對的歷史版本

   在「比對」樹狀清單中，雙擊或單選目標版本（如 v1.2）。

2. 設定比對參數

   配置：
   • 比對基準：選擇「新」或「舊」
   • 元素類別：勾選需要檢查的類型
   • 樓層關鍵字：設定範圍過濾（如只檢查 1F-3F）
   • 略過唯讀參數：建議勾選以減少雜訊

3. 執行比對命令

   點擊「比對」按鈕開始處理。系統將：

   • 步驟 1：從伺服器下載指定版本的壓縮資料包
   • 步驟 2：本地解壓並解析 JSON 數據結構
   • 步驟 3：掃描本地專案收集當前狀態（與上傳流程類似）
   • 步驟 4：逐項比對兩個版本的元素集合：
       - 新增檢測：ID 在新版存在但舊版無 → 標記為「新增」
       - 刪除檢測：ID 在舊版存在但新版無 → 標記為「刪除」
       - 移動檢測：同一 ID 的 XYZ 座標差異超過容差（如 >1mm）→ 標記為「位置變更」
       - 參數比對：逐一比較各屬性值，記錄不同的參數名稱與舊新數值
       - 體積計算：對於樓板、牆體等計算體積變化量
   • 步驟 5：將所有差異彙整成結構化報告數據
   • 步驟 6：在「比對結果」樹狀清單中展示結果
4. 檢視比對結果清單

   系統顯示完整的異動報告，結構如下：

   比對結果：v1.3 vs v1.2
   📊 總覽統計：
     • 新增元素：柱 x5, 樑 x12, 牆 x8
     • 刪除元素：柱 x2, 樑 x3, 牆 x15
     • 位置移動：柱 x3, 樑 x7
     • 參數變更：樓板厚度 x20, 牆高度 x10
   
   🏗️ 細項明細：
   • [新增] 柱 RC-60x60 #A102 @ B1F (ID:45892)
   • [刪除] 牆 W-300mm #W205 @ 1F (ID:78234)
   • [移動] 柱 RC-50x50 #A201 @ 2F 位移：(X+50mm, Y-30mm) (ID:12456)
   • [變更] 樓板 F-20cm #FL01 @ 1F Thickness: 200mm → 220mm (ID:98765)
   
5. 深入檢視特定異動

   在比對結果清單中：

   • 展開樓層節點：查看該樓層的詳細異動清單
   • 雙擊元素項目：系統自動在 Revit 視圖中選取該元素（若存在）
   • 右鍵選單操作：針對特定變更執行處理動作

功能三：套用變更（從來源文件複製/修改）

1. 設定來源文件（若尚未設定）

   點擊「設定來源 RVT 檔案」按鈕，選擇包含新元素或正確版本的 Revit 專案。

2. 在比對結果中選擇要套用的項目

   勾選需要處理的異動項目（如所有「新增」的元素）。

3. 執行右鍵選單命令

   右鍵點擊選定項目，選擇：

   從來源文件複製

   適用：「新增」類型的元素
   作用：將來源檔中的對應元素完整複製至本地專案，包含幾何與所有參數。

   刪除元素

   適用：「刪除」類型的元素
   作用：從本地專案移除該元素，恢復到舊版本狀態。

   修改參數值

   適用：「參數變更」類型的元素
   作用：將本地元素的參數更新為來源檔的數值。

   忽略此變更

   適用：任何類型的異動
   作用：標記為已處理但不實際修改，保留在報告中供參考。

4. 批次套用變更

   可一次選取多個項目並執行相同操作：

   • 批量複製新增：將所有「新增」元素從來源檔導入
   • 批量刪除移除：清除所有被標記為「刪除」的元素
   • 選擇性還原：只還原特定類別（如只還原柱的變更，保留樑的新位置）
5. 驗證套用結果

   在 Revit 視圖中檢查：

   • 新增的元素是否正確複製且位置準確
   • 刪除的元素確實已從模型移除
   • 參數變更後的元素屬性值已更新
   • 無意外的附帶影響（如接合關係斷裂、排程表錯誤等）

功能四：樓層關鍵字過濾與精確比對

1. 輸入樓層關鍵字

   在「樓層關鍵字」欄位輸入需要比對的樓層名稱（如："1F,2F" 或 "B*"）。

2. 系統自動過濾

   比對時只會處理名稱包含該關鍵字的樓層元素，忽略其他區域。

3. 結果範圍縮小

   顯著減少異動清單長度，讓團隊聚焦於實際變更區域。

功能五：類型自動導入與參數同步

進階應用技巧

常見疑難排解

與其他工具的協同作業

最佳實踐工作流程