您可以通过一次提示为文件夹中的文档添加水印：AI 代理列出文件，对每个文件调用一次水印工具，并报告其生成的内容，全部在本地完成，无需上传。在 Claude Desktop、Claude Code、Cursor 或 Windsurf 中，请求如下：

在我的文档文件夹中的每个 PDF 上添加一个对角线的 DRAFT 水印，然后列出您生成的文件。

带有配置和故障排除的逐步版本请参阅文档：如何使用 AI 代理批量为文件夹中的文档添加水印.

为什么按生命周期阶段而不是一次性加盖印章？

提案包很少只标记一次。它最初是 DRAFT，交给同事时变为 FOR REVIEW，批准后则去除标记。手动在三十个文件上完成这些工作在紧迫的截止日期下往往被省略。使用 GroupDocs.Watermark.Mcp，每个阶段只需一句话，代理提供了您本来需要编写脚本的循环。引擎会处理格式，因此同一个提示即可覆盖文件夹中的 PDF、Word、Excel、PowerPoint 和图像文件。

阶段 1：如何为所有文件添加草稿水印？

将 GROUPDOCS_MCP_STORAGE_PATH 指向该文件夹。文件通过名称解析，因此代理传递的是 proposal-01.pdf，而不是您机器上的路径。然后：

在我的文档文件夹中的每个 PDF 上添加一个对角线的 DRAFT 水印，然后列出您生成的文件。

代理对每个文件调用 add_watermark。每次调用都会保存一个新的带水印副本，并保留原始文件不变，因此源文件夹仍然是未加水印版本的记录。

阶段 2：如何切换为审阅印章？

在阶段 1 之后，每个文件都带有 DRAFT 标记，因此需要更换标记：先按文本删除旧标记，然后在结果上加盖新印章。

从此文件夹中的每个文件中移除 DRAFT 水印，然后在每个结果上添加 FOR REVIEW 水印。

代理使用 textFilter 设置为 DRAFT 调用 remove_watermarks，然后对每个已清理的副本调用 add_watermark。对于状态混合的文件夹，即有些文件已标记有些未标记，先让代理查看：

将每个文件标记为 FOR REVIEW，已存在水印的文件除外。

它对每个文件运行 search_watermarks，并跳过返回标记的文件。若不同格式使用不同标记，请说明：

在幻灯片文件上放置徽标，在 PDF 上放置文字标记。

阶段 3：工作获批后如何清除标记？

批准后需求相反。在同一文件夹中，使用您自己的文档：

从此文件夹中的每个文件中移除 DRAFT 水印，并保留其余标记。

这相当于使用 textFilter 为 “DRAFT” 的 remove_watermarks。该过滤器进行不区分大小写的子字符串匹配；如果不使用过滤器，引擎能够识别的所有水印都会被移除。结果保存为 <name>_unwatermarked.<ext>。详细信息请参阅下面链接的关于删除前搜索的配套文章。

示例会话（节选）

You:    Add a diagonal DRAFT watermark to every PDF in my documents
        folder, then list the files you produced.
Agent:  [add_watermark x 3: text "DRAFT", rotation -45]
        Added text watermark "DRAFT" to "proposal-01.pdf"
        Added text watermark "DRAFT" to "proposal-02.pdf"
        Added text watermark "DRAFT" to "proposal-03.pdf"
        Produced 3 watermarked copies. 0 failures.
        Originals are unchanged.

原始文件和输出文件夹怎么办？

默认情况下，输入和输出共享同一个文件夹，带水印的副本与源文件并列放置。如果您希望分离干净，可将 GROUPDOCS_MCP_OUTPUT_PATH 设置为另一个文件夹并从该处发布。无论哪种方式，原始文件都不会被覆盖，因此在源文件更改后可以重新运行某个阶段；只需再次指定要处理的文件名。

如何确保批处理的透明性？

  • 要求提供生成文件的列表。 仅报告“完成”的运行会让您猜测哪些副本需要发布。
  • 明确要求列出失败。 混合文件夹可能包含引擎无法加水印的格式。调用会返回错误信息而不是静默跳过，因此请请求提供失败列表。
  • 注意计量使用。 在计量授权下，每个文件的处理都会计费。
  • 先检查许可证。 评估模式下的批处理是浪费的运行。

限制有哪些？

评估模式是主要限制：服务器的授权页面说明未授权的输出带有评估限制；具体限制请参见库的 授权页面。评估模式下的副本文件夹相当于一堆无法分发的草稿。请在运行前让代理调用 get_license_status；它会报告 mode 为 evaluation、licensed 或 metered。另无内置调度器：服务器在代理请求时才会执行，因此循环任务需要客户端或任务运行器来发送提示。

常见问题

AI 能一次为多个 PDF 加水印吗？
可以。代理遍历文件夹，对每个文件调用一次 add_watermark，随后列出生成的副本。每个文件单独处理。

我可以在文件夹中的每个文档上添加 CONFIDENTIAL 吗？
可以。在提示中将 DRAFT 替换为 CONFIDENTIAL。明确说明是否应跳过已经带有标记的文件。

是否可以在本地批量加水印，而无需上传？
可以。服务器是由您的客户端启动的本地进程，它会读取并写入您配置的文件夹。

深入了解