BlockCompare 說明文件

BlockCompare 預設以 Compare DWG 模式開啟；標題列上的 Compare DWG / Compare with Excel 切換鈕可改為比對已匯出的 Excel 活頁簿，而非第二個 DWG 資料夾。無論哪種模式，接下來都會逐一經過以下畫面：Select Files → Review Matches → 簡短的 Comparing… 進度畫面 → Comparison Report。此處沒有步驟指示器 —— 每次點擊 Back 都會返回確切的前一個畫面實例（其檔案清單、篩選與編輯內容都仍保留），而報告畫面上的 Finish 會直接跳回兩步之前的同一個 Select Files（或 Select Excel）畫面實例，而非 Review Matches —— 其檔案清單、篩選與設定檔同樣完整保留，效果與使用 Back 相同。

快速上手

截圖來自較新版本 —— 與您安裝的版本相比，視覺細節可能略有差異。

Comparing files

Compare DWG 與 Compare with Excel

在標題列上切換一般雙資料夾工作流程，與比對已匯出 Excel 活頁簿對單一 DWG 資料夾的模式。

• Compare DWG（預設模式）即本頁其餘部分所述的雙資料夾工作流程。Compare with Excel 會將 Select Files 畫面中的 Folder A 選取器，替換為單一 .xlsx 活頁簿 —— 即由搭配工具 BlockSync 產生的圖塊資料匯出檔 —— 而 Folder B 仍為一般的 DWG 資料夾。
• 切換模式時，各模式自身的 Select Files 狀態會完整保留 —— 切換到 Compare with Excel 再切回 Compare DWG，不會遺失 Folder A/B 的檔案清單或篩選選取內容。

Compare with Excel —— 選取活頁簿

瀏覽至由 BlockSync 匯出的圖塊資料活頁簿；Folder B 仍為一般的 DWG 資料夾。

• Browse… 用於選取 .xlsx 活頁簿。選取後，畫面會回報找到多少個圖塊實例，以及原始記錄涵蓋多少個來源檔案 —— 例如 "Found 13 block instance(s) across 2 source file(s) in this workbook." —— 這是在尚未進行任何掃描前顯示的內容。
• 活頁簿中已存在的圖塊名稱會自動成為比對範圍；此模式沒有另外的 Blocks/Layers/Viewports 核取清單，因為活頁簿本身已反映了從 BlockSync 匯出時所選取的內容。
• 接下來的流程與 Compare DWG 相同，依序為 Review Matches → Comparing → Comparison Report，將活頁簿中記錄的檔名與 Folder B 中實際的檔案配對 —— 此模式預設的比對策略為 Filename priority，而非 Hybrid，因為活頁簿端沒有自己的即時控制代碼資料可供 Hybrid 比對加權使用。
• Excel 活頁簿沒有已解析的圖層顏色，因此 Layer name 仍會被比對，但 LayerColor 會被排除在此模式的差異比較之外 —— 否則每一列都會顯示虛假的顏色變更。

加入檔案（Folder A / Folder B）

加入要比對的圖面批次「修改前」與「修改後」版本。

• Add Files 或 Add Folder 會分別獨立建立 Folder A（修改前）與 Folder B（修改後）。Add Folder 會掃描整個資料夾中的 .dwg 檔案 —— 是否同時掃描子資料夾取決於 "Include subfolders when adding a folder"（Settings → AutoCAD，預設關閉），此設定對兩側皆適用。重複路徑會被靜默略過。
• 在 Folder A 中新增、移除或清空檔案，都會自動觸發輕量級的預先掃描，以填入下方的 Blocks/Layers/Viewports 分頁 —— 預先掃描進行期間，Folder A 自身的 Add/Add Folder/Clear 按鈕與清單會暫時停用。Folder B 則刻意不做預先掃描，因為其作用僅為提供比對候選項目，而非驅動篩選分頁。
• 每個清單顯示 File Name 與以顏色標示的 Status，每列並附有 Remove 按鈕。尚未加入任何檔案時，清單會顯示 "No files yet — add a folder or files above."，而非空白表格。

以 Blocks、Layers 與 Viewports 篩選

根據 Folder A 的內容，縮小實際比對的範圍。

