43 lines
2.0 KiB
Markdown
43 lines
2.0 KiB
Markdown
# 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`。
|