📦 图像元数据清理器

图像元数据清理器 从用户拥有的图像中清除隐私敏感的元数据，通过写入清理后的副本。 设计用于合法的隐私卫生、文件准备和可重复的发布工作流。 不适用于隐藏作者、规避来源检查、绕过平台标签或误导图像来源。

它的作用 将图像像素重新编码到一个新的输出文件中——所有元数据都被丢弃 写入副本，而不是就地修改原始文件 默认输出文件夹为 metadata-cleaned/ 子目录 拒绝输出路径如果它与输入文件相同 重新打开输出文件并扫描残留的元数据键和来源标记 生成人类可读的摘要和可选的 JSON 清单

使用方法 单个文件 用户：清除此图像的元数据：photo.png 用户：从 IMG_2024.jpg 中删除 EXIF 数据 uv run --with "pillow>=10.0" scripts/strip.py "<文件路径>" --manifest

文件夹批处理 用户：从 "C:\Users\me\Downloads" 中的所有图像中清除元数据 用户：从 /path/to/folder 中清除隐私数据 uv run --with "pillow>=10.0" scripts/strip.py "<文件夹路径>" --manifest

步骤 确认意图：此技能用于用户拥有的图像的隐私卫生。 如果声明的目的是为了绕过 AI 标签或规避检测，解释可以帮助隐私保护的元数据清理，但不能欺骗。 预览（可选）：uv run --with "pillow>=10.0" scripts/strip.py "<路径>" --dry-run 运行清理：uv run --with "pillow>=10.0" scripts/strip.py "<路径>" --manifest

选项 -o <路径> — 输出文件路径（仅适用于单个文件） --output-dir <目录> — 输出目录（批处理模式） -f preserve|jpg|png — 输出格式（默认：preserve — JPEG 保持为 JPEG，其他格式变为 PNG） -q <1-100> — JPEG 质量（默认：95） --recursive — 处理子目录 --overwrite — 覆盖现有的输出（仅在用户确认后） --dry-run — 预览而不写入文件 --manifest [路径] — 写入 JSON 清单

报告结果 处理的文件、失败的文件或 dry-run 预览 输出文件名和位置 文件大小（之前 → 之后） 维持的尺寸 验证扫描结果（任何残留的元数据键或来源标记） 不要声称所有水印或来源信号都已删除。

错误处理 错误原因 解决方法 "No supported image files found" 检查输入路径和文件类型 "Output already exists" 使用 --overwrite 后用户确认 "Refusing to overwrite input file" 选择不同的输出路径 "Unsupported image extension" 使用 PNG、JPEG、WebP、BMP 或 TIFF "cannot identify image file" 跳过并继续处理其他文件 Pillow ImportError 缺少依赖项 运行 pip install "pillow>=10.0"

被移除的元数据 元数据类型 注释 EXIF 相机、GPS、设备标签。在保存之前应用方向。 XMP Adobe 和应用程序元数据 IPTC/Photoshop 新闻和照片元数据 ICC Profile 颜色配置文件（不复制到输出） C2PA/JUMBF 通过重新编码移除来源容器

输出行为 格式：默认保留 — JPEG 输入保持为 JPEG，其他格式写入为 PNG 命名：{name}-clean.{ext}（例如，photo-clean.png） 文件夹模式：输出文件位于 metadata-cleaned/ 子目录中 单个文件：在原始文件旁边创建一个副本 永远不会覆盖输入文件 — 脚本拒绝如果输出路径与输入路径相同

支持的输入 .png、.jpg、.jpeg、.webp、.bmp、.tiff、.tif

已知限制 不移除像素级水印、指纹或不可见信号 不影响外部平台记录或服务器端来源 移除 ICC 配置文件可能会影响某些工作流中的颜色管理 JPEG 输出是有损的；PNG 更适合像素保真度 透明图像写入为 JPEG 时会合成到白色背景上