先保证不超限,再谈画质
脚本按三级降档跑:先保 1200 宽、256 色,超了就降色数,再超就降宽度,每降一档记一行日志。跑完你能看到每张图最后落在哪一档,而不是只知道「压过了」。1200×675 的实拍图多数落在第二档,输出在 220 到 290 KB 之间。
失败不静默
有 3 类文件会被跳过并写进 failed.csv:小于 8 KB 的(本来就没多少可压)、通道数异常的 CMYK 图、以及解码就报错的。日志里写清文件名与原因,不会跑到一半停下来,也不会把原图覆盖掉——输出目录默认是 out/,原图不动。
参数只有四个
--src 源目录、--out 输出目录、--max-kb 上限、--width 最大宽度。四个参数都有默认值,直接双击 run.bat 就能跑当前目录。需要递归子目录时加 --deep,不需要就不加,避免误处理整个盘。
参数表
| 项目 | 数值 |
|---|---|
| 运行环境 | Python 3.9 及以上,Windows 10/11 与 Ubuntu 22.04 实测 |
| 依赖 | 仅 Pillow 一个库,requirements.txt 一起给 |
| 单批上限 | 600 张,超过请分批,避免内存占用过高 |
| 输出上限 | 默认 300 KB,可用 --max-kb 改 |
| 最大宽度 | 默认 1200px,超出按比例缩放 |
| 日志输出 | report.csv 逐张体积,failed.csv 记录失败原因 |
| 授权范围 | 单团队授权,可改源码,不可转售脚本本身 |
三个具体的使用场合
- 静态站上线前压图:把 300 张配图丢进 src,跑一次,半小时内拿到 300 张合规图片和一份体积清单,直接替换上线。
- 客户给的图规格不一:脚本会把超过 1200 宽的图缩到 1200,把 40 KB 的图跳过不处理,省掉逐张判断。
- 内容团队交接:report.csv 可以直接给编辑看,谁交的图压不下来,一行就能定位到文件名。
交付周期
付款后立刻发下载链接,压缩包 1.2 MB,含脚本、run.bat、requirements.txt 与一份 6 页的用法说明。源码不做混淆,可以直接改阈值和目录判断逻辑。
售后条款
脚本报错把控制台输出发来,48 小时内给定位;Pillow 升级导致跑不动,会更新兼容版本并发给已购读者;30 天内可退款,脚本不必删除。
选型建议
如果你一个月只压十几张图,用系统自带工具更快;如果站里有几百张图要统一规格,或者要给团队定一条「不许超过 300 KB」的规矩,脚本的价值在失败清单和日志,不在压缩算法本身。三个工具里这个最常用,建议先买它。
为什么选这件,而不是隔壁那一件
- 降档有记录:每张图最后用了哪一档、体积多少都写进 CSV,可复核
- 原图不动:默认输出到 out/,不覆盖源文件,跑错了也能重来
- 失败有清单:三类跳过原因分开写,不会混成一句「处理完成」
- 只有四个参数:不多塞选项,看说明 3 分钟能上手
买之前常问的三件事
付款之后多久能拿到文件?
付款后立刻发下载链接,压缩包 1.2 MB,含脚本、run.bat、requirements.txt 与一份 6 页的用法说明。源码不做混淆,可以直接改阈值和目录判断逻辑。
改坏了能找你们改回来吗?
脚本报错把控制台输出发来,48 小时内给定位;Pillow 升级导致跑不动,会更新兼容版本并发给已购读者;30 天内可退款,脚本不必删除。
和同类的另一件怎么选?
如果你一个月只压十几张图,用系统自带工具更快;如果站里有几百张图要统一规格,或者要给团队定一条「不许超过 300 KB」的规矩,脚本的价值在失败清单和日志,不在压缩算法本身。三个工具里这个最常用,建议先买它。