sprite-gen：专治 AI 生精灵图三大折磨
@realfxw：输入一张单图，输出开箱即用的游戏精灵图集与透明动作循环——Python CLI + Agent Skill。
开篇：这课解决什么问题
用 AI 直接生成"雪碧图（Sprite Sheet）"的人都懂那种折磨。@realfxw 总结了三条，条条致命。
他推荐的开源神器 sprite-gen（github.com/aldegad/sprite-gen）专治这个：输入一张单图，输出真正开箱即用的游戏精灵图集与透明动作循环。它既是 Python CLI，也是 Claude/Codex 的 Agent Skill。
三大折磨：AI 生精灵图的痛
以下来自 @realfxw，用过的人"都懂"：
- 每帧角色长相完全不同：第一帧是圆脸，第二帧变尖脸——"换头"现场。
- 绿幕/品红背景抠出毛边：怎么抠都有杂色边缘，放进游戏里一圈脏边。
- 动作重叠、对不齐网格：生成的图根本放不进游戏引擎。
《第 9 课》的轻量路线（Codex 内建 Image2）能出 GIF，但这三处是它的天花板——痛点重的，请看本课。
AI 直接生精灵图像"复印机卡纸"：每张印出来都歪一点、还带黑边；sprite-gen 像"专业印刷机"：套准、裁齐、直接装订。
五大亮点：暴力直接的核心逻辑
核心逻辑非常暴力直接，一句话：基于一张基础立绘，逐行推进动作状态生成。
不从零每帧重画，而是基于同一张基础立绘，逐行推进动作状态生成。同一张脸，动起来还是同一张脸。
不是粗暴的绿幕色键剥离，而是精准的背景解混算法，彻底消灭杂色边缘——白底测试也毫无破绽。
Backbone Lattice 骨架对齐机制：像素动作精准锁定在统一网格内，再也不会上下左右乱飘。
结合视频模型（如 Grok Imagine），把单张立绘切出跳跃、攻击等透明循环动效，并自动计算运动周期进行裁剪。
内置检视器，支持手动微调、帧挑选、投射影子、调色盘重着色。机器做 90 分，人工收尾 10 分。
交付：引擎级 manifest
输出不是"一张图"，而是引擎级交付：
- manifest.json：带完整包围盒元数据的 frame_layout。
- 透明 PNG：精灵图集。
- 直接兼容 Phaser、Flame、Aseprite。
- 静止待机姿态自动烘焙呼吸（Breathe）拉伸动效——站着不动也有生命感。
独立游戏开发者、Game Jam 创作者：这套管线省去数天无意义的修图与对齐时间。
路线：轻量 vs 工程
本专题 2D 精灵图两课，最终对照：
- 第 9 课（轻量）：Codex 内建 Image2 + agent-sprite-forge，一句话出 GIF，适合小动画、教学素材。
- 本课（第 21 课·工程）：sprite-gen，Python CLI + Skill，治换头/毛边/对不齐，输出引擎级 manifest，适合独立游戏、Game Jam。
选型就一句话：图只在视频里出现 → 第 9 课；图要进游戏引擎 → 本课。
第 9 课像"拍立得"：咔嚓就有，能看；本课像"证件照相馆"：尺寸、底色、版式全按标准来，直接能用。前者图自己看，后者图给机器读。
上手
项目：github.com/aldegad/sprite-gen。
- 当 Python CLI 用：命令行跑，输入单图，输出图集 + manifest。
- 当 Agent Skill 用：装进 Claude / Codex，让 AI 按流程调用。
评论区 @007_eth_ 言简意赅："不错。"——工具类帖子最好的评价，就是没人抬杠。
术语翻卡：点卡片看解释
自测一下：点问题展开参考答案
每帧角色长相不同（换头）；绿幕抠图有毛边；动作重叠、对不齐网格，进不了游戏引擎。
输入一张单图，基于基础立绘逐行推进动作状态生成，输出开箱即用的精灵图集与透明动作循环。
角色特征锁定治换头；背景解混算法（真 Alpha）治毛边；Backbone Lattice 骨架对齐治对不齐。
manifest.json（包围盒元数据 frame_layout）+ 透明 PNG，直兼容 Phaser/Flame/Aseprite；待机姿态自动烘焙呼吸动效。
图只在视频里出现→第 9 课轻量路线；图要进游戏引擎→本课工程路线。