evomeme 0.1.9 → 0.1.10

package/dist/skills/zh-CN/game-asset-align/references/blender-scene-pipeline.md

@@ -0,0 +1,45 @@
+# Blender 源场景 → Stage → 引擎
+
+## 从图片开始
+
+先读取图片，明确主体、比例、材质、主光和参考机位。单张图片未展示的背面与遮挡区域按合理假设建模，并在交付时说明。优先通过当前可用的 Blender MCP 完成建模；本插件提供导出和验收流程，不捆绑外部 Blender MCP 安装或图像转三维模型服务。没有 Blender MCP 时，若有本机 Blender，可用 Python 建模；只在缺失路径或不可执行时报告具体阻塞。
+
+先搭建空间和相机，输出低成本参考供迭代，再细化模型、材质和灯光。保存 `.blend` 后进行以下导出。源场景采用米制、unit scale=1，保留场景原点；导出器完成 Blender Z-up 到 glTF Y-up 的转换。不要再旋转整个世界。支持 Cycles/Eevee、透视相机；相机非单位缩放与 lens shift 会报错，需先处理。外链库及未能打包的序列/缓存应在 Blender 本地化后再导出。
+
+## 统一导出入口
+
+```json
+{
+  "workspace_dir": "<当前工作区绝对路径>",
+  "asset_id": "courtyard",
+  "source_blend_path": "<已保存的场景.blend绝对路径>",
+  "camera_names": ["Reference", "MaterialDetail"],
+  "quality": "preview",
+  "width": 960,
+  "bake_materials": true,
+  "texture_size": 1024,
+  "godot_project_dir": "<已有Godot工程绝对路径>"
+}
+```
+
+以上参数传给 `evomeme_scene_export_blender`。相机名与 Godot 工程路径可省略；没有相机时自动建立参考机位，并补全 overview。最多 6 个指定透视相机。width 为 320–1920；texture_size 为 256/512/1024/2048。未指定目标工程时 Godot 默认 Compatibility，可用 godot_renderer 指定 mobile/forward_plus/gl_compatibility；预览和同步工程必须一致。
+
+导出器在隔离 Blender 进程中读取已保存源文件，禁用自动脚本执行，保存自包含源快照，生成 GLB、各机位 Blender 原生参考图、源特征清单及两个目标 profile。原文件不改动；活动 Blender 中未保存的更改不会进入导出。失败不会替换当前包。更新同一场景用 replace_existing:true；旧包保留在返回的 backup_dir，新版本重新确认。
+
+preview 使用快速采样；final 保留源场景采样设置。自由视角原生预览仍为快速模式并关闭景深，不能用它证明最终离线渲染完全一致。
+
+## 烘焙与源契约
+
+bake_materials:true 为可选项，只处理直接连接 Principled BSDF 的受支持程序表面；按对象生成基础色、粗糙度、金属度、切线法线贴图，必要时建立 UV。源 `.blend` 保留原节点；导出模型使用烘焙版本。复杂闭包、混合 shader、体积和间接光不会被此通道烘焙自动转换。保留报告中的跳过原因，不能把部分对象烘焙说成整份材质完成。
+
+`scene.contract.json.source_features` 使用 evomeme.source_scene_features.v1，记录节点 ID、对象/材质关联、程序节点、未转换节点、已烘焙通道/对象、体积、世界环境、源渲染设置。ID 优先复用 evomeme_node_id；未设置时由资产和对象名派生，需要跨重命名稳定 ID 时应在源场景设置该属性。
+
+标准 PBR 与灯光事实共用一份源契约。`runtime/three.profile.json` 和 `runtime/godot.profile.json` 保存引擎覆盖；重新导出保留匹配 schema 的既有覆盖，未覆盖灯光从新源事实派生。修改 profile 后更新 contract.files 中的字节数与 SHA-256。
+
+烘焙材质为每个对象建立独立运行时材质；其精确名称记录在 source_features.materials[].runtime_materials。设置引擎材质覆盖时使用该 material_name。未烘焙版本使用 GLB 内的实际材质名。
+
+## 查看与交付
+
+调用 `evomeme_stage_open` 选择 three_js/godot。展板逐项显示已映射、已烘焙、采用近似、尚未实现、待核对，提供相关机位和“记录修复要求”。修复要求会写入反馈记录，需要代理读取并继续修改；按钮不会自行完成修复。
+
+用户查看并确认目标引擎当前版本后，再调用相应 sync。Three.js 游戏使用生成的 loadReviewedScene 和 runtime.render，与 Stage 共用显示实现；Godot 使用 load_scene 与同一原生显示适配器。完成导入后在实际工程复验。确认记录中的 visual_equivalence=not_evaluated 表示没有计算跨渲染器逐像素等价，不抹去已经记录的近似或缺失项。

package/dist/skills/zh-CN/game-asset-align/references/canonical-package.md

