P3DSync

P3DSync 是如何工作的

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

点击放大

Tab: Plant3D → Excel

第一步 — 将每一个资产 Tag 和 UDA 属性提取到一个 Excel 文件

添加 DWG 文件，浏览批次中发现的资产类别（带内嵌预览缩略图），得到一个工作簿，每个类别一张工作表，每个资产实例占一行。

1. 1使用 Add Files… 或 Add Folder…（可选是否递归子文件夹）— 可以把磁盘上任意位置的任意数量 DWG 混合加入同一批次。
2. 2P3DSync 会扫描每个文件中的 Plant3D 资产类别、图层和图纸空间视口，并显示逐文件的实时进度条。
3. 3在 Assets 标签页中，勾选你真正需要的类别。每一行显示其引用数量、有多少文件包含它、是否带有属性，以及（如果有的话）一张内嵌预览缩略图 — 点击 Details… 可在提交导出之前查看完整图像。
4. 4按名称搜索，或使用 Select All / Select None / Invert 来管理一个包含数十种资产类别的项目的勾选列表。
5. 5需要更精细的导出范围？切换到 Layers 或 Viewports 标签页，勾选特定图层或图纸空间视口 — 只有放置在（或可通过）已勾选项可见的资产才会被提取。
6. 6将 Plant3D Project Database 指向该项目的 ProcessPower.dcf（会在 DWG 旁边或上一级文件夹中自动检测）— 这是 Include Attributes 提取超出 Tag、几何和图层之外内容所必需的，因为自定义（UDA）属性存放在项目数据库中，而不是图纸实体上。
7. 7打开 Options，可以包含 UDA 属性、几何信息（位置 + 旋转角度）、图层信息，并选择空间范围（模型空间、图纸空间，或两者）。在性能较好的机器上，开启 Parallel processing 可以同时扫描并提取多个文件。
8. 8点击 Extract to Excel。带时间戳的 .xlsx 文件会出现在屏幕上显示的输出文件夹中 — Open Output Folder 可以直接跳转到那里。

Options on this screen

Include attributes

从 Plant3D 项目数据库中提取每个资产的自定义（UDA）属性，与其 Tag 一并提取。需要先设置 Plant3D Project Database。

Include geometry

将每个资产的位置和旋转角度作为额外的列提取出来。

Include layer info

提取每个资产所在的图层。

Space scope

将提取范围限定为模型空间、图纸空间，或两者。

Parallel processing

同时处理多个 DWG 文件，而不是逐一处理。速度更快，但占用更多内存。

点击放大

Tab: Excel → Plant3D

第二步 — 预览准确的差异，再写回

在 Excel 中随意编辑导出的工作簿 — P3DSync 会把每一行精确匹配回其对应的资产实例，并在改动任何图纸或项目数据库之前，精确显示将会发生什么变化。

1. 1选择 Excel Workbook（第一步导出并编辑过的文件），以及要与之匹配的 DWG 文件夹 — 默认使用工作簿自身所在的文件夹，并且仅按精确文件名匹配。
2. 2选择一个备份文件夹，或保持 Automatic backup before writing 开启 — 在改动发生之前，每个即将被写入的文件都会被原样复制到该文件夹。
3. 3P3DSync 读取工作簿，把每一行精确匹配回它来源的具体资产实例（依据文件 + 对象句柄，而不仅仅是行序）。Excel 中在该文件夹里找不到匹配 DWG 的内容会显示在 Unmatched 标签页中，而不是悄无声息地失败。
4. 4Diff preview 标签页列出每个文件的改动计数和被阻止计数。选中一个文件即可看到完整的逐属性对照表：File、Handle、Class、Attribute、Current 和 New value 并排显示，每一行都标注 WillChange / NoChange / CannotWrite 及其原因。没有变化的行默认隐藏 — 如果仍想全面审查，勾选 Show unchanged rows。
5. 5如果想先把确切的计划改动交给别人签核，Export Preview… 可以把差异表格本身另存为一个工作簿。
6. 6只勾选你想包含的文件，然后点击 Write Back。确认对话框会准确说明即将发生多少文件、多少属性变更 — 没有意外。
7. 7写入完成后，P3DSync 会分别从图纸和项目数据库中，把每一个已更改的 Tag 和属性重新读出来，核对是否与预期一致。任何不匹配都会在写入结果报告中指名道姓地列出，而不是被默认为已经成功。
8. 8Restore Backup… 可以从之前任意一次运行的备份中恢复文件；结果报告中的 Rollback All 可以一键撤销当前运行中涉及的所有改动。

Options on this screen

Automatic backup before writing

在改动之前，每个被写入的文件都会被原样复制到备份文件夹。只有在你确定不需要回滚时才关闭此选项。

Show unchanged rows

默认情况下，差异视图会隐藏没有变化的属性，这样一个大批次就不会把真正重要的那几处修改埋没掉。

运行环境与要求

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

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

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