evomeme 0.1.9 → 0.1.10-beta.13

package/{skills → dist/skills/zh-CN}/game-asset-image-generator/references/static-game-assets.md

@@ -11,7 +11,7 @@
 
 ## 使用概念图作为引用
 
-如果存在游戏概念图或当前元素的设定概念图，必须将概念图的可访问 URL 作为 `reference_image_url`：
+如果存在游戏概念图或当前元素的设定概念图，先读取其内容并将可继承的特征写入提示词；需要直接引用原图时，必须先将图片复制到当前工作区 `assets/`（已在其中则复用），确认可读取后再通过 `reference_ids` 提供工作区相对素材 ID，显式指定同一 `workspace_dir`：
 
 - 优先使用当前元素的设定概念图；没有时再使用整体游戏概念图。
 - 在提示词中明确需要继承的特征，例如元素造型、轮廓、配色、材质和画风。
@@ -27,7 +27,7 @@
 - 固定敌人只描述一个可直接使用的姿态。
 - 只保留一至三个关键识别特征，确保缩小后仍有清晰轮廓。
 - 要求主体居中、完整显示、四周留白、边缘不裁切。
-- 使用 `pure white background, no ground, no cast shadow, clean edges`，便于自动抠图。
+- 使用 `pure white background, no ground, no cast shadow, clean edges`，便于后续智能抠图或白色剔除。
 - 结尾包含 `no text, no watermark, no logo, no UI, no extra objects`。
 
 ## 禁止写法

package/dist/skills/zh-CN/game-asset-mesh-generator/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: game-asset-mesh-generator
+description: 通过 evomemeMCP 生成和后处理 Three.js 3D 资产，适用于文本或图像生成模型、贴图、风格化、分割、转换、绑骨、动画及模型 URL 的使用。
+---
+
+# game-asset-mesh-generator
+
+通过本地 **evomemeMCP** 工具生成和处理 3D 资产。本地 tasks 管理执行与下载，远端插件服务负责模型服务和凭据。生成与远端后处理使用 MCP 工具。
+
+## 按需读取参考
+
+先读 [tool-reference.md](references/tool-reference.md)，了解工具选择、公共任务参数、返回文件与 ID、任务恢复；再按当前操作读取：
+
+- 文本、单图、多视图生成：[generation-contracts.md](references/generation-contracts.md)。
+- 贴图、风格化、分割、补全、减面、转换、绑骨、重定向：[postprocess-contracts.md](references/postprocess-contracts.md) 中对应操作的章节。
+- 选择动画：[animation-presets.md](references/animation-presets.md)。
+- 准备概念图：[image-generator-workflows.md](references/image-generator-workflows.md)。
+
+## 工作流程
+
+1. 从用户请求确定资产用途、风格、尺度、性能预算和动画需求；仅对影响结果且无法推断的缺失信息进行澄清。
+2. 按工具参考选择生成或处理工具。远端操作需要本地源文件时，先用 `evomeme_upload_game_asset` 上传并取得公开 URL。磁盘路径和 `file://` URL 不能作为模型服务的输入。
+3. 遵守当前操作的参数限制。生成系列与后处理版本分别定义，不将生成参数直接套入其他操作。
+4. 保留返回文件、ID 和完整结果。串联操作或导入资产前，按工具参考检查结果就绪状态；中断时按其恢复规则处理。
+5. 集成游戏时，使用已下载的 `local_path`，遵循 [game-asset-align](../game-asset-align/SKILL.md)：CLI import → review → Stage 用户确认 → sync。启动与参数见其 [CLI 契约](../game-asset-align/references/tool-contract.md)，加载方式见 [Three.js 集成](references/threejs-integration.md)。格式不兼容时先转换。
+
+## 角色流程
+
+生成完整连通的角色模型：双足使用清晰的 T-pose/A-pose，生物使用所选预设要求的姿态。根据身体结构选择 `rig_type`，绑骨后将返回的**绑骨任务 ID**传给动画重定向。选择动作前读取动画预设，检查骨架与动画质量后，再决定是否需要再次付费绑骨。
+
+MCP 调用方使用生成 → 绑骨 → 重定向三个原子工具。角色组合流程位于内部 tasks 层，不提供 character-pipeline 或 rig-check MCP 工具。
+
+## 完成依据
+
+报告来源、最终本地文件与 URL、任务 ID、实际格式、生成与质量设置，以及尚未解决的问题。导入后补充可获得的面数、材质与贴图、尺度、轴心、包围盒和动画片段信息。仅对已验证结果的阶段声明完成；失败时保留工具原始错误和已有任务标识。

