PolyPDF插件的工作方式

PolyPDF 是一款桌面应用程序，适合使用 PDF 工程图而不是 CAD 文件进行工作的人员（独立工程师、建筑师、估算师以及他们周围的小团队）。其核心文档、注释、测量和导出工作在 Mac 和 Windows 上本地进行。地图、许可证激活、更新、购买和支持可能需要连接。

这种局部优先的形状为我们添加的任何内容设置了约束。插件是在其中设计的：包携带签名数据和艺术品，而不是下载的可执行代码或订阅服务。

当前访问：安装、运行和编辑插件内容需要 PolyPDF Pro。已放置在 PDF 上的内容仍然是普通文档内容。

插件包可以携带数据表、经过净化的 SVG 或 PNG 图稿以及用户填写的表单的声明性描述。它不携带可执行插件 JavaScript。该软件包命名了 PolyPDF 的固定主机拥有的生成器之一，并为该生成器提供有界输入。

这种设计缩小了攻击面；它不会使任意文件变得无害。包仍然可以包含结构化值、标签、选项和图形。因此，PolyPDF 会验证存档和清单、清理支持的图稿、强制执行声明的权限，并在插入任何内容之前验证其自己的生成器生成的注释和图像资源。

安装包之前验证什么

• 捆绑和目录交付的软件包使用覆盖每个文件的 SHA-256 摘要上的 Ed25519 签名，并对每个文件进行单独的 SHA-256 检查。
• 仅当签名的目录固定程序包校验和时，才会接受目录安装。用户直接选择的文件可以进行自签名；同意屏幕会识别该来源并在批准后固定作者密钥。
• 严格的布局允许列表 - 包可能仅包含清单、表单架构、签名以及数据、资产和图标文件夹。其他的都被拒绝。
• 路径安全和符号链接检查拒绝遍历、绝对路径和重复条目。
• 档案、每个成员以及成员数量的大小上限。

权限模型

插件声明它需要三个权限中的哪一个：读取当前文档上下文、创建注释以及在工作区中创建图像资源。详细信息或旁加载审查视图以简单语言列出它们。超出这些权限的生成器结果将被拒绝。

生成器对话框由 PolyPDF 从插件的表单架构中绘制。该插件描述了字段；应用程序呈现它们。包中没有任何内容直接控制界面。

插件在一个“插件”窗口中进行管理，该窗口显示 PolyPDF 所携带的软件包以及您自己安装的软件包的单个列表。详细信息页面显示发布者、安装的版本、权限、命令、兼容性、包来源和大小、发行说明（如果存在）以及是否启用插件。

• 从同一窗口启用、禁用、卸载和回滚可用的先前版本。
• 从文件安装…打开对用户故意选择的软件包的同意审查，包括其来源、签名者、权限以及降级或重新安装上下文。
• 经同意的旁加载可以重新安装相同版本或安装旧版本；在您批准之前，审核屏幕会告诉您即将发生的情况。
• 卸载插件不会影响它已经生成的内容 - 该内容是文档的一部分，而不是插件的一部分。

PolyPDF 带有三个第一方生成器并在首次运行时启用它们。仅当构建配置了更新源时才会出现“检查更新”；普通的交付配置没有“发现”、“已安装”或“更新”选项卡，也没有目录刷新操作。

没有市场或公共提交目录。从文件安装…是用户选择的第三方软件包的显式路径，其同意屏幕将该软件包与 PolyPDF 提供的软件区分开来。

键入受支持的名称（例如 W24X55、L6X6X1/2、HSS8X8X1/2 或 PIPE6），然后选择惯用或公制单位和注释比例，PolyPDF 会将剖面轮廓绘制到纸张上。

轮廓是真正的矢量几何体，作为多边形注释而不是粘贴的位图放置：它在任何缩放下都保持清晰，并以您要求的尺寸打印。高速钢和管材等空心形状是用其内环绘制的，因此壁厚是实际壁厚。

AISC 型钢绘制截面轮廓。它不执行容量、代码或设计检查。捆绑数据是 W、M、S、HP、C、MC、L、WT、HSS、HSS-Round 和 Pipe 系列的精选 57 形状子集，而不是完整的数据库，因此在做出设计决策之前，请根据权威参考检查任何指定。

选择专业工程师或建筑师，选择管辖区（50 个州和哥伦比亚特区），填写管辖区模板要求的字段，然后在插入之前在实时预览中观看印章的构建。

输出是根据模板生成的图形。它不是加密签名，插入签名不会对文档进行签名。 PolyPDF 的数字签名工具是独立的，如果您需要验证者可以检查的签名，那就是要使用的路径。

Seal Maker 的印章是图形艺术品，而不是加密数字签名。 PolyPDF 不会检查许可证状态，也不会确认模板是否符合您主板的当前要求。印章上出现姓名的持照专业人员仍对其外观、措辞和使用负责。

输入地址、城市或地名，设置从世界视图到建筑物级别的缩放级别，然后在页面上插入地图图像。在 PolyPDF 内部，结果保持可调：双击它即可在小型编辑器中平移和缩放并保存视图。在其他 PDF 查看器中，它是纯图像。

地点搜索通过 openstreetmap.org 上的 Nominatim 进行地理编码。图像本身是使用 OpenMapTiles 架构从 OpenFreeMap 矢量切片渲染的。 PolyPDF 将“OpenFreeMap © OpenStreetMap 中的 OpenMapTiles 数据”烘焙到生成的图像中（或者在空间需要时使用更短的布局形式），因此功劳会随 PDF 一起传递。

PDF 地图在解析地点并渲染 OpenFreeMap 图块时需要互联网连接。插入后，结果是与 PDF 一起保留的独立图像注释。

MUTCD 标志不是插件。它们作为工具集内置于 PolyPDF 中。监管箱包含 435 张标志卡；选择 R1-1 Stop 并放置它会创建一个可以像其他页面内容一样移动、调整大小或删除的图像注释。

下面的示例在示例流量控制表上运行浏览和放置工作流程。标志图稿来自 FHWA 标准公路标志 2024 版本。

每个插件都遵循相同的路径。学习一次，也适用于下一次。

1. 打开插件管理器。在 macOS 上：PolyPDF ▸ 插件...。在 Windows 上：工具 ▸ 插件 ▸ 插件...。
2. 在单个列表中选择一行并阅读其详细信息页面 - 发布者、安装的版本、请求的权限、来源、兼容性和命令。
3. 对于您自己获取的软件包，请选择从文件安装...并在同意之前检查其签名者、来源、权限以及重新安装或降级警告。图中所示的三台发电机已安装完毕。
4. 从“工具”▸“插件”运行插件，然后选择其命令：插入 AISC 钢型材…、插入专业密封…或插入地图…。
5. 填写生成器对话框。预览面板会在您键入时重新绘制，因此您可以在其接触文档之前看到结果。
6. 选择插入。内容作为普通注释放置在单个撤消步骤中 - 一次撤消即可删除整个插入。
7. 使用该注释类型支持的编辑操作。矢量轮廓可以移动、调整大小、重新设计样式或删除；基于图像的输出可以移动、调整大小或删除。

页面上出现的是标准 PDF 注释——钢截面的多边形、印章或地图的图章——用烘焙的外观流编写。内容属于文档，而不属于插件，这就是为什么卸载插件后它不会受到影响。

前三个生成器故意不相似：绘制矢量几何的数据查找、组成图像的模板以及访问外部服务的生成器。每个都告诉我们关于包格式接下来必须支持的内容的不同内容。

如果某个插件能让您的一周变得更轻松，请告诉我们它应该生成什么以及它应该要求什么。写信至support@polypdf.com。