开源项目解析
PerfectPixel
AI 精灵动画工作室:一句角色描述先出基础角色,再自动生成一百多种动作动画(走、跑、攻击、法术……)与完整的八方向精灵组,导出成引擎能直接导入的格式。
一句话出整套精灵表八方向 100+ 动作正面对付身份漂移
读懂层
2 张 · 架构图 / 时序图
DeepWiki · 抓取 2026-08-17 · 核验 2026-08-17
DeepWiki · 抓取 2026-08-17 · 核验 2026-08-17
它管哪几个决定
2D 美术与精灵图文生图
0/10 家有官方说法自持能力
动手层
还没做。装它要过哪几关、改哪个文件能改什么、坑在代码哪一处 —— 这三项要读源码,尚未完成。
教程
没找到官方口径的教程 —— 官方只给了 README。
项目自述
以下是仓库 README 的开头部分(原文引用,抓取 2026-08-17)。读全文 ↗
PerfectPixel
An AI-powered animation sprite generation studio
Turn a one-line character description into a base character, then auto-generate 100+ motion
animations (walk, run, attack, magic, …) and complete 8-direction sprite sets — exported in
formats your game engine can import directly.
🌐 Homepage
English · 한국어
A power-up animation generated end-to-end by the actual pipeline (gemini-3-pro-image).
Why this is a hard problem
Plenty of tools draw a pretty picture. Game developers need something else: a 6-frame walk
must be *exactly* 6 frames, every frame must read as the *same* character, the background must
be fully alpha-transparent, and the character's anchor must not jitter between frames — all in a
format an engine can import as-is.
AI models are bad at these constraints. Frame counts come out wrong, poses bleed into each
other, hair color drifts mid-strip (*identity drift*), and the chroma-key background spills
onto the character's silhouette.
PerfectPixel's core idea: let the AI render, but enforce quality, consistency, and precision
with a deterministic post-processing pipeline. Even when the AI's output is non-deterministic,
the result converges to a consistent quality bar. That is the engineering moat — see the
before/after comparisons below, all produced by the *real* pipeline code on *real* AI output.
Features
- Text → character: describe a character, pick a style (pixel art, chibi, cartoon …), and
generate a base character with the background auto-removed.
- 100+ motion presets: a categorized keyword catalog — walk, run, jump, attack, magic,
emotes, and more.
- 8-direction sets: 5 directions are generated by AI and the 3 mirror directions are
derived by horizontal mirroring, for a consistent set at 37.5% lower generation cost.
- Self-correcting quality loop: generate → matte → extract → inspect → corrective
regenerate, up to 3 passes, converging frame count and motion quality.
- Real pixelization: shared-palette quantization + pixel-grid snapping for authentic dot art.
- Engine-friendly export: sprite sheet + manifest.json + Aseprite-compatible JSON +
per-state GIF/APNG + individual frame PNGs, all in one pass.
- Multi-provider: choose Gemini, OpenRouter, fal.ai, or BytePlus as the backend.
- Sessions & gallery: work state is persisted to disk and results are auto-archived.
Sample Output
| Walk | Idle | Cheer | Power Up |
| Dance | Victory | Block | Low HP |
How it works
Generating one state (animation) runs this pipeline in the Go backend:
description + style + motion preset
│
▼
build prompt ──► AI image generation (horizontal filmstrip)
│
▼
background detect & matte ──► frame extraction (cell segmentation)
│
▼
inspect (frame count / identity drift / motion presence)
│
├─ pass ─────────────► pixel quantization ──► done
│
└─ fail ─► corrective retry hint ──► regenerate (up to 3×)
Two things make this more than a naive retry loop:
- Best-candidate scoring — every attempt is scored score = Found*100 − errors*10, and the
best candidate is kept. A perfect result returns immediately; if 3 passes still aren't perfect,
……(后略,见原文)判断
优势
- 开源侧正面做游戏 2D 精灵图的,目前就它一个成规模的
- 把「一致性」「帧数」「透明」「锚点」写成了明确目标,而不是含糊的「效果好」
- 直接导出引擎能用的格式,省掉最烦的一段手工整理
局限
- 示例流水线依赖闭源图像模型,产能不在开源这边
- 开源时间短,长期维护看不出来
- 只做角色精灵,场景与图块不在范围内
不适用
要三维角色 —— 它的产出是二维精灵表。
同管这些决定的其它项目
github README + DeepWiki · 核验 2026-10-19 | 判断栏可报错。