TextSync 說明文件
TextSync 有三種模式，可透過標題列上的切換鈕切換：Text → Excel（匯出）、Excel → Text（寫回）與 Batch Edit Styles。Text → Excel 是單一畫面；Excel → Text 是一連串較短的步驟 —— 選取活頁簿與資料夾、寫入，最後另有一個報告畫面；Batch Edit Styles 則是獨立的單一畫面，共用同一個表格。
快速上手
截圖來自較新版本 —— 與您安裝的版本相比，視覺細節可能略有差異。
Text → Excel (export)
加入檔案（Text → Excel）
建立要匯出文字的圖面批次。
- Add Files… 用於選取個別 .dwg 檔案（可多選）；Add Folder… 會掃描整個資料夾中的 .dwg 檔案 —— 是否同時掃描子資料夾取決於 "Include subfolders when adding a folder"（Settings → AutoCAD，預設關閉）。兩者都會以不區分大小寫的方式，排除清單中已存在的重複檔案。
- Clear All 會清空清單。Remove Selected 會移除選取的列 —— 這是一般按鈕，並非鍵盤快捷鍵；此畫面沒有 Delete 鍵處理，與 CADXChange 其他工具中的某些檔案清單不同。
- 檔案清單顯示名稱與路徑，可點擊任一欄標題排序。尚未加入任何檔案時，清單會顯示空白狀態提示，而非空白表格。
- 此處沒有 DBText 與 MText 的實體類型篩選 —— 批次中的每個 DBText 與 MText 實體一律會被讀取。
選項與 Export to Excel
除純文字之外還會一併匯出什麼內容，以及單次執行適用的 Free 版限制。
- Parallel processing（預設開啟）會同時讀取多個檔案，而非逐一處理。Free 版一律限制為一次僅處理一個檔案，無論此核取方塊或 Settings 中的 "Max parallel AutoCAD instances" 數值為何 —— 加速效果僅在 Pro 版生效。
- Free 版將單次執行上限設為 3 個 DWG 檔案 —— 超出限制會在執行任何動作前完全阻擋匯出，並明確說明超出了哪個限制，而不是匯出部分結果。Pro 版則移除此上限。TextSync 對匯出的活頁簿本身沒有另外的列數上限。
- Export to Excel 一律寫入單一附時間戳記的活頁簿 —— TextSync_Export_{yyyyMMdd_HHmmss}.xlsx —— 內含每個相符實體的 file、handle、entity type、layer 與 content；此檔名與輸入檔案本身的名稱無關。
- 輸出資料夾預設為所有已加入檔案的共同上層資料夾；若檔案分散於多個資料夾，則改用固定的 Documents\TextSync\Exports。
- 寫出後會提示是否立即開啟活頁簿。匯出時點擊 Cancel 會在目前檔案完成後停止。AutoCAD 失去回應的檔案會在 10 分鐘後被放棄並回報為失敗，批次的其餘檔案繼續進行。
Excel → Text (write back)
選取活頁簿與 DWG 資料夾（Excel → Text）
指向已匯出的活頁簿與其對應的圖面，並設定備份寫入位置。
- 步驟 1：Excel Workbook 瀏覽至已匯出（並已編輯）的 .xlsx 檔案。
- 步驟 2：DWG Folder。"Use the Excel file's folder"（預設勾選）會自動依活頁簿本身的位置推導資料夾；若手動瀏覽選取資料夾，會取消勾選該選項，之後便不會再自動變回原本推導出的資料夾。
- 將活頁簿列比對至圖面時，僅以該資料夾內的精確檔名比對 —— 與 Text → Excel 端的 Add Folder 不同，此資料夾一律不會遞迴掃描，無論 "Include subfolders" 設定為何。
- Automatic backup（預設開啟）會在任何變更發生前，先將每個即將被寫入的檔案原封不動地複製到備份資料夾。備份資料夾預設為在首次選取時，於 DWG 資料夾旁建立的 _TextSyncBackup 資料夾。
- Restore Backup… 會開啟一個獨立的視窗（詳見下方說明），並預先帶入目前的備份資料夾 —— 它會直接從磁碟讀取備份封存檔，因此即使應用程式已重新啟動，仍可正常運作，這一點與僅在報告畫面上使用的 Rollback All 不同。
Matched Files 與 Unmatched
TextSync 在寫入前找到的內容 —— 僅為比對數量，並非逐欄位的差異比較。
- 只要選取的活頁簿與資料夾中至少有一筆比對成功，就會自動執行比對。與 CADXChange 其他部分寫回工具不同，此處沒有試算差異的預覽步驟 —— Matched Files 分頁僅顯示每個已比對的檔案，以及其中即將變更的實體數量，而非逐欄位的前後對照表。
- 活頁簿中某一列的檔名若在 DWG 資料夾中找不到精確對應，會顯示於 Unmatched 分頁，而不會導致整批作業失敗 —— 其分頁標題會顯示目前未比對的數量。
- 若活頁簿本身讀取失敗（檔案錯誤、損毀或格式不符），狀態訊息會明確說明錯誤內容，而不是顯示空白或過期的比對清單。
Write Back
在動作發生前先確認寫入的範圍 —— 此處沒有寫入後的驗證步驟。
- 確認對話框會明確說明即將變更多少個檔案、多少個實體，並列出備份資料夾 —— 若備份已關閉，則會明確警告此變更無法復原。
- Free 版的每次執行 3 個檔案上限在此處同樣適用，依即將被寫入的已比對檔案計算。
- 檔案會逐一寫入，而非平行處理，因為每個檔案在寫入前都會先在磁碟上建立一份實際的備份檔。若某檔案的備份失敗，該檔案的寫入會完全被略過 —— TextSync 絕不會在備份剛失敗的情況下仍寫入該檔案。
- 與 BlockSync 對應的寫回功能不同，TextSync 在寫入後不會重新讀取每個檔案來驗證變更是否真正生效 —— 每個檔案的結果僅反映 AutoCAD 本身的寫入指令在寫入當下所回報的成功或失敗。 只有與圖面實際不同的值才會寫入：文字未變更的 MText 會保留全部格式（字型、色彩、堆疊等），值來自欄位的文字不會被覆寫（會回報為失敗並說明原因），沒有任何變更的檔案不會被儲存。
- Cancel 會讓目前正在寫入的檔案完成後才停止，而不是在寫入途中中斷 —— 因為中途離開可能使該張 DWG 處於寫到一半的狀態。
Write-Back Report
寫入完成後，本次執行中每個檔案的結果。
- 每個檔案各佔一列：整體狀態、成功與失敗的實體數量，以及備份存放位置（或未備份的原因）。
- 檔案的 Fail count 只要非零即可點擊，會開啟 Write Errors 彈出視窗顯示具體的逐實體原因，而不只是一個數字。
- Export Report 會將相同的逐檔明細儲存至活頁簿。
- Rollback All 可一鍵將本次執行中所有檔案還原為各自寫入前的備份 —— 但僅在此報告畫面仍開啟時有效，因為它是依此次執行的記憶體結果運作。一旦點擊 Finish 或應用程式重新啟動，請改用獨立的 Restore Backup… 視窗，該視窗會直接從磁碟讀取備份封存檔。
- Finish 會返回空白的 Excel → Text 畫面，並捨棄本次執行的結果 —— 如需留存紀錄，請先匯出報告。
Batch Edit Styles
讀取並篩選樣式（Batch Edit Styles）
加入檔案後，其中每個 TextStyle 會自動讀入同一個共用表格。
- Add Files 用於選取 .dwg 檔案（可多選）；檔案一經加入，TextSync 便會自動讀取每個檔案中的所有 TextStyle —— 沒有另外的「載入」步驟。Clear All 會清空表格。
- 表格列出 File、Style Name、Font、Big Font、Width Factor、Fixed Height 與 Current（表示該檔案目前使用中樣式的勾選標記），並在每列提供 Make Current 按鈕 —— 點擊後會將該列標示為目前使用中，並取消同一檔案中其他樣式列的標示，確保每個檔案永遠只有一個目前使用中的樣式。
- "Name contains:" 會即時依樣式名稱篩選表格；此篩選會限縮下方 Apply to All 與批次編輯欄位所套用的範圍（詳見下一節）。
- 此處的 Automatic backup 預設資料夾為第一個加入檔案旁的 _TextSyncBackup 子資料夾；若始終未設定備份資料夾，TextSync 會在寫入時退回使用應用程式本身旁的資料夾 —— 這與 Excel → Text 的預設退回方式不同，若備份出現在非預期位置，可留意這一點。
批次編輯與建立文字樣式
一次變更多列中的某個欄位，或將全新樣式加入到每個已載入的檔案中。
- 四組獨立的核取方塊＋欄位配對 —— Font、Big Font、Width Factor、Fixed Height —— 各自僅在自己的核取方塊被勾選時才會生效；未勾選的欄位即使填入數值也不會被套用。
- Apply to Selected 僅將已勾選的欄位套用至目前反白選取的表格列；Apply to All 則套用至目前 "Name contains" 篩選所顯示的每一列（不論是否被選取）—— 若要將批次編輯限縮至特定樣式，請先調整篩選條件。
- 對於 Width Factor/Fixed Height，若輸入的數值無法解析為數字，該欄位會被靜默略過，而不會顯示錯誤訊息 —— 若批次編輯似乎沒有生效，請檢查輸入的數值是否確實為數字。
- Create Text Style 會提示輸入名稱及其 Font/Big Font/Width Factor/Fixed Height，接著會加入到每個目前已載入、且尚未擁有該確切名稱（不區分大小寫）樣式的 DWG 中 —— 已擁有該樣式的檔案會被略過並另外回報，而非被覆寫。新增的列會加入表格並自動捲動至可見範圍。
Write Styles Back
將樣式定義寫回，並更新現有文字以符合新樣式 —— 不只更新樣式本身，連幾何外觀也會一併更新。
- 確認對話框會說明即將寫入多少個檔案，以及若備份已開啟，將儲存於何處；若備份已關閉，則會警告此變更無法復原。Batch Edit Styles 沒有 Free 版的檔案數量上限 —— 與另外兩種模式不同，此處單次執行並不限於 3 個檔案。
- 對於檔案中已存在的樣式，Write Styles Back 會更新其既有定義的 Font、Big Font、Width Factor 與 Fixed Height（若標示為 Current，也會將其設為該檔案目前使用中的樣式），而不是建立重複項目。
- 接著會在 Model space 與每個圖紙空間配置中，找出所有使用該樣式的 DBText，並無條件將其 Width Factor 設為一致 —— 但僅在 Fixed Height 大於零時才會更新其高度以符合 Fixed Height；Fixed Height 為 0（或空白）時，既有文字的高度會維持不變，而不會被壓縮為零。
- 與 Write Back 相同的備份硬性限制規則：若某檔案的備份失敗，該檔案的樣式寫入會完全被略過，而不是在沒有安全副本的情況下繼續進行。
Restore Backup
Restore Backup（獨立視窗）
還原任何一次過往的備份封存檔，與目前畫面上是否有執行中的作業無關。
- 以獨立視窗開啟，而非主應用程式中的分頁 —— 在 Excel → Text 與 Batch Edit Styles 中皆可使用 —— 因此即使 TextSync 已重新啟動、原本的工作階段已不存在，仍可正常運作。
- 指定一個備份資料夾，會依從新到舊列出其中的所有備份（每次執行一個）。目前版本的備份是 Backup_{timestamp} 資料夾；舊版本產生的 Backup_*.zip 壓縮檔也會列出。
- 選取一個封存檔後，會列出其中每個 DWG 檔案並附上核取方塊；Select All / Deselect All 可一次切換整個清單。
- Restore 會將勾選的檔案從封存檔複製到選定的目的資料夾（預設為備份資料夾的上層資料夾），並覆蓋任何同名的既有檔案。
設定
點擊標題列的齒輪圖示開啟。每個欄位都會即時儲存 —— 沒有單獨的儲存按鈕。
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僅套用於 Text → Excel 畫面上的 Add Folder… —— 對 Excel → Text 的 DWG 資料夾比對（一律僅限頂層）或 Batch Edit Styles（沒有資料夾選取器）皆無影響。
預設值：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 只有在互動模式下至少執行過一次後，才會信任外掛程式的位置。
作業似乎卡在某個檔案上
每個檔案有 10 分鐘的時限——如果 AutoCAD 在某個檔案上停滯這麼久，TextSync 會終止處理它的背景程序，將該檔案回報為逾時並繼續下一個檔案。你也可以隨時點擊 Cancel；AutoCAD 停滯時在做什麼，可在記錄資料夾中查看。
Excel → Text 時某個檔案出現在 "Unmatched" 中
比對僅以您選取的 DWG 資料夾內精確檔名為依據，不會遞迴子資料夾 —— 請檢查活頁簿中的檔名是否與該頂層資料夾（而非其子資料夾）中的實際檔案相符，以及匯出後是否曾被重新命名。
樣式變更似乎沒有反映在文字本身上
請確認已使用 Write Styles Back，而不只是編輯了表格 —— 這才是將 Width Factor / Fixed Height 重新套用到所有使用該樣式的既有 DBText 的步驟。同時請檢查 Fixed Height 數值：Fixed Height 為 0 或空白時，會刻意保留既有文字的高度不變，而不是將其歸零，因此即使樣式記錄已更新，文字大小在視覺上也不會改變。
Batch Edit Styles 中的批次編輯似乎沒有套用
欄位的核取方塊必須被勾選才會套用 —— 未勾選的欄位即使填入數值也會被忽略。對於 Width Factor/Fixed Height，若數值無法解析為數字，該欄位會被靜默略過而不會顯示為錯誤，請再次確認輸入的是純數字。
即使已啟用備份，某個檔案的寫入或樣式寫入仍被略過
若該特定檔案的備份複製失敗（例如備份資料夾無法寫入），TextSync 會完全略過該檔案的寫入，而不是在沒有安全副本的情況下繼續進行。請查看報告中該檔案的 Backup 欄位所顯示的錯誤，修正問題（資料夾權限、磁碟空間）後重新執行。
"Rollback All" 無法使用或沒有反應
它只在該次執行的結果仍顯示在 Write-Back Report 畫面時可用——點擊 Finish 或重新啟動應用程式後，請改用獨立的 Restore Backup… 視窗（從 Excel → Text 或 Batch Edit Styles 開啟），它可以讀取磁碟上仍保留的任何備份，包括舊版本產生的 Backup_*.zip 壓縮檔。
本機檔案
Settings → Diagnostics → Open Log Folder 可直接跳轉到記錄檔資料夾，方便疑難排解。
| 設定 | %LocalAppData%\CADXChange\TextSync\settings.json |
| 記錄檔 | %LocalAppData%\CADXChange\TextSync\Logs\ |
| 預設備份資料夾 | {DWG folder}\_TextSyncBackup |
| 預設匯出資料夾 | Documents\TextSync\Exports |