@@ -0,0 +1,26 @@
+# Canonical package
+
+## Required layout
+
+```text
+assets/canonical/<asset_id>/
+  model.glb
+  asset.json
+  preview/
+```
+
+`asset_id` is normalized and stable. `model_file` remains package-relative. Do not reference files outside the package.
+
+An optional `scene.contract.json` may define camera, world-coordinate and display-profile supplements. Its file manifest uses relative paths, byte sizes and SHA-256 hashes. Export/sync verifies the whole manifest and rejects traversal, missing files, stale hashes and coordinate conflicts.
+
+For a complete Blender source scene, `evomeme_scene_export_blender` creates this contract, `source/scene.blend`, per-camera references and both engine profiles automatically. See [Blender scene pipeline](blender-scene-pipeline.md). `source_features` makes unsupported/approximate effects visible in Stage; a loaded GLB alone does not demonstrate material or lighting equivalence.
+
+## World-coordinate scenes
+
+For a complete meter-scale map already exported as Y-up, use `up_axis=+y`, `forward_axis=-z`, `pivot=origin`, `scale_hint_metres=null` and zero offsets unless evidence says otherwise. Do not center a whole world or normalize it by height.
+
+## Replacement and history
+
+`replace_existing=true` may reuse the asset ID and descriptive metadata, but new model bytes create a new source revision. Previous recipes and evidence become stale. Keep repair reports/backups inside the package repair area; never treat a backup as the active `model.glb`.
+
+The bounded alignment history explains creation, migration, acceptance and invalidation. It is an audit aid, not a substitute for current revision checks.

package/dist/skills/zh-CN/game-asset-align/references/engine-capabilities.md

@@ -0,0 +1,14 @@
+# Engine capabilities
+
+| Component | Owns | Must not own |
+|---|---|---|
+| Stage | Three.js live preview, native Godot/Blender preview, bounds/TRS, explicit user confirmation before import | substituting Three.js frames for Godot, agent acceptance on behalf of the user |
+| Blender | topology, normals, origin baking, mesh cleanup, GLB re-export | final engine readiness, hidden per-engine orientation |
+| Godot 4 | GLB import, one runtime wrapper, gameplay integration, target render/physics QA | guessing authored axes, accumulating compensation transforms |
+| Three.js game | one runtime wrapper, web presentation and gameplay QA | a second canonical schema or per-entity hard rotations |
+
+Tripo and other generators are sources, not alignment authorities. Preserve their task/model/version metadata in provenance, but compute readiness from the emitted file and current user intent.
+
+Use GLB as the canonical mesh payload. Blender source files may be retained as provenance or repair artifacts, but engines consume the package, not an arbitrary `.blend` working file.
+
+Unity and Unreal are intentionally outside this plugin plan. Do not add placeholder adapters that appear supported but bypass validation.

package/dist/skills/zh-CN/game-asset-align/references/lightweight-review.md

@@ -0,0 +1,32 @@
+# Stage 展板确认与引擎导入
+
+Blender 建模或修改后，必须打开 Stage 展板查看当前版本，由用户点击“确认当前版本，允许导入”，之后才能进行下一步导入。仅启动展板、格式检查通过、保存技术对齐状态或 ready=true 均不能放行。
+
+## 顺序
+
+1. 完整 Blender 场景使用 evomeme_scene_export_blender 生成 canonical 包、源快照、契约与原生参考图；已有 GLB 可单独入库。
+2. evomeme_asset_review 检查模型格式与文件摘要。
+3. evomeme_stage_open({workspace_dir, asset_id, target}) 打开单场景视窗。target 为 three_js 或 godot。
+4. 以同机位、同画幅对比 Blender 与目标引擎原生渲染，检查空间、结构、材质和灯光。Godot 使用临时原生预览工程，不提前写最终游戏工程。
+   查看“效果转换与待核对项”的映射、烘焙、近似和缺失状态，可跳转相关机位或记录修复要求。状态来自源特征与适配器能力，不是图像相似度评分。
+5. 用户在页面确认。工具和代理不得代替用户点击，也不得直接构造确认文件。
+6. 调用相应 sync 工具。Three.js 确认不能替代 Godot 确认；导出同样需要当前 Stage 确认。
+
+需要修改时回 Blender 或更新引擎 profile，然后重新载入、查看和确认。页面保留单场景范围，不加入资产列表、部件编辑或玩法。
+
+## 环境
+
+Blender 通过 EVOMEME_BLENDER / BLENDER_PATH 配置；Godot 通过 EVOMEME_GODOT / GODOT_PATH 或 PATH 上的 godot 配置。原生预览等待时不把旧图冒充当前视角，失败时不能确认当前画面。
+
+## 记录与失效
+
+.review/stage-view.json 记录实际展板机位、目标引擎和版本。Godot 查看还绑定原生渲染回执及 profile key。
+.review/confirmation.json 记录用户确认、当前资源/显示实现摘要、完整 TRS、机位、截图摘要和技术报告。
+
+模型、asset.json、场景契约、纹理、Godot profile、材质/灯光配置或显示模块变化会让确认过期。export/sync 在写目标前检查当前确认及对齐配方；设置 verified_by 或直接改 ready 不能绕过。
+
+## 交接与范围
+
+浏览器 handoff 只复现已确认的 Three.js 画面；Godot 用 sync_to_godot 输出原生加载器和显示适配器，不把 Three.js 交接图当作 Godot 验收。
+
+Godot 基础流程保留 GLB PBR，重建灯光、环境、曝光与相机，支持材料参数校准。面光使用明确标注的近似；Three.js 专用烘焙着色器/LUT 不会在 Godot 自动执行。用户确认资产显示后，游戏集成与玩法仍需目标引擎复验。

package/dist/skills/zh-CN/game-asset-align/references/repair-policy.md