package/dist/skills/zh-CN/game-asset-mesh-generator/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+  display_name: "Game Asset Mesh Generator"
+  short_description: "生成并后处理 3D 网格资产（文/图生 3D、贴图、绑骨、动画等）"
+  default_prompt: "请使用 $game-asset-mesh-generator 通过远程 MCP 生成或后处理所需的 GLB 资产。"
+
+policy:
+  allow_implicit_invocation: false

package/dist/skills/zh-CN/game-asset-mesh-generator/references/animation-presets.md

@@ -0,0 +1,313 @@
+# Animation presets
+
+Pass to `evomeme_retarget_mesh` via `animation` (one preset) or `animations` (preset array; legacy comma-separated string also accepted). Explicit strings/arrays pass through unchanged; only legacy comma strings and the omitted walk default are normalized using the rig-version hint. Match `rig_type` to the preset family.
+
+| `rig_type` | Rig model | Catalog |
+| --- | --- | --- |
+| `biped` | `v2.5-20260210` | `preset:idle`, `preset:walk`, `preset:run`, `preset:dive`, `preset:climb`, `preset:jump`, `preset:slash`, `preset:shoot`, `preset:hurt`, `preset:fall`, `preset:turn` |
+| `biped` | `v1.0-20240301` | Large `preset:biped:*` library below |
+| `quadruped` / `hexapod` / `octopod` / `serpentine` / `aquatic` / `avian` | `v2.5-20260210` | One locomotion each (except avian) |
+
+The official retarget contract does not specify a maximum batch size or guaranteed clip names/order. Preserve the complete result and inspect the downloaded animation clips; do not automatically split into extra paid calls based on an assumed five-preset limit.
+
+Generate creatures in the **stance the preset expects** (e.g. quadruped with all fours planted). Extra creature motion beyond the single locomotion preset should be procedural, a second rig, or external clips.
+
+---
+
+## Quick map
+
+| `rig_type` | Preset(s) |
+| --- | --- |
+| `biped` | For v1 use `preset:biped:*` below; v2.5 uses its separate catalog above. Only legacy comma-string/default mode maps plain names. |
+| `quadruped` | `preset:quadruped:walk` |
+| `hexapod` | `preset:hexapod:walk` |
+| `octopod` | `preset:octopod:walk` |
+| `serpentine` | `preset:serpentine:march` |
+| `aquatic` | `preset:aquatic:march` |
+| `avian` | (none catalogued — procedural / external) |
+
+---
+
+## Creature locomotion
+
+### Quadruped (`rig_type=quadruped`)
+
+```text
+preset:quadruped:walk
+```
+
+### Hexapod (`rig_type=hexapod`)
+
+```text
+preset:hexapod:walk
+```
+
+### Octopod (`rig_type=octopod`)
+
+```text
+preset:octopod:walk
+```
+
+### Serpentine (`rig_type=serpentine`)
+
+```text
+preset:serpentine:march
+```
+
+### Aquatic (`rig_type=aquatic`)
+
+```text
+preset:aquatic:march
+```
+
+### Avian (`rig_type=avian`)
+
+No dedicated Tripo locomotion preset in this catalog. Prefer procedural wing/idle motion, a ground `rig_type` for walk when applicable, or external clips.
+
+---
+
+## Biped (`rig_type=biped`, `preset:biped:*`)
+
+Prefer the full `preset:biped:...` form. In legacy comma-string mode, plain `preset:idle` is mapped server-side to `preset:biped:idle` (and similar).
+
+### Locomotion / core gameplay (most common)
+
+```text
+preset:biped:idle
+preset:biped:walk
+preset:biped:run
+preset:biped:jump
+preset:biped:jump_down
+preset:biped:turn
+preset:biped:climb
+preset:biped:fall
+preset:biped:flee_01
+preset:biped:flee_02
+preset:biped:swim
+preset:biped:run_upstairs
+preset:biped:wait
+preset:biped:standing_relax
+preset:biped:swagger
+```
+
+### Combat / action
+
+```text
+preset:biped:slash
+preset:biped:shoot
+preset:biped:cast_a_spell
+preset:biped:fire
+preset:biped:chop
+preset:biped:front_kick_01
+preset:biped:front_kick_02
+preset:biped:box_01
+preset:biped:box_02
+preset:biped:box_03
+preset:biped:hit_to_body_01
+preset:biped:hit_to_body_02
+preset:biped:hit_to_head
+preset:biped:hit_to_side
+preset:biped:hit_to_stomach
+preset:biped:hurt
+preset:biped:dive
+preset:biped:flip
+```
+
+### Social / emote
+
+```text
+preset:biped:agree
+preset:biped:bow
+preset:biped:cheer
+preset:biped:clap
+preset:biped:greet_01
+preset:biped:greet_02
+preset:biped:greet_03
+preset:biped:greet_04
+preset:biped:wave_goodbye_01
+preset:biped:wave_goodbye_02
+preset:biped:hug
+preset:biped:fold_arms
+preset:biped:look_around
+preset:biped:scratch
+preset:biped:heart_pose
+```
+
+### Emotion
+
+```text
+preset:biped:afraid
+preset:biped:angry_01
+preset:biped:angry_02
+preset:biped:angry_03
+preset:biped:cry
+preset:biped:sob
+preset:biped:depressed
+preset:biped:frightened
+preset:biped:frustrated_01
+preset:biped:frustrated_02
+preset:biped:scared_01
+preset:biped:scared_02
+preset:biped:laugh_01
+preset:biped:laugh_02
+preset:biped:complain_01
+preset:biped:complain_02
+preset:biped:defeat_02
+preset:biped:defeat_03
+preset:biped:victory_celebration
+preset:biped:freaky
+```
+
+### Dance / performance
+
+```text
+preset:biped:dance_01
+preset:biped:dance_02
+preset:biped:dance_03
+preset:biped:dance_04
+preset:biped:dance_05
+preset:biped:dance_06
+preset:biped:sing_01
+preset:biped:sing_02
+preset:biped:sing_03
+preset:biped:sing_04
+```
+
+### Sports / activity
+
+```text
+preset:biped:basketball_shot
+preset:biped:crossover_dribble
+preset:biped:dribble
+preset:biped:football_catch
+preset:biped:football_save
+preset:biped:football_pass
+preset:biped:golf
+preset:biped:pitch_baseball
+preset:biped:volleyball
+preset:biped:surf
+preset:biped:jump_rope_01
+preset:biped:jump_rope_02
+preset:biped:cross_body_crunch
+preset:biped:press-up
+preset:biped:warm_up
+preset:biped:lift_heavy
+```
+
+### Work / props / misc
+
+```text
+preset:biped:dig
+preset:biped:shovel
+preset:biped:sit
+preset:biped:make_a_call_01
+preset:biped:make_a_call_02
+preset:biped:play_mobile_game
+preset:biped:play_video_game
+```
+
+### Biped full flat list (copy-paste)
+
+```text
+preset:biped:afraid
+preset:biped:agree
+preset:biped:angry_01
+preset:biped:angry_02
+preset:biped:angry_03
+preset:biped:basketball_shot
+preset:biped:bow
+preset:biped:box_01
+preset:biped:box_02
+preset:biped:box_03
+preset:biped:cast_a_spell
+preset:biped:cheer
+preset:biped:chop
+preset:biped:clap
+preset:biped:climb
+preset:biped:complain_01
+preset:biped:complain_02
+preset:biped:cross_body_crunch
+preset:biped:crossover_dribble
+preset:biped:cry
+preset:biped:dance_01
+preset:biped:dance_02
+preset:biped:dance_03
+preset:biped:dance_04
+preset:biped:dance_05
+preset:biped:dance_06
+preset:biped:defeat_02
+preset:biped:defeat_03
+preset:biped:depressed
+preset:biped:dig
+preset:biped:dive
+preset:biped:dribble
+preset:biped:fall
+preset:biped:fire
+preset:biped:flee_01
+preset:biped:flee_02
+preset:biped:flip
+preset:biped:fold_arms
+preset:biped:football_catch
+preset:biped:football_save
+preset:biped:football_pass
+preset:biped:freaky
+preset:biped:frightened
+preset:biped:front_kick_01
+preset:biped:front_kick_02
+preset:biped:frustrated_01
+preset:biped:frustrated_02
+preset:biped:golf
+preset:biped:greet_01
+preset:biped:greet_02
+preset:biped:greet_03
+preset:biped:greet_04
+preset:biped:heart_pose
+preset:biped:hit_to_body_01
+preset:biped:hit_to_body_02
+preset:biped:hit_to_head
+preset:biped:hit_to_side
+preset:biped:hit_to_stomach
+preset:biped:hug
+preset:biped:hurt
+preset:biped:idle
+preset:biped:jump_down
+preset:biped:jump
+preset:biped:jump_rope_01
+preset:biped:jump_rope_02
+preset:biped:laugh_01
+preset:biped:laugh_02
+preset:biped:lift_heavy
+preset:biped:look_around
+preset:biped:make_a_call_01
+preset:biped:make_a_call_02
+preset:biped:pitch_baseball
+preset:biped:play_mobile_game
+preset:biped:play_video_game
+preset:biped:press-up
+preset:biped:run_upstairs
+preset:biped:run
+preset:biped:scared_01
+preset:biped:scared_02
+preset:biped:scratch
+preset:biped:shoot
+preset:biped:shovel
+preset:biped:sing_01
+preset:biped:sing_02
+preset:biped:sing_03
+preset:biped:sing_04
+preset:biped:sit
+preset:biped:slash
+preset:biped:sob
+preset:biped:standing_relax
+preset:biped:surf
+preset:biped:swagger
+preset:biped:swim
+preset:biped:turn
+preset:biped:victory_celebration
+preset:biped:volleyball
+preset:biped:wait
+preset:biped:walk
+preset:biped:warm_up
+preset:biped:wave_goodbye_01
+preset:biped:wave_goodbye_02
+```

