如需检查哪些工具已连接，请参阅 CONNECTORS.md。

签署 PDF

使用图像批注向文档添加可视化签名或首字母缩写。

免责声明： 此操作将你的签名图像放置在页面上。它 并非经过认证的或加密的数字签名。如需具有法律约束力的 电子签名，请使用专用的签名服务。

工作流程

  1. 获取签名图像 — 向用户询问其签名或首字母缩写的本地文件路径 （PNG/JPG）。如果用户没有，建议用户创建一个并保存到已知路径。

  2. 打开 PDF — display_pdf（或复用现有的 viewUUID）。 检查返回的 formFields 中是否有签名字段 — 它们包含页面和边界框坐标。

  3. 定位目标位置 — 如果有签名字段，使用其坐标。 否则询问："哪一页，以及页面上的什么位置？ （例如，第 3 页右下角）"

  4. 放置签名 — interact → add_annotations：

    {"action": "add_annotations", "annotations": [
  {"id": "sig1", "type": "image", "page": 3,
   "imageUrl": "/path/to/signature.png",
   "x": 400, "y": 700, "width": 150}
]}

    如果省略宽度/高度，将从图像自动检测。

  5. 验证 — 随后对该页执行 get_screenshot。展示给 用户。如有需要可通过 update_annotations 调整位置。

  6. 每页添加首字母 — 在单次 add_annotations 调用中批量添加每页一个 image 批注。

提示