TextCompare 說明文件
TextCompare 預設以 Compare DWG 模式開啟；標題列上的 Compare DWG / Compare with Excel 切換鈕可改為比對已匯出的 Excel 活頁簿，而非第二個 DWG 資料夾。無論哪種模式，接下來都會逐一經過以下畫面：Select Files → Review Matches → 簡短的 Comparing… 進度畫面 → Comparison Report。它僅會讀取 DWG —— 應用程式中沒有任何寫回或備份步驟，因為比對與匯出就是它的全部功能。
快速上手
截圖來自較新版本 —— 與您安裝的版本相比，視覺細節可能略有差異。
Comparing files
Compare DWG 與 Compare with Excel
在標題列上切換一般雙資料夾工作流程，與比對已匯出 Excel 活頁簿對單一 DWG 資料夾的模式。
- Compare DWG（預設模式）即本頁其餘部分所述的雙資料夾工作流程。Compare with Excel 會將 Select Files 畫面中的 Folder A 選取器，替換為單一 .xlsx 活頁簿 —— 即由搭配工具 TextSync 產生的文字資料匯出檔 —— 而 Folder B 仍為一般的 DWG 資料夾。
- 切換模式時，各模式自身的 Select Files 狀態會完整保留 —— 切換到 Compare with Excel 再切回 Compare DWG，不會遺失 Folder A/B 的檔案清單或篩選選取內容。
Compare with Excel —— 選取活頁簿
瀏覽至由 TextSync 匯出的文字資料活頁簿；Folder B 仍為一般的 DWG 資料夾。
- Browse… 用於選取 .xlsx 活頁簿。選取後，畫面會回報找到多少筆文字項目，以及原始記錄涵蓋多少個來源檔案 —— 例如 "Found 1023 text entry(ies) across 3 source file(s) in this workbook." —— 這是在尚未進行任何掃描前顯示的內容。
- 活頁簿中已存在的圖層名稱會自動成為比對範圍；此模式沒有另外的 Layers/Viewports 核取清單，因為活頁簿本身已反映了從 TextSync 匯出時所選取的內容。
- 接下來的流程與 Compare DWG 相同，依序為 Review Matches → Comparing → Comparison Report，將活頁簿中記錄的檔名與 Folder B 中實際的檔案配對 —— 此模式預設的比對策略為 Filename priority，而非 Hybrid，因為活頁簿端沒有自己的即時控制代碼資料可供 Hybrid 比對加權使用。
- Excel 活頁簿沒有已解析的圖層顏色，因此 Layer name 仍會被比對，但 LayerColor 會被排除在此模式的差異比較之外 —— 否則每一列都會顯示虛假的顏色變更。活頁簿也從不記錄文字高度，因此 TextHeight 同樣會被排除在差異比較之外。
加入檔案（Folder A / Folder B）
加入要比對的圖面批次「修改前」與「修改後」版本。
- Add Files 或 Add Folder 會分別獨立建立 Folder A（修改前）與 Folder B（修改後）。Add Folder 會掃描整個資料夾中的 .dwg 檔案 —— 是否同時掃描子資料夾取決於 "Include subfolders when adding a folder"（Settings → AutoCAD，預設關閉），此設定對兩側皆適用。
- Free 版將此步驟上限設為每側 3 個檔案（Folder A 與 Folder B 分別計算）—— 超出限制會在任何內容開始掃描前完全阻擋整次執行，並明確說明超出了哪個限制。
以 Layers 與 Viewports 篩選
將比對範圍縮小至特定圖層或圖紙空間視埠 —— 此處沒有 Blocks 分頁。
- 與 BlockCompare 不同，此處沒有 Blocks 分頁 —— 圖塊名稱在 TextCompare 中並非面向使用者的篩選項目，因為圖塊參考本身從一開始就不會被納入差異比較（見下方 Comparison Report 說明）。
- Layers 分頁才是真正的篩選項目：只有位於已勾選圖層上的 DBText/MText 實體才會被讀取。不勾選任何項目即會比對所有圖層。
- Viewports 分頁則是在掃描後套用一項位置/邊界框測試進行篩選，僅保留實際落在已勾選圖紙空間視埠範圍內的實體。
- 無論這些篩選條件為何，掃描期間仍一律會讀取圖塊參考，但純粹是為了給檔案配對演算法提供控制代碼指紋以進行配對 —— 這些圖塊參考絕不會出現在比對結果本身中。
比對策略、信心度與已儲存設定檔
TextCompare 如何決定哪個「修改前」檔案對應哪個「修改後」檔案。
- Match strategy —— Filename priority、Handle priority，或 Hybrid（預設）—— 設定提議配對時，檔名相似度與兩檔案共有的圖塊控制代碼數量各佔多少權重（Hybrid 的權重為 40% 檔名 / 60% 控制代碼）。Hybrid 是即使修訂版同時重新命名檔案，仍能維持正確配對的關鍵。
- Confidence 滑桿（0.00–1.00，預設 0.15）為提議配對的綜合分數需達到的門檻，才會被自動接受；分數低於此門檻的配對則會保留為未配對狀態，供下一個畫面手動配對。
- Save… / Load 會將目前的 Layers/Viewports 選取內容以名稱儲存（不含比對策略或信心度數值）。Free 版一次僅能保留一份設定檔 —— 儲存第二份會顯示升級提示，而不會默默覆蓋既有的設定檔。
Scan & Match
讀取兩個資料夾並提出檔案對檔案的配對建議。
- 先掃描 Folder A，再掃描 Folder B，每個處理槽在背景中一次處理一個檔案；Free 版的平行處理一律限制為 1，無論 Settings 中 "Max Parallel AutoCAD Instances" 的數值為何。此步驟也會計算每個檔案的 MD5 雜湊值，供之後偵測位元組完全相同的配對使用。
- 此步驟沒有 Cancel 按鈕，但每個檔案有 10 分鐘的時限——AutoCAD 在損壞或特別大的 DWG 上失去回應時會被終止，該檔案標記為失敗。無法讀取的檔案會被排除在比對之外並在下一個畫面列出，而不會被報告為「全部新增/刪除」。
Review Matches
在進行任何比對前，確認或修正提議的修改前/修改後檔案配對。
- 每一列顯示 File A 及其提議的 File B（可編輯的下拉選單，列出每個 Folder B 檔案），並附有 Filename %、Handle % 與 Combined % 分數。
- 以紅色標示的列表示衝突 —— 該檔案的僅依檔名最佳配對與僅依控制代碼最佳配對彼此不一致（或與目前選定的配對不一致）—— 並會列出 Conflict candidate，方便您在決定前查看候補配對。
- 沒有高信心度配對的 Folder A 檔案會自成一列，未選取 File B 且已勾選 Exclude —— 除非您自行選取 File B 並取消勾選 Exclude，否則會被排除於此次比對之外。
- Re-match 會純粹依據已掃描的快照資料重新執行配對演算法 —— 不會重新讀取任何 DWG —— 但會取代每一列的內容，捨棄自上次掃描以來所做的手動 File B 覆寫或 Exclude 變更。
Comparing（進度畫面）
確認配對到查看報告之間的簡短進度畫面 —— 此處同樣沒有 Cancel 按鈕。
- 此步驟是對已掃描快照進行純記憶體內比對 —— 不會重新開啟任何 DWG，因此即使批次很大也能很快完成。
- 此畫面沒有 Back 也沒有 Cancel —— 一旦最後一組配對完成，會自動導向 Comparison Report。
Comparison Report
每一筆文字用語或內容的變更，逐項列出 —— 僅限文字，絕不涉及圖塊參考或屬性。
- 僅比對 DBText/MText 實體。圖塊參考的掃描純粹用於協助檔案配對（見上方 Filtering 說明），絕不會出現在報告中的項目裡。
- 結果依每組已配對檔案分組。若某組配對的兩個檔案雜湊值位元組完全相同，會回報為 "Identical file — comparison skipped"，且不會為該組配對執行任何逐實體比對。
- 每筆項目顯示 Handle、Block Name（字面上為 "DBText" 或 "MText"）、Kind（Added/Removed/Modified）與文字內容，以及變更了多少個欄位 —— Details… 會並列顯示每個已變更欄位的新舊值，包括文字內容本身、位置、高度、圖層與顏色。
- 未變更的項目完全不會列在畫面上，因此高度標註的圖紙不會將少數真正的用語變更淹沒其中。
Exporting to Excel
Export to Excel
將相同的比對結果寫入任何人都能開啟的活頁簿，無需安裝 TextCompare。
- 每種實體類型（實務上為 B_DBText / B_MText）各佔一個工作表，另附一個中繼資料工作表，列出每組配對的檔名、MD5 雜湊值，以及是否因完全相同而被略過。
- 與畫面上的報告不同，匯出的工作表包含 Unchanged 列，與 Added/Modified/Removed 並列 —— 沒有任何內容被排除在檔案之外，只是不顯示於畫面上。
- Added 列以綠色填滿；Removed 列以紅色填滿並加上刪除線文字；Modified 列的每個變更儲存格都會附上記錄舊值的註解，並附有獨立的 "TextContent A"/"TextContent B" 欄位存放文字內容本身 —— 這是此處描述的預設「每筆記錄一列」版面配置；另一種配置請見下一節。
- 匯出工作表中的 Status 欄使用 "Deleted"/"Altered"，而畫面上的 Kind 欄則使用 "Removed"/"Modified" —— 兩者意義相同，僅措辭在兩種檢視方式間不同。
- 匯出本身沒有列數上限或 Free/Pro 限制 —— TextCompare 中唯一的 Free 版限制是 Scan & Match 的每側 3 個檔案上限。
選擇報告版面配置
Export to Excel 會先開啟一個小型對話框，詢問要以哪一種列版面配置寫入報告。
- One row per record（預設）即上一節所述的版面配置：已變更欄位的舊值以儲存格註解方式附加，且 TextContent 擁有各自獨立的欄位。
- Adjacent before/after rows 則改為將每個 Modified 項目展開為兩列，共用同一個 TextContent 欄位 —— 詳見下一節的說明。
- 此選擇僅影響 Modified 項目的版面配置；Added、Removed 與 Unchanged 列在兩種選擇下寫法皆相同。
雙列前後對照版面配置
另一種版面配置：Modified 項目的新舊值分別置於兩個相鄰列，而非同一列，並在兩列上皆標示變更欄位。
- 一個 Modified 項目會佔用兩列而非一列 —— 第一列為舊值，第二列為新值 —— 共用一個 "TextContent" 欄位，而非預設版面配置中獨立的 "TextContent A"/"TextContent B" 欄位。
- Status 欄在第一列顯示 "┌ ALTERED"，第二列顯示 "└ ALTERED"，因此即使工作表被篩選或排序打散，這一組仍能被識別為一個關聯單位，而不必依賴兩列保持相鄰。
- 兩列之間實際變更的每個欄位都會被標示出來（不僅是加上註解），讓審核者可以並排掃視完整的兩列內容，而不必逐一將滑鼠停留在每個標示的儲存格上。
- Added、Removed 與 Unchanged 項目不受此選項影響，兩種配置下皆維持單列，因為這些項目沒有需要配對的「前」或「後」一側。
設定
點擊標題列的齒輪圖示開啟。每個欄位都會即時儲存 —— 沒有單獨的儲存按鈕。
Language
Settings → GeneralEnglish / 简体中文 / 繁體中文 / 日本語 / 한국어 / Deutsch / Français / Italiano / Español。變更語言後需重新啟動應用程式才會生效。
預設值：EnglishTheme
Settings → GeneralSystem / Light / Dark。變更佈景主題後需重新啟動應用程式才會生效。
預設值：Match systemAutoCAD version
Settings → AutoCAD優先使用哪一個已安裝的 AutoCAD 版本。若該版本載入失敗，應用程式會自動改用其他已安裝的版本。
預設值：Auto (newest installed)Max parallel AutoCAD instances
Settings → AutoCADAutoCAD 可同時在背景處理多少張圖面（可選 1、2、4、6、8、12、16）。數值愈高速度愈快，但會使用較多 CPU 與記憶體 —— 若電腦效能較低，建議調低此值。
預設值：8Include subfolders when adding a folder
Settings → AutoCAD套用於 Select Files 畫面上的 Add Folder，對 Folder A 與 Folder B 皆適用。
預設值：Off授權
授權狀態會顯示於標題列，為 Free、Pro、Pro (offline) 或 Expired，完整資訊則在 Settings → License 中查看。
啟用授權：在 Settings → License → "License key" 貼上您的授權金鑰，然後點擊 Activate。若要將授權移轉到新電腦，請先在舊電腦上點擊 "Deactivate this machine"，再於新電腦上啟用。
如果應用程式無法連線授權伺服器（沒有網路，或伺服器暫時無法使用），先前啟用的 Pro 授權會以「Pro (offline)」狀態繼續使用 14 天。請在此期間內重新連線驗證——超過 14 天仍未驗證成功、超過訂閱到期日，或系統時鐘被調回時，授權會顯示為 Expired，直到能夠重新驗證。
疑難排解
應用程式啟動作業時出現 "AutoCAD not found" 或外掛信任錯誤
本應用程式在背景驅動 AutoCAD 來開啟並處理每張圖面，因此需要一套完整、已授權的 AutoCAD 2021–2027（不支援 AutoCAD LT）。若已安裝 AutoCAD 但仍出現此錯誤，通常表示該 AutoCAD 版本尚未在此電腦上手動啟動過：請先手動開啟一次（哪怕只是進入繪圖畫面），再關閉它後重試 —— AutoCAD 只有在互動模式下至少執行過一次後，才會信任外掛程式的位置。
Review Matches 中某一列以紅色標示
僅依檔名的配對與僅依控制代碼的配對，對於此「修改前」檔案應屬於哪個「修改後」檔案意見不一致。請查看 Conflict candidate 欄，然後選擇確認、覆寫配對，或將該列 Exclude。
掃描似乎卡住
Scan & Match 期間每個檔案有 10 分鐘的時限——失去回應的 AutoCAD 背景程序（最常見的原因是 DWG 損壞或特別大）會被終止，該檔案標記為失敗。無法讀取的檔案不參與比對，並在 Review matches 畫面列出。可在記錄資料夾中查看最後讀取的檔案。
已加入的檔案沒有出現在 Comparison Report 中
沒有高信心度配對的 Folder A 檔案，會在 Review Matches 畫面上以預先排除的狀態出現（未選取 File B、已勾選 Exclude）—— 除非您返回上一步、為它選取 File B 並取消勾選 Exclude，否則會被靜默排除於比對之外。
Re-match 似乎沒有抓到剛新增或移除的檔案
Re-match 僅會依已掃描的資料重新執行配對演算法 —— 絕不會重新讀取任何 DWG。若要納入新增或移除的檔案，請返回 Select Files 並重新執行 Scan & Match。
本機檔案
Settings → Diagnostics → Open Log Folder 可直接跳轉到記錄檔資料夾，方便疑難排解。
| 設定 | %LocalAppData%\CADXChange\TextCompare\settings.json |
| 記錄檔 | %LocalAppData%\CADXChange\TextCompare\Logs\ |
| 篩選設定檔 | %LocalAppData%\CADXChange\TextCompare\Profiles\ |