用途:面向本地目录的离线、可脚本化图片批处理流水线,用于把某个目录下的图片批量转换为统一格式(默认 webp,质量默认 80),在压缩体积的同时保持处理完全离线。适合分发前统一格式、CI/本地自动化准备网站或应用素材等场景。
主要能力:使用 Pillow 完成常见图片格式的批量转换;可配置输出格式与质量;可选递归遍历子目录并在输出目录中保留相对路径结构;可控制是否覆盖已有输出;运行结束时在标准输出打印数量与错误汇总;某个文件失败不会中断整批处理,错误会被收集并在最后汇总。
用法:需要 Python >= 3.9,并安装依赖 pip install -r scripts/requirements.txt;转换命令为 python scripts/convert_images.py --source-dir "<src>" --output-dir "<out>" --format webp --quality 80,可选 --recursive 递归、--overwrite 允许覆盖(具体参数以实际实现为准)。最小验证可运行 python scripts/convert_images.py --help。脚本只从 --source-dir 读取、只向 --output-dir 写入,无网络访问、无外部 API、无需凭证。
格式细节:JPG/JPEG 以 RGB 保存并使用给定质量、启用渐进式输出;PNG 使用由 quality 参数推导的压缩级别;WebP 使用给定质量并设置 method=6。
限制:仅处理本地目录图片,不涉及联网或外部服务;缺少必要源数据、文件、标识或凭证时不适用;请求伪造结果或超出范围结论时不适用;更简单的直接回答优于该工作流时也不适用。执行前应先确认任务目标、所需文件与参数齐备。输出契约、示例文件与验证摘要的具体约定,资料中部分未展开,暂未提供。