用途：从视频中提取动画帧，去除背景、对齐主体，输出独立透明 PNG 和合并的 spritesheet，并生成可交互播放器用于验证。适用于游戏精灵动画、循环动画制作，以及绿幕/蓝幕/白幕视频抠图。
主要能力：可选帧数、spritesheet 列数、背景色类型；循环检测支持手动指定起止帧、强制包含第 0 帧，默认使用主体感知全局接缝检测（在主体 mask 内搜索最优接缝，不假设循环从第 0 帧开始）。支持诊断模式与重打包模式。
使用方式：在 scripts 目录运行 uv run spritesheet.py --video <视频路径> [选项]。常用参数包括 --frames（默认 8）、--cols（默认 4）、--bg-color（auto/green/blue/white/black）、--loop-start/--loop-end、--output-dir、--analyze、--txt、--repack-dir、--drop-frames、--keep-frames。示例：uv run spritesheet.py --video video.mp4 --bg-color green --frames 16；自动检测不可靠时先用 --analyze --txt 诊断再手动指定区间。
输出：frames/frame_01.png 至 frame_NN.png 透明 PNG、spritesheet.png、metadata.json（裁切框、循环区间、视频源）、player.html 交互播放器；--analyze 模式另生成 .analysis.json 报告。
限制：绿幕抠图效果最佳，白幕高光、黑幕暗部易与主体混淆，边缘可能不干净；主体分离失败（mask 占比过低）会自动回退全画面法并提示。输出目录、价格等信息资料未提供。