Ase Deliver

AseDeliver · 任意 AI 都能给用户交出一份能在 Aseprite 里打开、能进游戏的像素原画
_{CLI · MCP · ASCII pixels · Godot / Phaser / Unity}

没有 .aseprite 就不算交货。AseDeliver 是「AI 画了一张图」和「游戏能用」之间缺的那一层编译器。

图像模型可以换。交付合同不变。

展示

史莱姆示例是工具自己画的 32×32 成品（描边、四档明暗、idle / walk / jump），已用官方 Aseprite 1.3.18.2 打开验证。

看完整页面（大图 + 动图）：ylty1516.github.io/ase-deliver

它产出什么

任意 AI 怎么用

1. init 一个模板项目
2. brief — 按它列出的文件名画（任何模型，或 ASCII）
3. 文件放进 raw/
4. build
5. validate 的 deliverable 必须为 true
6. open 到 Aseprite

完整合同见 AGENTS.md。Grok / Claude / Cursor / Codex 直接读这一份即可。

git clone https://github.com/ylty1516/ase-deliver.git
cd ase-deliver
py -3 -m venv .venv
.venv\Scripts\python.exe -m pip install -r requirements.txt

ase-deliver.bat demo --out examples\slime --open
ase-deliver.bat init hero --template character-platformer --desc "side-view fox knight"
ase-deliver.bat brief hero
ase-deliver.bat build hero

Linux / macOS：

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
PYTHONPATH=. python -m ase_deliver demo --out examples/slime

模板

MCP

任意 MCP 客户端：

{
  "mcpServers": {
    "ase-deliver": {
      "command": "python",
      "args": ["-m", "ase_deliver", "mcp"],
      "env": { "PYTHONPATH": "/path/to/ase-deliver" }
    }
  }
}

工具：init_project · generation_brief · paint_cel · build · validate_sprite · open_in_aseprite

硬规则（给模型）

• 主体孤立，背景 #FF00FF 或已透明，不要地面、投影、水印、文字
• 站立姿态脚踩画布底边
• 同一角色跨帧：比例、颜色、pivot 锁定
• 循环动画必须能 loop
• 不要发明文件名，以 brief 为准

没有图像模型时：

{ "map": { ".": null, "#": "#63c74d" }, "rows": ["....", ".##.", ".##.", "...."] }

ase-deliver paint <project> --tag idle --frame 0 --file pixels.json

License

MIT