Hatch Pet 是一款以对话流程驱动的宠物精灵图生成工具，适用于需要为项目制作动画像素宠物的用户。
用途 通过逐步引导，将用户的角色描述或参考图片转化为多状态动画精灵图，生成结果可用于 Codex 兼容的精灵图集。
主要能力
- 支持文字描述创建角色，也可提供参考图片辅助匹配外观。
- 提供多种视觉风格：pixel（粗像素风，推荐默认）、plush（毛绒玩具）、clay（黏土）、sticker（贴纸）、flat-vector（扁平矢量）、3d-toy（3D 玩具）、painterly（绘画风）。
- 支持动画状态：默认包含 idle、running-right（running-left 自动镜像）、waving、failed；另有 jumping、waiting、running、review 可选。
- 输出 1536x1872 的精灵图集（spritesheet.png 与 .webp），并为每种动画生成预览 GIF。
- 生成前可先进行免费准备与预览，确认基础形象后再批量生成全部动画条带。
- 提供质检与重试流程，可针对不满意的动画状态重新生成。
使用方式 工具按步骤执行：先展示示例 GIF，再询问角色描述与名称（kebab-case 目录名）、选择风格、质量与动画状态；随后检查 Python 依赖（Pillow、numpy、httpx）并配置 .env 中的 API Base URL、API Key 与模型（gpt-image-2）；创建 pet.json 配置后运行 prepare.py 进行免费准备并显示预估费用，确认后运行 generate.py --preview 生成预览，满意后运行 generate.py 生成全部条带，最后运行 extract.py 提取并构建图集，展示预览 GIF 供检查。若动画异常，可删除对应状态文件后重新生成与提取。
适用场景 适合游戏开发、个人项目或演示中需要定制动画宠物精灵图的场景，尤其是希望以较低门槛通过自然语言描述快速获得多状态像素角色的用户。
限制与注意事项
- 依赖支持 GPT-Image-2 的 OpenAI 兼容 API，其他模型不适用。
- 生成涉及 API 调用费用；资料中提及中等质量全套约 $0.25、低质量约 $0.06，具体以实际计费为准，调用前需用户确认。
- API 密钥仅保存在本地 .env，不应提交或展示。
- 生成结果具有非确定性，可能需要多次重试以获得理想效果。
- 需要 Python 环境及 Pillow、numpy、httpx 依赖。