@@ -0,0 +1,30 @@
+# Repair policy
+
+Choose the shallowest layer that fixes the actual defect while preserving one canonical result.
+
+## Metadata repair
+
+Use the Stage or `evomeme_asset_package_set_orientation` when geometry is sound but authored axes, pivot intent, scale target, semantic label, sockets, or review evidence are wrong. Save a complete wrapper TRS. Do not bake a rotation into gameplay code.
+
+## Wrapper repair
+
+Use the canonical recipe for non-destructive translation, quaternion rotation and scale. The wrapper must be applied exactly once. It is appropriate for grounding, recentering, authored-forward conversion and size normalization.
+
+If `pivot=origin` and `scale_hint_metres=null`, a deterministic identity translation/unit scale recipe is possible. Bounds-dependent pivots or height normalization require a measured recipe from the board or another adapter.
+
+## Blender geometry repair
+
+Use `evomeme_asset_repair_blender` for broken origins that must be baked, detached/duplicate parts, bad normals, unusable topology, destructive transform cleanup, or export defects. It backs up the prior model and writes into the same canonical package.
+
+Any Blender result changes the source revision and invalidates all prior review states. Reopen the Stage and accept a new recipe before export or sync.
+
+## Never repair here
+
+- player/controller yaw offsets;
+- AnimationTree or animation-track compensations;
+- per-scene scale overrides;
+- a second Godot/Three wrapper;
+- a material tweak claimed as canonical without updating review evidence.
+
+These hide drift and cannot be maintained when the asset is regenerated.
+

package/dist/skills/zh-CN/game-asset-align/references/tool-contract.md

@@ -0,0 +1,39 @@
+# MCP tool contract
+
+## Create and inspect
+
+- `evomeme_scene_export_blender`: saved Blender scene → source snapshot, GLB, cameras/reference PNGs, source-feature contract, Three.js/Godot profiles and derived diagnostics. Read [blender-scene-pipeline.md](blender-scene-pipeline.md) for parameters, baking and replacement behavior. This source export precedes Stage; it is distinct from confirmed package export to an engine.
+- `evomeme_asset_package_create`: copy GLB/GLTF into a canonical package. New packages are normally `needs_review`.
+- `evomeme_asset_package_list`: inspect `alignment_status` and `alignment_ready` before choosing work.
+- `evomeme_asset_package_get`: read full paths, flat compatibility fields and the v2 alignment record.
+- `evomeme_stage_open`: preferred path for bounds-dependent alignment and user visual acceptance.
+- Blender modeling/changes MUST stop at Stage before engine import. Open with `target=three_js` or `target=godot`; the user must view and click the current-version confirmation. An agent must not click on the user's behalf or fabricate a record.
+
+## Accept alignment
+
+`evomeme_asset_package_set_orientation` writes technical alignment only. It cannot replace Stage user confirmation or unlock import. It accepts flat intent fields plus optional:
+
+```json
+{
+  "alignment_recipe": {
+    "translation_metres": [0, 0, 0],
+    "rotation_quaternion_xyzw": [0, 0, 0, 1],
+    "scale_xyz": [1, 1, 1],
+    "algorithm_version": "adapter-name.v1"
+  },
+  "alignment_conditions": {
+    "spatial": { "status": "aligned", "evidence": "front/side board review" }
+  }
+}
+```
+
+For a bounds-dependent pivot or scale, omitting `alignment_recipe` leaves the package non-ready. Use the board instead of inventing translation/scale values.
+
+## Repair and delivery
+
+- `evomeme_asset_repair_blender`: changes the source and invalidates alignment.
+- `evomeme_asset_package_export`: validates source bytes, readiness and current Stage user confirmation.
+- `evomeme_asset_sync_to_three`: exports to `public/assets/canonical/<id>/` and generates `src/evomeme-stage/<id>/canonical_loader.js`; use loadReviewedScene with Three.js 0.170.0 and runtime.render to retain the reviewed appearance pipeline.
+- `evomeme_asset_sync_to_godot`: requires `project.godot` and current native Godot Stage confirmation; exports to `assets/canonical/<id>/`, generating the guarded model loader and shared material/light/environment/camera adapter. Use `load_scene` for a scene and `load_package` for props.
+
+On a gate error, do not retry with edited JSON. Read the reported pending/stale conditions, repair or review the package, then sync again.

package/dist/skills/zh-CN/game-asset-align/references/visual-review.md

@@ -0,0 +1,26 @@
+# Visual review
+
+## Review sequence
+
+1. Load the exact current `model.glb`; confirm the displayed source revision.
+2. Compare against the user request or versioned reference, not memory.
+3. Inspect front/back/side/top and a gameplay camera view.
+4. Check spatial, structural, semantic and render conditions separately.
+5. Save the measured wrapper TRS and concise evidence.
+6. Verify again in the target engine after sync.
+
+## Practical checks
+
+- Spatial: feet/wheels/base touch the expected plane; forward direction is unambiguous; height and world scale are plausible; maps retain their intended origin.
+- Structural: named parts exist, transforms are not unexpectedly nested, skeleton and sockets remain attached, animations do not jump on frame zero.
+- Semantic: silhouette, part count, handedness, openings, controls, weapon muzzle, seats, doors and other requested affordances are correct.
+- Render: normals face outward, textures resolve, alpha/culling are correct, material response is credible and no parts disappear under the target camera/light setup.
+
+## Evidence quality
+
+Prefer a user-approved board view or target-engine screenshot. Agent visual review is acceptable when the comparison and limitations are recorded. Heuristics alone do not close structural, semantic or render review.
+
+Three.js Stage is a neutral inspection surface, not proof of Godot render parity. Blender Cycles, Three.js and Godot use different shading pipelines. Describe approximations explicitly; do not promise pixel identity unless a target-engine capture was compared.
+
+For `scene.contract.json`, keep reference camera, aspect ratio, near/far and framing fixed during comparison. Do not let auto-frame controls overwrite a contract camera.
+

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