package/dist/skills/zh-CN/game-asset-mesh-generator/references/generation-contracts.md

@@ -0,0 +1,131 @@
+# 文本、单图与多视图生成
+
+使用 `evomeme_text_to_mesh` 或 `evomeme_image_to_mesh`。公共任务参数、结果字段和恢复规则统一见 [tool-reference.md](tool-reference.md)。示例是 MCP 参数演示，实际调用时替换提示词和来源 URL。
+
+## 目录
+
+- [版本选择](#版本选择)
+- [公共生成参数](#公共生成参数)
+- [面数限制](#面数限制)
+- [来源专用参数](#来源专用参数)
+- [图像输入](#图像输入)
+- [调用示例](#调用示例)
+
+## 版本选择
+
+按用户意图填写 `model_version`：**高精度模型 → `v3.1-20260211`（H）**；**智能网格 → `P2-20260801`（P）**。用户明确指定版本时优先；省略默认 H `v3.1-20260211`。传版本值，不增加 `family` 字段；H 的 `smart_low_poly` 不等于 P 系列。
+
+| 系列 | 版本 | 必须完全省略的不支持字段 |
+| --- | --- | --- |
+| H3 | `v3.1-20260211`、`v3.0-20250812` | 不因系列本身排除下表字段，但仍需遵守参数组合限制。 |
+| H2.5 | `v2.5-20250123` | `texture_quality`、`geometry_quality`、`auto_size`、`quad`、`smart_low_poly`、`generate_parts`、`compress` |
+| P1 | `P1-20260311` | `quad`、`geometry_quality`、`smart_low_poly`、`generate_parts`、`compress` |
+| P2 | `P2-20260801`（预览） | `geometry_quality`、`smart_low_poly`、`generate_parts`、`compress` |
+
+不支持的字段即使取 `false` 或常见默认值也必须省略；支持的字段则保留显式 `false` 和 `0`。种子必须是 JavaScript 安全整数。
+
+## 公共生成参数
+
+默认值仅适用于支持该字段的版本。除明确注明插件默认的项目外，省略可选参数以保留上游行为。
+
+| 参数 | 类型 | 默认值与限制 |
+| --- | --- | --- |
+| `model_version` | string | 插件默认 `v3.1-20260211`；可选版本见上表。 |
+| `mesh_format` | string | `auto`（默认）、`glb`、`fbx`。H3 `quad=true` 输出 FBX，其他生成模式输出 GLB；显式格式必须匹配。其他格式使用 `evomeme_convert_mesh`。 |
+| `model_seed` | integer | 省略随机，`0` 有效。 |
+| `face_limit` | integer | 省略自适应，H3 四边面除外，其默认 10000；范围见下表。 |
+| `texture` | boolean | `true`；裸模还需设置 `pbr=false`。 |
+| `pbr` | boolean | `true`；启用 PBR 会强制生成贴图。 |
+| `texture_seed` | integer | 省略随机，`0` 有效。 |
+| `texture_quality` | string | 默认 `standard`；另有 `fast`、`detailed`、`extreme`（8K）。`fast` 要求显式 `texture_version="v3.5-20260815"`。 |
+| `texture_version` | string | `v3.5-20260815`、`v3.0-20250812`、`v2.5-20250123`。H3/P 默认 v3.0，H2.5 默认 v2.5。 |
+| `delight` | boolean | `true`；去除参考图烘焙光照，仅贴图 v3.5 读取。 |
+| `auto_size` | boolean | `false`；按真实尺寸缩放，单位米。 |
+| `export_uv` | boolean | `true`；`false` 推迟 UV 展开。 |
+| `export_orientation` | string | 默认 `+x`，另有 `-x`、`+y`、`-y`。后续还需处理时省略，最终转换时调整。 |
+| `quad` | boolean | `false`；H3 和 P2 支持，H3 输出 FBX。 |
+| `geometry_quality` | string | 仅 H3：`standard`（默认）或 `detailed`（Ultra）。 |
+| `smart_low_poly` | boolean | 仅 H3，默认 `false`；低多边形模式使用专门的面数范围。 |
+| `generate_parts` | boolean | 仅 H3，默认 `false`。必须显式 `texture=false`、`pbr=false`；完全省略 `quad` 和 `smart_low_poly`，包括 `false`。 |
+| `compress` | string | 仅 H3：`geometry` 启用 meshopt，省略不压缩。 |
+
+## 面数限制
+
+| 模式 | `face_limit` 范围 |
+| --- | --- |
+| H3.1 标准三角面 | 1–1500000 |
+| H3.0 标准三角面 | 1–1000000 |
+| H2.5 三角面 | 1–500000 |
+| H3 Ultra 三角面 | 1–2000000 |
+| H3 四边面 | 1–150000；省略时 10000 |
+| H3 `smart_low_poly` | 三角面 500–20000，四边面 500–10000 |
+| P1 | 50–20000 |
+| P2 | 三角面 48–50000，四边面 48–25000 |
+
+## 来源专用参数
+
+| 工具 | 参数 | 类型 | 要求或默认值 |
+| --- | --- | --- | --- |
+| `evomeme_text_to_mesh` | `prompt` | string | 必填，1–1024 字符；描述轮廓、风格、材质和用途。 |
+| `evomeme_text_to_mesh` | `negative_prompt` | string | 可选，最多 255 字符。 |
+| `evomeme_text_to_mesh` | `image_seed` | integer | 可选，文本转图像的种子；省略随机。 |
+| `evomeme_image_to_mesh` | `input` | string | 单张图像 URL、文件 token 或成功的上游图像任务 ID。 |
+| `evomeme_image_to_mesh` | `inputs` | array | 多视图输入，形式见下文。 |
+| `evomeme_image_to_mesh` | `image_url` | string | 兼容形式：单个 URL 或逗号分隔的四个视图槽位。 |
+| `evomeme_image_to_mesh` | `enable_image_autofix` | boolean | 仅单图，默认 `false`；多视图必须完全省略。 |
+| `evomeme_image_to_mesh` | `texture_alignment` | string | `original_image`（颜色优先）或 `geometry`；默认 `original_image`。 |
+| `evomeme_image_to_mesh` | `orientation` | string | `default` 或 `align_image`；默认 `default`，仅生成贴图时生效。 |
+
+`input`、`inputs`、`image_url` 必须三选一。图像生成模型不接受文本专用的 `prompt`、`negative_prompt`、`image_seed`。
+
+## 图像输入
+
+使用 PNG/JPEG/WebP，建议至少 256×256；单图上限 20 MB。本地文件先上传；多视图应是同一物体，光照保持一致。多视图共同生成一个模型，不会为每张图分别生成模型。
+
+- **单图**：`input` 为 URL、文件 token 或成功的上游 `text_to_image`/`image_to_image` 任务 ID 字符串，不接受视图对象或本地文件路径。
+- **命名多视图**：2–4 个对象，每个只含一个不重复的 `front`、`left`、`back` 或 `right` 键；必须包含正面和另一个视图。值接受字符串、`{"url":"https://example.com/front.png"}`、`{"file_token":"file_front"}` 或 `{"object":{"bucket":"images","key":"front.png"}}`。
+- **固定槽位多视图**：严格四个字符串，顺序 `[front,left,back,right]`。缺失视图保留 `""`，正面和至少另一个视图不能为空。
+- **任务多视图**：严格为 `[{"task_id":"task_upstream_multiview_image"}]`，引用成功的上游 `generate_multiview_image`/`edit_multiview_image` 任务；不可混用其他形式。
+- **兼容 URL**：`image_url` 接受单个公开 URL 或四个逗号分隔槽位；两个、三个无标记 URL 会被拒绝。
+
+上游图像 ID 不等于网关模型 ID，标识区别见公共工具参考。
+
+## 调用示例
+
+### evomeme_text_to_mesh — H 高精度
+
+```json
+{"prompt":"Detailed carved stone guardian, full body in T-pose","model_version":"v3.1-20260211","geometry_quality":"detailed","texture_quality":"fast","texture_version":"v3.5-20260815"}
+```
+
+### evomeme_text_to_mesh — P 智能网格
+
+```json
+{"prompt":"Low-poly wooden chair","model_version":"P2-20260801","face_limit":3000,"model_seed":0}
+```
+
+### evomeme_image_to_mesh — 单图
+
+```json
+{"input":"https://example.com/front.png","model_version":"v3.1-20260211","enable_image_autofix":false}
+```
+
+### evomeme_image_to_mesh — 命名多视图
+
+```json
+{"inputs":[{"front":"https://example.com/front.png"},{"back":"https://example.com/back.png"}],"model_version":"P2-20260801","quad":true}
+```
+
+### evomeme_image_to_mesh — 固定槽位多视图
+
+```json
+{"inputs":["https://example.com/front.png","","https://example.com/back.png",""],"model_version":"v3.1-20260211"}
+```
+
+### evomeme_text_to_mesh — 分件
+
+```json
+{"prompt":"An oak tree with separable trunk and crown","model_version":"v3.1-20260211","texture":false,"pbr":false,"generate_parts":true}
+```
+
+P1 需省略 `quad` 并遵守 P1 面数范围；H2.5 需移除全部不支持字段。分件结果按公共就绪规则处理，保留全部部件链接并检查实际主文件。

package/dist/skills/zh-CN/game-asset-mesh-generator/references/image-generator-workflows.md

@@ -0,0 +1,65 @@
+# 2D To 3D Pairing (local image generator skill removed)
+
+Use a strong 2D input when it improves `game-asset-mesh-generator` output or when the final asset is 2D rather than 3D.
+
+**Sources for 2D references:**
+
+- User-supplied PNG/JPG/WebP uploaded via `evomeme_upload_game_asset` → public URL → MCP `evomeme_image_to_mesh`
+- 使用本地 MCP `evomeme_generate_game_image` 请求远端生图（参数 `model`：`asset-max`、`asset-pro`、`asset-lite`）。
+- Procedural/CSS/canvas UI art exported to disk, then published via `evomeme_upload_game_asset`
+
+Do **not** load removed local `threejs-image-generator` or require `GEMINI_API_KEY`.
+
+## 2D To 3D Reference Images
+
+Generate or obtain clean reference images before image-to-3D for:
+
+- Characters: full-body T-pose or A-pose, neutral expression, visible hands/feet, no cropped limbs.
+- Creatures: side/front silhouettes, clear limb count, readable anatomy.
+- Vehicles: front/side/three-quarter concepts, clear wheels/thrusters/wings, material zones.
+- Buildings: front elevation, roof silhouette, doors/windows, scale cues.
+- Weapons/tools: side view, readable handle/blade/barrel proportions, material callouts.
+- Props/pickups: centered object, plain background, strong silhouette, no text baked in unless wanted.
+- Terrain/world modules: tileable rocks, cliffs, rails, gates, arena pieces, modular set dressing.
+
+For prompt wording (image-to-3D reference, riggable character/creature, texture/material, logo/icon/UI, sky/background), adapt the asset brief in the active card or AAA/UI skill references — there is no separate image-generator SKILL.md in this plugin.
+
+## Texture And Material References
+
+Obtain 2D references via procedural canvas textures, user art, or remote MCP when you need:
+
+- Terrain albedo references: rock, sand, mud, snow, moss, cracked asphalt.
+- Sci-fi trim sheets, panel lines, decals, hazard stripes, window bands.
+- Metal, leather, fabric, glass, ceramic, wood, painted plastic, worn armor.
+- Sky, clouds, nebula, city haze, horizon plates, menu backgrounds.
+- Faction marks, logos, numbers, signs, pickup icons, hazard labels.
+
+## UI And Logo Use Cases
+
+Handle as 2D assets directly (not 3D generation) when appropriate:
+
+- Logos and faction marks.
+- HUD icons, item icons, ability icons, pickup symbols.
+- Menu backgrounds and loading illustrations.
+- Button/icon textures, decals, title art, achievement badges.
+- 2D sky/backdrop cards when a 3D model is unnecessary.
+
+Prefer procedural/CSS/canvas UI from `game-ui` before external 2D sourcing.
+
+## 3D Generator Handoff
+
+After obtaining a 2D reference:
+
+1. Save the image in the working project, usually `assets/concepts/`.
+2. Publish it to a public https URL via `evomeme_upload_game_asset`, or use an already-public URL from remote image tools.
+3. Call evomemeMCP `evomeme_image_to_mesh` with that `image_url` (never a local path).
+4. 粗糙单图可考虑 `enable_image_autofix=true`；多视图必须省略该字段。
+5. Prefer `texture_alignment=original_image` when visual match matters; use `geometry` when structural accuracy matters.
+6. 使用 MCP 成功结果中的 `local_path` 与最终 `asset_url`，遵循公共[就绪与恢复规则](tool-reference.md)。MCP 负责轮询与下载。
+
+## Avoid
+
+- Crowded scene images for single-object 3D generation.
+- Cropped limbs, hidden backs, extreme perspective, motion blur, or heavy depth of field.
+- Tiny UI/logo text in 3D model textures unless text fidelity is noncritical.
+- Using 3D generation for pure 2D UI assets.