allenk/GeminiWatermarkTool

Gemini Watermark Tool – 功能簡介

GeminiWatermarkTool 是一個輕量級的跨平台程式，用於移除 Google Gemini AI 模型生成的圖像（以及透過配套二進位檔處理的影片）中添加的可視浮水印。它採用確定性反向 Alpha 混合 (deterministic reverse-alpha-blending) 演算法，而非通用的生成式修復，因此能夠盡可能準確地還原原始像素數據。此外，還可以選擇使用輕量級神經網路去噪器 (FDnCNN) 來清理殘餘的偽影。

核心功能 (詳見 README)

類別	詳情
核心演算法	使用針對 Gemini 浮水印校準的 48×48 和 96×96 遮罩進行反向 Alpha 混合。
浮水印配置	支援較新的 Gemini 3.5 佈局（36×36 或 96×96 Logo），並自動回退至舊版 3.5 之前的佈局。
檢測	帶有置信度評分的三階段歸一化互相關 (NCC)；自動跳過無浮水印圖像。
CLI	支援單檔案、批次目錄及多檔案模式。具備自動舊版回退、可配置的 `--threshold`、`--force`、`--legacy` 以及獨立的退出代碼 (0 = 成功, 1 = 跳過, 2 = 錯誤)。
GUI	支援拖放的桌面應用，具備實時前後對比預覽、自定義區域選擇、修復 (NS, TELEA, Soft)、AI 去噪、批次縮圖及鍵盤快捷鍵。
AI 輔助清理	透過 NCNN 執行 FDnCNN（20 層卷積網路），支援 Vulkan GPU 加速；若無 GPU 則回退至 CPU。
影片支援	獨立的 VeoWatermarkRemover 二進位檔 (v0.6.1)，逐幀應用相同的反向 Alpha 計算，支援自適應逐幀 Alpha、音訊透傳及可選 AI 去噪。
跨平台	提供 Windows、Linux、macOS (Intel + Apple Silicon) 和 Android CLI 的預建便攜式執行檔。
Agent 集成	透過 MCP 伺服器及 Claude Code 技能 (`gwt-integrations`) 為 AI Agent 流水線提供四個工具呼叫 (`remove_watermark`, `detect_watermark`, `batch_process`, `get_tool_info`)。
授權	MIT – 商業用途免費，重新分發需註明出處。

典型使用場景

清理 Gemini 生成的圖像：在發佈或封存前，在不依賴生成式填充的情況下保留原始細節進行清理。
批次處理：處理包含大量截圖或匯出資產的資料夾，其中部分檔案可能不含浮水印。
整合至自動化腳本：利用 CLI 的退出代碼與 MCP 暴露的 API，將其整合至 CI 流水線或內容審核機器人中。
影片後處理：使用配套的 VeoWatermarkRemover 二進位檔，處理包含 Gemini 3.5 「鑽石」浮水印的錄影。

快速入門 (CLI)

# 單張圖像，自動檢測
GeminiWatermarkTool image.png

# 即使檢測失敗也強制處理
GeminiWatermarkTool --force image.png -o clean.png

# 資料夾批次處理 → 輸出資料夾
GeminiWatermarkTool -i./watermarked/ -o./clean/

# 僅使用舊版配置
GeminiWatermarkTool --legacy old_image.png

快速入門 (GUI)

執行執行檔（無需安裝）。
將圖像或資料夾拖放到視窗中。
工具會自動檢測浮水印；如有需要，可調整區域或選擇不同的配置。
按 X 套用，按 V 切換前後檢視，按 Z 復原。
對於影片，請啟動獨立的 VeoWatermarkRemover 二進位檔並拖入 MP4 檔案。

為什麼它很重要

確定性還原：不同於會產生「幻覺」內容的 AI 修復工具，此方法透過數學方式逆轉添加浮水印的精確混合過程，在原始圖像未被修改時實現忠實的重建。
輕量且離線：單個便攜式執行檔，支援可選的 GPU 加速去噪，無需雲端服務。
緊跟前沿：支援最新的 Gemini 3.5 浮水印佈局，並為舊版圖像提供自動回退。
可擴展性：透過 MCP 暴露，以便未來的 AI Agent (Claude, Cursor 等) 可以直接呼叫。

獲取更多資訊

原始碼與發佈 – https://github.com/allenk/GeminiWatermarkTool
影片移除工具 – https://github.com/allenk/VeoWatermarkRemover
技術深挖 – README 中連結的 Medium 文章。
演示影片 – https://www.youtube.com/watch?v=0jux3AJVb2Q

總結

GeminiWatermarkTool 是一個真正的開源工具，專注於一個非常具體的 AI 相關問題：移除 Google Gemini 模型在其輸出中蓋上的專有浮水印。它結合了數學精確的反向 Alpha 演算法與可選的 AI 基礎去噪，提供 CLI 與精美的 GUI，甚至還為 AI Agent 集成提供了 API。對於任何需要可靠、離線方式來清理 Gemini 生成媒體的人來說，這個儲存庫非常對口且開箱即用。