makelore/.opencode/skills/game-assets/meowart_api.md

Meowa game-assets 固定指引

这是 NianCode 的离线兜底指引。在线时，skill-doc 会优先通过 Electron Main 代理读取 Meowa 当前指引；在线指引不可用时才使用本文件。

本适配器当前只生成 2D 像素/高清光栅素材，不生成 3D 模型。3D 模型请在 ASSET_PLAN.md 中记录项目、用户或许可证明确来源，以及 GLB/glTF 文件和预览证据。

调用顺序

1. config-status 确认 Main 是否配置了 Meowa 凭据。
2. template-info --kind pixel 或 template-info --kind hd 读取真实模版。
3. 从 GDD、ART_GUIDE 和 ASSET_PLAN 提取一个明确缺口，写成可验证的 requirement。
4. 运行 pixel-gen 或 hd-gen，等待任务结束并下载文件。
5. 检查项目内输出和 generation.meta.json，再把候选写入 ASSET_PLAN。

常用命令

"$NIANCODE_PYTHON_PATH" meowart_api.py config-status
"$NIANCODE_PYTHON_PATH" meowart_api.py skill-doc --task "像素角色和攻击帧"
"$NIANCODE_PYTHON_PATH" meowart_api.py template-info --kind pixel
"$NIANCODE_PYTHON_PATH" meowart_api.py pixel-gen --template-name "<真实模版名>" --requirement "<需求>" --output-dir assets/generated/meowa
"$NIANCODE_PYTHON_PATH" meowart_api.py hd-gen --template-name "<真实模版名>" --requirement "<需求>" --output-dir assets/generated/meowa
"$NIANCODE_PYTHON_PATH" meowart_api.py credits

pixel-gen 和 hd-gen 是异步任务。成功后 CLI 会将任务响应、最终响应、下载文件和授权元数据保存在同一个 run 目录。下载失败时不要提交审核标记。

远程 API 事实

NianCode Main 只代理以下固定能力，并负责注入凭据：

• GET /api/pixel-gen/template-info
• POST /api/pixel-gen
• GET /api/pixel-gen/jobs?id=...
• GET /api/pixel-gen/jobs/{id}/download
• GET /api/hd-gen/template-info
• POST /api/hd-gen
• GET /api/hd-gen/jobs?id=...
• GET /api/hd-gen/jobs/{id}/download
• GET /api/credits/balance

Agent 不应直接构造这些远程 URL；只调用项目内的 meowart_api.py。