@@ -45,7 +45,7 @@ description: 指导 Agent 正确使用 MCP 提供的各类游戏素材生成与
 | `image_type` | 否 | `asset`、`background`、`parallax background`、`tileset` | 图片类型，默认 `background`。`asset`、`parallax background`、`tileset` 会自动抠图。 |
 | `size` | 否 | `2048x2048`、`1728x2304`、`2304x1728`、`2560x1440`、`1440x2560`、`1664x2496`、`2496x1664`、`3024x1296` | 输出尺寸，默认 `2048x2048`。 |
 | `reference_image_url` | 否 | `string` | 参考图片的可访问 URL。 |
-| `image_model` | 否 | `asset-lite`、`asset-pro` | 生图模型，默认 `asset-lite`。 |
+| `image_model` | 否 | `asset-lite`、`asset-pro`、`asset-max` | 生图模型，默认 `asset-lite`。 |
 | `workspace_dir` | 否 | `string` | Agent 当前工作区根目录的绝对路径。为满足素材准则，调用时必须显式传入。 |
 
 ### 出参

package/dist/skills/zh-CN/game-audio/references/bgm-cdn.md

@@ -0,0 +1,127 @@
+# BGM CDN And URL Catalog
+
+This file is the authoritative source for hosted background-music routing. Read `../SKILL.md` first, then use this reference to compose final HTTPS URLs for tracks stored under the BGM bucket path.
+
+## CDN Roots
+
+Primary public CDN root:
+
+```text
+https://vibe-writing-dev-public.tos-cn-beijing.volces.com/
+```
+
+Secondary root that may be used only when the user explicitly provides a full URL or confirms that a track lives there:
+
+```text
+https://ppy-test.tos-cn-beijing.volces.com/
+```
+
+## Required Prefix
+
+All hosted background music objects live under:
+
+```text
+bgm/
+```
+
+## Final URL Shape
+
+```text
+{CDN root}bgm/{encoded filename}
+```
+
+- Keep the CDN root exactly as listed.
+- Keep the `bgm/` prefix exactly as listed.
+- The filename segment includes the extension such as `.mp3` or `.m4a`.
+- Encode the filename segment with UTF-8 percent-encoding when it contains non-ASCII or reserved characters.
+
+## Encoding Rule
+
+- Use the full stored filename, including extension, as the source string for `encodeURIComponent`.
+- Encode only the filename segment, not the entire URL.
+- Keep spaces encoded as `%20`.
+- Common examples:
+  - `–` -> `%E2%80%93`
+  - `（` -> `%EF%BC%88`
+  - `）` -> `%EF%BC%89`
+
+## Track Catalog
+
+Final URL = `https://vibe-writing-dev-public.tos-cn-beijing.volces.com/bgm/` + filename fragment below unless the user explicitly confirms the secondary CDN root.
+
+| Object key | Filename fragment |
+| --- | --- |
+| `2048.mp3` | `2048.mp3` |
+| `Arrows – Puzzle Escape（箭头逃脱）.mp3` | `Arrows%20%E2%80%93%20Puzzle%20Escape%EF%BC%88%E7%AE%AD%E5%A4%B4%E9%80%83%E8%84%B1%EF%BC%89.mp3` |
+| `Ballz 打砖块.mp3` | `Ballz%20%E6%89%93%E7%A0%96%E5%9D%97.mp3` |
+| `Block Blast! 方块消除1.mp3` | `Block%20Blast%21%20%E6%96%B9%E5%9D%97%E6%B6%88%E9%99%A41.mp3` |
+| `Block Blast! 方块消除2.mp3` | `Block%20Blast%21%20%E6%96%B9%E5%9D%97%E6%B6%88%E9%99%A42.mp3` |
+| `DOODLE JUMP2.mp3` | `DOODLE%20JUMP2.mp3` |
+| `Doodle Jump.mp3` | `Doodle%20Jump.mp3` |
+| `Flappy Bird1.mp3` | `Flappy%20Bird1.mp3` |
+| `Flappy Bird2.mp3` | `Flappy%20Bird2.mp3` |
+| `Vita Mahjong 麻将配对1.mp3` | `Vita%20Mahjong%20%E9%BA%BB%E5%B0%86%E9%85%8D%E5%AF%B91.mp3` |
+| `Vita Mahjong 麻将配对2.mp3` | `Vita%20Mahjong%20%E9%BA%BB%E5%B0%86%E9%85%8D%E5%AF%B92.mp3` |
+| `_疯狂的鸽子1.mp3` | `_%E7%96%AF%E7%8B%82%E7%9A%84%E9%B8%BD%E5%AD%901.mp3` |
+| `_疯狂的鸽子2.mp3` | `_%E7%96%AF%E7%8B%82%E7%9A%84%E9%B8%BD%E5%AD%902.mp3` |
+| `三消 _ 二合1.mp3` | `%E4%B8%89%E6%B6%88%20_%20%E4%BA%8C%E5%90%881.mp3` |
+| `三消 _ 二合2.mp3` | `%E4%B8%89%E6%B6%88%20_%20%E4%BA%8C%E5%90%882.mp3` |
+| `人格测试.mp3` | `%E4%BA%BA%E6%A0%BC%E6%B5%8B%E8%AF%95.mp3` |
+| `休闲小镇.mp3` | `%E4%BC%91%E9%97%B2%E5%B0%8F%E9%95%87.mp3` |
+| `休闲轻快.mp3` | `%E4%BC%91%E9%97%B2%E8%BD%BB%E5%BF%AB.mp3` |
+| `休闲拼图1.mp3` | `%E4%BC%91%E9%97%B2%E6%8B%BC%E5%9B%BE1.mp3` |
+| `休闲拼图2.mp3` | `%E4%BC%91%E9%97%B2%E6%8B%BC%E5%9B%BE2.mp3` |
+| `冰壶游戏.mp3` | `%E5%86%B0%E5%A3%B6%E6%B8%B8%E6%88%8F.mp3` |
+| `割绳子（Cut the Rope）1.mp3` | `%E5%89%B2%E7%BB%B3%E5%AD%90%EF%BC%88Cut%20the%20Rope%EF%BC%891.mp3` |
+| `割绳子（Cut the Rope）2.mp3` | `%E5%89%B2%E7%BB%B3%E5%AD%90%EF%BC%88Cut%20the%20Rope%EF%BC%892.mp3` |
+| `割草游戏1.mp3` | `%E5%89%B2%E8%8D%89%E6%B8%B8%E6%88%8F1.mp3` |
+| `割草游戏2.mp3` | `%E5%89%B2%E8%8D%89%E6%B8%B8%E6%88%8F2.mp3` |
+| `割草游戏3.mp3` | `%E5%89%B2%E8%8D%89%E6%B8%B8%E6%88%8F3.mp3` |
+| `华容道 _ 拼图1.mp3` | `%E5%8D%8E%E5%AE%B9%E9%81%93%20_%20%E6%8B%BC%E5%9B%BE1.mp3` |
+| `华容道 _ 拼图_2.mp3` | `%E5%8D%8E%E5%AE%B9%E9%81%93%20_%20%E6%8B%BC%E5%9B%BE_2.mp3` |
+| `发泄暴打.mp3` | `%E5%8F%91%E6%B3%84%E6%9A%B4%E6%89%93.mp3` |
+| `叠房子.mp3` | `%E5%8F%A0%E6%88%BF%E5%AD%90.mp3` |
+| `吃分避障.mp3` | `%E5%90%83%E5%88%86%E9%81%BF%E9%9A%9C.mp3` |
+| `合成大西瓜1.mp3` | `%E5%90%88%E6%88%90%E5%A4%A7%E8%A5%BF%E7%93%9C1.mp3` |
+| `合成大西瓜2.mp3` | `%E5%90%88%E6%88%90%E5%A4%A7%E8%A5%BF%E7%93%9C2.mp3` |
+| `哈吉米南北绿豆.mp3` | `%E5%93%88%E5%9F%BA%E7%B1%B3%E5%8D%97%E5%8C%97%E7%BB%BF%E8%B1%86.mp3` |
+| `场景模拟对话1.mp3` | `%E5%9C%BA%E6%99%AF%E6%A8%A1%E6%8B%9F%E5%AF%B9%E8%AF%9D1.mp3` |
+| `场景模拟对话2.mp3` | `%E5%9C%BA%E6%99%AF%E6%A8%A1%E6%8B%9F%E5%AF%B9%E8%AF%9D2.mp3` |
+| `塔防.mp3` | `%E5%A1%94%E9%98%B2.mp3` |
+| `对抗类.mp3` | `%E5%AF%B9%E6%8A%97%E7%B1%BB.mp3` |
+| `奇幻冒险.m4a` | `%E5%A5%87%E5%B9%BB%E5%86%92%E9%99%A9.m4a` |
+| `愤怒的小鸟.mp3` | `%E6%84%A4%E6%80%92%E7%9A%84%E5%B0%8F%E9%B8%9F.mp3` |
+| `战斗.mp3` | `%E6%88%98%E6%96%97.mp3` |
+| `打地鼠.mp3` | `%E6%89%93%E5%9C%B0%E9%BC%A0.mp3` |
+| `搞笑.mp3` | `%E6%90%9E%E7%AC%91.mp3` |
+| `拧螺丝1.mp3` | `%E6%8B%A7%E8%9E%BA%E4%B8%9D1.mp3` |
+| `拧螺丝2.mp3` | `%E6%8B%A7%E8%9E%BA%E4%B8%9D2.mp3` |
+| `数值生存.mp3` | `%E6%95%B0%E5%80%BC%E7%94%9F%E5%AD%98.mp3` |
+| `数字门跑酷1.mp3` | `%E6%95%B0%E5%AD%97%E9%97%A8%E8%B7%91%E9%85%B71.mp3` |
+| `数字门跑酷2.mp3` | `%E6%95%B0%E5%AD%97%E9%97%A8%E8%B7%91%E9%85%B72.mp3` |
+| `是男人就下 100 层.mp3` | `%E6%98%AF%E7%94%B7%E4%BA%BA%E5%B0%B1%E4%B8%8B%20100%20%E5%B1%82.mp3` |
+| `是男人就下100层2.mp3` | `%E6%98%AF%E7%94%B7%E4%BA%BA%E5%B0%B1%E4%B8%8B100%E5%B1%822.mp3` |
+| `校准类.mp3` | `%E6%A0%A1%E5%87%86%E7%B1%BB.mp3` |
+| `横板过关.mp3` | `%E6%A8%AA%E6%9D%BF%E8%BF%87%E5%85%B3.mp3` |
+| `沙盒模拟类1.mp3` | `%E6%B2%99%E7%9B%92%E6%A8%A1%E6%8B%9F%E7%B1%BB1.mp3` |
+| `沙盒模拟类2.mp3` | `%E6%B2%99%E7%9B%92%E6%A8%A1%E6%8B%9F%E7%B1%BB2.mp3` |
+| `沙盒模拟类3.mp3` | `%E6%B2%99%E7%9B%92%E6%A8%A1%E6%8B%9F%E7%B1%BB3.mp3` |
+| `祖玛1.mp3` | `%E7%A5%96%E7%8E%9B1.mp3` |
+| `祖玛2.mp3` | `%E7%A5%96%E7%8E%9B2.mp3` |
+| `经营养成.mp3` | `%E7%BB%8F%E8%90%A5%E5%85%BB%E6%88%90.mp3` |
+| `经营养成2.mp3` | `%E7%BB%8F%E8%90%A5%E5%85%BB%E6%88%902.mp3` |
+| `背包堆叠（Stack_Backpack）.mp3` | `%E8%83%8C%E5%8C%85%E5%A0%86%E5%8F%A0%EF%BC%88Stack_Backpack%EF%BC%89.mp3` |
+| `节奏类（音游点击）.mp3` | `%E8%8A%82%E5%A5%8F%E7%B1%BB%EF%BC%88%E9%9F%B3%E6%B8%B8%E7%82%B9%E5%87%BB%EF%BC%89.mp3` |
+| `解绳游戏（Tangled Rope）1.mp3` | `%E8%A7%A3%E7%BB%B3%E6%B8%B8%E6%88%8F%EF%BC%88Tangled%20Rope%EF%BC%891.mp3` |
+| `解绳游戏（Tangled Rope）2.mp3` | `%E8%A7%A3%E7%BB%B3%E6%B8%B8%E6%88%8F%EF%BC%88Tangled%20Rope%EF%BC%892.mp3` |
+| `贪吃蛇.mp3` | `%E8%B4%AA%E5%90%83%E8%9B%87.mp3` |
+| `贪吃蛇2.mp3` | `%E8%B4%AA%E5%90%83%E8%9B%872.mp3` |
+| `跑酷避障.mp3` | `%E8%B7%91%E9%85%B7%E9%81%BF%E9%9A%9C.mp3` |
+| `跳一跳.mp3` | `%E8%B7%B3%E4%B8%80%E8%B7%B3.mp3` |
+| `跳一跳2.mp3` | `%E8%B7%B3%E4%B8%80%E8%B7%B32.mp3` |
+| `连击挑战1.mp3` | `%E8%BF%9E%E5%87%BB%E6%8C%91%E6%88%981.mp3` |
+| `连击挑战2.mp3` | `%E8%BF%9E%E5%87%BB%E6%8C%91%E6%88%982.mp3` |
+| `鉴别伪人.mp3` | `%E9%89%B4%E5%88%AB%E4%BC%AA%E4%BA%BA.mp3` |
+| `雷霆战机.mp3` | `%E9%9B%B7%E9%9C%86%E6%88%98%E6%9C%BA.mp3` |
+| `鬼抓人.mp3` | `%E9%AC%BC%E6%8A%93%E4%BA%BA.mp3` |
+| `黑洞（Tiles In Hole_ Black Hole）.mp3` | `%E9%BB%91%E6%B4%9E%EF%BC%88Tiles%20In%20Hole_%20Black%20Hole%EF%BC%89.mp3` |