• Blocks 分頁列出 Folder A 預先掃描中找到的每個圖塊定義：Block Name、References、In Files、Dynamic 與 Has Attrs 標記。Layers 分頁則列出每個圖層名稱，附有顏色色塊與 In Files 數量。Viewports 分頁則依 Layout、Layer、Width 與 Height 列出每個圖紙空間視埠。
• 每個分頁各自擁有自己的 Search 欄；All / None / Invert 僅作用於目前搜尋結果所顯示的內容，而非未篩選的完整清單。
• 在某分頁上不勾選任何項目，即會如常比對全部內容；勾選特定圖塊/圖層則會限制 Scan & Match 最初讀取的範圍，而 Viewports 選取則是在掃描後另外套用的邊界框篩選，僅保留實際落在已勾選視埠範圍內的圖塊實例。
• 與 CADXChange 其他部分比對工具不同，此處三個分頁共用同一份篩選設定檔（見下一節），而非各分頁分別擁有各自的設定檔。

比對策略、信心度與已儲存設定檔

BlockCompare 如何決定哪個「修改前」檔案對應哪個「修改後」檔案。

• Match strategy —— Filename priority、Handle priority，或 Hybrid（預設）—— 設定提議配對時，檔名相似度與兩檔案共有的圖塊控制代碼數量各佔多少權重。Hybrid 偏向控制代碼訊號，這也是即使修訂版同時重新命名檔案，仍能維持正確配對的關鍵。
• Confidence 滑桿（0.00–1.00，預設 0.15）為提議配對的綜合分數需達到的門檻，才會被自動接受；分數低於此門檻的配對則會保留為未配對狀態，供下一個畫面手動配對。調高滑桿會使比對更嚴格；調低則會自動接受較弱的推測結果。
• Filter profile 的 Save… 會將目前的 Blocks/Layers/Viewports 選取內容以名稱儲存；Load 則會套用已儲存的選取結果，勾選名稱相符的各列並保留其餘未勾選。Free 版一次僅能保留一份設定檔 —— 以新名稱儲存第二份會顯示升級提示，而不會默默取代既有的設定檔（以相同名稱覆蓋既有設定檔則一律允許）。

Scan & Match

讀取兩個資料夾並提出檔案對檔案的配對建議 —— 這是實際開啟每個 DWG 的步驟。

• Free 版將此步驟上限設為每側 3 個檔案（Folder A 與 Folder B 分別計算）—— 超出限制會在任何內容開始掃描前完全阻擋整次執行，並明確說明超出了哪個限制，而不是掃描部分批次。
• 先掃描 Folder A，再掃描 Folder B，每個處理槽在背景中一次處理一個檔案；Free 版的平行處理一律限制為 1，無論 Settings 中 "Max Parallel AutoCAD Instances" 的數值為何，因此 Free 版的掃描一律逐一進行。此步驟也會計算每個檔案自身的 MD5 雜湊值，供之後偵測位元組完全相同的配對使用。
• 掃描失敗的檔案會標示其錯誤，不會影響批次中其他檔案的掃描；該失敗結果會延續至配對階段，成為一個無可配對對象的檔案。
• 配對本身是一個橫跨所有 Folder A/Folder B 配對的全域最佳指派（而非簡單的最近相似配對），因此某個檔案看似最佳的配對，不會搶走另一個檔案更需要的配對對象。
• 此步驟沒有 Cancel 按鈕，但每個檔案有 10 分鐘的時限——AutoCAD 在損壞或特別大的 DWG 上失去回應時會被終止，該檔案標記為失敗。無法讀取的檔案會被排除在比對之外並在下一個畫面列出，而不會被報告為「全部新增/刪除」。

Review Matches

在進行任何比對前，確認或修正提議的修改前/修改後檔案配對。

• 每一列顯示 File A 及其提議的 File B（可編輯的下拉選單，列出每個 Folder B 檔案），並附有 Filename %、Handle % 與 Combined % 分數 —— 這些百分比反映的是最初提議的配對，若您從下拉選單手動選擇其他 File B，這些數值不會重新計算。
• 以紅色標示的列表示衝突 —— 該檔案的僅依檔名最佳配對與僅依控制代碼最佳配對彼此不一致（或與目前選定的配對不一致）—— 並會列出 Conflict candidate，方便您在決定前查看候補配對。
• 沒有高信心度配對的 Folder A 檔案會自成一列，未選取 File B 且已勾選 Exclude —— 除非您自行選取 File B 並取消勾選 Exclude，否則會被排除於此次比對之外。
• Change Strategy 與 Re-match 會純粹依據已掃描的快照資料重新執行配對演算法 —— 不會重新讀取任何 DWG，因此幾乎是即時完成，但會取代每一列的內容，捨棄自上次掃描以來所做的手動 File B 覆寫或 Exclude 變更。
• Compare 需至少有一列處於「未排除且已選取 File B」的狀態才會可用。

Comparing（進度畫面）

確認配對到查看報告之間的簡短進度畫面 —— 此處同樣沒有 Cancel 按鈕。

