图片压缩
图片压缩
先预演，再写入独立目录。输入和输出均使用实际绝对路径；下列 /absolute/path/... 需要替换。
slothtool image-compress --recursive --dry-run --json --output-dir "/absolute/path/compressed" "/absolute/path/album"
slothtool image-compress --recursive --output-dir "/absolute/path/compressed" "/absolute/path/album"
所有选项放在输入路径之前。 当前后端在遇到位置参数后停止解析选项，路径之后的 --dry-run 可能被当成文件；相对路径还受包装层后端工作目录影响。
预演实际执行压缩计算，但不写文件。默认保留原图，文件名插入 .compressed；指定输出目录时保留相对目录结构。默认仅写出更小结果，跳过不一定是失败。
参数
| 参数 | 行为 |
|---|---|
| -r / --recursive | 递归扫描，默认不递归 |
| -o / --output-dir | 输出目录，默认在输入旁生成 |
| --quality | JPEG 质量 1–100，默认 82 |
| --max-width / --max-height | 最大尺寸，0 保持原尺寸限制 |
| --concurrency | worker 数，0 使用后端默认 |
| --overwrite | 无输出目录时允许替换原图；有输出目录时允许替换目标 |
| --allow-larger | 允许写出更大结果 |
| --dry-run / --json / --quiet | 不写文件 / 输出汇总 JSON / 隐藏常规进度 |
--overwrite 会改写文件，使用前保留原件。写出后抽查细节、透明背景和颜色，不根据固定压缩率判断质量。
JPEG、PNG 是当前输出格式；WebP 可识别但没有输出编码器，会受控跳过，不提供 HEIC/AVIF 转换。
无失败时退出 0，处理失败或取消退出 1，后端参数解析错误退出 2。JSON 的 FailedCount、SkippedCount 等字段区分大小写；批量完成后检查失败项。
也可运行 slothtool image-compress，将路径拖入终端加入队列，核对选项后执行。发布平台条件见安装与环境。