當你請求 AI 代理對掃描頁面進行遮蔽，而文字遮蔽找不到任何可替換的內容時，該頁面並不乾淨，因為它沒有可搜尋的文字層。若要在本機對掃描件進行遮蔽，代理會使用 redact_image_area 依座標覆蓋區域，而不是匹配文字。將 GroupDocs.Redaction.Mcp 連接到 Claude Desktop 或 Cursor 時，請求會是這樣：

覆蓋 scan.png 底部三分之一的區域，使用黑色方框。

步驟說明（含設定與故障排除）請參考文件：如何使用 AI 代理遮蔽掃描文件與影像。

為什麼文字遮蔽在掃描件上找不到任何內容？

掃描件是文件的圖片。上面的文字是像素，因此正規表達式找不到可匹配的內容。redact_text 在掃描頁面上找不到可替換的文字，而找不到並不等同於沒有敏感資訊。將影像檔案的空結果視為「沒有文字層」，然後切換工具。對於照片、印章以及位於原本數位合約背面的掃描簽名頁也同樣適用。

哪個工具可以覆蓋頁面的區域？

redact_image_area 會以實心顏色方框覆蓋頁面矩形，永久隱藏其下的影像內容，例如臉孔、簽名與印章。它接受以像素為單位的 x、y、width 與 height，相對於頁面左上角，並可選擇 color（預設為黑色，或十六進位值如 #FF0000）。此工具不接受頁碼參數，只需檔案與矩形，因此請開啟輸出檔案確認方框的位置。由於數值是像素，您需要先取得影像或頁面的尺寸，才能選擇矩形。

如何取得座標？

先取得頁面尺寸。get_document_info 會回傳檔案類型、頁數以及每頁的寬度與高度，從而把「底部三分之一」轉換為實際數字。

scan.png 的尺寸是多少？

然後給予代理區域：

覆蓋 scan.png 底部三分之一的區域，使用黑色方框。

若要定位特定元素（例如簽名或臉孔），需要取得其位置。有兩種實用方式。先在任何檢視器中開啟頁面自行讀取座標。或讓代理使用回傳頁面影像的伺服器渲染頁面：GroupDocs.Viewer.Mcp 的 render_page 工具會將單一頁面渲染為 PNG 並內嵌回傳，GroupDocs.Annotation.Mcp 伺服器則能回傳頁面預覽（其預覽工具目前在 Linux 與 Docker 上的 PDF 檔案會失敗；Word 與其他 Office 文件可以渲染，且在 Windows 使用 dnx 時所有格式皆可渲染）。具備視覺能力的模型即可估算方框，您在遮蔽執行前先確認。

那些文字與掃描混合的文件該怎麼處理？

包含掃描簽名頁的原生數位合約需要同時使用兩種工具，而 redact_image_area 無法透過參數針對單一頁面。請將兩個步驟分開：先遮蔽文字，然後將掃描頁視為影像，使用區域遮蔽。

在 contract.docx 中遮蔽電子郵件地址，然後告訴我下一步應使用哪個已儲存的檔案。

接著以肉眼檢查最終輸出檔案的每一頁。

典型的掃描工作流程是什麼樣子？

可行的順序為：讀取頁面尺寸 → 決定區域 → 覆蓋 → 檢視結果。若區域不明顯，先渲染頁面，讓具視覺能力的模型提出方框建議。將建議與最終座標保留在對話紀錄中，讓任何審查案件檔案的人都能看到覆蓋的內容與原因。區域遮蔽之所以刻意粗糙，是因為它只覆蓋矩形，沒有其他處理。

這個伺服器會讀取影像中的文字（OCR）嗎？

不會。GroupDocs.Redaction.Mcp 只負責遮蔽，不會辨識影像中的文字。這樣的行為較為可預測，因為不會有信心門檻在背後悄悄判斷模糊的名字不是名字。如果您的工作流程需要從掃描件中取得文字，請先使用專門的工具抽取文字，判斷哪些是敏感資訊，再以區域方式遮蔽。伺服器無法告訴您名字在圖片中的位置。

範例對話（節錄）

You:    How big is scan.png?
Agent:  -> get_document_info(file: scan.png)
        The image is 1200 x 1600 pixels.
You:    Cover the bottom third of scan.png with a black box.
Agent:  -> redact_image_area(file: scan.png, x: 0, y: 1067, width: 1200, height: 533, color: Black)
        Saved the output file. Please open it and check that the box covers the area.

如何檢查區域遮蔽？

檢查輸出檔案的每一頁，而不只檢查您指定的那一頁。若區域遮蔽少了 20 像素，就代表遮蔽失敗，且不會有回應文字告知。這是唯一無法透過重新執行模式來自動驗證的情況：檢查必須靠肉眼或代理能看到的渲染預覽。驗證相關內容請參考另一篇文章，Trust no redaction you haven’t verified。

評估模式的限制是什麼？

未取得授權時，伺服器每個程序僅允許處理一份文件與一次遮蔽，最多 4 次取代，並附加試用徽章。對於掃描件而言，這代表只能使用一個方框：若一頁需要三個覆蓋區域，仍只會得到一個，且看起來已被處理。請先執行 get_license_status。此上限僅供試用工具，非正式工作使用。

  • Linux 上的 PDF。 在 Linux（包括 Docker 映像）中，redact_image_area 與 erase_metadata 目前在 PDF 檔案上會失敗（PDF 引擎的影像處理依賴 System.Drawing，而 .NET 只在 Windows 上支援）；兩者在 Word 文件上可正常運作，且 redact_text 在 PDF 上可用。請在 Windows 使用 dnx 執行 PDF 區域遮蔽與中繼資料擦除。

常見問題

AI 代理能遮蔽掃描文件嗎？ 可以，透過區域遮蔽。它會使用 redact_image_area 覆蓋您定義的矩形，因為沒有文字可供模式匹配。

Claude 能從掃描影像中移除簽名嗎？ 當簽名位置已透過檢視器或渲染的頁面預覽取得後，Claude 可指示遮蔽。伺服器會以實心方框覆蓋該矩形。

如何自動將掃描或影像的區域塗黑？ 提供檔案與矩形給代理，它會呼叫 redact_image_area。此工具沒有頁碼參數，請以肉眼檢查結果的每一頁。

為什麼文字遮蔽在我的掃描件上沒有任何變化？ 掃描或影像只包含像素，沒有文字可替換。請使用區域遮蔽，並以肉眼檢查結果。

深入了解