您可以使用一個提示為文件夾中的文件添加水印：AI 代理列出文件，對每個文件調用一次 watermark 工具，並報告其產出，全部在本地完成，無需上傳。在 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 設為另一個文件夾，並從該處發送。無論哪種方式，原始文件永不會被覆蓋，因此在源文件變更後可以重新執行某個階段；只需再次指定要處理的文件名稱。

如何確保批次的正確性？

  • 要求提供產生的文件清單。 只回報「完成」的執行會讓您猜測哪些副本需要發送。
  • 明確要求失敗資訊。 混合文件夾可能包含引擎無法加水印的格式。調用會以訊息失敗，而不是靜默跳過，因此請求失敗清單。
  • 注意計量使用。 在計量授權下，每個文件的處理都會計費。
  • 先檢查授權。 評估模式下的批次執行是浪費的。

有哪些限制？

評估模式是主要限制：伺服器的授權頁面說明未授權的輸出帶有評估限制；具體限制請參閱庫的 licensing page。評估模式的副本文件夾相當於無法分發的草稿文件夾。請在執行前讓代理調用 get_license_status；它會回報 mode 為 evaluation、licensed 或 metered。另無內建排程器：伺服器僅在您的代理請求時執行，因此要實現定期任務需要客戶端或任務執行器來發送提示。

常見問題

AI 能一次為多個 PDF 加水印嗎？
可以。代理會遍歷文件夾，對每個文件調用一次 add_watermark，然後列出產生的副本。每個文件單獨處理。

我可以在文件夾中的每個文件添加 CONFIDENTIAL 嗎？
可以。將提示中的 DRAFT 替換為 CONFIDENTIAL。說明是否應跳過已帶有標記的文件。

是否可以在本地批量加水印，而無需上傳？
可以。伺服器是由您的客戶端啟動的本地進程，會讀寫您配置的文件夾。

深入了解