BlockSync 說明文件
BlockSync 有兩種模式，可透過標題列上的切換鈕切換：AutoCAD → Excel（擷取）與 Excel → AutoCAD（寫回）。擷取模式是單一畫面，內含 Blocks/Layers/Viewports 分頁組；寫回模式則是一連串較短的步驟 —— 選取活頁簿與資料夾、檢視差異、寫入，最後另有一個結果畫面。
快速上手
截圖來自較新版本 —— 與您安裝的版本相比，視覺細節可能略有差異。
AutoCAD → Excel (extract)
加入檔案並掃描
加入圖面，BlockSync 會自動掃描圖塊、圖層與視埠。
- Add Files… (Ctrl+O) 用於選取個別 .dwg 檔案；Add Folder… 會掃描整個資料夾中的 .dwg 檔案 —— 是否同時掃描子資料夾，取決於 "Include subfolders when opening a DWG folder"（Settings → AutoCAD，預設關閉）。
- 新增、移除或清空檔案都會自動重新掃描整批檔案。F5 會依需求重新掃描而不變更檔案清單。掃描本身一旦開始就無法取消，因為中途停止會導致 Blocks/Layers/Viewports 清單彼此不一致。
- Remove Selected 會移除選取的檔案並重新掃描；Clear All 會清空清單並重新掃描。按下 Delete 鍵也會移除選取的檔案，但僅限於檔案列具有焦點時 —— 若在搜尋欄輸入時按下 Delete，則會刪除文字內容。
- 檔案清單顯示名稱、路徑，以及以顏色標示的 Status/Details 欄位；掃描失敗的檔案會標示其錯誤並略過，不會影響批次中其他檔案的正常掃描。
- 清單下方的狀態列會回報整批已掃描檔案的合計結果："{blocks} block definitions, {layers} layers, {viewports} viewports across {files} file(s)."
Blocks 分頁
選擇要擷取哪些圖塊定義，並可依需求檢視個別圖塊的詳細資訊。
- 欄位包含：核取方塊、縮圖預覽、圖塊名稱、References（整批檔案中的總參考數量）、In files（有多少檔案包含此圖塊）、Dynamic 與 Has attrs 標記，以及 Details… 按鈕（雙擊該列亦可開啟）。
- Details 會開啟一個小型彈出視窗，顯示該圖塊的參考／檔案數量、文字/MText 數量、屬性標籤清單，以及（若為動態圖塊）每個動態屬性的名稱與允許值。點選其他列時視窗不會自動關閉，可持續切換查看。
- Search 會依輸入內容即時依圖塊名稱篩選清單。Select All / Select None / Invert 僅套用於目前搜尋結果所顯示的內容，而非未篩選的完整清單。
- Save Profile… 會將目前勾選的圖塊組合命名並儲存；Load Profile 則會套用已儲存的組合（設定檔中若有圖塊名稱已不存在，會直接維持未勾選）。Free 版一次僅能保留一份設定檔 —— 儲存第二份會顯示升級提示，而不會默默覆蓋或失敗。
- Extract to Excel 需至少勾選一個圖塊才會啟用；若已載入檔案但尚未勾選任何圖塊，按鈕下方的提示會顯示 "Select at least one block above to enable extraction."
Layers 分頁
可選擇將擷取範圍限制在特定圖層 —— 擁有各自獨立的篩選與設定檔，與 Blocks 分頁分開。
- 列出整批檔案中找到的每個圖層名稱，各自附有顏色色塊，以及一個 "Present in N file(s)…" 按鈕（或雙擊該列）可查看實際包含此圖層的檔案。
- 不勾選任何項目即會如常擷取全部內容；勾選一個或多個圖層則只會擷取位於這些圖層上的圖塊參考。
- 擁有自己的 Search 欄，以及自己的 Save Profile…/Load Profile 組合 —— 圖層選取結果會與 Blocks 分頁中勾選的內容分開儲存，即使兩者以相同的設定檔名稱儲存也不會互相衝突，因此將圖層設定檔命名為 "Foo" 並不會覆蓋同樣命名為 "Foo" 的圖塊設定檔。
Viewports 分頁
可選擇將擷取範圍限制在特定圖紙空間視埠中可見的圖塊。
- 列出所有找到的視埠（依配置名稱、圖層、寬度、高度與形狀），並提供與 Layers 相同的 "Present in N file(s)…" 查詢功能，以及自己的 Search 欄 —— 此分頁沒有設定檔儲存/載入功能。
- 勾選一個或多個視埠，只會擷取透過該視埠裁切範圍可見的模型空間圖塊參考；不勾選任何項目則會如常擷取全部內容，與 Layers 的慣例相同。
- 在此勾選任何視埠，即使 Include geometry 核取方塊未勾選，也會靜默強制在該次執行中開啟（見下方的 Options 說明）—— 依視埠篩選需要每個圖塊的位置資訊，才能與視埠邊界進行比對。
Options
除屬性值本身外，還會一併擷取哪些內容 —— 預設全部開啟。
- Include nested blocks —— 同時擷取巢狀於其他圖塊內部的圖塊參考，不僅限於頂層插入。
- Include dynamic block attributes —— 連同一般屬性一起擷取動態圖塊屬性（可見性狀態、自訂參數）。讀取這些數值在 Free 版即可使用；日後將已變更的動態屬性值寫回則為 Pro 專屬功能（見下方 Write Selected Files 說明）。
- Include geometry —— 擷取每個圖塊參考的位置與旋轉角度。只要有任一 Viewports 篩選啟用，無論此核取方塊為何皆會被強制開啟。
- Include layer info —— 擷取每個圖塊參考所在的圖層。
- Parallel processing —— 同時掃描/擷取多個檔案，而非逐一處理。Free 版一律限制為一次僅處理一個檔案，無論此核取方塊或 Settings 中的 "Max parallel AutoCAD instances" 數值為何 —— 加速效果僅在 Pro 版生效。
Extract to Excel
活頁簿寫入位置，以及單次執行適用的 Free 版限制。
- Extract to Excel 一律寫入單一合併活頁簿 —— BlockSync_Export_{yyyyMMdd_HHmmss}.xlsx —— 每個圖塊定義各佔一個工作表；不提供每個檔案各自輸出一份活頁簿的選項。
- 輸出資料夾預設為所有已加入檔案的共同上層資料夾；若檔案分散於多個資料夾，則改用固定的 Documents\BlockSync\Exports。Open Output Folder 可直接跳至該處，若尚未存在則會先建立。
- Free 版將單次執行上限設為 3 個 DWG 檔案，且匯出列數合計不超過 300 列。任一項超出限制都會在寫入任何內容前完全阻擋匯出，而不是默默匯出一份被截斷的結果 —— Free 版的匯出絕不會悄悄漏資料，而是直接拒絕執行並明確說明超出了哪個限制。Pro 版則移除這兩項上限。
- 寫入完成後，會出現提示詢問是否立即開啟活頁簿。Cancel（於擷取進行中）會在目前正在處理的檔案完成後停止，並同時終止 AutoCAD 對該檔案的背景處理，而不是讓它繼續在背景執行。
Excel → AutoCAD (write back)
選取活頁簿與 DWG 資料夾
指向已匯出的活頁簿與其對應的圖面，並設定備份寫入位置。
- 步驟 1 瀏覽至已匯出（並已編輯）的 .xlsx 活頁簿；旁邊的按鈕會直接以系統預設程式開啟該檔案，方便在比對前快速檢查。
- 步驟 2 選取 DWG 資料夾。"Same folder as Excel file"（預設勾選）會自動依活頁簿本身的位置推導資料夾；若手動瀏覽選取資料夾，會取消勾選該選項，之後便不會再自動變回原本推導出的資料夾。
- 將活頁簿列比對至圖面時，僅以該資料夾內的精確檔名比對 —— 不會遞迴至子資料夾，這一點與 AutoCAD → Excel 端的 Add Folder 不同。
- Enable automatic backup（預設開啟）會在任何變更發生前，先將每個即將被寫入的檔案原封不動地複製到備份資料夾。關閉此選項後，該次執行將無法以任何方式回復。
- 備份資料夾預設為在首次選取時，於 DWG 資料夾旁建立的 _BlockSyncBackup 資料夾；Browse 可變更此位置。
- Restore Backup… 會開啟一個獨立的視窗（詳見下方說明），並預先帶入目前的備份資料夾 —— 它會直接從磁碟讀取備份封存檔，因此即使應用程式已重新啟動，仍可正常運作，這一點與僅在結果畫面上使用的 Rollback All 不同。
差異預覽
BlockSync 即將進行的每一項屬性變更，先以唯讀方式進行試算。
- 只要選取的活頁簿與資料夾中至少有一筆比對成功，就會自動執行預覽，將 Excel 中每一列與圖面現有屬性逐一比對，比對依據為 AutoCAD 自身的物件控制代碼（handle），而非列的位置或順序。
- 左側的檔案清單會顯示每個已比對檔案的 Change 數量與 Blocked 數量；選取檔案後，右側會顯示完整的 File / Handle / Block / Attribute / Current / New 表格。
- Show unchanged rows 預設關閉 —— 若有數百項未變更的屬性，未關閉時會將真正需要注意的少數變更淹沒其中。若需完整稽核某個檔案，可開啟此選項。
- 某一列被標為 Blocked 而非一般修改的原因包括：Excel 中的控制碼在圖面中已不存在、該實例上不存在此屬性標籤、（動態屬性）新值不在該實例的允許值清單中、屬性值來自欄位（寫入會把欄位取代成靜態文字），或圖面本身無法讀取。這些情況都不會中斷其餘的執行——只會略過該列（或該檔案）。
- 活頁簿中某一列的檔名若在 DWG 資料夾中找不到精確對應，會顯示於 Unmatched 分頁，而不會導致整個比對失敗。
- Export Preview… 會將每個檔案的所有列（無論是變更、未變更或被阻擋）寫入其專屬的活頁簿 —— 適合在正式寫入前，於 BlockSync 之外供他人審核或簽核差異內容。
Write Selected Files
先確認即將寫入的確切範圍，再逐一驗證每項變更是否真正生效。
- 只有在差異預覽左側清單中仍勾選的檔案才會被納入寫入；在被納入的檔案中，也只有標示為實際變更的列會被送出 —— 未變更與被阻擋的列不會被寫入，即使同一檔案兩者皆有也是如此。
- 確認對話框會明確說明即將異動多少個檔案、多少項屬性變更，並列出備份資料夾 —— 若備份已關閉，則會明確警告這些檔案將被修改且無法回復。
- 編輯動態圖塊屬性值是 Pro 專屬功能：若任何被納入的變更屬於動態屬性編輯，Free 版會阻擋整個寫入作業，並顯示 "Editing dynamic block attributes is a Pro feature."（擷取時讀取動態屬性值不受此限制影響）。
- 與 Extract 相同的每次執行 3 張圖面上限，在此處同樣依已勾選/納入的檔案計算。
- 檔案會逐一處理 —— 先備份、寫入，再讀回以驗證 —— 而非平行處理，因為每個檔案都會在磁碟上建立一份實際的備份檔。若某檔案的備份失敗，該檔案的寫入會完全被略過；BlockSync 絕不會在備份剛失敗的情況下仍寫入該檔案，即使該項變更本身可能是安全的。
- 寫入後，BlockSync 會重新讀取剛修改的所有內容——屬性、動態性質、圖層和旋轉——並與寫入的值比較。不一致不會使執行失敗，但會被記錄並顯示在結果畫面上，而不是預設視為成功。
- Cancel 會讓目前正在寫入的檔案完成後才停止 —— 絕不會在檔案寫入途中中斷。
寫入結果
本次執行中每個檔案的結果，包括任何讀回後與寫入內容不符的項目。
- 每個檔案各佔一列：整體狀態、成功與失敗的屬性變更數量、備份存放位置（或未備份的原因），以及發現多少筆讀回不一致。
- 檔案的 Fail count 與 Read-back mismatches count 只要非零即可點擊，會開啟彈出視窗顯示具體原因或數值，而不只是一個數字。
- Export Report… 會將相同的逐檔明細儲存至活頁簿，以便在應用程式之外留存紀錄。
- Rollback All 可一鍵將本次執行中所有檔案還原為各自寫入前的備份 —— 但僅在結果畫面仍開啟時有效。一旦離開此畫面（點擊 Finish）或應用程式重新啟動，請改用獨立的 Restore Backup 視窗，該視窗會依據磁碟上的備份檔案運作，而非本次執行的記憶體狀態。
- Finish 會返回空白的 Excel → AutoCAD 畫面，並捨棄本次執行的結果 —— 如需留存紀錄，請先匯出報告。
Restore Backup
Restore Backup（獨立視窗）
還原任何一次過往的備份封存檔，與目前畫面上是否有執行中的作業無關。
- 以獨立視窗開啟，而非主應用程式中的分頁，因此即使 BlockSync 已重新啟動、原本的寫回工作階段已不存在，仍可正常運作。
- 指定一個備份資料夾，會依從新到舊列出其中的所有備份（每次執行一個）。目前版本的備份是 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 opening a DWG folder
Settings → AutoCAD套用於 AutoCAD → Excel 畫面上的 Add Folder…。
預設值：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 只有在互動模式下至少執行過一次後，才會信任外掛程式的位置。
掃描、擷取或寫回作業似乎卡在某個檔案上
除了可手動點擊 Cancel 外，每個檔案本身也有 10 分鐘的上限 —— 若 AutoCAD 在某個檔案上卡住超過此時間，BlockSync 會終止處理該檔案的背景處理程序並回報逾時，其餘批次會繼續進行。可查看記錄檔資料夾，了解該檔案的處理程序在卡住當下正在執行什麼動作。
寫回時某個檔案出現在 "Unmatched" 中
比對僅以您選取的 DWG 資料夾內精確檔名為依據，不會遞迴子資料夾也不做模糊比對 —— 請檢查活頁簿中的檔名是否與該資料夾（而非其子資料夾）中的實際檔案相符，以及匯出後是否曾被重新命名。
"Write Selected Files" 因動態屬性訊息而被阻擋
將已變更的動態圖塊屬性值寫回圖面是 Pro 專屬功能。在擷取時讀取動態屬性值在 Free 版仍可正常使用 —— 只有寫回已編輯的數值受到限制。請升級至 Pro，或取消勾選包含該動態屬性變更的檔案/列。
即使已啟用備份，某個檔案的寫入仍被略過
若該特定檔案的備份複製失敗（例如備份資料夾無法寫入），BlockSync 會完全略過該檔案的寫入，而不是在沒有安全副本的情況下繼續進行。請查看寫入報告中該檔案的 Backup 欄位所顯示的錯誤，修正問題（資料夾權限、磁碟空間）後重新執行。
"Rollback All" 無法使用或沒有反應
它只在該次執行的結果仍顯示在 Write results 畫面時可用——點擊 Finish 或重新啟動應用程式後，請改用獨立的 Restore Backup… 視窗（從 Excel → AutoCAD 畫面開啟），它可以讀取磁碟上仍保留的任何備份，包括舊版本產生的 Backup_*.zip 壓縮檔。
本機檔案
Settings → Diagnostics → Open Log Folder 可直接跳轉到記錄檔資料夾，方便疑難排解。
| 設定 | %LocalAppData%\CADXChange\BlockSync\settings.json |
| 記錄檔 | %LocalAppData%\CADXChange\BlockSync\Logs\ |
| 預設備份資料夾 | {DWG folder}\_BlockSyncBackup |
| 預設匯出資料夾 | Documents\BlockSync\Exports |