mcpField
P
perfectpixel

perfectpixel

github.com/akillness创意与媒体53106 次安装4 天前更新
代码仓库

关于 perfectpixel

perfectpixel 是通过无头 `ppgen` 命令行运行 PerfectPixel 精灵生成流程的技能，供游戏创作者按角色描述制作动画精灵包，并支持帧检查与修正重生成。

主要功能

  1. 01根据文本描述生成精灵
  2. 02支持 pixel、chibi、cartoon 和 retro16 风格
  3. 03使用动作预设生成动画
  4. 04通过镜像构建八方向套组
  5. 05检查帧并修正重生成
  6. 06移除背景并进行像素量化

适用场景

  1. 01制作角色的待机与移动动画
  2. 02生成八方向行走套组
  3. 03根据描述制作可用于游戏的精灵包

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/akillness/jeo-skills --skill perfectpixel

安装后在 Claude Code 中输入/perfectpixel确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

SKILL.toon
reference/
providers.md
presets.md
scripts/
install.sh

详细介绍

PerfectPixel — AI 动画精灵图生成

通过无头 CLI（ppgen）运行与可安装桌面应用相同的生成流水线（提示词 → AI 图像生成 → 背景移除 → 帧提取 → 质量检查 → 修正后重新生成 → 像素量化），创建可直接用于游戏的精灵图包。

适用场景

  • 用户要求生成角色、动作动画、精灵图表或 8 方向套件时使用。
  • 希望使用 god-tibo-imagen（Codex ChatGPT 后端）或 gemini（Google AI Studio）模型生成高质量且一致的精灵图时使用。
  • 希望通过一行文字描述定义角色，并套用 100 多种动作预设来生成动画时使用。
  • 希望通过 5 方向 AI 生成和 3 方向水平镜像，高效构建 8 方向精灵图套件时使用。

操作说明

步骤 0 — 准备工作（每次运行时的第一步）

检查/安装 ppgen 二进制文件。在此 SKILL.md 所在目录（即技能根目录）中运行安装脚本。成功后，将二进制文件的绝对路径输出为最后一行。

# SKILL_DIR = 이 SKILL.md 파일이 있는 디렉토리의 절대경로로 치환할 것.
PPGEN="$(bash "$SKILL_DIR/scripts/install.sh" 2>/tmp/ppgen-install.log | tail -1)"
echo "$PPGEN"   # 이후 모든 ppgen 호출에 이 경로를 사용
步骤 1 — 设置 API 密钥和提供方

ppgen 按以下顺序查找密钥：config.json（可安装应用设置）→ 工作目录/可执行文件旁的 .env·.env.local → OS 环境变量 → CLI -key 标志。

  • Gemini：设置 GEMINI_API_KEY（或 GOOGLE_API_KEY）。默认模型：gemini-3-pro-image
  • GodTiboImagen：god-tibo-imagen 提供方使用本地 ~/.codex/auth.json，因此无需单独的 API 密钥，但要运行 CLI，必须传入类似 -key dummy 的虚拟密钥。默认模型：gpt-5.4
步骤 2 — 解析请求 → 映射标志

从用户的自然语言请求中提取以下信息，并映射到 ppgen 标志。

  • 角色描述 → -desc "..."（建议使用英文提示词）
  • 风格 → -style 中的一种：pixel（默认）、chibi、cartoon、retro16
  • 要创建的动作 → -states "idle,walk,attack"（以逗号分隔）。动作名称是英文预设键。
  • 指定提供方 → -provider god-tibo-imagen 或 -provider gemini
  • 指定模型 → -model gpt-5.4 或 -model gemini-3-pro-image
  • 输出文件夹 → -out ./output-dir（默认 ./perfectpixel-out）
步骤 3 — 运行

始终使用 -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

示例

示例 1：使用 god-tibo-imagen 生成基础角色和 idle 动画
"$PPGEN" \
  -provider god-tibo-imagen \
  -desc "a tiny blue slime" \
  -states "idle" \
  -out ./slime-sprites \
  -key dummy \
  -json
示例 2：使用 gemini 生成 8 方向行走动画
"$PPGEN" \
  -provider gemini \
  -desc "a red wizard with a staff" \
  -dirset "walk" \
  -out ./wizard-walk-8dir \
  -key "$GEMINI_API_KEY" \
  -json

最佳实践

  1. 试运行：为节省成本和时间，先使用 1 个状态（-states idle）试运行，确认风格和质量；获得用户批准后，再生成所有状态。
  2. 遵守背景色要求：在提示词中强制要求 AI 模型将背景完全填充为纯洋红色（#FF00FF），并避免在角色设计中使用洋红色/粉色/紫色系，以免抠图时角色被移除。
  3. 质量修正循环：使用 -attempts 标志（默认 3 次）；检测到帧数不匹配或角色身份漂移（identity drift）时，自动注入修正提示并重新生成。

参考资料

评论

支持 Markdown