feat: add frame-sampling options for flash/RAM budget control

Add --frame-start / --frame-end to restrict the frame range, and
--frame-step / --frame-count (mutually exclusive) to decimate within
that range. Kept frames are re-numbered contiguously from 0000 so
LVGL's sequential player never sees index gaps.

Interactive menu gains a matching "是否抽帧" step; CLI and menu both
display a human-readable sampling summary before conversion starts.

Bump version to 0.3.0.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

AGENTS.md

@@ -7,16 +7,21 @@
 `EmbeddedAnimPacker` 是一个 Python 命令行工具，用于：
 
 1. 读取输入 GIF。
-2. 使用 Pillow 拆分为逐帧 PNG。
+2. 使用 Pillow 拆分为逐帧 PNG，可选抽帧（帧区间 / 隔帧步长 / 目标帧数），输出帧从 0 连续重编号。
 3. 调用本地 LVGL 仓库中的 `scripts/LVGLImage.py`。
 4. 生成适合放入 LittleFS 的 LVGL BIN 图片文件。
 
-主入口是 `EmbeddedAnimPacker.py`。
+主入口是 `EmbeddedAnimPacker.py`，提供两种用法：
+
+- **命令行**：传入 GIF 与参数，行为与脚本最初版本一致。
+- **交互式菜单**：不带 GIF 参数（或传 `-i`/`--interactive`）时进入，基于 `questionary` 选择素材并配置参数。`_select_gifs()` 采用两步式选择，返回 GIF 列表，支持多选 / 一键全选 / 手动输入路径。
+
+两条路径都汇聚到同一个 `run_conversion(ConversionConfig)` 单 GIF 管线。命令行直接调用它；菜单经 `run_conversions(gifs, template)` 逐个调用（continue-on-error，末尾打印聚合结果），且多选时强制用各 GIF 自身 stem 作帧前缀以避免冲突。
 
 ## 重要文件
 
 - `EmbeddedAnimPacker.py`: CLI 主程序。
-- `requirements.txt`: Python 运行依赖，目前只有 `Pillow`。
+- `requirements.txt`: Python 运行依赖：`Pillow`（读取 GIF）与 `questionary`（交互式菜单）。
 - `README.md`: 面向用户的使用说明。
 - `default.gif`: 示例输入素材。
 - `frames/`: `--keep-frames` 生成的中间 PNG 帧，通常不要提交。
@@ -43,7 +48,14 @@ python3 -m pip install -r requirements.txt
 python3 -m pip install -r requirements.txt
 ```
 
-运行转换：
+进入交互式菜单（不带 GIF 参数，或显式加 `-i`）：
+
+```bash
+python3 EmbeddedAnimPacker.py
+python3 EmbeddedAnimPacker.py -i
+```
+
+运行转换（命令行）：
 
 ```bash
 python3 EmbeddedAnimPacker.py default.gif
@@ -65,6 +77,14 @@ python3 EmbeddedAnimPacker.py default.gif \
 python3 EmbeddedAnimPacker.py default.gif --keep-frames ./frames
 ```
 
+抽帧 / 减帧（区间、隔帧、目标帧数；`--frame-step` 与 `--frame-count` 互斥）：
+
+```bash
+python3 EmbeddedAnimPacker.py default.gif --frame-step 2          # 隔帧减半
+python3 EmbeddedAnimPacker.py default.gif --frame-start 0 --frame-end 11  # 只取前半段
+python3 EmbeddedAnimPacker.py default.gif --frame-count 8         # 均匀抽成 8 帧
+```
+
 只检查 CLI 参数和基础语法时，可运行：
 
 ```bash
@@ -80,6 +100,8 @@ python3 EmbeddedAnimPacker.py --help
 - 调用外部命令时使用参数列表，不拼接 shell 字符串。
 - 默认行为应避免留下临时文件；只有用户传入 `--keep-frames` 时才保留中间 PNG。
 - 不要引入重量级依赖，除非能明显简化核心流程。
