LayerSync 說明文件
LayerSync 有三種模式，可從標題列的切換按鈕切換：AutoCAD → Excel（讀取與編輯）、Excel → AutoCAD（預覽與寫回）和 Clean Up（批次 PURGE）。AutoCAD → Excel 是一個帶有 Layers / Layouts / Properties / Dim Styles 索引標籤的畫面；在表格裡所做的修改可以用 Write Directly… 直接進入差異預覽，也可以用 Export to Excel… 匯出到一個 Excel 活頁簿。在你於預覽頁確認之前，不會向任何圖面寫入任何內容。
快速上手
截圖來自較新版本 —— 與您安裝的版本相比，視覺細節可能略有差異。
AutoCAD → Excel (read and edit)
加入檔案與掃描
加入圖面，LayerSync 一次讀取它們的圖層、配置、圖面屬性和標註樣式。
- Add Files… 用於選取單個 .dwg 檔案；Add Folder… 掃描整個資料夾 — 是否也掃描子資料夾取決於 "Include subfolders when adding a folder"（Settings → AutoCAD，預設關閉）。
- 加入、移除或清空檔案會自動重新掃描整個批次，並帶有即時的逐檔進度列。每張圖面只開啟一次，供四個索引標籤共用。
- 檔案清單顯示名稱、路徑，以及帶顏色標記的 Status/Details 欄；掃描失敗的檔案會標出其錯誤並被略過，不會阻礙批次中其餘檔案。
- 狀態列回報合計結果："{n} layer(s), {n} layout(s) found across {n} file(s)." Files 清單可以摺疊，給表格騰出更多空間。
Layers（圖層）
每張圖面的每個圖層佔一列 — 批次重新命名、合併、改色和切換圖層狀態。
- 欄位：File、Layer、Used、Xref、實體數量、New Name、Merge Into、Color、Linetype、Line Weight、Transparency、Plot、Off、Frozen、Locked 和 Description。Used、Xref 和實體數量僅供參考。
- 依名稱搜尋支援 * 和 ? 萬用字元；Used、Unused 和 Xref layers 核取方塊可進一步縮小清單。Plot / Off / Frozen / Locked 的標題核取方塊會一次設定整個篩選後的清單。
- Find & Replace… 會重新命名目前顯示的圖層，可用純文字或規則運算式，並可選擇區分大小寫。
- Merge Into 會把來源圖層的所有實體 — 包括圖塊定義內部的實體 — 移到目標圖層，然後刪除清空後的圖層。差異預覽會依目標圖層對合併分組。
- Color 接受 "ACI n" 或 "#RRGGBB"；按一下色塊可開啟色彩選取器。
- 圖層 0 不能被重新命名或合併，來自 XREF 的圖層也不能被重新命名或合併 — 二者在預覽中都會標為被阻擋，而不是被悄悄略過。
Layouts（配置）
在整批圖面中重新命名圖紙空間配置並調整它們的索引標籤順序。
- 每張圖面的每個圖紙空間配置佔一列（Model 從不列出）：File、Layout、New Name 和 Tab Order。
- 新名稱如果與同一張圖面中已有的名稱重複，或包含 AutoCAD 名稱中不允許的字元，會在預覽中標為 Cannot write 並給出原因。
Properties（圖面屬性）
讀取並設定每張圖面的 DWGPROPS — 標準欄位和自訂屬性。
- 每張圖面的每個屬性佔一列。Title、Subject、Author、Keywords、Comments 和 HyperlinkBase 一律顯示（未設定時為空），其後依字母順序是圖面的自訂屬性。
- 直接在原位編輯數值。清空自訂屬性的值會把它從圖面中刪除；清空標準欄位只是把它設為空白。
- Add Property… 會在每張已掃描的圖面上設定一個自訂屬性，並覆寫同名的既有屬性。屬性名稱保持你輸入的拼寫。
- 搜尋會比對屬性名稱或檔名 — 縮小到一個屬性，就能看到它在整批圖面中的取值。
- 寫入之後，LayerSync 會重新整理圖面中的欄位（相當於 UPDATEFIELD），因此引用屬性的標題欄會顯示新值。欄位重新整理失敗會作為警告回報；屬性本身仍然已儲存。
Dim Styles（標註樣式）
統一標註文字高度、文字樣式、箭頭大小和全域比例。
- 每張圖面的每個標註樣式佔一列：Text Height（DIMTXT）、Text Style（DIMTXSTY）、Arrow Size（DIMASZ）和 Overall Scale（DIMSCALE）。標註樣式的其他變數保持原樣。
- 可以直接在儲存格裡編輯，也可以使用 "Set for shown styles" 列：填寫任意幾個方塊並按一下 Apply to shown — 目前搜尋顯示的每個樣式都會得到這些值；留空的方塊保持該設定不變。
- 來自 XREF 的樣式是灰色的，無法編輯；它們的未變更值在預覽中仍顯示為 No change。
- 寫入之後，使用了被改樣式的既有標註會被重新產生，因此圖面會立即顯示新的尺寸。套用在單個標註上的覆寫設定保持不變。
- 圖面中不存在的文字樣式名稱只會讓該樣式失敗，原因會顯示在結果報告中。
Export to Excel 與 Write Directly
把修改帶到 Excel 裡批次處理，或直接進入預覽。
- Export to Excel… 會寫出帶時間戳記的 LayerSync_Export_{date}_{time}.xlsx，含 Layers、Layouts、Properties 和 DimStyles 工作表，外加 Color Reference 工作表和 _LayerSync 中繼資料工作表。匯出的內容就是表格目前顯示的內容 — 包括你已做的修改。
- 在 Properties 工作表裡每一列是一張圖面；在新欄裡輸入的標題會成為新的自訂屬性。空白儲存格表示清除該屬性。
- Write Directly… 跳過 Excel：只有你修改過的列會被帶到差異預覽。
Excel → AutoCAD (write back)
將編輯後的活頁簿比對回圖面
選擇編輯後的活頁簿以及要與之比對的 DWG 資料夾。
- 活頁簿與圖面純粹依所選資料夾中的完整檔名比對，列與物件則依檔案加物件控制代碼（圖層、配置、標註樣式）或屬性名稱比對 — 而不是依列序。由較早版本 LayerSync 匯出、缺少較新工作表的活頁簿仍可開啟。
- 在資料夾中找不到相符 DWG 的列會顯示在 Unmatched 索引標籤下，而不會悄悄失敗。
- 從 Write Directly… 進入時完全跳過這一步 — 沒有需要選擇的活頁簿。
檢視差異預覽
在寫入任何內容之前，逐檔準確查看將會發生的變更。
- Diff Preview 列出每個已比對檔案的變更數量和被阻擋數量。選擇一個檔案即可看到它的 Layers、Layouts、Properties 和 Dim Styles 索引標籤；每個索引標籤都帶有計數徽章，顯示將要改變或被阻擋的列數。
- 每一列都標註 Will change / No change / Cannot write 並給出原因。Show unchanged rows 預設關閉，因此大批量資料不會埋沒真正重要的變更。
- Export Preview… 會把差異表格儲存到它自己的活頁簿中，便於在寫入之前簽核。
寫回並驗證
寫入已勾選的檔案，然後確認每一處變更確實生效。
- 準確勾選要包含的檔案，然後按一下 Write Selected Files。確認對話方塊會說明即將寫入多少檔案、多少處變更。
- "Automatic backup"（預設開啟）會在變更每個檔案之前，把它原樣複製到備份資料夾。如果備份失敗，該檔案不會被寫入。
- 寫入之後，LayerSync 會重新開啟每個已儲存的檔案，把其中儲存的內容與預期值比對；任何不相符都會在結果報告中指出。
- 結果報告中的 Rollback All 會還原本次執行涉及的所有檔案。Restore Backup… 可從更早執行的備份中還原。
Clean Up (batch PURGE)
要清除的內容與分析
選擇類別，加入圖面，然後依檔案查看將被清除的內容。
- 預設開啟的類別：未使用的圖塊、圖層、線型、文字樣式、標註樣式、多線/多重引線/表格樣式和材料，以及註冊應用程式。
- 零長度的直線、弧和多段線以及 Empty text 預設關閉：它們刪除的是圖面內容，而不僅僅是未使用的定義。它們只檢查模型空間和圖紙空間，並會略過含欄位的文字、屬性定義以及位於鎖定圖層上的任何物件。
- 加入檔案後會立即分析。分析在記憶體中完整執行整個清理過程，反覆進行直到沒有更多可清除的內容，因此那些要等別的項目被清除後才變成未使用的項目也已經算了進去。磁碟上的檔案不會被改動。
- 表格顯示每個類別的數量、總數和檔案大小。按兩下一個檔案（或使用 Details）可列出所有將被清除的項目，依類別分組。變更選項之後，Analyze 會重新執行分析。
清理與還原
先備份，再清理這批圖面，然後驗證。
- Clean Now 會（在 Automatic backup 開啟時）先備份每個檔案，再清理並儲存，然後重新分析已儲存的檔案，確認沒有可清除的內容殘留。
- 圖層 0、Defpoints、目前圖層、XREF 相關項、Standard 文字樣式和標註樣式、匿名圖塊和配置圖塊，以及仍被參考的圖塊，一律會保留。
- 在分析之後變更選項或檔案清單，數量會被標為已過期，直到你再次按下 Analyze。Roll Back All 會從備份還原原始檔案。
- Clean Up 只做 PURGE，不包含 AUDIT：AutoCAD .NET API 中沒有可以對背景圖面執行的對應功能。
設定
點擊標題列的齒輪圖示開啟。每個欄位都會即時儲存 —— 沒有單獨的儲存按鈕。
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 → AutoCADAdd Folder… 是否遞迴掃描子資料夾，還是僅掃描頂層。
預設值：Off授權
授權狀態會顯示於標題列，為 Free、Pro、Pro (offline) 或 Expired，完整資訊則在 Settings → License 中查看。
啟用授權：在 Settings → License → "License key" 貼上您的授權金鑰，然後點擊 Activate。若要將授權移轉到新電腦，請先在舊電腦上點擊 "Deactivate this machine"，再於新電腦上啟用。
如果應用程式無法連線授權伺服器（沒有網路，或伺服器暫時無法使用），先前啟用的 Pro 授權會以「Pro (offline)」狀態繼續使用 14 天。請在此期間內重新連線驗證——超過 14 天仍未驗證成功、超過訂閱到期日，或系統時鐘被調回時，授權會顯示為 Expired，直到能夠重新驗證。
免費版每次執行最多處理 10 份圖面，且一次只使用一個 AutoCAD 執行個體；Pro 版去掉這兩項限制。
疑難排解
"Include attributes" 只擷取了 Tag 與圖層，沒有自訂欄位
自訂（UDA）資產屬性存放於 Plant3D 專案資料庫中，而非圖面實體上 —— 請將 Plant3D Project Database 設為該專案的 ProcessPower.dcf（若自動偵測 DWG 旁或其上一層皆未找到，可使用 Browse…）。
差異預覽中某一列顯示 Cannot write
該列的 Reason 欄會說明原因 — 例如圖層或標註樣式來自 XREF、圖層 0 不能被重新命名或合併、配置名稱已存在，或圖面無法讀取。標記為 Cannot write 的列永遠不會被寫入，即使所在檔案已勾選。
標題欄沒有顯示新的屬性值
LayerSync 在寫入屬性之後會重新整理圖面中的欄位。如果重新整理時回報了警告，請開啟該圖面並執行 UPDATEFIELD；同時確認標題欄欄位確實引用了你修改的那個自訂屬性。
標註樣式的修改被阻擋或失敗
來自 XREF 的樣式不能在主圖面裡編輯。修改文字樣式時，該名稱必須已存在於那張圖面中 — 結果報告會指出失敗的圖面和樣式。
原本預期會看到的列卻出現在 Unmatched 分頁中
寫回僅以選定資料夾內的精確檔名，將 Excel 列比對至 DWG —— 若活頁簿是從不同資料夾匯出，或檔案自匯出後已被重新命名，請重新指向正確的 DWG 資料夾或重新匯出。
本機檔案
Settings → Diagnostics → Open Log Folder 可直接跳轉到記錄檔資料夾，方便疑難排解。
| 設定 | %LocalAppData%\CADXChange\LayerSync\settings.json |
| 記錄檔 | %LocalAppData%\CADXChange\LayerSync\Logs\ |
| 預設備份資料夾 | {DWG folder}\_LayerSyncBackup |
| 預設匯出資料夾 | Documents\LayerSync\Exports |