/add-photo-certificate-watermarks

name: add-photo-certificate-watermarks
description: 为照片、身份证、护照、学位证、毕业证、资格证、营业执照等证件或证书扫描件及 PDF 添加本地文字水印。用户提出照片加版权水印、身份证或学历证件添加“仅限某用途”水印、资质文件批量加水印、生成水印预览，或需要保持头像、二维码、印章等区域可辨认时使用。支持 JPEG、PNG、WebP 和 PDF，默认先预览、保留原件并清除图片元数据。不用于去除水印、伪造或篡改证件内容，也不用于仅设计 Logo 水印素材。

照片与证件水印

使用随 Skill 提供的本地脚本生成可复现的文字水印。先预览，再批量输出；绝不覆盖原件。

工作流

复制并跟踪：

水印进度：
- [ ] 1. 确认输入与用途
- [ ] 2. 选择预设与水印文案
- [ ] 3. 检查依赖并生成预览
- [ ] 4. 审核可读性和避让区域
- [ ] 5. 批量输出并交付

1. 确认输入与用途

• 解析用户给出的文件或目录；只接受 JPEG、PNG、WebP、PDF。
• 判断是照片版权标记还是证件 / 证书用途限制；不确定时只问用途这一项。
• 证件范围包括身份证、护照、学位证、毕业证、成绩单、资格证、营业执照和资质证明等材料。
• 若请求去水印、修改证件内容或制造误导性材料，停止并说明不能执行。
• 创建独立输出目录。不要写回输入路径，不要删除原件。

2. 选择预设与文案

• 照片：使用 `--preset photo`，默认右下角单点水印，适合作者名、品牌名或版权声明。
• 证件 / 证书：使用 `--preset certificate`，默认斜向平铺，适合身份证、学历证件、资格证和资质文件的“仅用于……，再次复印无效”等用途限制。
• 水印文案必须具体、短且与真实用途一致。不要擅自写身份证号、电话、住址等新的个人信息。
• 需要文案建议、参数说明或避让原则时，读取 [references/presets-and-safety.md](references/presets-and-safety.md)。

3. 检查依赖并生成预览

先检查：

python3 -c "from PIL import Image; import fitz; print('watermark dependencies OK')"

缺少依赖时，说明将安装到哪个 Python 环境并征得用户同意，再执行：

python3 -m pip install --upgrade Pillow PyMuPDF

先对第一个输入生成预览：

python3 scripts/add_watermark.py INPUT \
  --output-dir OUTPUT_DIR \
  --text "仅用于办理示例业务，其他用途无效" \
  --preset certificate \
  --preview-only

照片示例：

python3 scripts/add_watermark.py PHOTO.jpg \
  --output-dir OUTPUT_DIR \
  --text "© Example Studio" \
  --preset photo \
  --preview-only

在实际使用时，从当前 Skill 目录解析 `scripts/add_watermark.py` 的绝对路径，不要假设调用者的工作目录就是 Skill 目录。

4. 审核预览

必须检查预览，不能仅以命令成功作为通过：

• 水印清晰但不遮挡主体信息。
• 证件 / 证书水印至少穿过部分内容区域，不能只落在可裁掉的空白边缘。
• 身份证、护照等身份证明上的人像、姓名、证件号码、机读码或二维码仍可核验；水印可以低透明度穿过，但不能遮成不可辨认。
• 学位证、毕业证和资格证上的印章、签名、证书编号仍可辨认。
• 文字没有被裁切，中文没有显示成方框。

需要避让时，使用一个或多个归一化矩形；格式为 `左,上,右,下`，取值均为 0 到 1：

python3 scripts/add_watermark.py CERT.pdf \
  --output-dir OUTPUT_DIR \
  --text "仅用于供应商资质审核，其他用途无效" \
  --preset certificate \
  --exclude 0.72,0.06,0.94,0.25 \
  --exclude 0.62,0.68,0.90,0.92 \
  --preview-only

脚本不会自动识别敏感区域。根据预览调整 `--opacity`、`--font-size`、`--layout`、`--angle` 或 `--exclude`，直到通过。

5. 批量输出并交付

移除 `--preview-only`，保持已确认的参数不变：

python3 scripts/add_watermark.py INPUT_OR_DIRECTORY \
  --output-dir OUTPUT_DIR \
  --text "仅用于办理示例业务，其他用途无效" \
  --preset certificate \
  --recursive

• 输出文件默认追加 `_watermarked`；已存在同名文件时停止，不覆盖。
• 输出目录位于输入目录内部时，递归扫描会自动排除该输出目录，避免结果被再次加水印。
• 图片默认移除 EXIF 等元数据；只有用户明确需要保留时才使用 `--keep-metadata`，并提醒其可能包含拍摄时间、设备或位置。
• 对一批同版式文件，至少抽查首个、最后一个和一个中间结果。不同版式不要共用未经复核的避让坐标。
• 最终交付输出目录、文件数量、使用的文案和预设，并明确原件未修改。不要在回复中展示身份证号、证件正文或其他私人信息。

失败处理

• 文件损坏、加密 PDF、零页 PDF或格式不支持：停止该文件，报告文件名和原因，不生成假成功结果。
• 字体缺失或中文显示异常：要求用户提供支持该文字的 `.ttf` / `.otf` / `.ttc`，再用 `--font` 指定；不要把未授权字体打包进 Skill。
• 输出文件已存在：改用新的输出目录或文件名；不要自动删除或覆盖。
• PDF 处理失败：保留原件和已成功输出，报告失败项；不要把 PDF 静默转成图片冒充原格式。

Gotchas

• 水印不是密码学保护，仍可能被裁剪、修复或重绘；不要承诺“绝对防盗用”。
• 过浅的水印失去限制用途的意义，过深则影响核验；必须以预览为准。
• 同一组 `--exclude` 坐标只适合同版式页面。PDF 每页布局不同就逐页检查或拆开处理。
• 身份证、护照的正反面通常不是同一版式，必须分别预览，不能直接共用避让坐标。
• `--keep-metadata` 可能保留 GPS、设备和拍摄时间，默认不要启用。
• 不要在公开日志、临时目录名或交付说明里写证件号码和其他敏感内容。

输出契约

交付时简要说明：

水印处理完成
- 输出目录：<绝对路径>
- 结果：<成功数> 个；<失败数> 个
- 预设 / 布局：<photo|certificate> / <corner|tile|center>
- 水印文案：<文案>
- 原件：未修改
- 元数据：已移除 / 按用户要求保留
- 复核：<抽查范围与结论>