要自动为文档加品牌，只需给 AI 代理一个固定指令，让它在出站文件夹中的每个文件上本地调用图像水印工具。使用 GroupDocs.Watermark.Mcp 服务器，该指令可以是规则文件中的单行、Claude Code 中的项目指令，或粘贴到 Cursor 中的提示：

在出站文件夹中的每个文件的每一页上放置 logo.png，透明度为 25%，然后列出你生成的文件。

带有配置和故障排除的逐步版本请参阅文档：使用 AI 为文档添加徽标水印的方式.

手动加品牌为何会出现偏差？

手动加品牌因人而异：一个团队将徽标粘贴到源文件中，另一个团队在 PDF 上以全强度盖章，第三个团队则忘记。通过编辑文档内容来“添加徽标”的大语言模型也没有稳定的位置。add_image_watermark 工具将徽标作为水印对象应用，并明确指定 opacity（不透明度）和 rotation（旋转）值，因此相同的输入会产生相同的强度和角度。由于它是对象而非粘贴的内容，徽标在品牌更改时可以被查找并移除。

代理决定什么，引擎执行什么？

步骤 代理决定 引擎执行
哪些文件在范围内 读取文件夹和你的指令 无
调用哪个工具 add_image_watermark 用于徽标，add_watermark 用于状态 无
强度和角度 从你的标准传递 opacity 和 rotation 使用恰好这些数值绘制水印
输出 报告生成的文件 写入新文件；原文件未被修改

标准写在你的提示中。服务器不会自行调度，也没有内置的品牌策略；可重复的部分是你保存并重复使用的指令。

如何用五个步骤强制执行标准？

  1. 将徽标与文档放在一起。 文档和图像都会根据名称从存储文件夹 (GROUPDOCS_MCP_STORAGE_PATH) 中解析。使用透明 PNG；如果徽标放在白色矩形上，页面上会显示该矩形。
  2. 分离出站文件。 如果希望品牌副本与源文件分开保存，请将 GROUPDOCS_MCP_OUTPUT_PATH 设置为另一个文件夹。若未设置，输出将写入存储文件夹。
  3. 检查许可证。 提问：“水印服务器的许可证状态是什么？” 代理会调用 get_license_status。
  4. 运行标准提示。 文档推荐的品牌不透明度范围是 0.2 到 0.4；超过 0.6 时徽标会主导页面。
  5. 验证。 对每个生成的文件执行 search_watermarks 检查，并将计数与预期值进行比较。

水印还能标注状态吗？

可以，通过第二个链式调用。在一次请求中同时加品牌并标注状态：

在 25% 不透明度下添加徽标，然后在该结果上添加 CONFIDENTIAL 文本水印。

每次调用都会写入新文件，因此“在该结果上”保证了两个水印都保留下来。

示例会话（节选）

你：    将 logo.png 放在 report.pdf 上，透明度 30%。
代理：  [add_image_watermark: watermarkImage logo.png, opacity 0.3]
        已将图像水印从 "logo.png" 添加到 "report.pdf"
你：    这太强了——请重新设置为 0.2。
代理：  [add_image_watermark: opacity 0.2, from the original report.pdf]
        已将图像水印从 "logo.png" 添加到 "report.pdf"
        已存在两个品牌副本。如果不需要 0.3 版，请删除它。

以这种方式迭代是安全的，因为每次尝试都会生成新文件。随后删除被拒绝的文件。

哪种交付渠道适合团队推广？

对于共享部署，Docker 镜像可以避免在每台机器上额外安装任何东西，因为运行时和本机依赖都已包含在镜像中：

docker run --rm -i -v $(pwd)/documents:/data \
  ghcr.io/groupdocs-watermark/watermark-net-mcp:latest

NuGet 渠道（dnx GroupDocs.Watermark.Mcp --yes）需要 .NET 10 SDK。两者都可在 Windows、Linux 和 macOS 上运行（Linux/macOS 上的 dnx 还需要 libgdiplus），并且使用相同的六个工具，因此品牌提示在两者之间保持不变。

有哪些限制？

需要围绕两个限制进行规划。第一，工具仅公开 opacity 和 rotation：没有位置、大小或边距设置。第二，评估模式：服务器的许可证页面说明未授权的输出带有评估限制（具体限制请参见库的 许可页面），因此未持有许可证生成的品牌副本不可分发。在品牌推广前运行 get_license_status。在计量授权下，每处理一个文件都会计费；在许可证文件模式下，服务器可离线工作。还要记住，水印只是给文档贴标签，并不能保护其下的内容。

常见问题

AI 能为所有 PDF 添加我们的公司徽标吗？
可以。通过文件名指定徽标并提供不透明度；代理会对每个文件调用一次 add_image_watermark。同样的调用也适用于 Word、PowerPoint、Excel 和图像文件。

我可以在图像和文档上使用相同的徽标吗？
可以。图像也是有效的目标，因此对产品照片加品牌的方式与对 PDF 加品牌相同。

品牌更改时会怎样？
remove_watermarks 可以去除旧徽标，因为它是作为水印对象添加的。它的 textFilter 仅匹配水印文本，所以删除图像徽标会移除所有水印，包括文本标记。先搜索以了解现有情况，然后再添加新徽标。

深入了解