package/dist/skills/zh-CN/game-audio/references/sfx-cdn.md

@@ -0,0 +1,77 @@
+# SFX CDN And URL Catalog
+
+This file is the authoritative source for hosted sound-effect routing. Read `../SKILL.md` first, then use this reference to compose final HTTPS URLs for short feedback audio stored under the SFX bucket path.
+
+This catalog is for audio feedback only. Do not use it for canvas particles, trails, sparks, or other visual VFX implementations.
+
+## CDN Root
+
+Public CDN root:
+
+```text
+https://ppy-test.tos-cn-beijing.volces.com/
+```
+
+## Required Prefix
+
+All hosted gameplay and UI sound effects live under:
+
+```text
+sfx/
+```
+
+## Final URL Shape
+
+```text
+{CDN root}sfx/{encoded filename}
+```
+
+- Keep the CDN root exactly as listed.
+- Keep the `sfx/` prefix exactly as listed.
+- The filename segment includes the extension such as `.mp3`, `.m4a`, `.ogg`, or `.mp4`.
+- Encode the filename segment with UTF-8 percent-encoding when required.
+
+## Encoding Rule
+
+- Use the full stored filename, including extension, as the source string for `encodeURIComponent`.
+- Encode only the filename segment, not the full URL.
+- Keep spaces encoded as `%20`.
+
+## Sound Catalog
+
+Final URL = `https://ppy-test.tos-cn-beijing.volces.com/sfx/` + filename fragment below.
+
+| Object key | Filename fragment |
+| --- | --- |
+| `RUA.mp3` | `RUA.mp3` |
+| `人物冲刺.mp3` | `%E4%BA%BA%E7%89%A9%E5%86%B2%E5%88%BA.mp3` |
+| `人物叫声.mp3` | `%E4%BA%BA%E7%89%A9%E5%8F%AB%E5%A3%B0.mp3` |
+| `人物碰撞.m4a` | `%E4%BA%BA%E7%89%A9%E7%A2%B0%E6%92%9E.m4a` |
+| `人物脚步声.mp3` | `%E4%BA%BA%E7%89%A9%E8%84%9A%E6%AD%A5%E5%A3%B0.mp3` |
+| `僵尸叫声.ogg` | `%E5%83%B5%E5%B0%B8%E5%8F%AB%E5%A3%B0.ogg` |
+| `僵尸死亡.mp3` | `%E5%83%B5%E5%B0%B8%E6%AD%BB%E4%BA%A1.mp3` |
+| `动物脚步声.mp3` | `%E5%8A%A8%E7%89%A9%E8%84%9A%E6%AD%A5%E5%A3%B0.mp3` |
+| `吃金币.mp3` | `%E5%90%83%E9%87%91%E5%B8%81.mp3` |
+| `呼噜.mp3` | `%E5%91%BC%E5%99%9C.mp3` |
+| `壮汉死亡倒地.mp3` | `%E5%A3%AE%E6%B1%89%E6%AD%BB%E4%BA%A1%E5%80%92%E5%9C%B0.mp3` |
+| `失误.mp3` | `%E5%A4%B1%E8%AF%AF.mp3` |
+| `射击-轻.mp3` | `%E5%B0%84%E5%87%BB-%E8%BD%BB.mp3` |
+| `射击-重.mp3` | `%E5%B0%84%E5%87%BB-%E9%87%8D.mp3` |
+| `成功.mp3` | `%E6%88%90%E5%8A%9F.mp3` |
+| `我想上班.mp3` | `%E6%88%91%E6%83%B3%E4%B8%8A%E7%8F%AD.mp3` |
+| `拖拽.mp3` | `%E6%8B%96%E6%8B%BD.mp3` |
+| `拾取.mp3` | `%E6%8B%BE%E5%8F%96.mp3` |
+| `放置.mp3` | `%E6%94%BE%E7%BD%AE.mp3` |
+| `旋转.mp4` | `%E6%97%8B%E8%BD%AC.mp4` |
+| `汽车行驶.mp3` | `%E6%B1%BD%E8%BD%A6%E8%A1%8C%E9%A9%B6.mp3` |
+| `游戏失败.mp3` | `%E6%B8%B8%E6%88%8F%E5%A4%B1%E8%B4%A5.mp3` |
+| `点击.mp3` | `%E7%82%B9%E5%87%BB.mp3` |
+| `爆炸.mp3` | `%E7%88%86%E7%82%B8.mp3` |
+| `爽.mp3` | `%E7%88%BD.mp3` |
+| `猫叫.mp3` | `%E7%8C%AB%E5%8F%AB.mp3` |
+| `碰撞.mp3` | `%E7%A2%B0%E6%92%9E.mp3` |
+| `苏卡不列.mp3` | `%E8%8B%8F%E5%8D%A1%E4%B8%8D%E5%88%97.mp3` |
+| `苏卡不列那惠.mp3` | `%E8%8B%8F%E5%8D%A1%E4%B8%8D%E5%88%97%E9%82%A3%E6%83%A0.mp3` |
+| `谢谢啊.mp3` | `%E8%B0%A2%E8%B0%A2%E5%95%8A.mp3` |
+| `雪地上的脚步声.mp3` | `%E9%9B%AA%E5%9C%B0%E4%B8%8A%E7%9A%84%E8%84%9A%E6%AD%A5%E5%A3%B0.mp3` |
+| `飞行.mp3` | `%E9%A3%9E%E8%A1%8C.mp3` |

