BlockCopy 文档

BlockCopy 有五种模式，通过标题栏中的切换按钮切换：Distribute、Copy Reference、Sync Update、Upgrade Version 和 Delete Blocks。前四种模式共用相同的 Source（左）/ Target files（右）布局；Delete Blocks 没有源图纸，因为块定义和图层是直接从目标文件本身扫描出来的。默认情况下，每种模式在写入目标文件之前都会先进行备份 — 不仅仅是那两种改动现有内容的模式。免费版将每种模式的单次运行都限制在 3 个目标文件，且一次只处理 1 个文件；没有任何模式是 Pro 专属的。

快速上手

截图来自较新版本 —— 与您安装的版本相比，视觉细节可能略有差异。

Distribute

将一个块定义克隆到尚未拥有它的文件中。

浏览到源 DWG，在源列表中勾选要分发的块（每个块会显示引用数量、动态标志和属性存在情况，并带有一个 View… 按钮以查看某个块的完整属性列表）。
Add Files… 建立目标列表。默认情况下，已经拥有该块的目标文件不会被改动 — 勾选 Replace existing definitions 可强制覆盖。（块所依赖的图层、文字样式和线型即使在块本身被跳过时也仍会刷新到目标文件中。）
Clone Now 会把几何图形、属性标签布局和动态属性复制到每一个尚未拥有该块的目标文件中。

Copy Reference

将一个已填写数值的块实例（连同数值）复制到其他文件中。

在源列表中选取一个特定的块定义（单选，而非勾选列表）— BlockCopy 随后会扫描并列出该块的每一个已插入引用，包括其 Handle、Position 和一个 Attributes 查看功能。勾选要复制的那一个实例。
Add Files… 选取目标文件；Insert Now 会把该确切实例的一个新引用 — 与源实例相同的位置、旋转角度和属性值 — 插入到每一个目标文件中。
比例不会被带过来：新引用始终以该块的默认比例插入，即使源实例被缩放过。下方的 Upgrade Version 会保留比例，如果源实例并非 1:1，这一点值得留意。

Sync Update

推送修订后的块定义，而不清空属性值。

浏览到持有修订后定义的源 DWG，添加目标文件，然后点击 Sync Now 替换定义并重新同步每一个已有引用。
数值按属性标签名称匹配，而不是按位置 — 在修订版中重新排列属性顺序不会打乱数值的对应关系。
写入完成后，BlockCopy 会回读文件，并将每个属性值与预期值进行比对。不匹配只会将该文件标记为失败（在其 Details 弹窗中），不会中止批次中的其余部分，也不会自动回滚任何内容。使用 Details 弹窗中的 Rollback 按钮，或 Restore Backup…，可以恢复该特定文件。

Upgrade Version

为每一个引用，用新的定义（v2）淘汰旧的块定义（v1）。

添加目标文件，然后使用 Old Blocks 选择器扫描目标文件中的 v1 候选项，并选择要淘汰的定义，以及用于替换它的新（v2）定义。
Upgrade Now 会原地把每一个 v1 引用替换为 v2 — 位置、旋转角度、比例和图层始终会被带过来。属性按标签匹配：只有当 v2 仍拥有相同标签时，v1 的值才会保留；仅存在于 v2 中的标签会以其自身的默认值创建，而不是从 v1 中填入。动态属性也会被带过来，但仅当新块本身是动态块时才会生效。
旧的（v1）块定义本身会原样保留在文件中不受影响 — 只有各个引用被替换为指向 v2。
目前这里还没有预览步骤，与其他一些模式不同 — 点击 Upgrade Now 后会立即运行。

Delete Blocks

跨一批文件删除块引用，可选地按图层筛选。

添加目标文件 — 这里没有可浏览的源图纸；块定义和图层都是直接从目标文件本身扫描出来，并合并成一个列表，引用数量会跨文件累加。
在 Blocks 标签页中勾选要删除的块定义；切换到 Layers 标签页可将删除范围限定到特定图层（不勾选任何图层则删除所有图层上匹配的引用）。

确认删除

在任何操作发生之前，最后一次确切说明即将删除的内容。

Delete Now 会显示一个确认对话框，准确说明即将影响多少块定义、文件数量，以及（如果有勾选的话）多少个图层 — 并说明这是作用于所有图层还是仅限所选图层。
同一个对话框还会说明是否会保存备份、保存到哪里，或者如果备份被关闭则直接警告已删除的引用无法恢复 — 因此在确认之前，备份状态会最后一次显示出来。

Restore Backup

一个用于从之前运行的备份中恢复文件的独立窗口 — 即使重启应用后仍然可用。

从各模式操作按钮旁的 Restore Backup… 打开。它直接从磁盘上的备份文件夹读取备份（Backup_{timestamp} 文件夹，以及旧版本生成的 Backup_*.zip 压缩包），与应用内的运行状态无关，因此重启应用后依然可用。
在左侧选择一个归档以查看其中包含的文件；勾选要恢复的文件并选择一个 Restore to folder — 可以是原始 DWG 文件夹，也可以是其他位置，因此恢复操作不必非要原地覆盖，除非你自己想这样做。

设置

点击标题栏的齿轮图标打开。每个字段都会即时保存 —— 没有单独的保存按钮。

Language

Settings → General

English / 简体中文 / 繁體中文 / 日本語 / 한국어 / Deutsch / Français / Italiano / Español。语言更改需要重启应用才能生效。

默认值：English

Theme

Settings → General

System / Light / Dark。主题更改需要重启应用才能生效。

默认值：Match system

AutoCAD version

Settings → AutoCAD

优先使用哪个已安装的 AutoCAD 版本。如果加载失败，应用会自动回退使用另一个已安装的版本。

默认值：Auto (newest installed)

Max parallel AutoCAD instances

Settings → AutoCAD

后台可同时处理多少份图纸（可选值：1、2、4、6、8、12、16）。数值越高速度越快，但会占用更多 CPU 和内存 — 在配置较低的机器上应调低此值。

默认值：8

Back up target files before writing

Settings → AutoCAD

每种模式自己界面上 "Enable Auto Backup" 复选框的默认值 — 每种模式都可以独立于此默认值，打开或关闭自己的备份（并选择自己的备份文件夹）。

默认值：On

授权

许可证状态会显示在标题栏中，为 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 只有在交互式运行过至少一次之后才会信任某个插件位置。

某个目标文件被报告为锁定，或运行卡在某一个文件上

每个操作（scan、clone、insert、sync、upgrade、delete）都被限制在每个文件 5 分钟以内 — 被锁定的文件（在别处的 AutoCAD 中打开）或无响应的 AutoCAD 进程会按名称报告出来，而不是让整个批次挂起。

需要撤销一次运行

如果该模式的 Enable Auto Backup 处于开启状态，请打开对应文件的 Details 弹窗并使用 Rollback to this backup，或打开 Restore Backup…（齿轮图标 → Settings，或各模式操作按钮旁的按钮），从备份文件夹中的任意备份恢复所选文件。没有“撤销整次运行”的按钮——恢复始终按文件进行。

本地文件

Settings → Diagnostics → Open Log Folder 可以直接跳转到日志文件夹，方便排查问题。

设置	%LocalAppData%\CADXChange\BlockCopy\settings.json
日志	%LocalAppData%\CADXChange\BlockCopy\Logs\
备份	%LocalAppData%\CADXChange\BlockCopy\Backups\Backup_{timestamp}\