Makelore 2.0 initial clean snapshot

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

@@ -0,0 +1,42 @@
+# 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`。