package/dist/skills/zh-CN/game-test/references/checklists/playtest-qa.md

@@ -0,0 +1,12 @@
+# Playtest QA Checklist
+
+- Start from a clean load.
+- Play through the main loop for at least 2 minutes.
+- Verify controls, camera, objective feedback, failure/retry, and progression.
+- Try rapid input changes and edge movement against arena boundaries.
+- Trigger collisions from multiple angles.
+- Pause, restart, resize, and refocus the tab if supported.
+- Check audio unlock and volume behavior after the first gesture.
+- Watch for unreadable moments, camera occlusion, jitter, and missed feedback.
+- Capture screenshots for desktop and mobile.
+- Record bugs as reproduction steps with expected and actual behavior.

package/{skills → dist/skills/zh-CN}/game-ui/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: game-ui
-description: 为游戏设计克制、清晰且具有类型感的 HUD、菜单、弹窗、触控区域、安全区和 UI 动效，并直接调用当前环境中的生图工具交付不同界面的 UI 概念图及其设计理念。当游戏需要确定或调整 UI 风格、信息层级、界面布局、交互反馈、移动端适配，或需要为开始、游玩、暂停、设置、胜负、结算和选择等状态生成 UI 概念图时使用。
+description: 为游戏设计克制、清晰且具有类型感的 HUD、菜单、弹窗、触控区域、安全区和 UI 动效，并直接调用当前环境中的生图工具交付不同界面的 UI 概念图及其设计理念。当游戏需要确定或调整 UI 风格、信息层级、界面布局、交互反馈、移动端适配，或需要为开始、游玩、暂停、设置、胜负、结算和选择等状态生成 UI 概念图时使用。面向 evomeme平台的游戏必须同时阅读并遵守 evomeme-ui。
 ---
 
 # 游戏 UI 设计
