不确定视频转 GIF 参数时…

用户想把视频片段转为 GIF，但不确定 FPS、宽度、颜色数和压缩级别时，生成多版本供视觉挑选。

适用场景

解决思路

1. 确认环境：安装并确保 FFmpeg 和 uv 可用；如需生成 lossy 压缩变体，额外安装 gifsicle。
2. 用户提供视频文件后，运行默认命令：`uv run --python 3.12 /path/to/skills/video-to-gif/scripts/video_to_gif.py <input.mp4>`。
3. 默认在 `<input>_gifs/` 目录生成 full preset 的 18 个 GIF 变体：3 个 FPS 值 10、15、20；3 个宽度 480px、640px、800px；2 个颜色数 128、256。
4. 查看脚本输出的排序对比表，其中包含每个变体的文件大小、FPS、宽度和颜色数。
5. 选择 `full` preset（约 18 个变体）用于通用场景，广泛探索参数空间。
6. 选择 `minimal` preset（约 4 个变体）用于快速比较，只看几个关键取舍点。
7. 选择 `lossy` preset（约 12 个变体）用于追求最小文件，包含 gifsicle lossy 压缩级别。
8. 选择 `quality` preset（约 12 个变体）用于最佳视觉效果，包含更高分辨率和 bayer dithering。
9. 快速比较减少变体：`uv run --python 3.12 .../video_to_gif.py input.mp4 --presets minimal`。
10. 生成 lossy 压缩变体（需 gifsicle）：`uv run --python 3.12 .../video_to_gif.py input.mp4 --presets lossy`。
11. 偏高质量输出：`uv run --python 3.12 .../video_to_gif.py input.mp4 --presets quality`。
12. 用 `-o` 或 `--output-dir` 指定输出目录；默认是 `<input>_gifs/`。
13. 用 `--start` 指定开始时间（秒）裁剪源视频；默认无。
14. 用 `--end` 指定结束时间（秒）裁剪源视频；默认无。
15. 用 `--presets` 指定预设配置：full、minimal、lossy、quality；默认 full。
16. 用 `--fps` 覆盖 FPS 值，例如 `--fps 10 15 20`。
17. 用 `--width` 覆盖宽度值，例如 `--width 480 640`。
18. 用 `--colors` 覆盖颜色数，例如 `--colors 128 256`。
19. 用 `--lossy` 覆盖 gifsicle lossy 级别，例如 `--lossy 0 30 80`。
20. 只转视频前 10 秒：`uv run --python 3.12 .../video_to_gif.py demo.mp4 --end 10`。
21. 提取指定片段：`uv run --python 3.12 .../video_to_gif.py demo.mp4 --start 5 --end 15`。
22. 自定义参数扫描：`uv run --python 3.12 .../video_to_gif.py demo.mp4 --fps 12 15 --width 480 800 --colors 256`。
23. 比较 lossy 压缩（需 gifsicle）：`uv run --python 3.12 .../video_to_gif.py demo.mp4 --lossy 0 30 60 100`。
24. 运行后打开输出目录，逐个比较 GIF。
25. 先看最小文件，检查质量是否可接受。
26. 若出现颜色条带，尝试 256 色或 bayer dithering（quality preset）。
27. 若不够流畅，将 FPS 提高到 15 或 20。
28. 若文字不可读，将宽度提高到 640px 或 800px。
29. 多数屏幕录制的甜点参数通常约为 640px、15fps、256 色。
30. 宽度大于源视频分辨率时会被自动跳过。
31. 脚本使用 FFmpeg 两遍调色板生成以获得最佳 GIF 质量（优于单遍）。
32. gifsicle lossy 压缩在级别 30-60 时通常可减少文件大小 30-70%，视觉影响很小。
33. 对非常长的片段，先用 `--start`/`--end` 裁剪；GIF 超过 10 秒会变得很大。

适用边界 · 注意事项

• 未安装 FFmpeg 和 uv 时不要使用，因为无法运行脚本。
• 需要 lossy preset 或 --lossy 但未安装 gifsicle 时不要使用这些选项。
• 视频片段很长或超过 10 秒且不先用 --start/--end 裁剪时，不适合直接生成，因为 GIF 可能非常大。