+- `questionary` 只在 `run_interactive_menu()` 内部按需导入；纯命令行路径不得依赖它，缺失时给出清晰安装提示。
+- 新增转换参数时，同步加到 `ConversionConfig`、命令行参数和交互式菜单三处，并更新 `README.md`。
 
 ## 版本控制注意事项
 
@@ -99,3 +121,5 @@ python3 EmbeddedAnimPacker.py --help
 ```
 
 有完整 LVGL 环境时，使用小 GIF 做一次端到端转换，并检查输出目录中的 `.bin` 文件数量是否等于 GIF 帧数。
+
+交互式菜单需要真实 TTY 才能运行（`questionary` 基于 `prompt_toolkit`），不便用管道自动化。无 TTY 时可单独调用 `discover_gifs()` 和 `run_conversion(ConversionConfig(...))` 验证非交互逻辑。

EmbeddedAnimPacker.py

@@ -1,23 +1,59 @@
 from __future__ import annotations
 
 import argparse
+import contextlib
 import subprocess
 import sys
 import tempfile
+from dataclasses import dataclass, replace
 from pathlib import Path
 
 
+__version__ = "0.3.0"
+
 DEFAULT_LVGL_DIR = Path("lvgl")
 DEFAULT_OUTPUT_DIR = Path("littlefs/anim")
 DEFAULT_COLOR_FORMAT = "RGB565"
 DEFAULT_COMPRESS = "RLE"
+COMPRESS_CHOICES = ("RLE", "LZ4", "NONE")
+COMMON_COLOR_FORMATS = ("RGB565", "RGB565A8", "RGB888", "ARGB8888", "XRGB8888")
+
+
+@dataclass
+class ConversionConfig:
+    """All inputs needed for one GIF -> LVGL BIN conversion run."""
+
+    gif: Path
+    lvgl_dir: Path = DEFAULT_LVGL_DIR
+    output_dir: Path = DEFAULT_OUTPUT_DIR
+    color_format: str = DEFAULT_COLOR_FORMAT
+    compress: str = DEFAULT_COMPRESS
+    prefix: str | None = None
+    keep_frames: Path | None = None
+    frame_start: int = 0
+    frame_end: int | None = None
+    frame_step: int = 1
+    frame_count: int | None = None
+    python: str = sys.executable
 
 
 def parse_args() -> argparse.Namespace:
     parser = argparse.ArgumentParser(
         description="Extract frames from a GIF and convert them to LVGL BIN images."
     )
-    parser.add_argument("gif", type=Path, help="Input GIF file.")
+    parser.add_argument(
+        "gif",
+        type=Path,
+        nargs="?",
+        default=None,
+        help="Input GIF file. Omit to launch the interactive menu.",
+    )
+    parser.add_argument(
+        "-i",
+        "--interactive",
+        action="store_true",
+        help="Launch the interactive configuration menu (used automatically when no GIF is given).",
+    )
     parser.add_argument(
         "--lvgl-dir",
         type=Path,
@@ -41,7 +77,7 @@ def parse_args() -> argparse.Namespace:
     parser.add_argument(
         "--compress",
         default=DEFAULT_COMPRESS,
-        choices=("RLE", "LZ4", "NONE"),
+        choices=COMPRESS_CHOICES,
         help=f"LVGL compression mode. Default: {DEFAULT_COMPRESS}",
     )
     parser.add_argument(
@@ -55,11 +91,41 @@ def parse_args() -> argparse.Namespace:
         default=None,
         help="Keep extracted PNG frames in this directory instead of using a temp directory.",
     )
+    parser.add_argument(
+        "--frame-start",
+        type=int,
+        default=0,
+        help="First GIF frame index to keep (inclusive). Default: 0.",
+    )
+    parser.add_argument(
+        "--frame-end",
+        type=int,
+        default=None,
+        help="Last GIF frame index to keep (inclusive). Default: last frame.",
+    )
+    sampling = parser.add_mutually_exclusive_group()
+    sampling.add_argument(
+        "--frame-step",
+        type=int,
+        default=1,
+        help="Keep every Nth frame within the range (decimation). Default: 1 (all).",
+    )
+    sampling.add_argument(
+        "--frame-count",
+        type=int,
+        default=None,
+        help="Evenly sample this many frames from the range (overrides --frame-step).",
+    )
     parser.add_argument(
         "--python",
         default=sys.executable,
         help="Python executable used to run LVGLImage.py. Default: current interpreter.",
     )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"%(prog)s {__version__}",
+    )
     return parser.parse_args()
 
 
@@ -77,7 +143,73 @@ def require_valid_input(gif_path: Path, lvgl_dir: Path) -> Path:
     return converter
 
 
-def extract_gif_frames(gif_path: Path, output_dir: Path, prefix: str) -> list[Path]:
+def select_frame_indices(
+    total: int,
+    start: int = 0,
+    end: int | None = None,
+    step: int = 1,
+    count: int | None = None,
+) -> list[int]:
+    """Return the original frame indices to keep (ascending, de-duplicated).
+
+    The default ``(0, None, 1, None)`` keeps every frame. The range ``[start,
+    end]`` is applied first; then ``count`` (evenly spaced sampling) takes
+    precedence over ``step`` (every-Nth decimation) when both are given.
+    """
+    if total <= 0:
+        return []
+    end = total - 1 if end is None else min(end, total - 1)
+    start = max(0, start)
+    if start > end:
+        raise ValueError(f"帧区间无效：start={start} > end={end}（共 {total} 帧）")
+
+    candidates = list(range(start, end + 1))
+
+    if count is not None:
+        if count < 1:
+            raise ValueError("目标帧数必须 ≥ 1")
+        if count >= len(candidates):
+            return candidates
+        if count == 1:
+            return [candidates[0]]
+        n = len(candidates)
+        picked = [candidates[round(i * (n - 1) / (count - 1))] for i in range(count)]
+        return sorted(set(picked))  # de-dup in case neighbouring picks round equal
+
+    if step < 1:
+        raise ValueError("步长必须 ≥ 1")
+    return candidates[::step]
+
+
+def _describe_sampling(cfg: ConversionConfig) -> str:
+    """One-line, human-readable summary of a config's frame-sampling options."""
+    if (
+        cfg.frame_start == 0
+        and cfg.frame_end is None
+        and cfg.frame_step == 1
+        and cfg.frame_count is None
+    ):
+        return "否（全部帧）"
+    rng = f"[{cfg.frame_start}..{'末' if cfg.frame_end is None else cfg.frame_end}]"
+    if cfg.frame_count is not None:
+        how = f"均匀抽 {cfg.frame_count} 帧"
+    elif cfg.frame_step != 1:
+        how = f"步长 {cfg.frame_step}"
+    else:
+        how = "全部"
+    return f"区间 {rng}，{how}"
+
+
+def extract_gif_frames(
+    gif_path: Path,
+    output_dir: Path,
+    prefix: str,
+    *,
+    start: int = 0,
+    end: int | None = None,
+    step: int = 1,
+    count: int | None = None,
+) -> list[Path]:
     try:
         from PIL import Image, ImageSequence
     except ImportError as exc:
@@ -90,10 +222,21 @@ def extract_gif_frames(gif_path: Path, output_dir: Path, prefix: str) -> list[Pa
     frame_paths: list[Path] = []
 
     with Image.open(gif_path) as gif:
-        for index, frame in enumerate(ImageSequence.Iterator(gif)):
+        total = getattr(gif, "n_frames", 1)
-            frame_path = output_dir / f"{prefix}_{index:04d}.png"
+        keep = set(select_frame_indices(total, start, end, step, count))
+        if not keep:
+            raise RuntimeError("抽帧后没有剩余帧，请检查区间/步长/目标帧数。")
+
+        # Re-number kept frames contiguously (0000, 0001, ...) so LVGL's
+        # sequential player never sees a gap in the frame indices.
+        out_index = 0
+        for src_index, frame in enumerate(ImageSequence.Iterator(gif)):
+            if src_index not in keep:
+                continue
+            frame_path = output_dir / f"{prefix}_{out_index:04d}.png"
             frame.convert("RGBA").save(frame_path)
             frame_paths.append(frame_path)
+            out_index += 1
 
     if not frame_paths:
         raise RuntimeError(f"No frames found in GIF: {gif_path}")
@@ -128,47 +271,330 @@ def convert_frame(
     )
 
 
-def main() -> int:
+def run_conversion(cfg: ConversionConfig) -> int:
-    args = parse_args()
+    """Validate inputs, extract frames and convert each one to an LVGL BIN."""
-    prefix = args.prefix or args.gif.stem
+    prefix = cfg.prefix or cfg.gif.stem
-    converter = require_valid_input(args.gif, args.lvgl_dir)
+    converter = require_valid_input(cfg.gif, cfg.lvgl_dir)
 
-    args.output_dir.mkdir(parents=True, exist_ok=True)
+    cfg.output_dir.mkdir(parents=True, exist_ok=True)
 
-    if args.keep_frames:
+    with contextlib.ExitStack() as stack:
-        frame_dir = args.keep_frames
+        if cfg.keep_frames is not None:
-        frame_paths = extract_gif_frames(args.gif, frame_dir, prefix)
+            frame_dir = cfg.keep_frames
+        else:
+            frame_dir = Path(
+                stack.enter_context(
+                    tempfile.TemporaryDirectory(prefix="embedded_anim_")
+                )
+            )
 
+        frame_paths = extract_gif_frames(
+            cfg.gif,
+            frame_dir,
+            prefix,
+            start=cfg.frame_start,
+            end=cfg.frame_end,
+            step=cfg.frame_step,
+            count=cfg.frame_count,
+        )
         for frame_path in frame_paths:
             convert_frame(
                 frame_path,
                 converter,
-                args.output_dir,
+                cfg.output_dir,
-                args.color_format,
+                cfg.color_format,
-                args.compress,
+                cfg.compress,
-                args.python,
+                cfg.python,
             )
-    else:
-        with tempfile.TemporaryDirectory(prefix="embedded_anim_") as temp_dir:
-            frame_paths = extract_gif_frames(args.gif, Path(temp_dir), prefix)
 
-            for frame_path in frame_paths:
+    print(f"Done. Converted {len(frame_paths)} frame(s) to {cfg.output_dir}.")
-                convert_frame(
-                    frame_path,
-                    converter,
-                    args.output_dir,
-                    args.color_format,
-                    args.compress,
-                    args.python,
-                )
-
-    print(f"Done. Converted {len(frame_paths)} frame(s) to {args.output_dir}.")
     return 0
 
 
+def run_conversions(gifs: list[Path], template: ConversionConfig) -> int:
+    """Convert each GIF using ``template``'s shared parameters.
+
+    With more than one GIF the per-GIF stem is always used as the frame prefix
+    (so frames from different GIFs never collide). A failure on one GIF is
+    reported and the rest still run.
+    """
+    multi = len(gifs) > 1
+    failures: list[Path] = []
+    for gif in gifs:
+        cfg = replace(template, gif=gif, prefix=None if multi else template.prefix)
+        try:
+            run_conversion(cfg)
+        except Exception as exc:  # noqa: BLE001 - keep batch going, report at end
+            print(f"Error: {gif}: {exc}", file=sys.stderr)
+            failures.append(gif)
+
+    if multi:
+        print(
+            f"\nBatch complete: {len(gifs) - len(failures)}/{len(gifs)} "
+            f"GIF(s) converted to {template.output_dir}."
+        )
+        for gif in failures:
+            print(f"  failed: {gif}", file=sys.stderr)
+
+    return 1 if failures else 0
+
+
+# --------------------------------------------------------------------------- #
+# Interactive menu
+# --------------------------------------------------------------------------- #
+
+
+class _MenuCancelled(Exception):
+    """Raised when the user aborts the interactive menu (Ctrl-C / quit)."""
+
+
+def _ask(question):
+    """Run a questionary prompt; treat a None answer (Ctrl-C) as cancellation."""
+    answer = question.ask()
+    if answer is None:
+        raise _MenuCancelled
+    return answer
+
+
+def discover_gifs() -> list[Path]:
+    """List *.gif files in the current working directory."""
+    return sorted(Path.cwd().glob("*.gif"))
+
+
+def _validate_gif(candidate: Path, questionary) -> bool:
+    if candidate.is_file() and candidate.suffix.lower() == ".gif":
+        return True
+    questionary.print(f"无效的 GIF 文件：{candidate}", style="bold fg:red")
+    return False
+
+
+def _select_gifs(questionary) -> list[Path]:
+    """Two-step source selection: pick a mode, then the GIF(s).
+
+    Returns a non-empty list of GIF paths, or raises _MenuCancelled on quit.
+    """
+    pick = "勾选多个 GIF"
+    manual = "✏️  手动输入路径…"
+    quit_choice = "退出"
+    while True:
+        gifs = discover_gifs()
+        if gifs:
+            all_choice = f"全部 {len(gifs)} 个 GIF"
+            choices = [pick, all_choice, manual, quit_choice]
+        else:
+            questionary.print(
+                "当前目录没有找到 .gif 文件，请手动输入路径。", style="fg:yellow"
+            )
+            all_choice = None
+            choices = [manual, quit_choice]
+
+        mode = _ask(questionary.select("选择源 GIF：", choices=choices))
+
+        if mode == quit_choice:
+            raise _MenuCancelled
+
+        if mode == manual:
+            candidate = Path(_ask(questionary.path("GIF 路径："))).expanduser()
+            if _validate_gif(candidate, questionary):
+                return [candidate]
+            continue
+
+        if mode == all_choice:
+            return gifs
+
+        # mode == pick: multi-select via checkbox
+        selected = _ask(
+            questionary.checkbox(
+                "空格勾选，回车确认：",
+                choices=[questionary.Choice(gif.name, value=gif) for gif in gifs],
+            )
+        )
+        if not selected:
+            questionary.print("请至少选择一个 GIF。", style="fg:yellow")
+            continue
+        return selected
+
+
+def _ask_int(questionary, message: str, default: str) -> int | None:
+    """Prompt for an optional integer; an empty answer returns None."""
+    while True:
+        raw = _ask(questionary.text(message, default=default)).strip()
+        if raw == "":
+            return None
+        try:
+            return int(raw)
+        except ValueError:
+            questionary.print(f"请输入整数：{raw!r}", style="fg:red")
+
+
+def _ask_frame_sampling(questionary) -> tuple[int, int | None, int, int | None]:
+    """Ask whether / how to sample frames. Returns (start, end, step, count)."""
+    if not _ask(
+        questionary.confirm("是否抽帧（截取片段 / 减少帧数）？", default=False)
+    ):
+        return 0, None, 1, None
+
+    keep_all = "保留区间内全部帧"
+    by_step = "按步长隔帧（每 N 帧取 1）"
+    by_count = "按目标帧数均匀抽（共 N 帧）"
+    while True:
+        start = _ask_int(questionary, "起始帧（含，默认 0）：", "0") or 0
+        end = _ask_int(questionary, "结束帧（含，留空=末帧）：", "")
+        if start < 0 or (end is not None and end < start):
+            questionary.print(f"帧区间无效：start={start}, end={end}", style="fg:red")
+            continue
+
+        method = _ask(
+            questionary.select(
+                "区间内如何抽帧：",
+                choices=[keep_all, by_step, by_count],
+                default=keep_all,
+            )
+        )
+        if method == keep_all:
+            return start, end, 1, None
+        if method == by_step:
+            step = _ask_int(questionary, "步长 N（≥1）：", "2")
+            if step is None or step < 1:
+                questionary.print("步长必须 ≥ 1。", style="fg:red")
+                continue
+            return start, end, step, None
+        count = _ask_int(questionary, "目标帧数 N（≥1）：", "8")
+        if count is None or count < 1:
+            questionary.print("目标帧数必须 ≥ 1。", style="fg:red")
+            continue
+        return start, end, 1, count
+
+
+def run_interactive_menu() -> int:
+    try:
+        import questionary
+    except ImportError:
+        print(
+            "交互式菜单需要 questionary。请安装：\n"
+            "    python3 -m pip install questionary\n"
+            "或：python3 -m pip install -r requirements.txt",
+            file=sys.stderr,
+        )
+        return 1
+
+    print("=== EmbeddedAnimPacker 交互式菜单 ===")
+
+    try:
+        gifs = _select_gifs(questionary)
+        single = len(gifs) == 1
+
+        lvgl_dir = _ask(
+            questionary.path("LVGL 目录：", default=str(DEFAULT_LVGL_DIR))
+        )
+        output_dir = _ask(
+            questionary.path("输出目录：", default=str(DEFAULT_OUTPUT_DIR))
+        )
+
+        color_format = _ask(
+            questionary.select(
+                "颜色格式 (color format)：",
+                choices=[*COMMON_COLOR_FORMATS, "自定义…"],
+                default=DEFAULT_COLOR_FORMAT,
+            )
+        )
+        if color_format == "自定义…":
+            color_format = _ask(
+                questionary.text("自定义颜色格式：", default=DEFAULT_COLOR_FORMAT)
+            ).strip()
+
+        compress = _ask(
+            questionary.select(
+                "压缩方式 (compress)：",
+                choices=list(COMPRESS_CHOICES),
+                default=DEFAULT_COMPRESS,
+            )
+        )
+
+        frame_start, frame_end, frame_step, frame_count = _ask_frame_sampling(
+            questionary
+        )
+
+        prefix = None
+        if single:
+            prefix = _ask(
+                questionary.text("帧文件名前缀（留空使用 GIF 文件名）：", default="")
+            ).strip() or None
+
+        keep_frames: Path | None = None
+        if _ask(questionary.confirm("保留中间 PNG 帧？", default=False)):
+            keep_frames = Path(
+                _ask(questionary.path("帧输出目录：", default="frames"))
+            ).expanduser()
+
+        template = ConversionConfig(
+            gif=gifs[0],
+            lvgl_dir=Path(lvgl_dir).expanduser(),
+            output_dir=Path(output_dir).expanduser(),
+            color_format=color_format,
+            compress=compress,
+            prefix=prefix,
+            keep_frames=keep_frames,
+            frame_start=frame_start,
+            frame_end=frame_end,
+            frame_step=frame_step,
+            frame_count=frame_count,
+        )
+
+        print("\n--- 配置汇总 ---")
+        if single:
+            print(f"  源 GIF    : {gifs[0]}")
+        else:
+            print(f"  源 GIF    : {len(gifs)} 个")
+            for gif in gifs:
+                print(f"             - {gif.name}")
+        print(f"  LVGL 目录 : {template.lvgl_dir}")
+        print(f"  输出目录  : {template.output_dir}")
+        print(f"  颜色格式  : {template.color_format}")
+        print(f"  压缩方式  : {template.compress}")
+        print(f"  帧前缀    : {template.prefix or gifs[0].stem if single else '各 GIF 文件名'}")
+        print(f"  保留帧    : {template.keep_frames or '否（使用临时目录）'}")
+        print(f"  抽帧      : {_describe_sampling(template)}")
+        print("----------------")
+
+        if not _ask(questionary.confirm("确认开始转换？", default=True)):
+            raise _MenuCancelled
+    except _MenuCancelled:
+        print("已取消。")
+        return 0
+
+    return run_conversions(gifs, template)
+
+
+def main() -> int:
+    args = parse_args()
+
+    if args.interactive or args.gif is None:
+        return run_interactive_menu()
+
+    cfg = ConversionConfig(
+        gif=args.gif,
+        lvgl_dir=args.lvgl_dir,
+        output_dir=args.output_dir,
+        color_format=args.color_format,
+        compress=args.compress,
+        prefix=args.prefix,
+        keep_frames=args.keep_frames,
+        frame_start=args.frame_start,
+        frame_end=args.frame_end,
+        frame_step=args.frame_step,
+        frame_count=args.frame_count,
+        python=args.python,
+    )
+    return run_conversion(cfg)
+
+
 if __name__ == "__main__":
     try:
         raise SystemExit(main())
+    except KeyboardInterrupt:
+        print("\n已取消。", file=sys.stderr)
+        raise SystemExit(130)
     except Exception as exc:
         print(f"Error: {exc}", file=sys.stderr)
         raise SystemExit(1) from exc

README.md

@@ -11,13 +11,25 @@ python3 -m venv .venv
 . .venv/bin/activate
 ```
 