@@ -9,6 +9,12 @@ description: 为游戏设计克制、清晰且具有类型感的 HUD、菜单、
 
 根据游戏玩法、美术方向和目标设备完成 UI 设计，并为不同界面生成能够表现最终游戏效果的概念图。概念图应同时体现信息层级、操作意图、画面构图和统一的视觉语言。
 
+## evomeme平台前置要求
+
+如果开发的游戏要在 evomeme平台运行、上线或发布，必须在 UI 设计、概念图生成或自适应实现前阅读并遵守 [`evomeme-ui`](../evomeme-ui/SKILL.md)。以宿主已经分配的 WebView 容器为画幅，不按手机整屏或固定比例设计，不再次扣除 App 栏位及手机安全区。
+
+evomeme游戏的尺寸来源、安全区处理与适配验收以 `evomeme-ui` 为准。本技能及通用检查表中的移动端安全区建议不得导致重复扣减；其他平台继续按其实际宿主约束设计。
+
 ## 核心设计宗旨
 
 1. **少即是多**：让每个 UI 元素服务于玩家当前的判断、操作或反馈理解。
@@ -26,6 +32,7 @@ description: 为游戏设计克制、清晰且具有类型感的 HUD、菜单、
 
 - 核心玩法与玩家在每个状态下需要作出的决定；
 - 目标设备、横竖屏、画面比例和安全区；