• 已確認的配對會依序逐一比對，進度條與狀態訊息 "Comparing {n}/{total}: {File A} vs {File B}" 會在每組配對完成後更新。
• 此畫面沒有 Back 也沒有 Cancel —— 一旦最後一組配對完成，會自動導向 Comparison Report。

Comparison Report

每一組已配對檔案的逐欄位差異 —— 絕不只是標示為「不同」。

• 結果依每組已配對檔案分組，各自顯示為標題為 "{File A} → {File B}" 的可展開區塊。若某組配對的兩個檔案雜湊值位元組完全相同，會回報為 "Identical file — comparison skipped."，且完全不會列出任何詳細內容 —— 該組配對不會執行任何逐圖塊比對。
• 差異比對依據 AutoCAD 自身的持久性物件控制代碼，而非名稱或位置，因此即使圖塊被移動或重新命名，仍會被辨識為同一個實例，而不會被誤報為一次刪除加一次新增。
• 每筆項目顯示 Handle、Block Name、Kind（Added/Removed/Modified）以及變更了多少個欄位。未變更的圖塊實例完全不會列在此畫面清單中 —— 但仍會計入各組摘要列的統計，只是不會逐列列出，讓包含數千個未變更實例的圖面，不會將少數真正變更的項目淹沒。
• Details…（僅在至少有一個欄位變更時可用）會開啟一個小型彈出視窗，並列顯示每個已變更欄位的新舊值；在其中一個彈出視窗開啟時點擊另一列的 Details，只會重新指向該列，而不需先關閉目前的視窗。
• 頁面層級的摘要列刻意不包含 Unchanged 數量，即使各組自身的摘要列會顯示該數字。

Exporting to Excel

Export to Excel

將相同的比對結果寫入任何人都能開啟的活頁簿，無需安裝 BlockCompare —— 內容涵蓋畫面上報告遺漏的一切。

• 每個不同的圖塊名稱在所有已比對配對中各佔一個工作表，另附一個中繼資料工作表，列出應用程式/AutoCAD 版本，以及每組配對自身的檔名與 MD5 雜湊值（以便獨立確認哪些配對完全相同）。
• 與畫面上的報告不同，匯出的工作表包含 Unchanged 列，與 Added/Modified/Removed 並列 —— 沒有任何內容被排除在檔案之外，只是不顯示於畫面上。
• Added 列以綠色填滿；Removed 列以紅色填滿並加上刪除線文字；Modified 列不做整列填色，但每個變更的儲存格都會附上記錄舊值的註解，讓新值持續顯示於表格中，只需將滑鼠停留即可查看舊值 —— 這是此處描述的預設「每筆記錄一列」版面配置；另一種配置請見下一節。
• 匯出工作表中的 Status 欄使用與畫面上 Kind 欄不同的措辭 —— Excel 中為 "Deleted" 與 "Altered"，畫面上則為 "Removed" 與 "Modified" —— 若需交叉參照兩者，這一點值得留意。
• 匯出本身沒有列數上限或 Free/Pro 限制 —— Free 版可匯出任意大小的報告；BlockCompare 中唯一的 Free 版限制是 Scan & Match 的每側 3 個檔案上限。

選擇報告版面配置

Export to Excel 會先開啟一個小型對話框，詢問要以哪一種列版面配置寫入報告。

• One row per record（預設）即上一節所述的版面配置：已變更欄位的舊值以儲存格註解方式附加。
• Adjacent before/after rows 則改為將每個 Modified 實例展開為兩列 —— 詳見下一節的說明。
• 此選擇僅影響 Modified 實例的版面配置；Added、Removed 與 Unchanged 列在兩種選擇下寫法皆相同。

雙列前後對照版面配置

另一種版面配置：Modified 實例的新舊值分別置於兩個相鄰列，而非同一列，並在兩列上皆標示變更欄位。

• 一個 Modified 實例會佔用兩列而非一列 —— 第一列為舊值，第二列為新值 —— 而不是將舊值折疊為單一列上的註解。
• Status 欄在第一列顯示 "┌ ALTERED"，第二列顯示 "└ ALTERED"，因此即使工作表被篩選或排序打散，這一組仍能被識別為一個關聯單位，而不必依賴兩列保持相鄰。
• 兩列之間實際變更的每個欄位都會被標示出來（不僅是加上註解），讓審核者可以並排掃視完整的兩列內容，而不必逐一將滑鼠停留在每個標示的儲存格上。
• Added、Removed 與 Unchanged 實例不受此選項影響，兩種配置下皆維持單列，因為這些項目沒有需要配對的「前」或「後」一側。