PerfectPixel 通过无头 CLI（ppgen）运行与桌面应用相同的生成流程：提示词→AI 图像生成→去背景→抽帧→质量检查→修正重生成→像素量化，产出可直接用于游戏的精灵资源包。
用途：当用户需要生成角色/动作动画/精灵图/八方向套装时使用；可用 god-tibo-imagen（Codex ChatGPT 后端）或 gemini（Google AI Studio）模型生成一致的高质量精灵；一行文本描述定义角色，配合约百种动作预设生成动画；通过五方向 AI 生成与三方向水平镜像构建八方向精灵集。
使用方式：先运行安装脚本获取 ppgen 二进制路径：PPGEN="$(bash "$SKILL_DIR/scripts/install.sh" 2>/tmp/ppgen-install.log | tail -1)"。密钥查找顺序为 config.json → 工作目录/.env 与 .env.local → OS 环境变量 → CLI -key 标志。Gemini 需设置 GEMINI_API_KEY（或 GOOGLE_API_KEY），默认模型 gemini-3-pro-image；god-tibo-imagen 使用本地 ~/.codex/auth.json，无需真实密钥但需传 -key dummy，默认模型 gpt-5.4。将自然语言请求映射为标志：-desc 描述、-style 风格（pixel 默认/chibi/cartoon/retro16）、-states 动作（如 "idle,walk,attack"）、-provider、-model、-out 输出目录（默认 ./perfectpixel-out）。建议始终加 -json 获取机器可读摘要，例如："$PPGEN" -provider god-tibo-imagen -desc "a small knight with silver armor and a blue plume" -style pixel -states "idle,walk,run,attack" -out ./knight-sprites -key dummy -json。八方向示例使用 -dirset "walk"。
最佳实践：先以单状态（-states idle）试运行确认风格质量，获用户确认后再生成全部状态；提示词中强制规定品红（#FF00FF）纯色背景，角色配色避免品红/粉/紫以免抠图误删；利用 -attempts（默认 3 次）在帧数不符或角色身份漂移时自动注入修正提示重生成。
限制：资料未提供收费与价格信息；平台支持范围、具体动作预设清单及全部配置项以随附参考文档为准，本文未展开。