信息卡

一句话定位

一个"Agent skill + 纯标准库 Python 服务"，对自有文本与文件分层剥离 Claude、Gemini/SynthID、OpenAI 及学术绿名单方案留下的多厂商 AI 出处标记。

走红原因分析

随着 SynthID-Text 登上 Nature 论文、各大厂商默认嵌入出处标记，"内容归属卫生"成为刚需。该项目在争议赛道里采用了罕见的克制姿态：限定用于自己拥有或获授权的内容，附 ethics.md 伦理边界，检测与清洗分离且可选 fail-soft；建仓三天即近八百星，说明需求侧早已憋着一口气。

核心功能拆解

• Layer A（确定性）：清除隐形 Unicode、异形空格、双向控制符、标签字符——纯 Python 标准库，无损可测。
• Layer B（统计性）：针对 token 采样类水印（Kirchenbauer 绿名单、keyed-Gumbel/Aaronson EXP），用 agent 重写加可选 rewrite_text.py 进行高强度改写，属 best-effort 且会损失风格语气。
• 文件层：剥离 C2PA/EXIF/XMP 元数据与文档属性。
• 覆盖九类图像格式（PNG/JPEG/WebP/SVG 等）、PDF/DOCX/XLSX/PPTX/EPUB 等文档、MP4/WAV/MP3 等音视频，各格式策略不同（PDF 须 qpdf 才能真正剥离）。
• 支持备选外部工具 c2patool/exiftool/qpdf，核心脚本零第三方依赖。
• PostToolUse hook 可自动清洗写入文件；pre-commit hook 支持。

7. 明确免责："No tool can certify that a vendor detector will fail."；建议用非原始来源模型重写以免二次打标。

架构与技术栈浅析

Skill 本身只是 HTTP 客户端，全部清洗逻辑在本地服务端执行：`make serve` 拉起 FastAPI 风格 HTTP 服务，提供 /health、/capabilities、/inspect、/detect、/clean 与批量接口（单批上限 50 个文件），文件经 base64 提交；默认绑定 127.0.0.1:8765，可用 bearer key 加认证；另有 Docker 三 profile（core/harness/heavy）。

安装与环境要求

Python 3.10+ 即可跑核心；qpdf/c2patool/exiftool 为增强可选；Windows/macOS/Linux 均可，服务地址非默认时设 WATERMARKS_SERVICE_URL。

快速上手示例

python3 install_skill.py --skill remove-ai-marks --target claude-code
python3 service/scripts/server.py --host 127.0.0.1 --port 8765

python3 "$SCRIPTS/inspect_file.py" draft.md
python3 "$SCRIPTS/clean_file.py" draft.md -o draft.cleaned.md
python3 "$SCRIPTS/rewrite_text.py" draft.md --backend print-prompt --strength paraphrase

也可作为 Claude Code 插件安装：`/plugin marketplace add guillaumemeyer/watermarks-remover` 后 `/plugin install watermarks-remover@watermarks-remover`。

进阶使用要点

check 模式默认只报告不改动，clean 才就地清理；未识别格式不会自动清洗；软绑定 C2PA 与纯像素/音频域水印不在核心路径内；README 尾部附 SynthID-Text、MarkLLM、CtrlRegen 等完整参考文献。

典型应用场景

• 自有博客文章发布前去除元数据残留。
• 企业合规：清理内部文档流转中的出处信息以降低泄露面。
• 水印检测研究：配 MarkLLM 做攻防对照实验。

同类生态位对比

同类多为单点脚本或论文复现；本项目的差异化是"skill + 本地服务 + 批量 API + hook 自动化"的完整工程链路，并把伦理声明前置，社区接受度因此更高。

资源导航

仓库：https://github.com/ShadowAqueduct/watermark-remover ；当前版本 v0.5.0；许可证 MIT；伦理边界见 skills/remove-ai-marks/references/ethics.md。