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 实体都会始终被读取。
Options 与 Export to Excel
除纯文本之外还会一并导出哪些内容，以及适用于单次运行的免费版限制。
- Parallel processing（默认开启）会同时读取多个文件，而不是逐一处理。无论此复选框或 Settings 中的 "Max parallel AutoCAD instances" 值如何设置，免费版都被硬性限制为一次只处理一个文件 — 加速效果仅在 Pro 版中生效。
- 免费版将单次运行限制在 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）
将 TextSync 指向一个已编辑的导出结果及其所对应的图纸，并设置备份的写入位置。
- Step 1: Excel Workbook 浏览到已导出（并且已编辑过）的 .xlsx 文件。
- Step 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
在任何操作发生之前确认写入的范围 — 这里没有写入后的验证步骤。
- 确认对话框准确说明即将改动多少文件、多少实体，并指名备份文件夹 — 如果备份被关闭，则明确警告该改动无法撤销。
- 免费版每次运行 3 个文件的上限在此处同样适用，按即将写入的匹配文件计算。
- 文件是逐个写入的，而不是并行处理，因为在写入之前会先在磁盘上为每个文件创建一个真实的备份文件。如果某个文件自身的备份失败，其写入会被完全跳过 — TextSync 绝不会写入一个刚刚备份失败的文件。
- 与 BlockSync 对应的写回不同，TextSync 在写入后不会重新读取每个文件以验证改动是否真正生效 — 逐文件结果只反映 AutoCAD 自身的写入命令在写入时所报告的成功或失败。 只有与图纸实际不同的值才会写入：文字未变化的 MText 会保留全部格式（字体、颜色、堆叠等），值来自字段的文字不会被覆盖（会报告为失败并说明原因），没有任何变化的文件不会被保存。
- Cancel 会让当前正在写入的文件先完成，再停止，而不是在写入过程中中途中止 — 中途放手可能会让该 DWG 处于半写入状态。
Write-Back Report
写入完成后，本次运行中每个文件发生了什么。
- 每个文件占一行：总体状态、成功和失败的实体数量，以及其备份写入的位置（或没有备份的原因）。
- 文件的 Fail 计数在非零时可点击，会打开一个 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 的回退方式不同，如果发现备份出现在意想不到的位置，值得留意这一点。
批量编辑与 Create Text Style
一次性跨多行改动某个字段，或将一个全新样式添加到每一个已加载的文件。
- 四个独立的复选框+字段配对 — 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 没有免费版文件数量上限 — 与另外两种模式不同，此处的运行不受 3 个文件的限制。
- 对于文件中已存在的样式，Write Styles Back 会更新其现有定义上的 Font、Big Font、Width Factor 和 Fixed Height（并在标记为 Current 时将其设为该文件的当前样式），而不是创建重复项。
- 然后它会找到使用该样式的每一个 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 → AutoCAD后台可同时处理多少份图纸（可选值：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 |