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 生成媒体的人来说，这个仓库非常对口且开箱即用。