用途：把 AI 生成的原始图像加工为可复用的 2D 游戏资产，覆盖精灵表、人物/怪物/道具/法术/弹道与命中动画、分层地图以及 Godot/Unity 工程导出。
主要能力： 一、精灵生成（$generate2dsprite）：按提示词生成角色、怪物、道具、施法、弹道与命中动画，支持多方向、指定帧数与参考图引导变体，输出整张精灵表、逐帧 PNG、各方向 GIF 与 metadata.json。 二、地图生成（$generate2dmap）：生成分层地图，含纯净地面层、装饰参考图、道具包与透明道具，并可导出 Godot 场景（.tscn）、可编辑 TileMap 层、tileset 资源、调试用 gd 脚本、碰撞体与区域（遭遇草地、出口）。 三、后处理：色键抠底生成透明 PNG、帧提取与 GIF 导出、道具包切片，附带 QA 元数据。
使用方式：git clone https://github.com/0x0funky/agent-sprite-forge.git 并 cd 进入目录；pip install -r requirements.txt；设置环境变量 export OPENAI_API_KEY="your-api-key-here" 或写入 .env。核心类为 SpriteGenerator、MapGenerator、BackgroundRemover、FrameExtractor、GIFExporter、PropPackSlicer，可用 config.yaml 设定图像模型、帧尺寸、色键容差等默认值。
适用场景：Godot/Unity 原型与小型项目的美术快速铺量，角色与技能动画、RPG 地图、类幸存者玩法素材准备。
限制：需 Python 3.8+、Pillow 与 OpenAI API 访问权限，需自行配置密钥；Godot 4.x 或 Unity 为可选导出目标；关于价格、授权与生成质量的实际效果资料暂未提供。