-然后安装 GIF 读取依赖：
+然后安装依赖（Pillow 用于读取 GIF，questionary 用于交互式菜单）：
 
 ```bash
 python3 -m pip install -r requirements.txt
 ```
 
-然后传入 GIF 文件：
+## 交互式菜单
+
+不带任何参数运行，会进入交互式菜单：从当前目录选择源 GIF（支持**多选或一键全选**，批量转换）、逐项配置参数，最后确认并执行转换：
+
+```bash
+python3 EmbeddedAnimPacker.py
+```
+
+也可以用 `-i` / `--interactive` 显式进入菜单。菜单仅在进入时才需要 `questionary`；纯命令行用法不依赖它。
+
+## 命令行
+
+直接传入 GIF 文件即可（行为与以前一致）：
 
 ```bash
 python3 EmbeddedAnimPacker.py boot.gif
@@ -40,3 +52,44 @@ python3 EmbeddedAnimPacker.py boot.gif \
 ```bash
 python3 EmbeddedAnimPacker.py boot.gif --keep-frames ./frames
 ```
+
+## 抽帧 / 减帧
+
+嵌入式场景下每一帧都是占 flash / RAM 的 `.bin`，可以用下面的选项**截取片段**或
+**减少帧数**。抽帧只决定哪些帧被送去转 BIN，输出帧始终从 `0000` **连续重新编号**
+（不会留空洞，方便 LVGL 顺序播放）。
+
+| 选项 | 含义 |
+| --- | --- |
+| `--frame-start N` | 起始帧（含），默认 `0` |
+| `--frame-end N` | 结束帧（含），默认末帧 |
+| `--frame-step N` | 区间内每 N 帧取 1（隔帧减帧），默认 `1`（全保留） |
+| `--frame-count N` | 区间内均匀抽 N 帧；与 `--frame-step` **互斥**，给定时优先 |
+
+隔帧减半（12 帧 → 6 帧）：
+
+```bash
+python3 EmbeddedAnimPacker.py boot.gif --frame-step 2
+```
+
+只取前半段（第 0–11 帧）：
+
+```bash
+python3 EmbeddedAnimPacker.py boot.gif --frame-start 0 --frame-end 11
+```
+
+把任意帧数均匀抽成固定 8 帧：
+
+```bash
+python3 EmbeddedAnimPacker.py boot.gif --frame-count 8
+```
+
+组合使用，并保留抽完的 PNG 以便预览：
+
+```bash
+python3 EmbeddedAnimPacker.py boot.gif --frame-start 0 --frame-end 11 --frame-step 2 \
+  --keep-frames ./frames
+```
+
+> 多选 / 全选批量转换时，同一套抽帧参数会套用到所有 GIF；固定的 `--frame-end`
+> 在较短的 GIF 上会自动收敛到其末帧。交互式菜单里也有对应的「是否抽帧」步骤。

requirements.txt

@@ -1 +1,2 @@
 Pillow
+questionary