+- 是否在 evomeme平台运行或发布；若是，必须先完成上方 `evomeme-ui` 前置阅读，并使用其中的游戏容器测试尺寸；
 - 键盘、鼠标、触控或原生输入方式；
 - 游戏美术风格、题材、气氛和已有视觉资产；
 - 需要设计的游戏状态及每个状态的主要行动。
@@ -162,6 +169,7 @@ description: 为游戏设计克制、清晰且具有类型感的 HUD、菜单、
 
 ## Reference Routing
 
+- 为 evomeme平台游戏设计或适配 UI 时，必须先读取并遵守 [`evomeme-ui`](../evomeme-ui/SKILL.md)。
 - 设计 HUD、菜单、覆盖层、触控控件和响应式布局时，读取 [`references/ui-patterns.md`](references/ui-patterns.md)。
 - 检查整体游戏感与界面质量时，读取 [`references/checklists/game-ui-quality.md`](references/checklists/game-ui-quality.md)。
 - 检查 HUD 信息层级和动态可读性时，读取 [`references/checklists/hud-readability.md`](references/checklists/hud-readability.md)。

package/dist/skills/zh-CN/game-ui/references/checklists/game-ui-quality.md

@@ -0,0 +1,14 @@
+# Game UI Quality Checklist
+
+- The first screen is the playable game or a deliberate modal state, not a landing page.
+- HUD hierarchy matches gameplay priority: survival/status, objective, feedback, secondary flavor.
+- UI visual language matches the game's genre, world materials, color, and motion.
+- Menus include expected states: pause, resume, restart, settings, win/lose when relevant.
+- Buttons and controls have stable dimensions plus hover, pressed, focus, and disabled states.
+- Icons are used for compact tool/actions when recognizable; ambiguous icons have labels or tooltips.
+- UI does not use nested cards, marketing-page layout, or generic dashboard styling.
+- UI does not block player, threats, goals, interactables, or near-future path unless intentionally modal.
+- Dynamic values such as score, time, health, combo, and ammo do not shift layout.
+- Reduced-motion and flash risk is considered for intense UI animation or damage feedback.
+- UI state is driven by the game state model and does not duplicate simulation rules.
+- Desktop and mobile screenshots show coherent composition and no clipped or overlapping controls.

package/dist/skills/zh-CN/game-ui/references/checklists/hud-readability.md

@@ -0,0 +1,12 @@
+# HUD Readability Checklist
+
+- Player health/status is readable during normal movement and high-action moments.
+- Objective/progress information is visible without competing with threats or pickups.
+- Text contrast remains legible over bright, dark, and moving scene backgrounds.
+- Critical status changes have at least two feedback channels when useful: shape, color, motion, sound, or text.
+- Meters, timers, and counters have fixed-width or stable containers.
+- HUD placement avoids the player focal area and likely spawn/threat lanes.
+- HUD scale is appropriate for desktop, laptop, and mobile viewports.
+- Touch controls and HUD elements do not overlap each other.
+- UI transitions do not delay input response or hide the next player decision.
+- Screenshot review confirms HUD readability before and after interaction.

package/dist/skills/zh-CN/game-ui/references/checklists/mobile-input.md

@@ -0,0 +1,12 @@
+# Mobile Input Checklist
+
+- Include `<meta name="viewport" content="width=device-width, initial-scale=1.0">`.
+- Set canvas and touch overlays to `touch-action: none` only where needed.
+- Use Pointer Events when possible.
+- Keep controls reachable with thumbs and away from safe-area edges.
+- Avoid tiny text or buttons below practical touch size.
+- Verify portrait and landscape if both are supported.
+- Check high-DPR canvas scaling and cap DPR if performance suffers.
+- Prevent page scroll/zoom gestures from stealing gameplay input.
+- Test virtual joystick/button release paths when the pointer leaves the control.
+- Verify with Playwright mobile emulation and real hardware when available.

package/dist/skills/zh-CN/game-ui/references/checklists/responsive-ui-fit.md

@@ -0,0 +1,12 @@
+# Responsive UI Fit Checklist
+
+- Desktop, laptop, narrow, and mobile viewports have been checked.
+- Safe-area padding is applied for mobile edges and notches when controls sit near edges.
+- No text clips, overflows, overlaps, or becomes unreadably small.
+- Long labels wrap or compress intentionally without breaking button height.
+- Controls keep stable hit targets and do not shift during score/time/state changes.
+- Layout uses grid/flex/container-aware constraints instead of viewport-only guesses where practical.
+- Menu content remains reachable without hidden offscreen controls.
+- Touch controls are large enough, separated enough, and do not trigger page scroll.
+- Canvas resizing does not desynchronize HUD placement from gameplay framing.
+- Screenshots or Playwright artifacts prove fit at the tested sizes.