evomeme 0.1.9 → 0.1.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/canvas-public/app.js +509 -5999
- package/dist/canvas-public/assets/presets/catalog.json +47 -0
- package/dist/canvas-public/assets/presets/tiles/A_01_CaoDi.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_02_ShaMo.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_03_TianKong.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_04_ShuiBo.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_05_HaiMian.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_06_MuDiBan.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_07_ShiZhuan.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_08_AnRongYan.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_09_QingTaiShi.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_10_ShenHai.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_11_HuiYanShi.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_12_HongTu.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_13_GengDi.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_14_HuoShanYan.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_15_NiTu.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_16_HuangSha.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_17_CongLin.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_18_ZiYanShi.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_19_MoGuTu.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_20_HuaDian.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_21_HaiLang.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_22_GanTu.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_23_QingTaiShiBan.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_24_XingKong.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_25_MoFaFuWen.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_26_ShiTuYeDi.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_27_LanZhuan.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_28_HongZhuan.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_29_YueQiu.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_30_JinShuGe.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_31_JinShuJingGai.png +0 -0
- package/dist/canvas-public/assets/presets/tiles/A_32_ShuZiChuang.png +0 -0
- package/dist/canvas-public/canvas/actions.js +143 -0
- package/dist/canvas-public/canvas/camera.js +28 -0
- package/dist/canvas-public/canvas/chrome.js +13 -0
- package/dist/canvas-public/canvas/data.js +123 -0
- package/dist/canvas-public/canvas/dependencies.js +19 -0
- package/dist/canvas-public/canvas/interactions.js +544 -0
- package/dist/canvas-public/canvas/panel-resize.js +5 -0
- package/dist/canvas-public/canvas/renderer.js +297 -0
- package/dist/canvas-public/canvas/selection.js +62 -0
- package/dist/canvas-public/canvas/serialization.js +118 -0
- package/dist/canvas-public/canvas/sync.js +202 -0
- package/dist/canvas-public/core/api.js +27 -0
- package/dist/canvas-public/core/feature-registry.js +29 -0
- package/dist/canvas-public/core/feature-state.js +228 -0
- package/dist/canvas-public/core/layout.js +133 -0
- package/dist/canvas-public/core/operations.js +38 -0
- package/dist/canvas-public/core/project.js +203 -0
- package/dist/canvas-public/core/state.js +27 -0
- package/dist/canvas-public/dialogs/context-menu.js +118 -0
- package/dist/canvas-public/elements/base.js +100 -0
- package/dist/canvas-public/elements/connections.js +105 -0
- package/dist/canvas-public/elements/drag.js +53 -0
- package/dist/canvas-public/elements/image.js +259 -0
- package/dist/canvas-public/elements/loading-recovery.js +5 -0
- package/dist/canvas-public/elements/loading.js +21 -0
- package/dist/canvas-public/elements/map.js +64 -0
- package/dist/canvas-public/elements/registry.js +58 -0
- package/dist/canvas-public/elements/replacement.js +78 -0
- package/dist/canvas-public/elements/resize.js +210 -0
- package/dist/canvas-public/elements/task-pipeline.js +234 -0
- package/dist/canvas-public/elements/types.js +21 -0
- package/dist/canvas-public/elements/ui.js +14 -0
- package/dist/canvas-public/elements/video.js +64 -0
- package/dist/canvas-public/features/assets/local-assets.js +72 -0
- package/dist/canvas-public/features/assets/official-assets.js +538 -0
- package/dist/canvas-public/features/editing/canvas-size.js +532 -0
- package/dist/canvas-public/features/editing/color-key.js +469 -0
- package/dist/canvas-public/features/editing/cutout.js +20 -0
- package/dist/canvas-public/features/editing/interactive-image-editing.js +981 -0
- package/dist/canvas-public/features/editing/layer-decomposition.js +44 -0
- package/dist/canvas-public/features/editing/manual-split.js +114 -0
- package/dist/canvas-public/features/editing/perfect-pixel.js +336 -0
- package/dist/canvas-public/features/editing/scroll-preview.js +129 -0
- package/dist/canvas-public/features/editing/scroll-seam-elimination.js +71 -0
- package/dist/canvas-public/features/editing/seam-elimination.js +46 -0
- package/dist/canvas-public/features/editing/smart-split.js +48 -0
- package/dist/canvas-public/features/editing/source-preview.js +43 -0
- package/dist/canvas-public/features/editing/video-cycle.js +49 -0
- package/dist/canvas-public/features/editing/video-frames.js +35 -0
- package/dist/canvas-public/features/frame-editor/frame-editing.js +755 -0
- package/dist/canvas-public/features/frame-editor/frame-model.js +63 -0
- package/dist/canvas-public/features/frame-editor/playback.js +83 -0
- package/dist/canvas-public/features/frame-editor/preview.js +149 -0
- package/dist/canvas-public/features/generation/animation.js +272 -0
- package/dist/canvas-public/features/generation/asset-batch.js +102 -0
- package/dist/canvas-public/features/generation/direction.js +163 -0
- package/dist/canvas-public/features/generation/fields.js +73 -0
- package/dist/canvas-public/features/generation/game-ui.js +64 -0
- package/dist/canvas-public/features/generation/image.js +83 -0
- package/dist/canvas-public/features/generation/scroll-image.js +157 -0
- package/dist/canvas-public/features/generation/seamless-tile.js +52 -0
- package/dist/canvas-public/features/generation/tile-transition-atlas.js +79 -0
- package/dist/canvas-public/features/generation/video.js +105 -0
- package/dist/canvas-public/features/map/creation.js +73 -0
- package/dist/canvas-public/features/map/tile-map-editor.js +2518 -0
- package/dist/canvas-public/features/registry.js +59 -0
- package/dist/canvas-public/index.html +84 -259
- package/dist/canvas-public/inspector/controls.js +49 -0
- package/dist/canvas-public/inspector/frame-preview.js +11 -0
- package/dist/canvas-public/inspector/inspector.js +190 -0
- package/dist/canvas-public/inspector/media-inspector.js +517 -0
- package/dist/canvas-public/inspector/media-preview.js +56 -0
- package/dist/canvas-public/inspector/number-stepper.js +96 -0
- package/dist/canvas-public/inspector/resize.js +88 -0
- package/dist/canvas-public/inspector/scroll-preview.js +11 -0
- package/dist/canvas-public/inspector/ui-inspector.js +14 -0
- package/dist/canvas-public/language/en-US.js +1059 -0
- package/dist/canvas-public/language/index.js +79 -0
- package/dist/canvas-public/language/zh-CN.js +1059 -0
- package/dist/canvas-public/map/export.js +9 -0
- package/dist/canvas-public/map/inspector.js +8 -0
- package/dist/canvas-public/map/model.js +409 -0
- package/dist/canvas-public/map/tile-map-editor.js +2 -0
- package/dist/canvas-public/media/metadata.js +183 -0
- package/dist/canvas-public/media/support.js +183 -0
- package/dist/canvas-public/styles/base.css +49 -0
- package/dist/canvas-public/styles/canvas.css +127 -0
- package/dist/canvas-public/styles/controls.css +203 -0
- package/dist/canvas-public/styles/dialogs.css +521 -0
- package/dist/canvas-public/styles/feature-form.css +409 -0
- package/dist/canvas-public/styles/inspector.css +441 -0
- package/dist/canvas-public/styles/layout.css +344 -0
- package/dist/canvas-public/styles/map.css +11 -0
- package/dist/canvas-public/styles/nodes.css +636 -0
- package/dist/canvas-public/styles.css +9 -2247
- package/dist/canvas-public/ui/controls.js +222 -0
- package/dist/canvas-public/ui/elements.js +9 -0
- package/dist/canvas-public/ui/feature-controller.js +296 -0
- package/dist/canvas-public/ui/feature-form.js +401 -0
- package/dist/canvas-public/ui/settings.js +83 -0
- package/dist/canvas-public/ui/toolbar.js +55 -0
- package/dist/canvas-public/vendor/pixi-tilemap.js +126 -0
- package/dist/canvas-public/vendor/pixi.min.js +2340 -0
- package/dist/canvas-public/workers/color-key-worker.js +289 -0
- package/dist/canvas-public/workers/perfect-pixel-worker.js +510 -0
- package/dist/index.js +42236 -13382
- package/dist/skills/en-US/evomeme-canvas/SKILL.md +52 -0
- package/dist/skills/en-US/evomeme-canvas/agents/openai.yaml +7 -0
- package/dist/skills/en-US/evomeme-cloud-fs/SKILL.md +176 -0
- package/dist/skills/en-US/evomeme-cloud-fs/agents/openai.yaml +7 -0
- package/dist/skills/en-US/evomeme-cover/SKILL.md +132 -0
- package/dist/skills/en-US/evomeme-cover/agents/openai.yaml +7 -0
- package/dist/skills/en-US/evomeme-game-maker/SKILL.md +288 -0
- package/dist/skills/en-US/evomeme-game-maker/agents/openai.yaml +4 -0
- package/dist/skills/en-US/evomeme-login/SKILL.md +92 -0
- package/dist/skills/en-US/evomeme-login/agents/openai.yaml +7 -0
- package/dist/skills/en-US/evomeme-native-bridge-sdk/SKILL.md +286 -0
- package/dist/skills/en-US/evomeme-native-bridge-sdk/agents/openai.yaml +8 -0
- package/dist/skills/en-US/evomeme-tos-upload/SKILL.md +47 -0
- package/dist/skills/en-US/evomeme-tos-upload/agents/openai.yaml +5 -0
- package/dist/skills/en-US/evomeme-ui/SKILL.md +123 -0
- package/dist/skills/en-US/evomeme-ui/agents/openai.yaml +4 -0
- package/dist/skills/en-US/evomeme-ui/references/host-layout.md +69 -0
- package/dist/skills/en-US/game-art/SKILL.md +121 -0
- package/dist/skills/en-US/game-art/agents/openai.yaml +8 -0
- package/dist/skills/en-US/game-asset-align/SKILL.md +45 -0
- package/dist/skills/en-US/game-asset-align/agents/openai.yaml +8 -0
- package/dist/skills/en-US/game-asset-align/references/alignment-contract.md +61 -0
- package/dist/skills/en-US/game-asset-align/references/blender-scene-pipeline.md +45 -0
- package/dist/skills/en-US/game-asset-align/references/canonical-package.md +26 -0
- package/dist/skills/en-US/game-asset-align/references/engine-capabilities.md +14 -0
- package/dist/skills/en-US/game-asset-align/references/lightweight-review.md +32 -0
- package/dist/skills/en-US/game-asset-align/references/repair-policy.md +30 -0
- package/dist/skills/en-US/game-asset-align/references/tool-contract.md +39 -0
- package/dist/skills/en-US/game-asset-align/references/visual-review.md +26 -0
- package/dist/skills/en-US/game-asset-image-generator/SKILL.md +104 -0
- package/dist/skills/en-US/game-asset-image-generator/agents/openai.yaml +7 -0
- package/dist/skills/en-US/game-asset-image-generator/references/background.md +32 -0
- package/dist/skills/en-US/game-asset-image-generator/references/static-game-assets.md +38 -0
- package/dist/skills/en-US/game-audio/SKILL.md +82 -0
- package/dist/skills/en-US/game-audio/agents/openai.yaml +4 -0
- package/dist/skills/en-US/game-demo/SKILL.md +103 -0
- package/dist/skills/en-US/game-demo/agents/openai.yaml +7 -0
- package/dist/skills/en-US/game-maker/SKILL.md +111 -0
- package/dist/skills/en-US/game-maker/agents/openai.yaml +4 -0
- package/dist/skills/en-US/game-test/SKILL.md +58 -0
- package/dist/skills/en-US/game-test/agents/openai.yaml +7 -0
- package/dist/skills/en-US/game-ui/SKILL.md +177 -0
- package/dist/skills/en-US/game-ui/agents/openai.yaml +4 -0
- package/dist/skills/en-US/godot-3d-game/SKILL.md +39 -0
- package/dist/skills/en-US/godot-3d-game/agents/openai.yaml +8 -0
- package/dist/skills/en-US/godot-3d-game/references/alignment-gates.md +26 -0
- package/dist/skills/en-US/godot-3d-game/references/appearance-alignment.md +52 -0
- package/dist/skills/en-US/godot-3d-game/references/build-and-qa.md +22 -0
- package/dist/skills/en-US/godot-3d-game/references/canonical-asset-runtime.md +27 -0
- package/dist/skills/en-US/godot-3d-game/references/import-and-wrapper-scenes.md +20 -0
- package/dist/skills/en-US/godot-3d-game/references/physics-colliders.md +13 -0
- package/dist/skills/en-US/godot-3d-game/references/project-structure.md +22 -0
- package/dist/skills/en-US/godot-3d-game/references/skeleton-animation.md +16 -0
- package/dist/skills/en-US/phaser-2d-game/SKILL.md +127 -0
- package/dist/skills/en-US/phaser-2d-game/agents/openai.yaml +8 -0
- package/dist/skills/en-US/phaser-2d-game/references/engine-performance.md +64 -0
- package/dist/skills/en-US/phaser-2d-game/references/engine-physics.md +139 -0
- package/dist/skills/en-US/phaser-2d-game/references/engine-runtime.md +129 -0
- package/dist/skills/en-US/phaser-2d-game/references/engine-spritesheets.md +99 -0
- package/dist/skills/en-US/phaser-2d-game/references/engine-tilemaps.md +80 -0
- package/dist/skills/en-US/phaser-2d-game/references/file-structure.md +94 -0
- package/dist/skills/en-US/phaser-2d-graphics-builder/SKILL.md +68 -0
- package/dist/skills/en-US/phaser-2d-graphics-builder/agents/openai.yaml +7 -0
- package/dist/skills/en-US/threejs-3d-game/SKILL.md +117 -0
- package/dist/skills/en-US/threejs-3d-game/agents/openai.yaml +7 -0
- package/dist/skills/en-US/threejs-3d-game/references/engine-asset-pipeline.md +153 -0
- package/dist/skills/en-US/threejs-3d-game/references/engine-audio.md +70 -0
- package/dist/skills/en-US/threejs-3d-game/references/engine-input-camera.md +84 -0
- package/dist/skills/en-US/threejs-3d-game/references/engine-performance.md +96 -0
- package/dist/skills/en-US/threejs-3d-game/references/engine-physics.md +142 -0
- package/dist/skills/en-US/threejs-3d-game/references/engine-runtime.md +199 -0
- package/dist/skills/en-US/threejs-3d-game/references/file-structure.md +353 -0
- package/dist/skills/en-US/threejs-aaa-graphics-builder/SKILL.md +62 -0
- package/dist/skills/en-US/threejs-aaa-graphics-builder/agents/openai.yaml +7 -0
- package/{skills → dist/skills/zh-CN}/evomeme-cloud-fs/SKILL.md +4 -4
- package/{skills → dist/skills/zh-CN}/evomeme-cover/SKILL.md +1 -1
- package/{skills → dist/skills/zh-CN}/evomeme-game-maker/SKILL.md +91 -88
- package/{skills → dist/skills/zh-CN}/evomeme-tos-upload/SKILL.md +6 -5
- package/dist/skills/zh-CN/evomeme-ui/SKILL.md +123 -0
- package/dist/skills/zh-CN/evomeme-ui/agents/openai.yaml +4 -0
- package/dist/skills/zh-CN/evomeme-ui/references/host-layout.md +69 -0
- package/dist/skills/zh-CN/game-asset-align/SKILL.md +45 -0
- package/dist/skills/zh-CN/game-asset-align/agents/openai.yaml +8 -0
- package/dist/skills/zh-CN/game-asset-align/references/alignment-contract.md +61 -0
- package/dist/skills/zh-CN/game-asset-align/references/blender-scene-pipeline.md +45 -0
- package/dist/skills/zh-CN/game-asset-align/references/canonical-package.md +26 -0
- package/dist/skills/zh-CN/game-asset-align/references/engine-capabilities.md +14 -0
- package/dist/skills/zh-CN/game-asset-align/references/lightweight-review.md +32 -0
- package/dist/skills/zh-CN/game-asset-align/references/repair-policy.md +30 -0
- package/dist/skills/zh-CN/game-asset-align/references/tool-contract.md +39 -0
- package/dist/skills/zh-CN/game-asset-align/references/visual-review.md +26 -0
- package/{skills → dist/skills/zh-CN}/game-asset-image-generator/SKILL.md +1 -1
- package/dist/skills/zh-CN/game-audio/references/bgm-cdn.md +127 -0
- package/dist/skills/zh-CN/game-audio/references/sfx-cdn.md +77 -0
- package/dist/skills/zh-CN/game-test/references/checklists/playtest-qa.md +12 -0
- package/{skills → dist/skills/zh-CN}/game-ui/SKILL.md +9 -1
- package/dist/skills/zh-CN/game-ui/references/checklists/game-ui-quality.md +14 -0
- package/dist/skills/zh-CN/game-ui/references/checklists/hud-readability.md +12 -0
- package/dist/skills/zh-CN/game-ui/references/checklists/mobile-input.md +12 -0
- package/dist/skills/zh-CN/game-ui/references/checklists/responsive-ui-fit.md +12 -0
- package/dist/skills/zh-CN/game-ui/references/ui-patterns.md +140 -0
- package/dist/skills/zh-CN/game-ui/references/ui-prompt-templates.md +63 -0
- package/dist/skills/zh-CN/godot-3d-game/SKILL.md +39 -0
- package/dist/skills/zh-CN/godot-3d-game/agents/openai.yaml +8 -0
- package/dist/skills/zh-CN/godot-3d-game/references/alignment-gates.md +26 -0
- package/dist/skills/zh-CN/godot-3d-game/references/appearance-alignment.md +52 -0
- package/dist/skills/zh-CN/godot-3d-game/references/build-and-qa.md +22 -0
- package/dist/skills/zh-CN/godot-3d-game/references/canonical-asset-runtime.md +27 -0
- package/dist/skills/zh-CN/godot-3d-game/references/import-and-wrapper-scenes.md +20 -0
- package/dist/skills/zh-CN/godot-3d-game/references/physics-colliders.md +13 -0
- package/dist/skills/zh-CN/godot-3d-game/references/project-structure.md +22 -0
- package/dist/skills/zh-CN/godot-3d-game/references/skeleton-animation.md +16 -0
- package/dist/skills/zh-CN/phaser-2d-graphics-builder/assets/scorecard-anchors/scene-1.jpeg +0 -0
- package/dist/skills/zh-CN/phaser-2d-graphics-builder/assets/scorecard-anchors/scene-2.jpeg +0 -0
- package/dist/skills/zh-CN/phaser-2d-graphics-builder/assets/scorecard-anchors/scene-3.jpg +0 -0
- package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/checklists/compose-quality.md +10 -0
- package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/checklists/performance-safe-visual-detail.md +9 -0
- package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/checklists/premium-game-quality-gate.md +15 -0
- package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/checklists/sprite-quality.md +10 -0
- package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/checklists/technical-art-quality.md +9 -0
- package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/checklists/visual-scorecard.md +9 -0
- package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/compose-recipes.md +71 -0
- package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/graphics-prompt-templates.md +33 -0
- package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/implementation-blueprint.md +82 -0
- package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/sprite-recipes.md +90 -0
- package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/technical-art.md +67 -0
- package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/vfx-recipes.md +67 -0
- package/dist/skills/zh-CN/phaser-2d-graphics-builder/references/visual-scorecard.md +129 -0
- package/{skills → dist/skills/zh-CN}/threejs-3d-game/SKILL.md +6 -2
- package/{skills → dist/skills/zh-CN}/threejs-3d-game/references/engine-asset-pipeline.md +52 -15
- package/dist/skills/zh-CN/threejs-aaa-graphics-builder/assets/scorecard-anchors/scene-1.jpg +0 -0
- package/dist/skills/zh-CN/threejs-aaa-graphics-builder/assets/scorecard-anchors/scene-2.jpg +0 -0
- package/dist/skills/zh-CN/threejs-aaa-graphics-builder/assets/scorecard-anchors/scene-3.jpg +0 -0
- package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/checklists/aaa-game-quality-gate.md +23 -0
- package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/checklists/aaa-visual-scorecard.md +19 -0
- package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/checklists/material-lighting-quality.md +14 -0
- package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/checklists/performance-safe-visual-detail.md +14 -0
- package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/checklists/procedural-model-quality.md +15 -0
- package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/checklists/technical-art-quality.md +17 -0
- package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/graphics-prompt-templates.md +236 -0
- package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/implementation-blueprint.md +161 -0
- package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/model-recipes.md +146 -0
- package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/render-recipes.md +90 -0
- package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/shader-cookbook.md +292 -0
- package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/technical-art.md +167 -0
- package/dist/skills/zh-CN/threejs-aaa-graphics-builder/references/visual-scorecard.md +147 -0
- package/dist/stage-blender/bake_materials.py +102 -0
- package/dist/stage-blender/export_scene.py +275 -0
- package/dist/stage-blender/preview_camera.py +90 -0
- package/dist/stage-blender/repair_mesh.py +112 -0
- package/dist/stage-public/app.js +759 -0
- package/dist/stage-public/baked/bakePilot.js +44 -0
- package/dist/stage-public/baked/bakedScene.js +129 -0
- package/dist/stage-public/baked/sceneAppearance.js +225 -0
- package/dist/stage-public/baked/sceneCamera.js +45 -0
- package/dist/stage-public/comparison-contract.js +28 -0
- package/dist/stage-public/delivery.html +4 -0
- package/dist/stage-public/delivery.js +17 -0
- package/dist/stage-public/godot/appearance.gd +170 -0
- package/dist/stage-public/godot/preview.gd +79 -0
- package/dist/stage-public/index.html +141 -0
- package/dist/stage-public/review-app.js +289 -0
- package/dist/stage-public/review-runtime.js +63 -0
- package/dist/stage-public/review.css +24 -0
- package/dist/stage-public/review.html +47 -0
- package/dist/stage-public/scene-runtime.js +212 -0
- package/dist/stage-public/sceneContractRuntime.js +235 -0
- package/dist/stage-public/styles.css +328 -0
- package/dist/stage-public/three-appearance.js +104 -0
- package/dist/stage-public/vendor/three170/LICENSE +21 -0
- package/dist/stage-public/vendor/three170/build/three.module.js +54571 -0
- package/dist/stage-public/vendor/three170/examples/jsm/controls/OrbitControls.js +1523 -0
- package/dist/stage-public/vendor/three170/examples/jsm/environments/RoomEnvironment.js +144 -0
- package/dist/stage-public/vendor/three170/examples/jsm/libs/fflate.module.js +2672 -0
- package/dist/stage-public/vendor/three170/examples/jsm/loaders/EXRLoader.js +2563 -0
- package/dist/stage-public/vendor/three170/examples/jsm/loaders/GLTFLoader.js +4727 -0
- package/dist/stage-public/vendor/three170/examples/jsm/utils/BufferGeometryUtils.js +1373 -0
- package/dist/tile-transition-mask.svg +40 -0
- package/package.json +21 -7
- package/dist/canvas-public/cycle-detect.js +0 -166
- package/dist/canvas-public/smart-split.js +0 -185
- /package/{skills → dist/skills/en-US}/game-audio/references/bgm-cdn.md +0 -0
- /package/{skills → dist/skills/en-US}/game-audio/references/sfx-cdn.md +0 -0
- /package/{skills → dist/skills/en-US}/game-test/references/checklists/playtest-qa.md +0 -0
- /package/{skills → dist/skills/en-US}/game-ui/references/checklists/game-ui-quality.md +0 -0
- /package/{skills → dist/skills/en-US}/game-ui/references/checklists/hud-readability.md +0 -0
- /package/{skills → dist/skills/en-US}/game-ui/references/checklists/mobile-input.md +0 -0
- /package/{skills → dist/skills/en-US}/game-ui/references/checklists/responsive-ui-fit.md +0 -0
- /package/{skills → dist/skills/en-US}/game-ui/references/ui-patterns.md +0 -0
- /package/{skills → dist/skills/en-US}/game-ui/references/ui-prompt-templates.md +0 -0
- /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/assets/scorecard-anchors/scene-1.jpeg +0 -0
- /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/assets/scorecard-anchors/scene-2.jpeg +0 -0
- /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/assets/scorecard-anchors/scene-3.jpg +0 -0
- /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/checklists/compose-quality.md +0 -0
- /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/checklists/performance-safe-visual-detail.md +0 -0
- /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/checklists/premium-game-quality-gate.md +0 -0
- /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/checklists/sprite-quality.md +0 -0
- /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/checklists/technical-art-quality.md +0 -0
- /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/checklists/visual-scorecard.md +0 -0
- /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/compose-recipes.md +0 -0
- /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/graphics-prompt-templates.md +0 -0
- /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/implementation-blueprint.md +0 -0
- /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/sprite-recipes.md +0 -0
- /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/technical-art.md +0 -0
- /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/vfx-recipes.md +0 -0
- /package/{skills → dist/skills/en-US}/phaser-2d-graphics-builder/references/visual-scorecard.md +0 -0
- /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/assets/scorecard-anchors/scene-1.jpg +0 -0
- /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/assets/scorecard-anchors/scene-2.jpg +0 -0
- /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/assets/scorecard-anchors/scene-3.jpg +0 -0
- /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/checklists/aaa-game-quality-gate.md +0 -0
- /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/checklists/aaa-visual-scorecard.md +0 -0
- /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/checklists/material-lighting-quality.md +0 -0
- /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/checklists/performance-safe-visual-detail.md +0 -0
- /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/checklists/procedural-model-quality.md +0 -0
- /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/checklists/technical-art-quality.md +0 -0
- /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/graphics-prompt-templates.md +0 -0
- /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/implementation-blueprint.md +0 -0
- /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/model-recipes.md +0 -0
- /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/render-recipes.md +0 -0
- /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/shader-cookbook.md +0 -0
- /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/technical-art.md +0 -0
- /package/{skills → dist/skills/en-US}/threejs-aaa-graphics-builder/references/visual-scorecard.md +0 -0
- /package/{skills → dist/skills/zh-CN}/evomeme-canvas/SKILL.md +0 -0
- /package/{skills → dist/skills/zh-CN}/evomeme-canvas/agents/openai.yaml +0 -0
- /package/{skills → dist/skills/zh-CN}/evomeme-cloud-fs/agents/openai.yaml +0 -0
- /package/{skills → dist/skills/zh-CN}/evomeme-cover/agents/openai.yaml +0 -0
- /package/{skills → dist/skills/zh-CN}/evomeme-game-maker/agents/openai.yaml +0 -0
- /package/{skills → dist/skills/zh-CN}/evomeme-login/SKILL.md +0 -0
- /package/{skills → dist/skills/zh-CN}/evomeme-login/agents/openai.yaml +0 -0
- /package/{skills → dist/skills/zh-CN}/evomeme-native-bridge-sdk/SKILL.md +0 -0
- /package/{skills → dist/skills/zh-CN}/evomeme-native-bridge-sdk/agents/openai.yaml +0 -0
- /package/{skills → dist/skills/zh-CN}/evomeme-tos-upload/agents/openai.yaml +0 -0
- /package/{skills → dist/skills/zh-CN}/game-art/SKILL.md +0 -0
- /package/{skills → dist/skills/zh-CN}/game-art/agents/openai.yaml +0 -0
- /package/{skills → dist/skills/zh-CN}/game-asset-image-generator/agents/openai.yaml +0 -0
- /package/{skills → dist/skills/zh-CN}/game-asset-image-generator/references/background.md +0 -0
- /package/{skills → dist/skills/zh-CN}/game-asset-image-generator/references/static-game-assets.md +0 -0
- /package/{skills → dist/skills/zh-CN}/game-audio/SKILL.md +0 -0
- /package/{skills → dist/skills/zh-CN}/game-audio/agents/openai.yaml +0 -0
- /package/{skills → dist/skills/zh-CN}/game-demo/SKILL.md +0 -0
- /package/{skills → dist/skills/zh-CN}/game-demo/agents/openai.yaml +0 -0
- /package/{skills → dist/skills/zh-CN}/game-maker/SKILL.md +0 -0
- /package/{skills → dist/skills/zh-CN}/game-maker/agents/openai.yaml +0 -0
- /package/{skills → dist/skills/zh-CN}/game-test/SKILL.md +0 -0
- /package/{skills → dist/skills/zh-CN}/game-test/agents/openai.yaml +0 -0
- /package/{skills → dist/skills/zh-CN}/game-ui/agents/openai.yaml +0 -0
- /package/{skills → dist/skills/zh-CN}/phaser-2d-game/SKILL.md +0 -0
- /package/{skills → dist/skills/zh-CN}/phaser-2d-game/agents/openai.yaml +0 -0
- /package/{skills → dist/skills/zh-CN}/phaser-2d-game/references/engine-performance.md +0 -0
- /package/{skills → dist/skills/zh-CN}/phaser-2d-game/references/engine-physics.md +0 -0
- /package/{skills → dist/skills/zh-CN}/phaser-2d-game/references/engine-runtime.md +0 -0
- /package/{skills → dist/skills/zh-CN}/phaser-2d-game/references/engine-spritesheets.md +0 -0
- /package/{skills → dist/skills/zh-CN}/phaser-2d-game/references/engine-tilemaps.md +0 -0
- /package/{skills → dist/skills/zh-CN}/phaser-2d-game/references/file-structure.md +0 -0
- /package/{skills → dist/skills/zh-CN}/phaser-2d-graphics-builder/SKILL.md +0 -0
- /package/{skills → dist/skills/zh-CN}/phaser-2d-graphics-builder/agents/openai.yaml +0 -0
- /package/{skills → dist/skills/zh-CN}/threejs-3d-game/agents/openai.yaml +0 -0
- /package/{skills → dist/skills/zh-CN}/threejs-3d-game/references/engine-audio.md +0 -0
- /package/{skills → dist/skills/zh-CN}/threejs-3d-game/references/engine-input-camera.md +0 -0
- /package/{skills → dist/skills/zh-CN}/threejs-3d-game/references/engine-performance.md +0 -0
- /package/{skills → dist/skills/zh-CN}/threejs-3d-game/references/engine-physics.md +0 -0
- /package/{skills → dist/skills/zh-CN}/threejs-3d-game/references/engine-runtime.md +0 -0
- /package/{skills → dist/skills/zh-CN}/threejs-3d-game/references/file-structure.md +0 -0
- /package/{skills → dist/skills/zh-CN}/threejs-aaa-graphics-builder/SKILL.md +0 -0
- /package/{skills → dist/skills/zh-CN}/threejs-aaa-graphics-builder/agents/openai.yaml +0 -0
|
@@ -51,7 +51,7 @@ description: 用生图 MCP 生成 9:16 竖屏游戏封面(含大字标题、
|
|
|
51
51
|
| `prompt` | 见下方提示词结构 |
|
|
52
52
|
| `reference_image_url` | 可选 |
|
|
53
53
|
|
|
54
|
-
禁止传入未在工具枚举中的 size(如 `1080x1920`)。`image_model` 仅允许 `asset-pro` / `asset-lite`。
|
|
54
|
+
禁止传入未在工具枚举中的 size(如 `1080x1920`)。`image_model` 仅允许 `asset-max` / `asset-pro` / `asset-lite`。
|
|
55
55
|
|
|
56
56
|
### 提示词结构(必须覆盖)
|
|
57
57
|
|
|
@@ -11,6 +11,8 @@ description: 指导 Agent 创作 evomeme手机平台游戏,在开发过程中
|
|
|
11
11
|
|
|
12
12
|
**具体游戏开发计划**:制定、拆解或更新具体的游戏开发计划时,必须参照`game-maker`开发技能。本技能只提供evomeme平台对游戏的特殊要求。如果用户需要发布到EvoMeme平台,游戏必须满足本技能的要求。
|
|
13
13
|
|
|
14
|
+
**平台 UI 与自适应必读**:开发任何要在 evomeme平台运行、上线或发布的游戏时,必须阅读并遵守 [`evomeme-ui`](../evomeme-ui/SKILL.md)。Agent 需要构造游戏 UI 界面或进行自适应适配时,必须在设计、编码前加载该技能,并按其容器尺寸、安全区规则和测试矩阵执行。
|
|
15
|
+
|
|
14
16
|
## 平台要求
|
|
15
17
|
|
|
16
18
|
### 游戏形态
|
|
@@ -19,13 +21,13 @@ evomeme平台只支持竖屏手机游戏。开发的游戏必须适配竖屏 UI
|
|
|
19
21
|
|
|
20
22
|
#### 竖屏全屏适配
|
|
21
23
|
|
|
22
|
-
|
|
24
|
+
手机端游玩界面必须适配宿主提供的不同竖屏 WebView 尺寸和宽高比,并始终填满实际游戏容器。“全屏”指 WebView 可用区域;不得按手机整屏高度布局或再次扣除宿主栏位及安全区。具体实现和验收遵循 [`evomeme-ui`](../evomeme-ui/SKILL.md):
|
|
23
25
|
|
|
24
26
|
- 禁止使用固定宽高比容器、留黑边、上下或左右加黑条等方式维持设计稿比例。
|
|
25
|
-
- 游戏根容器、渲染画布和背景必须覆盖完整
|
|
27
|
+
- 游戏根容器、渲染画布和背景必须覆盖完整 WebView 游戏区域;页面不得因默认边距、固定尺寸或父容器约束产生未覆盖区域。
|
|
26
28
|
- 当屏幕宽高比与设计稿不同时,通过响应式布局、相机缩放、背景 `cover` 或允许裁切的扩展区域完成适配,不得把整个游玩画面等比缩小后留出黑边。
|
|
27
|
-
- HUD
|
|
28
|
-
- Web 页面应设置正确的移动端 viewport,并让 `html`、`body
|
|
29
|
+
- HUD、按钮和关键交互内容必须根据实际容器尺寸动态布局。可以设置游戏内部留白,但不得再次扣除宿主已经处理的手机安全区,也不得缩小游戏画面或背景的覆盖范围。
|
|
30
|
+
- Web 页面应设置正确的移动端 viewport,并让 `html`、`body`、应用根节点及游戏容器形成完整的 `100%` 高度链;容器尺寸变化时同步更新布局、渲染尺寸和输入映射。
|
|
29
31
|
- 完成开发后必须在多种竖屏尺寸和宽高比下验证:游玩区域全屏覆盖、无黑边、无页面滚动条,且关键 UI 不被裁切或遮挡。
|
|
30
32
|
|
|
31
33
|
### Demo 图片素材
|
|
@@ -57,82 +59,82 @@ evomeme平台只支持竖屏手机游戏。开发的游戏必须适配竖屏 UI
|
|
|
57
59
|
- `src/`:存放主要开发代码。
|
|
58
60
|
- `index.html`:作为游戏工程的网页入口。
|
|
59
61
|
|
|
60
|
-
#### 代码依赖与发布路径
|
|
61
|
-
|
|
62
|
-
**强制交付门槛:** 只有生产构建命令(通常为 `npm run build`)以退出码 `0` 完成,生成真实且非空的 `dist/`,其中存在 `dist/index.html` 和全部被引用的本地文件,并通过本节的构建后路径检查,游戏任务才算完成。仅修改源码、开发服务器可运行、截图正常或推测“应该可以构建”,均不能作为交付结果。任一条件不满足时,必须继续修复、重新构建并重新检查。
|
|
63
|
-
|
|
64
|
-
最终 `dist/` 可能被部署到任意 URL 子路径,不保证位于域名根目录。所有本地运行时引用都必须相对于当前文档或构建产物:
|
|
65
|
-
|
|
66
|
-
- 项目内代码依赖使用 `./` 或 `../`;禁止写入本机绝对路径、工作区绝对路径、`file://` 地址或只能由开发服务器解析的源码 URL。
|
|
67
|
-
- HTML 的本地 `src`、`href`、`poster`、`srcset`,CSS 的本地 `url(...)`,以及 JavaScript 的 `fetch()`、动态 `import()`、Worker、音频和其他本地资源地址,必须使用 `./...` 或等价相对路径。
|
|
68
|
-
- 严禁任何以单个 `/` 开头的本地根绝对路径,例如 `/assets/...`、`/asset/...`、`/config.json`、`/src/...`。应分别写为 `./assets/...`、`./asset/...`、`./config.json`、`./src/...`。
|
|
69
|
-
- 禁止通过 `location.origin`、`new URL(path, location.origin)` 或其他字符串拼接方式重新构造根绝对本地地址。
|
|
70
|
-
- 可公开访问的 `http://`、`https://` 远程 URL 不受本地相对路径规则限制。
|
|
71
|
-
- 修改现有项目时保留与任务无关的架构,但只要最终 `dist/` 仍包含根绝对本地引用,就必须做最小修复,不能交付。
|
|
72
|
-
|
|
73
|
-
##### Vite 基址(强制)
|
|
74
|
-
|
|
75
|
-
新建 Vite 项目必须创建 Vite 配置并显式设置 `base: './'`,不得依赖 Vite 默认值 `/`。React 项目示例:
|
|
76
|
-
|
|
77
|
-
```js
|
|
78
|
-
import { defineConfig } from 'vite';
|
|
79
|
-
import react from '@vitejs/plugin-react';
|
|
80
|
-
|
|
81
|
-
export default defineConfig({
|
|
82
|
-
plugins: [react()],
|
|
83
|
-
base: './',
|
|
84
|
-
});
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
其他构建工具必须设置等价的相对发布基路径。
|
|
88
|
-
|
|
89
|
-
##### 新建 React + Vite 项目的完整 `index.html`(强制)
|
|
90
|
-
|
|
91
|
-
新建 React + Vite 项目必须使用以下源码入口格式。JavaScript 项目使用 `./src/main.jsx`;TypeScript 项目只将其替换为 `./src/main.tsx`。入口禁止写成 `/src/main.jsx` 或 `/src/main.tsx`。
|
|
92
|
-
|
|
93
|
-
```html
|
|
94
|
-
<!doctype html>
|
|
95
|
-
<html lang="zh-CN">
|
|
96
|
-
<head>
|
|
97
|
-
<meta charset="UTF-8" />
|
|
98
|
-
<meta
|
|
99
|
-
name="viewport"
|
|
100
|
-
content="width=device-width,initial-scale=1,viewport-fit=cover,user-scalable=no"
|
|
101
|
-
/>
|
|
102
|
-
<meta name="theme-color" content="#000000" />
|
|
103
|
-
<title>游戏名称</title>
|
|
104
|
-
</head>
|
|
105
|
-
<body>
|
|
106
|
-
<div id="root"></div>
|
|
107
|
-
<script type="module" src="./src/main.jsx"></script>
|
|
108
|
-
</body>
|
|
109
|
-
</html>
|
|
110
|
-
```
|
|
111
|
-
|
|
112
|
-
CSS 应从入口模块通过 `import './style.css'` 等相对路径导入,不要在源码 `index.html` 中预写或猜测带哈希的构建文件名。Vite 构建后的 `dist/index.html` 必须使用相对构建资源路径,例如:
|
|
113
|
-
|
|
114
|
-
```html
|
|
115
|
-
<script type="module" crossorigin src="./assets/index-HASH.js"></script>
|
|
116
|
-
<link rel="stylesheet" crossorigin href="./assets/index-HASH.css">
|
|
117
|
-
```
|
|
118
|
-
|
|
119
|
-
`HASH` 代表 Vite 实际生成的哈希,不能硬编码。
|
|
120
|
-
|
|
121
|
-
##### `dist/` 完整性和路径检查(阻断交付)
|
|
122
|
-
|
|
123
|
-
每次生产构建完成后、宣布成功前,必须直接检查 `dist/index.html` 以及它引用的 JavaScript、CSS 和其他文本产物:
|
|
124
|
-
|
|
125
|
-
1. 确认构建命令退出码为 `0`。
|
|
126
|
-
2. 确认 `dist/` 真实存在且非空,并确认 `dist/index.html` 存在。
|
|
127
|
-
3. 解析或逐一核对 `dist/index.html` 中的本地引用,确认每个目标文件真实存在于 `dist/` 内。
|
|
128
|
-
4. 扫描 `dist/index.html`、构建后的 JavaScript 和 CSS,不得出现指向本地资源的 `src="/`、`src='/`、`href="/`、`href='/`、`poster="/`、`poster='/`、`url(/`、`fetch('/`、`fetch("/`、`import('/`、`import("/`、`new Worker('/`、`new Worker("/` 或等价根绝对形式。
|
|
129
|
-
5. 明确检查并禁止 `/assets/...`、`/asset/...`、`/config.json`、`/src/...`;它们必须改为 `./assets/...`、`./asset/...`、`./config.json`、`./src/...` 或其他正确的相对路径。
|
|
130
|
-
6. 检查 `dist/` 中不存在对 `src/`、`public/`、项目根目录、工作区文件、`localhost`、Vite 开发服务器、`.ts`、`.tsx` 或其他未构建源码的运行时依赖。
|
|
131
|
-
7. 发现任何违规引用、缺失文件或不完整产物时,构建即判定无效;修复后必须重新执行生产构建,并从第 1 步重新检查。不能因为构建命令曾经退出码为 `0` 就跳过复查。
|
|
132
|
-
|
|
133
|
-
`dist/` 必须是可以独立部署的完整运行目录。`dist/index.html`、构建后的 JavaScript、CSS 和配置只能依赖 `dist/` 内文件或公开远程 URL。`dist/` 内禁止存在图片、视频、音频、字体、模型等二进制文件;这些素材必须通过公开 URL 接入。禁止通过复制源码到 `dist/` 规避构建,源码依赖必须在生产构建中正确解析和打包。
|
|
134
|
-
|
|
135
|
-
发布前还必须以 `dist/` 为静态服务根目录启动预览,并在该地址验证启动、资源加载和完整核心流程。开发服务器可以用于开发,但不能作为发布验收证据。
|
|
62
|
+
#### 代码依赖与发布路径
|
|
63
|
+
|
|
64
|
+
**强制交付门槛:** 只有生产构建命令(通常为 `npm run build`)以退出码 `0` 完成,生成真实且非空的 `dist/`,其中存在 `dist/index.html` 和全部被引用的本地文件,并通过本节的构建后路径检查,游戏任务才算完成。仅修改源码、开发服务器可运行、截图正常或推测“应该可以构建”,均不能作为交付结果。任一条件不满足时,必须继续修复、重新构建并重新检查。
|
|
65
|
+
|
|
66
|
+
最终 `dist/` 可能被部署到任意 URL 子路径,不保证位于域名根目录。所有本地运行时引用都必须相对于当前文档或构建产物:
|
|
67
|
+
|
|
68
|
+
- 项目内代码依赖使用 `./` 或 `../`;禁止写入本机绝对路径、工作区绝对路径、`file://` 地址或只能由开发服务器解析的源码 URL。
|
|
69
|
+
- HTML 的本地 `src`、`href`、`poster`、`srcset`,CSS 的本地 `url(...)`,以及 JavaScript 的 `fetch()`、动态 `import()`、Worker、音频和其他本地资源地址,必须使用 `./...` 或等价相对路径。
|
|
70
|
+
- 严禁任何以单个 `/` 开头的本地根绝对路径,例如 `/assets/...`、`/asset/...`、`/config.json`、`/src/...`。应分别写为 `./assets/...`、`./asset/...`、`./config.json`、`./src/...`。
|
|
71
|
+
- 禁止通过 `location.origin`、`new URL(path, location.origin)` 或其他字符串拼接方式重新构造根绝对本地地址。
|
|
72
|
+
- 可公开访问的 `http://`、`https://` 远程 URL 不受本地相对路径规则限制。
|
|
73
|
+
- 修改现有项目时保留与任务无关的架构,但只要最终 `dist/` 仍包含根绝对本地引用,就必须做最小修复,不能交付。
|
|
74
|
+
|
|
75
|
+
##### Vite 基址(强制)
|
|
76
|
+
|
|
77
|
+
新建 Vite 项目必须创建 Vite 配置并显式设置 `base: './'`,不得依赖 Vite 默认值 `/`。React 项目示例:
|
|
78
|
+
|
|
79
|
+
```js
|
|
80
|
+
import { defineConfig } from 'vite';
|
|
81
|
+
import react from '@vitejs/plugin-react';
|
|
82
|
+
|
|
83
|
+
export default defineConfig({
|
|
84
|
+
plugins: [react()],
|
|
85
|
+
base: './',
|
|
86
|
+
});
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
其他构建工具必须设置等价的相对发布基路径。
|
|
90
|
+
|
|
91
|
+
##### 新建 React + Vite 项目的完整 `index.html`(强制)
|
|
92
|
+
|
|
93
|
+
新建 React + Vite 项目必须使用以下源码入口格式。JavaScript 项目使用 `./src/main.jsx`;TypeScript 项目只将其替换为 `./src/main.tsx`。入口禁止写成 `/src/main.jsx` 或 `/src/main.tsx`。
|
|
94
|
+
|
|
95
|
+
```html
|
|
96
|
+
<!doctype html>
|
|
97
|
+
<html lang="zh-CN">
|
|
98
|
+
<head>
|
|
99
|
+
<meta charset="UTF-8" />
|
|
100
|
+
<meta
|
|
101
|
+
name="viewport"
|
|
102
|
+
content="width=device-width,initial-scale=1,viewport-fit=cover,user-scalable=no"
|
|
103
|
+
/>
|
|
104
|
+
<meta name="theme-color" content="#000000" />
|
|
105
|
+
<title>游戏名称</title>
|
|
106
|
+
</head>
|
|
107
|
+
<body>
|
|
108
|
+
<div id="root"></div>
|
|
109
|
+
<script type="module" src="./src/main.jsx"></script>
|
|
110
|
+
</body>
|
|
111
|
+
</html>
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
CSS 应从入口模块通过 `import './style.css'` 等相对路径导入,不要在源码 `index.html` 中预写或猜测带哈希的构建文件名。Vite 构建后的 `dist/index.html` 必须使用相对构建资源路径,例如:
|
|
115
|
+
|
|
116
|
+
```html
|
|
117
|
+
<script type="module" crossorigin src="./assets/index-HASH.js"></script>
|
|
118
|
+
<link rel="stylesheet" crossorigin href="./assets/index-HASH.css">
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
`HASH` 代表 Vite 实际生成的哈希,不能硬编码。
|
|
122
|
+
|
|
123
|
+
##### `dist/` 完整性和路径检查(阻断交付)
|
|
124
|
+
|
|
125
|
+
每次生产构建完成后、宣布成功前,必须直接检查 `dist/index.html` 以及它引用的 JavaScript、CSS 和其他文本产物:
|
|
126
|
+
|
|
127
|
+
1. 确认构建命令退出码为 `0`。
|
|
128
|
+
2. 确认 `dist/` 真实存在且非空,并确认 `dist/index.html` 存在。
|
|
129
|
+
3. 解析或逐一核对 `dist/index.html` 中的本地引用,确认每个目标文件真实存在于 `dist/` 内。
|
|
130
|
+
4. 扫描 `dist/index.html`、构建后的 JavaScript 和 CSS,不得出现指向本地资源的 `src="/`、`src='/`、`href="/`、`href='/`、`poster="/`、`poster='/`、`url(/`、`fetch('/`、`fetch("/`、`import('/`、`import("/`、`new Worker('/`、`new Worker("/` 或等价根绝对形式。
|
|
131
|
+
5. 明确检查并禁止 `/assets/...`、`/asset/...`、`/config.json`、`/src/...`;它们必须改为 `./assets/...`、`./asset/...`、`./config.json`、`./src/...` 或其他正确的相对路径。
|
|
132
|
+
6. 检查 `dist/` 中不存在对 `src/`、`public/`、项目根目录、工作区文件、`localhost`、Vite 开发服务器、`.ts`、`.tsx` 或其他未构建源码的运行时依赖。
|
|
133
|
+
7. 发现任何违规引用、缺失文件或不完整产物时,构建即判定无效;修复后必须重新执行生产构建,并从第 1 步重新检查。不能因为构建命令曾经退出码为 `0` 就跳过复查。
|
|
134
|
+
|
|
135
|
+
`dist/` 必须是可以独立部署的完整运行目录。`dist/index.html`、构建后的 JavaScript、CSS 和配置只能依赖 `dist/` 内文件或公开远程 URL。`dist/` 内禁止存在图片、视频、音频、字体、模型等二进制文件;这些素材必须通过公开 URL 接入。禁止通过复制源码到 `dist/` 规避构建,源码依赖必须在生产构建中正确解析和打包。
|
|
136
|
+
|
|
137
|
+
发布前还必须以 `dist/` 为静态服务根目录启动预览,并在该地址验证启动、资源加载和完整核心流程。开发服务器可以用于开发,但不能作为发布验收证据。
|
|
136
138
|
|
|
137
139
|
#### `/public/config.json` 规则
|
|
138
140
|
|
|
@@ -256,20 +258,21 @@ key 以 `_` 开头,用于内部配置、资源映射、版本号和调试开
|
|
|
256
258
|
仅在准备提交或发布游戏时检查以下事项:
|
|
257
259
|
|
|
258
260
|
- [ ] 游戏使用竖屏 UI 布局,并支持触屏操作。
|
|
259
|
-
- [ ]
|
|
261
|
+
- [ ] 已阅读并遵守 `evomeme-ui`,至少通过 375×524、402×646、412×732 三档游戏容器尺寸及运行中尺寸变化验证。
|
|
262
|
+
- [ ] 在不同竖屏尺寸和宽高比下,游玩界面均填满宿主 WebView,无任何黑边或未覆盖区域,未重复扣除原生栏位及安全区,关键 UI 保持可见可操作。
|
|
260
263
|
- [ ] Demo 不包含 SVG、线条绘制或大面积纯色游戏素材;所需游戏图片均已通过图片生成获得并实际接入。
|
|
261
264
|
- [ ] 根目录包含 `dist/`、`public/config.json`、`src/` 和 `index.html`。
|
|
262
265
|
- [ ] `public/config.json` 可解析、符合配置 schema,并在构建后原样输出为 `dist/config.json`。
|
|
263
266
|
- [ ] `public/config.json` 以公开链接记录游戏使用的二进制素材。
|
|
264
267
|
- [ ] 本地二进制文件路径已加入 `.evomemeignore`。
|
|
265
268
|
- [ ] `.evomemeignore` 保持 `dist/` 在提交范围内。
|
|
266
|
-
- [ ] `dist/` 来自完成资源链接替换后的最新生产构建。
|
|
267
|
-
- [ ] 生产构建命令以退出码 `0` 完成,`dist/` 非空并包含 `dist/index.html`。
|
|
268
|
-
- [ ] 新建 Vite 项目显式设置 `base: './'`;源码 `index.html` 使用 `./src/main.jsx` 或 `./src/main.tsx`。
|
|
269
|
-
- [ ] `dist/index.html` 中引用的每个本地文件均真实存在于 `dist/` 内。
|
|
270
|
-
- [ ] 已扫描 `dist/index.html` 及其引用的 JavaScript、CSS;不存在 `src="/`、`href="/`、`url(/`、`fetch('/`、`fetch("/`、`/assets/`、`/asset/`、`/config.json`、`/src/` 或等价根绝对本地引用。
|
|
271
|
-
- [ ] 构建使用相对发布基路径;运行时配置和资源使用 `./...` 或等价相对 URL,不依赖域名根路径,也不通过 `location.origin` 重建根路径。
|
|
272
|
-
- [ ] `dist/` 可独立部署,且其中没有对 `src/`、`public/`、项目根目录、`localhost`、开发服务器或未构建源码的运行时依赖。
|
|
269
|
+
- [ ] `dist/` 来自完成资源链接替换后的最新生产构建。
|
|
270
|
+
- [ ] 生产构建命令以退出码 `0` 完成,`dist/` 非空并包含 `dist/index.html`。
|
|
271
|
+
- [ ] 新建 Vite 项目显式设置 `base: './'`;源码 `index.html` 使用 `./src/main.jsx` 或 `./src/main.tsx`。
|
|
272
|
+
- [ ] `dist/index.html` 中引用的每个本地文件均真实存在于 `dist/` 内。
|
|
273
|
+
- [ ] 已扫描 `dist/index.html` 及其引用的 JavaScript、CSS;不存在 `src="/`、`href="/`、`url(/`、`fetch('/`、`fetch("/`、`/assets/`、`/asset/`、`/config.json`、`/src/` 或等价根绝对本地引用。
|
|
274
|
+
- [ ] 构建使用相对发布基路径;运行时配置和资源使用 `./...` 或等价相对 URL,不依赖域名根路径,也不通过 `location.origin` 重建根路径。
|
|
275
|
+
- [ ] `dist/` 可独立部署,且其中没有对 `src/`、`public/`、项目根目录、`localhost`、开发服务器或未构建源码的运行时依赖。
|
|
273
276
|
- [ ] 已以 `dist/` 为静态服务根目录完成预览,游戏能够启动、加载资源并跑通核心流程。
|
|
274
277
|
- [ ] 提交文件集合只包含 UTF-8 文本文件。
|
|
275
278
|
- [ ] 发布过程遵循 `evomeme-cloud-fs`。
|
|
@@ -1,15 +1,15 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: evomeme-tos-upload
|
|
3
|
-
description: 通过 evomeme_upload_game_asset
|
|
3
|
+
description: 通过 evomeme_upload_game_asset 将受支持的本地图片、音频、视频或常见 3D 模型上传到 evomemeTOS,内容审核通过后获取公开 asset_url。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# evomeme-tos-upload
|
|
7
7
|
|
|
8
8
|
## Purpose
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
将受支持的本地图片、音频、视频或常见 3D 模型上传到 evomemeTOS,拿到公开可访问的 `asset_url`。
|
|
11
11
|
|
|
12
|
-
- 调用主 MCP(`evomeme`)工具 **`evomeme_upload_game_asset`**;plugin_client
|
|
12
|
+
- 调用主 MCP(`evomeme`)工具 **`evomeme_upload_game_asset`**;plugin_client 按后缀选择图片 / 模型同步接口或统一音视频接口并提交原始字节,由服务端上传 TOS。只有通过内容安全审核后才会返回链接。
|
|
13
13
|
- 不要手写 AK/SK,不要伪造 CDN 地址,不要把二进制直接塞进源码仓库。
|
|
14
14
|
|
|
15
15
|
允许的后缀只有:
|
|
@@ -17,8 +17,9 @@ description: 通过 evomeme_upload_game_asset 将受支持的本地图片、音
|
|
|
17
17
|
- 图片:PNG、JPG、JPEG、BMP、WEBP、TIFF、SVG、GIF、ICO、HEIC
|
|
18
18
|
- 音频:MP3、WAV、AAC、WMA、OGG、M4A、AMR
|
|
19
19
|
- 视频:AVI、FLV、MP4、MPG、ASF、WMV、MOV、WMA、RMVB、RM、FLASH、TS、M3U8
|
|
20
|
+
- 模型:GLB、GLTF、FBX、OBJ、STL(有外部贴图或缓冲文件时建议先打包为 GLB)
|
|
20
21
|
|
|
21
|
-
|
|
22
|
+
字体、压缩包和其他未列出的类型禁止上传。WMA 按音频处理。图片与模型同步审核;音频与视频异步轮询审核。
|
|
22
23
|
|
|
23
24
|
## Upload Workflow
|
|
24
25
|
|
|
@@ -32,7 +33,7 @@ description: 通过 evomeme_upload_game_asset 将受支持的本地图片、音
|
|
|
32
33
|
|
|
33
34
|
成功时工具返回公开可访问的 `asset_url`。
|
|
34
35
|
|
|
35
|
-
|
|
36
|
+
本地图片 / 音视频 / 常见 3D 模型需要公开 URL 时走本上传流程;未列出的类型不支持。
|
|
36
37
|
|
|
37
38
|
## Non-Negotiables
|
|
38
39
|
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: evomeme-ui
|
|
3
|
+
description: 规定 evomeme平台游戏的 WebView 容器适配、UI 布局和多尺寸验收要求。开发任何计划在 evomeme平台运行、上线或发布的游戏时必须阅读;创建或修改 HUD、菜单、弹窗、触控区域、Canvas 尺寸和响应式布局时必须遵守。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# evomeme 游戏 UI 与自适应
|
|
7
|
+
|
|
8
|
+
## 必读范围
|
|
9
|
+
|
|
10
|
+
凡是要在 evomeme平台运行、上线或发布的游戏,在开始开发、迁移或改造前必须阅读本技能。构造游戏 UI、修改布局或处理自适应问题时,必须按本技能执行,不能等到发布阶段才补做适配。
|
|
11
|
+
|
|
12
|
+
本技能规定平台容器与布局约束。游戏整体工程要求遵循 [`evomeme-game-maker`](../evomeme-game-maker/SKILL.md);需要 UI 风格、信息层级或概念设计时结合 [`game-ui`](../game-ui/SKILL.md)。evomeme游戏的尺寸来源、安全区处理和适配验收以本技能为准。
|
|
13
|
+
|
|
14
|
+
## 宿主容器约定
|
|
15
|
+
|
|
16
|
+
**游戏运行在 App 已经计算完成的 WebView 可用区域内。游戏的“全屏”是填满这个区域。**
|
|
17
|
+
|
|
18
|
+
1. 使用游戏容器实时的 `clientWidth`、`clientHeight` 或 `ResizeObserver` 测量结果作为布局依据;不得根据手机完整屏幕高度计算游戏高度。
|
|
19
|
+
2. 不得再次扣除 App Tab Bar、游戏信息及操作区或手机安全区。不得将宿主原生层的 `3.75rem`、`4.5rem`、`8.25rem` 用于游戏网页布局。
|
|
20
|
+
3. 游戏根节点、渲染画布和背景必须填满 WebView 容器,不得用固定宽高比容器、黑边或整幅等比缩小维持设计稿比例。
|
|
21
|
+
4. 背景可以裁剪或延展;核心角色、HUD、文字、按钮和游戏判定区域必须保持可见、可操作。不得只按设计稿屏幕边缘的固定绝对坐标摆放关键内容。
|
|
22
|
+
5. 容器尺寸变化时,重新计算布局、相机或可玩区域、Canvas 渲染尺寸及触控坐标映射。页面不得出现由布局溢出造成的滚动条。
|
|
23
|
+
6. App 原生层 NativeWind 的动态 `rem` 不会自动传入 WebView。网页 CSS 的 `rem` 由网页根字号决定;逻辑尺寸使用 CSS px,不能直接使用设备物理分辨率。
|
|
24
|
+
|
|
25
|
+
需要理解原生扣减公式、402px 设计基准或完整设备估算表时,读取 [`references/host-layout.md`](references/host-layout.md)。这些资料仅用于设计与测试,不得据此在游戏运行时硬编码高度。
|
|
26
|
+
|
|
27
|
+
## 设计与布局
|
|
28
|
+
|
|
29
|
+
以 **402×646 CSS px** 为主要设计基准。典型 WebView 宽高比约为 **1:1.60~1:1.78**,极端短屏约为 **1:1.40**;这些是测试参考,不能作为运行时尺寸限制。
|
|
30
|
+
|
|
31
|
+
- 先在短屏中保证核心玩法、主要按钮和必要文字完整,再利用较高容器增加背景延展、元素间距或可玩区域。
|
|
32
|
+
- HUD、菜单、弹窗和触控区域使用容器内的锚点、相对布局或响应式约束;内容长度变化后仍需保持可见和可点击。
|
|
33
|
+
- 游戏内部可以有视觉留白和触控间距,但不得以“安全区适配”为由再次扣除宿主已经处理的手机安全区。
|
|
34
|
+
- 背景裁切区域与关键内容区分开处理;不能为了铺满背景而裁掉角色、按钮或判定区域。
|
|
35
|
+
- 全屏背景、DOM UI、游戏相机和输入坐标共用同一套容器尺寸,避免画面已经缩放而按钮或命中区域仍停留在旧坐标。
|
|
36
|
+
|
|
37
|
+
## Web 页面基础样式
|
|
38
|
+
|
|
39
|
+
设置移动端 viewport,例如:
|
|
40
|
+
|
|
41
|
+
```html
|
|
42
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
让尺寸从 WebView 逐层传递到游戏根容器。下面的 `#root`、`#game-root` 应对应项目实际挂载节点;有额外包装层时,也必须保证高度链完整。
|
|
46
|
+
|
|
47
|
+
```css
|
|
48
|
+
html,
|
|
49
|
+
body,
|
|
50
|
+
#root {
|
|
51
|
+
width: 100%;
|
|
52
|
+
height: 100%;
|
|
53
|
+
min-height: 0;
|
|
54
|
+
margin: 0;
|
|
55
|
+
overflow: hidden;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
#game-root {
|
|
59
|
+
position: relative;
|
|
60
|
+
width: 100%;
|
|
61
|
+
height: 100%;
|
|
62
|
+
min-height: 0;
|
|
63
|
+
overflow: hidden;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
#game-root canvas {
|
|
67
|
+
display: block;
|
|
68
|
+
width: 100%;
|
|
69
|
+
height: 100%;
|
|
70
|
+
touch-action: none;
|
|
71
|
+
}
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
不得使用 `100vh - App栏高度 - safe-area-inset` 一类公式再次扣减宿主布局。`overflow: hidden` 只用于控制页面滚动,不能用它掩盖关键内容超出容器的问题。
|
|
75
|
+
|
|
76
|
+
## Canvas 与引擎尺寸同步
|
|
77
|
+
|
|
78
|
+
监听游戏容器,而不是只在启动时读取一次窗口尺寸。下面示例说明尺寸分层;`resizeGameLayout` 代表项目实际的布局更新函数,必须接入 UI、可玩区域和输入映射更新。
|
|
79
|
+
|
|
80
|
+
```js
|
|
81
|
+
const container = document.querySelector('#game-root');
|
|
82
|
+
const canvas = container.querySelector('canvas');
|
|
83
|
+
|
|
84
|
+
const observer = new ResizeObserver(([entry]) => {
|
|
85
|
+
const { width, height } = entry.contentRect;
|
|
86
|
+
if (width <= 0 || height <= 0) return;
|
|
87
|
+
const dpr = Math.min(window.devicePixelRatio || 1, 2);
|
|
88
|
+
|
|
89
|
+
canvas.style.width = `${width}px`;
|
|
90
|
+
canvas.style.height = `${height}px`;
|
|
91
|
+
canvas.width = Math.round(width * dpr);
|
|
92
|
+
canvas.height = Math.round(height * dpr);
|
|
93
|
+
|
|
94
|
+
// 逻辑布局使用 CSS px;渲染缓冲区使用乘以 DPR 后的尺寸。
|
|
95
|
+
resizeGameLayout(width, height, dpr);
|
|
96
|
+
});
|
|
97
|
+
|
|
98
|
+
observer.observe(container);
|
|
99
|
+
// 在组件卸载或场景销毁时调用 observer.disconnect()。
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Phaser、Three.js 或其他引擎项目应通过现有引擎的 resize、相机和像素比接口实现同等行为,避免绕过引擎重复管理画布。使用原生 Canvas 2D 时,调整画布宽高后需恢复绘图变换和状态。建议限制 DPR 上限,避免高分辨率设备产生过大的渲染缓冲区。
|
|
103
|
+
|
|
104
|
+
## 必须完成的适配验收
|
|
105
|
+
|
|
106
|
+
至少以以下三档**游戏容器尺寸**验证;无需再从这些高度中扣除宿主 UI:
|
|
107
|
+
|
|
108
|
+
| 测试目的 | 容器尺寸(CSS px) | 核心检查 |
|
|
109
|
+
| --- | --- | --- |
|
|
110
|
+
| 最小可用高度 | 375×524 | 核心玩法、HUD、弹窗和主要操作不溢出、不遮挡 |
|
|
111
|
+
| 标准设计基准 | 402×646 | 主要视觉、信息层级和交互流程完整 |
|
|
112
|
+
| Android 长屏 | 412×732 | 背景延展、纵向布局和触控坐标保持正确 |
|
|
113
|
+
|
|
114
|
+
开发时可以使用浏览器或嵌入容器模拟;交付前以实际生产构建的 `dist/` 验证主要状态,并覆盖一次运行中的容器尺寸变化。
|
|
115
|
+
|
|
116
|
+
- [ ] 根容器、Canvas 和背景始终填满 WebView,无黑边或未覆盖区域。
|
|
117
|
+
- [ ] 没有使用手机整屏高度、固定宽高比或重复扣减原生栏位及安全区。
|
|
118
|
+
- [ ] 三档尺寸下关键角色、按钮、文字、HUD 和判定区域完整可见。
|
|
119
|
+
- [ ] 开始、游玩、暂停、结算及游戏实际提供的其他主要界面都能操作。
|
|
120
|
+
- [ ] 缩放或尺寸变化后,UI、画面和触控命中区域保持一致。
|
|
121
|
+
- [ ] 页面无意外滚动条,未用裁切隐藏关键内容溢出。
|
|
122
|
+
|
|
123
|
+
交付时说明实际验证的尺寸、界面状态与结果。若未能进行真机或宿主 WebView 验证,应明确该验证范围;不能将浏览器模拟描述为真机验收。
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
# 宿主原生布局与 WebView 尺寸参考
|
|
2
|
+
|
|
3
|
+
本资料整理自项目的《游戏 WebView 多设备尺寸适配规范》。用于理解设计基准、估算可用区域和建立测试矩阵。游戏运行时始终使用容器实时测量值,不能将以下原生公式移植到网页中再次扣减高度。
|
|
4
|
+
|
|
5
|
+
## 402px 设计基准与原生 rem
|
|
6
|
+
|
|
7
|
+
App 设计基准宽度为 402px,在该宽度下 `1rem = 16`。这里的设计尺寸对应 React Native 布局逻辑单位 dp,不是设备物理像素。
|
|
8
|
+
|
|
9
|
+
原生层在 `app/_layout.tsx` 中按设备窗口逻辑宽度 `W` 调整 NativeWind 的 rem:
|
|
10
|
+
|
|
11
|
+
```text
|
|
12
|
+
缩放比例 S = W / 402
|
|
13
|
+
原生 1rem = 16 × W / 402
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
| 窗口宽度 W | 原生 1rem(约) |
|
|
17
|
+
| ---: | ---: |
|
|
18
|
+
| 360 | 14.33 |
|
|
19
|
+
| 375 | 14.93 |
|
|
20
|
+
| 393 | 15.64 |
|
|
21
|
+
| 402 | 16.00 |
|
|
22
|
+
| 430 | 17.11 |
|
|
23
|
+
|
|
24
|
+
WebView 内网页的 CSS rem 取决于网页自己的根字号,默认通常为 16 CSS px,不会继承上述 NativeWind 动态 rem。
|
|
25
|
+
|
|
26
|
+
## 原生层游戏区域估算
|
|
27
|
+
|
|
28
|
+
```text
|
|
29
|
+
H_game ≈ H_window - safeTop - safeBottom - 8.25rem
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
| 原生区域 | NativeWind 尺寸 | 402px 基准下的逻辑高度 |
|
|
33
|
+
| --- | --- | ---: |
|
|
34
|
+
| Tab Bar 主体 | h-13 / 3.25rem | 52 |
|
|
35
|
+
| Tab Bar 上下间距 | py-1 × 2 / 0.5rem | 8 |
|
|
36
|
+
| 完整 Tab Bar | 3.75rem | 60 |
|
|
37
|
+
| 游戏信息及操作区 | h-18 / 4.5rem | 72 |
|
|
38
|
+
| 固定扣减合计 | 8.25rem | 132 |
|
|
39
|
+
|
|
40
|
+
原生 rem 随宽度缩放,因此:
|
|
41
|
+
|
|
42
|
+
```text
|
|
43
|
+
固定扣减高度 = 8.25 × 16 × W / 402
|
|
44
|
+
= 132 × W / 402
|
|
45
|
+
≈ 0.32836W
|
|
46
|
+
|
|
47
|
+
预计 WebView 宽度 = W
|
|
48
|
+
预计 WebView 高度 ≈ H - safeTop - safeBottom - 0.32836W
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
W 为 360、375、393、402、430 时,固定扣减高度分别约为 118.2、123.1、129.0、132、141.2 个逻辑单位。宿主已经完成这些扣减,游戏内部直接填充 WebView。
|
|
52
|
+
|
|
53
|
+
## 设备估算矩阵
|
|
54
|
+
|
|
55
|
+
以下是原规范给出的代表设备与安全区假设,不是设备检测规则。系统版本、显示缩放、横竖屏变化和 Android 厂商实现可能产生约 5–15px 差异;实际可用尺寸仍以测量为准。
|
|
56
|
+
|
|
57
|
+
| 代表设备 | 屏幕逻辑尺寸 | 安全区假设(上/下) | 预计 WebView 尺寸 | 宽高比 W:H |
|
|
58
|
+
| --- | --- | --- | --- | --- |
|
|
59
|
+
| iPhone SE 2/3 | 375×667 | 20 / 0 | 375×524 | 1:1.40 |
|
|
60
|
+
| iPhone 13 mini | 360×780 | 50 / 34 | 360×578 | 1:1.61 |
|
|
61
|
+
| iPhone 12/13/14 | 390×844 | 47 / 34 | 390×635 | 1:1.63 |
|
|
62
|
+
| iPhone 14 Pro / 15 | 393×852 | 59 / 34 | 393×630 | 1:1.60 |
|
|
63
|
+
| iPhone 16 Pro / 17 | 402×874 | 62 / 34 | 402×646 | 1:1.61 |
|
|
64
|
+
| iPhone Plus / Pro Max | 430×932 | 59 / 34 | 430×698 | 1:1.62 |
|
|
65
|
+
| Android 紧凑型 | 360×800 | 24 / 24 | 360×634 | 1:1.76 |
|
|
66
|
+
| Android 常规型 | 384×832 | 24 / 24 | 384×658 | 1:1.71 |
|
|
67
|
+
| Android 大屏型 | 412×915 | 24 / 24 | 412×732 | 1:1.78 |
|
|
68
|
+
|
|
69
|
+
原规范的估算范围约为 1:1.40~1:1.78;现代 iPhone 主要在 1:1.60~1:1.63,主流 Android 主要在 1:1.70~1:1.78。最低可用高度参考 375×524,主要设计参考 402×646,长屏参考 412×732。实际容器超出这个范围时,也应继续响应容器变化。
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: game-asset-align
|
|
3
|
+
description: 维护 Three.js、Godot 与 Blender 之间的 3D canonical 资产对齐。凡涉及 Tripo/生成模型入库、朝向/尺度/枢轴修复、视觉与语义核对、跨引擎导入不一致、资产修复状态或持续验收,必须先使用本技能。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Game Asset Align
|
|
7
|
+
|
|
8
|
+
## Ownership
|
|
9
|
+
|
|
10
|
+
本技能拥有场景导出契约、资产对齐与修复生命周期。`godot-3d-game` 与 `threejs-3d-game` 消费当前目标已确认的包;Blender 提供建模源场景,导出器负责生成可核对的快照。
|
|
11
|
+
|
|
12
|
+
只支持当前插件范围内的 Three.js、Godot 4、Blender。不要新增 Unity 或 Unreal 分支。
|
|
13
|
+
|
|
14
|
+
## Required workflow
|
|
15
|
+
|
|
16
|
+
1. 完整 Blender 场景先保存 `.blend`,调用 `evomeme_scene_export_blender` 自动生成源快照、GLB、相机参考图和场景契约,流程见 [Blender 场景建模与导出](references/blender-scene-pipeline.md)。已有独立 GLB/GLTF 使用 `evomeme_asset_package_create` 入库。
|
|
17
|
+
2. **Blender 建模或修改后,必须先打开 Stage 展板,用户确认当前版本后才允许进入下一步引擎导入。** 调用 `evomeme_asset_review` 检查格式与依赖,再调用 `evomeme_stage_open({workspace_dir, asset_id, target})`。target 为 `three_js` 或 `godot`。查看相同机位的 Blender 与目标引擎原生画面,核对空间、结构、材质与灯光。
|
|
18
|
+
3. 需要改几何时调用 `evomeme_asset_repair_blender`。修复会使旧配方失效,必须回展板重新验收。
|
|
19
|
+
4. 用户在 Stage 点击 **“确认当前版本,允许导入”** 后,才能调用 export/sync/handoff。工具返回已启动、模型加载成功、格式检查通过或 `alignment.ready=true` 都不能代替确认。不得代用户点击、伪造查看/确认记录、用 `verified_by=spec/user_board` 绕过门禁或手动复制资产到引擎。等待确认期间可继续不依赖导入的工作。
|
|
20
|
+
5. 引擎中只允许一个对齐根节点;禁止在玩法、动画或实体脚本里再补旋转、缩放或位置。
|
|
21
|
+
|
|
22
|
+
`asset.json` v1 可以读取,但不能直接进入引擎。重新保存后升级为 v2 修复状态。
|
|
23
|
+
|
|
24
|
+
export/sync 均强制检查 Stage 当前版本确认;Godot 同步还要求 Godot 原生预览对应的确认,不能用 Three.js 画面代替。修改模型、契约、纹理、Godot profile、材质、灯光或显示实现后必须重新打开 Stage 查看并确认;旧交接包保留原版本。Godot 配置与预览流程见 [Godot 基础视觉对齐](../godot-3d-game/references/appearance-alignment.md)。
|
|
25
|
+
|
|
26
|
+
## Routing references
|
|
27
|
+
|
|
28
|
+
- 当前单场景对比与历史兼容接口说明:读 [lightweight-review.md](references/lightweight-review.md)。
|
|
29
|
+
- 图片参考建模、完整 Blender 场景导出与程序材质烘焙:读 [blender-scene-pipeline.md](references/blender-scene-pipeline.md)。
|
|
30
|
+
- 需要理解 v2 字段、状态推导或版本失效:读 [alignment-contract.md](references/alignment-contract.md)。
|
|
31
|
+
- 需要决定是改 metadata、wrapper 还是 Blender 几何:读 [repair-policy.md](references/repair-policy.md)。
|
|
32
|
+
- 需要判断“看起来一致”或保存验收证据:读 [visual-review.md](references/visual-review.md)。
|
|
33
|
+
- 需要比较 Three.js、Godot、Blender 能做什么:读 [engine-capabilities.md](references/engine-capabilities.md)。
|
|
34
|
+
- 需要创建、替换或迁移 canonical 包:读 [canonical-package.md](references/canonical-package.md)。
|
|
35
|
+
- 需要选择 MCP 工具、参数或处理门禁错误:读 [tool-contract.md](references/tool-contract.md)。
|
|
36
|
+
|
|
37
|
+
## Completion gates
|
|
38
|
+
|
|
39
|
+
- `asset.json` 是 `evomeme.canonical_asset.v2`。
|
|
40
|
+
- 当前目标引擎已在 Stage 展示,用户确认记录为当前 revision;只有原任务用户实际确认才允许继续导入。
|
|
41
|
+
- `alignment.overall_status` 为 `aligned`,`alignment.ready` 为 `true`。
|
|
42
|
+
- recipe 绑定当前 `model.glb` SHA-256 和当前 intent revision,并包含 translation、quaternion、scale。
|
|
43
|
+
- spatial、structural、semantic、render 四项均为 `aligned` 或有明确理由的 `waived`。
|
|
44
|
+
- 当前单视窗不得把显示已载入说成视觉契约已全部通过。若任务另行要求导出,继续验证源、意图、配方和唯一 wrapper,不在玩法代码中补偿 Transform。
|
|
45
|
+
- 视觉结论来自目标引擎截图或明确标注的展板近似,不把 Blender/Three.js 截图冒充 Godot 结果。
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# Alignment contract v2
|
|
2
|
+
|
|
3
|
+
## Source of truth
|
|
4
|
+
|
|
5
|
+
`asset.json` keeps the v1 flat fields for UI compatibility, but `alignment` is authoritative for engine readiness.
|
|
6
|
+
|
|
7
|
+
```json
|
|
8
|
+
{
|
|
9
|
+
"schema": "evomeme.canonical_asset.v2",
|
|
10
|
+
"forward_axis": "+z",
|
|
11
|
+
"up_axis": "+y",
|
|
12
|
+
"pivot": "ground_center",
|
|
13
|
+
"scale_hint_metres": 1.8,
|
|
14
|
+
"alignment": {
|
|
15
|
+
"schema": "evomeme.asset_alignment.v1",
|
|
16
|
+
"source": { "model_file": "model.glb", "sha256": "…", "bytes": 123 },
|
|
17
|
+
"recipe": {
|
|
18
|
+
"source_revision": "…",
|
|
19
|
+
"intent_revision": "…",
|
|
20
|
+
"translation_metres": [0, 0, 0],
|
|
21
|
+
"rotation_quaternion_xyzw": [0, 1, 0, 0],
|
|
22
|
+
"scale_xyz": [1, 1, 1],
|
|
23
|
+
"algorithm_version": "evomeme.stage.v2"
|
|
24
|
+
},
|
|
25
|
+
"conditions": {
|
|
26
|
+
"spatial": { "status": "aligned" },
|
|
27
|
+
"structural": { "status": "aligned" },
|
|
28
|
+
"semantic": { "status": "aligned" },
|
|
29
|
+
"render": { "status": "aligned" }
|
|
30
|
+
},
|
|
31
|
+
"overall_status": "aligned",
|
|
32
|
+
"ready": true,
|
|
33
|
+
"revisions": {
|
|
34
|
+
"source": "…",
|
|
35
|
+
"intent": "…",
|
|
36
|
+
"recipe": "…",
|
|
37
|
+
"alignment_key": "…"
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
## Four conditions
|
|
44
|
+
|
|
45
|
+
- `spatial`: position, pivot, grounding, facing, up-axis and size are correct.
|
|
46
|
+
- `structural`: hierarchy, mesh parts, skeleton, sockets and animation bindings remain usable.
|
|
47
|
+
- `semantic`: the object identity and functional details match the request.
|
|
48
|
+
- `render`: materials, visibility, normals, texture assignment and target-engine presentation are acceptable.
|
|
49
|
+
|
|
50
|
+
Allowed states are `aligned`, `needs_review`, `misaligned`, `stale`, and `waived`. A required aspect is ready only when `aligned` or explicitly `waived` with evidence.
|
|
51
|
+
|
|
52
|
+
## Revision invariant
|
|
53
|
+
|
|
54
|
+
An accepted recipe must reference the current source SHA-256 and current intent revision. `alignment_key` binds source + intent + recipe. A model replacement, Blender geometry edit, or intent field change invalidates the prior key. Never copy an old key into a new package.
|
|
55
|
+
|
|
56
|
+
`ready` and `overall_status` are derived values. Export/sync recomputes the invariant and compares the current model bytes; editing `ready: true` by hand cannot bypass the gate.
|
|
57
|
+
|
|
58
|
+
## v1 migration
|
|
59
|
+
|
|
60
|
+
v1 flat fields are parsed for inspection, then represented as `needs_review` with no accepted recipe. Open the Stage, inspect the actual model, and save to produce v2. Do not bulk-mark legacy assets ready without visual evidence.
|
|
61
|
+
|