TextCompare

TextCompare 是如何工作的

以下几个部分对应软件里真实的标签页，顺序与软件一致 —— 每张截图都是 TextCompare 运行时的真实、未经修改的画面。

点击放大

Tab: Select Files

第一步 — 添加修改前和修改后的版本

将 TextCompare 指向两个文件夹 — 修改前的图纸和同一批图纸修改后的版本 — 并在扫描之前先把比较范围缩小到特定图层或视口。标题栏中的 Compare DWG / Compare with Excel 开关，用于在这种双文件夹工作流与对照导出的 Excel 工作簿之间切换。

1. 1先使用标题栏中的 Compare DWG / Compare with Excel 开关 — Compare DWG（默认模式，如下所述）从磁盘读取双方内容；Compare with Excel 会把 Folder A 换成配套的 TextSync 工具导出的单一文字数据工作簿，而 Folder B 仍然是一个实时的 DWG 文件夹。
2. 2使用 Add Files 或 Add Folder，向 Folder A（修改前）和 Folder B（修改后）中添加内容 — 双方各自可添加任意数量的 DWG。
3. 3TextCompare 会预扫描两个文件夹，并在比较开始前报告每个文件的实时状态。
4. 4打开 Layers 标签页，将比较范围缩小到特定图层上的文字和块引用；或使用 Viewports 标签页，将比较范围限定到特定的图纸空间视口。
5. 5选择一种 Match strategy — Filename priority、Handle priority 或 Hybrid（默认，偏向句柄匹配）— 并拖动 Confidence threshold 滑块，决定一个文件配对需要多高的把握才会被自动提出。
6. 6将当前各标签页的选择另存为一个命名的 Filter profile（Save…），之后可再次加载（Load），用于同一项目上反复进行的比较工作。
7. 7点击 Scan & Match，读取每个文件并提出文件到文件的配对方案。

Options on this screen

Filename priority / Handle priority / Hybrid (default)

在为“修改前”文件匹配对应的“修改后”文件时，优先信任哪种信号。Hybrid 会综合两者，并偏向句柄匹配。

Confidence threshold

一个提议的文件配对需要达到多高的把握，TextCompare 才会自动接受它，而不是标记出来等待人工复核。

Compare DWG / Compare with Excel

Compare with Excel 会把 Folder B 的扫描范围缩小到仅限工作簿中出现的图层名称，并默认使用 Filename priority 匹配，因为在这一侧，工作簿中记录的文件名 — 而非实时句柄数据 — 是更可靠的信号。

点击放大

Tab: Review Matches

第二步 — 确认或修正提议的文件配对

TextCompare 会自动把每个“修改前”文件与最可能对应的“修改后”文件配对 — 这个界面用于在任何比较发生之前，确认这个配对，或手动修正它。

1. 1每一行列出 File A 与 TextCompare 提议的 File B，并附有 Filename %、Handle % 和 Combined % 分数，显示该配对的可信程度。
2. 2标红的行代表冲突 — 文件名信号与句柄信号不一致 — 并列出一个 Conflict candidate，方便你在决定前看到次优候选。
3. 3可以通过 File B 下拉菜单覆盖任何提议的配对，或勾选 Exclude 将某个文件完全排除在本次运行之外。
4. 4随时可以更改 Strategy，点击 Re-match 针对当前文件列表重新运行配对算法。
5. 5每个配对都确认无误后，点击 Compare。

点击放大

Tab: Comparison Report

第三步 — 逐条查看具体发生了什么变化

每一对已配对的文件都按 AutoCAD 的持久对象句柄进行比较，因此一条被重新措辞、移到新图层或调整了大小的注释，会被精确地报告出来 — 而不只是被标记为“不同”。

1. 1结果按已配对的文件对分组，每组带一行摘要以及一个可展开的条目列表。
2. 2每个条目都显示其 Handle、Block Name、Kind（Added / Removed / Modified）和条目的文字内容，以及 Fields Changed 的数量。
3. 3点击任意一个已修改条目上的 Details… 会弹出一个窗口，并排列出每一个已改动字段的 Old Value 和 New Value — 包括新旧文字内容本身。
4. 4未发生变化的条目完全不会被列出，因此一张标注密集的图纸不会把真正为数不多的措辞改动淹没掉。
5. 5点击 Finish 结束本次会话，或点击 Back 调整配对并重新比较。

点击放大

Tab: Export to Excel

把报告交给没有安装 TextCompare 的人

同样的 Added / Removed / Modified 分类，包含每一处字段级的改动和文字内容，写入一个任何人都能打开、筛选或存档的工作簿 — 在导出时可以选择两种版式之一。

1. 1在 Comparison Report 界面，点击 Export to Excel，然后在弹出的对话框中选择一种报告版式。
2. 2该工作簿列出每一个已改动、新增和删除的条目，附带其文件配对、句柄、块名称，以及字段级的新旧数值，包括文字内容。
3. 3作为一份扁平、可筛选的表格，它可以在没有人安装 TextCompare 的情况下，作为一份评审材料或 QA 签核记录使用。

Options on this screen

One row per record (default)

每个条目占一行，拥有自己的一对 TextContent A / TextContent B 列用于展示修改前后的措辞，其他每一处已改动字段的旧值以批注形式记录。

Before/after rows for changed records

一个已修改条目改为占用相邻的两行 — 一行显示旧值，一行显示新值 — 共用同一个 TextContent 列，真正发生变化的字段会在两行上都高亮显示。

运行环境与要求

决定 TextCompare 能否在您的电脑上运行、以及运行后表现如何的全部因素。

• 无需安装 Microsoft Excel — TextCompare 使用自带引擎（ClosedXML）直接读写 .xlsx。
• 仅支持 Windows 10/11，64 位。
• 需要一份已获得许可的完整版 AutoCAD（2021–2027）。不支持 AutoCAD LT — LT 无法运行 TextCompare 所依赖的后台自动化功能。
• 如果安装了多个 AutoCAD 版本，可在 Settings → AutoCAD 中指定要使用的版本，或保持 "Auto (newest installed)" 设置 — 如果该版本因任何原因加载失败，会自动回退使用另一个已安装的版本。
• 基于 .NET 8 构建。如果你的机器上尚未安装 .NET 8 Desktop Runtime，安装程序会提示从微软获取（免费、一次性，约 60 MB）。
• 联网仅用于在启动时以及之后定期检查许可状态。扫描、读取和写入操作全部通过 AutoCAD 自身引擎在本地完成 — 图纸内容永远不会被上传。
• 界面语言：English。
• 对于包含大量文件的批处理任务，可以在后台并行处理多个图纸 — 在 Settings 中调整 "Max parallel AutoCAD instances"，在速度与 CPU/内存占用之间取舍。
• 每个耗时较长的操作都会显示带百分比和预计剩余时间的进度条，并可在运行中随时取消。
• 如果需要排查问题，Settings → Diagnostics → Open Log Folder 可以直接打开宿主程序和插件的日志文件夹。

另见全站的 系统要求 页面，比较所有工具。