信息卡

一句话定位

一套「Agent skill + 纯标准库 Python 服务」，用于剥离文本与文件中的多厂商 AI 溯源标记——包括 Claude、Gemini/SynthID-Text、OpenAI 溯源面、开源统计水印以及 C2PA/EXIF/XMP 元数据；README 明确限定用于自己拥有或已授权的内容，不用于欺诈或虚假署名。

走红原因分析

一是 AI 内容水印（SynthID-Text、C2PA 凭证）全面铺开，用户对自有内容的隐私与元数据卫生需求陡增，而专门工具几乎空白；二是项目踩在敏感但强需求的合规边界上，话题性极强；三是工程质量扎实（核心零依赖、安全审计友好、CI 带 CodeQL/pip-audit），曾用名 remove-claude-marks 积累了首批关注；四是对 Claude Code 插件市场与 PostToolUse hook 的一键接入大幅降低门槛。

核心功能拆解

• Layer A（确定性）：清除零宽字符、双向控制符、Tag 字符、非字符等不可见 Unicode 载体；
• Layer B（尽力而为）：经 rewrite_text.py 钩子或 Agent 本体重写文本，攻击统计式 token 采样水印；
• 文件清洗：对 PNG/JPEG/PDF/DOCX/XLSX/MP4 等数十种格式剥除 C2PA/EXIF/XMP/doc 属性；
• 内置 HTTP 服务：/health、/capabilities、/inspect、/detect、/clean 及批量端点，附 OpenAPI；
• Claude Code PostToolUse hook（check 默认报告 / clean 就地清洗）+ pre-commit 两档钩子；
• 可选重型后端：reverse-SynthID 像素评分、CtrlRegen 像素移除、MarkDiffusion 扩散净化、MarkLLM 验证、keyed-Gumbel 同钥回放检测。

架构与技术栈浅析

三层结构：skill 层仅是 markdown 指令；服务层为 stdlib 实现的 HTTP 服务器（按扩展名 + magic bytes 双重路由）；外部重型 harness 固定 commit 克隆到独立 venv，永不捆绑。核心要求 Python 3.10+，零第三方依赖；真正的 PDF 元数据剥离需 qpdf/exiftool（exiftool 单独写增量段不算真删除），Ghostscript 负责 PDF 内深层图像。

安装与环境要求

python3 install_skill.py --skill remove-ai-marks --target claude-code

target 支持 claude-code / claude-project / cowork / cursor。服务端 `make serve`（默认 127.0.0.1:8765）；Docker 只读容器 `-p 127.0.0.1:8765:8765 --read-only --tmpfs /tmp`。

快速上手示例

SCRIPTS=service/scripts
python3 "$SCRIPTS/clean_file.py" draft.md -o draft.cleaned.md
python3 "$SCRIPTS/clean_file.py" photo.png -o photo.cleaned.png
python3 "$SCRIPTS/rewrite_text.py" draft.md --backend print-prompt --strength paraphrase

也可 `curl -X POST $WM/clean` 传 base64 文件。

进阶使用要点

• 所有密钥仅走环境变量（WATERMARKS_SERVER_API_KEY 等），绝不进 argv；
• 重型像素清除默认保守（CtrlRegen 强度 0.25、净化 0.3），更强设置损画质且可能残留取证痕迹；
• 仅 core/markllm/markdiffusion 镜像发布 GHCR，synthid/ctrlregen 仅本地构建（许可证限制）。

典型应用场景

• 自产文章、图片对外发布前的元数据与隐藏字符体检；
• 企业外发材料的 AI 痕迹合规自查流程节点；
• Agent 写作流水线内自动化的 PostToolUse 清洗关卡；
• commit 入库前的批量文件卫生扫描。

同类生态位对比

对比通用 EXIF 清理工具：额外覆盖 AI 统计水印与 C2PA，且以 Agent skill 形态分发；对比 MarkLLM 等学术框架：面向生产管道而非验证研究；同领域几乎无开源竞品，属先发占位。

资源导航

仓库 README（三层架构说明）、service/scripts 脚本目录、docker compose 的 core/harness/heavy 三组 profile、pytest 测试套件。