guanyang GIF 动画生成器 (GIF Maker)
本 Skill 旨在帮助用户快速将一组序列帧图片或单张精灵表（Sprite Sheet）转换为 GIF 动画。
核心功能
- 序列帧转 GIF：支持读取文件夹内的
png,jpg序列，按文件名排序合成 GIF。 - 精灵表转 GIF：支持读取单张 Grid 图片（如 4x4 精灵表），自动切分并合成为 GIF。
- 智能压缩：支持通过
--max-size参数指定目标文件大小（如 950KB），自动调整压缩参数以满足微信表情包等平台的体积限制。 - 参数控制：
--fps：指定每秒帧数（默认为 12）。--layout：指定精灵表布局（如4x4），仅在这个模式下需要。--loop：默认永久循环。--max-size: 指定最大体积 (KB)。
使用指南
1. 快速开始
无需手动安装依赖，直接运行脚本即可。工具会自动创建虚拟环境 (.venv) 并安装所需依赖。
# 基本用法 1：从文件夹读取序列帧
./skills/gif-maker/scripts/run.sh /path/to/frame_folder --output my_anim.gif
# 基本用法 2：从单张精灵表生成 (需要指定布局)
./skills/gif-maker/scripts/run.sh /path/to/sheet.png --layout 4x4 --output my_sheet_anim.gif
# 常用选项：
# - 指定 FPS (例如 24)
./skills/gif-maker/scripts/run.sh /path/to/folder --fps 24
# - 开启自动压缩 (限制文件大小在 950KB 以内)
./skills/gif-maker/scripts/run.sh /path/to/folder --max-size 950
2. (可选) 手动安装
如果您希望手动管理环境（注意：压缩功能依赖 gifsicle 工具，请确保系统已安装）：
- macOS:
brew install gifsicle - Ubuntu:
sudo apt-get install gifsicle
python3 -m venv skills/gif-maker/.venv
source skills/gif-maker/.venv/bin/activate
pip install -r skills/gif-maker/requirements.txt
python3 skills/gif-maker/scripts/make_gif.py ...
参数说明
source: 输入路径。可以是包含图片的文件夹，也可以是单张图片文件。--output(-o): 输出 GIF 文件名，默认为output.gif。--fps: 帧率，默认为 12。--layout: 仅当source为单文件时使用，格式为行数x列数(如4x4)。--max-size: (可选) 启用 GIF 压缩，指定目标文件最大大小 (KB)。仅当原始文件超过此大小时才会尝试压缩。
示例
假设你有一个文件夹 frames/ 包含 01.png, 02.png ... 10.png：
./skills/gif-maker/scripts/run.sh frames/ -o animation.gif --fps 15
假设你有一张 sheet.png 是 4x4 的动作序列，且需要生成符合微信表情包规范（<1MB）的 GIF：
./skills/gif-maker/scripts/run.sh sheet.png --layout 4x4 -o action.gif --max-size 950