# 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。

## 常用命令

```bash
"$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`。