用途：将视频文件转换为优化后的 GIF 动画，采用 FFmpeg 两遍调色板优化，相比单遍方式色彩还原更好、文件通常更小。
主要能力：第一遍分析视频生成优化调色板，第二遍应用调色板输出 GIF；自动通过 ffprobe 检测 HDR（BT.2020 色原或 SMPTE 2084 传输特性）并自动色调映射为 SDR；支持帧率、输出宽度、抖动算法、起始时间、时长、循环次数等参数；提供 bash 与 PowerShell 脚本。
使用方式：需先安装 FFmpeg 并加入 PATH（macOS：brew install ffmpeg；Debian/Ubuntu：sudo apt update && sudo apt install ffmpeg；Windows：choco install ffmpeg 或 winget install FFmpeg.FFmpeg；验证：ffmpeg -version）。默认调用 scripts/convert.sh input.mp4 或 scripts/convert.ps1 -InputPath input.mp4，默认输出 input.gif，默认 10 FPS、1280px 宽、sierra2_4a 抖动。仅给文件名时按当前目录、工作区根目录、~/Movies/（macOS）或 ~/Videos/（Linux）、~/Downloads/、~/Desktop/ 顺序搜索。
适用场景：文档缩略图、演示、UI 演示、简单动画等。
限制：输出路径必须与输入路径不同，否则脚本拒绝运行；不同路径的已有文件会被覆盖；每次 ffprobe/ffmpeg 调用受超时限制（默认 600 秒，可用 VIDEO_TO_GIF_TIMEOUT 或 -TimeoutSeconds 调整）；HDR 探测失败或超时按 SDR 处理；HDR 色调映射需 FFmpeg 4.0+ 及 zscale/libzimg 支持；调色板与 paletteuse 滤镜需 FFmpeg 4.0 或更高版本。