PPT 压缩技能

将 .pptx 文件解包后对内嵌图片进行有损/无损压缩、用 ffmpeg 压缩内嵌视频、清理冗余元数据，再重新打包，从而减小文件体积。

依赖

• Pillow（图片压缩，必需）：pip install Pillow
• ffmpeg（视频压缩，可选）：未安装时视频保留原始数据，脚本会输出安装指引

使用方法

python scripts/compress.py <input.pptx> [options]

参数说明

| 参数 | 说明 | 默认值 |

|------|------|--------|

| input | 输入 PPTX 文件路径 | 必填 |

| -o, --output | 输出文件路径 | _compressed.pptx |

| -l, --level | 压缩档次：low / medium / high / extreme | medium |

| 图片参数 | | |

| --image-quality | 图片 JPEG 质量 (1-100) | 由 level 决定 |

| --max-width | 图片最大宽度像素 | 由 level 决定 |

| --max-height | 图片最大高度像素 | 由 level 决定 |

| --strip-thumbnail | 移除文档缩略图 | 由 level 决定 |

| --strip-comments | 移除幻灯片批注 | false |

| --convert-png | 不透明 PNG 转 JPEG | 由 level 决定 |

| --no-convert-png | 禁止 PNG 转 JPEG | - |

| 视频参数 | | |

| --video-crf | 视频 CRF 值 (0-51，越高压缩率越大) | 由 level 决定 |

| --video-scale | 视频最大短边像素 (如 720、1080) | 由 level 决定 |

| --video-preset | x264 编码预设 (ultrafast~veryslow) | 由 level 决定 |

| --no-video | 跳过视频压缩 | false |

压缩档次预设

| 档次 | JPEG 质量 | 图片尺寸 | 移除缩略图 | PNG→JPG | 视频 CRF | 视频尺寸 | 编码预设 |

|------|-----------|----------|------------|---------|----------|----------|----------|

| low | 85 | 2560px | 否 | 否 | 23 | 原始 | medium |

| medium | 70 | 1920px | 是 | 是 | 28 | 1080p | medium |

| high | 50 | 1440px | 是 | 是 | 32 | 720p | slow |

| extreme | 30 | 1024px | 是 | 是 | 38 | 480p | slow |

使用示例

基本压缩（medium 档）：

python scripts/compress.py "报告.pptx"

高压缩档：

python scripts/compress.py "报告.pptx" -l high -o "报告_小.pptx"

跳过视频只压图片：

python scripts/compress.py "报告.pptx" -l medium --no-video

自定义视频参数：

python scripts/compress.py "报告.pptx" --video-crf 30 --video-scale 720 --video-preset slow

ffmpeg 安装指引

若系统未安装 ffmpeg，脚本运行时会跳过视频并输出安装方法：

• Windows: winget install Gyan.FFmpeg 或 scoop install ffmpeg 或 choco install ffmpeg
• macOS: brew install ffmpeg
• Linux: sudo apt install ffmpeg (Debian/Ubuntu)