Add prototype gameplay loop with character/battlefield assets and server game APIs.

Co-authored-by: Cursor <cursoragent@cursor.com>

Doc/Design/UI/Home/home_generation.json

@@ -0,0 +1,91 @@
+{
+  "date": "2026-10-14",
+  "method": "Built-in image_gen.imagegen; Unity Pipeline atlas extraction and Sprite import; JSON-to-Prefab; Unity isolated and Play Mode rendering",
+  "references": [
+    "https://play.google.com/store/apps/details?id=com.farlightgames.pgame.gp&hl=en",
+    "https://www.ldplayer.tw/blog/clash-of-critters-code.html",
+    "Doc/Design/ui_design.jpg",
+    "Doc/Design/UI_Design_Principles.md",
+    "Doc/Design/UI/UI_Themes.md"
+  ],
+  "images": [
+    {
+      "source": "Doc/Design/UI/Home/home_camp_source.png",
+      "asset": "AIClient/Assets/Bundles/UI/Texture/Home/home_camp.png",
+      "transparent_background": false,
+      "prompt": "Use case: stylized-concept. Asset type: portrait mobile game main-home background illustration, 9:16, 1080x1920 composition. Create a polished cozy stylized 3D cartoon town camp in the casual candy-game style: rounded cream cottages with orange-red tiled roofs and tiny yellow-striped shop awnings, emerald rounded trees, warm stone paths, a small blue fountain at the center, a wooden bench and flower beds, a cute small white-and-orange cat and a tiny explorer with teal goggles interacting in the clearing. Charming miniature diorama, hand-painted toy-like materials, soft sunlight, outlined details, optimistic afternoon atmosphere. High oblique orthographic camera angle. Center the cottages at x50%, y35-50%, fountain and cat in the middle at y55-65%. Environment fills the whole frame with grass and garden paths towards all edges; no floating island. Keep the top 20% quiet pale blue sky with soft distant hills so resource UI can overlay; keep outer left and right 15% of frame low-detail so menu icons can overlay; keep bottom 25% quiet soft grass for large overlay action panel. Color palette sky #EAF3F8, warm cream #F6EBCF, leaf green #7ED321, water cyan #46C8E6, honey gold accents. A fully finished professional mobile game environment illustration with crisp readable volumes. NO UI elements, NO cards, NO borders, NO text, NO numbers, NO labels, NO watermarks, NO logos. Original scene, original characters."
+    },
+    {
+      "source": "Doc/Design/UI/Home/home_icons_source.png",
+      "assets": "AIClient/Assets/Bundles/UI/Texture/Home/home_ico_*.png",
+      "transparent_background": true,
+      "grid": [
+        4,
+        4
+      ],
+      "order": [
+        "coin",
+        "diamond",
+        "energy",
+        "avatar",
+        "tasks",
+        "gift",
+        "mail",
+        "trophy",
+        "bag",
+        "home",
+        "battle",
+        "pets",
+        "chest",
+        "calendar",
+        "settings",
+        "pinball"
+      ],
+      "prompt": "Use case: stylized-concept. Asset type: a single sprite sheet for a casual candy-style mobile game HUD, 4 by 4 grid of SIXTEEN isolated inventory icons on a genuinely transparent background. Exact grid order: first row gold coin with star embossing, cyan faceted diamond, green lightning energy bolt, cute orange-and-white cat explorer avatar wearing teal goggles; second row parchment checklist task scroll, wrapped pink-and-gold gift box, blue envelope letter, golden trophy cup; third row blue-purple adventure backpack, wooden cream-roof cottage with orange tiles, crossed silver sword and round blue shield, open leather illustrated pet collection book; fourth row golden treasure chest, calendar with green check, silver cog settings gear, glossy turquoise pinball glass orb with a gold star inside. Consistent polished 3D hand-painted cartoon inventory item rendering, rounded forms, thick colored outlines, cream highlights, gentle short soft shadows, matching a casual fantasy toy-town game UI. All icons single recognizable objects in same visual language, no UI buttons or frames. Straight-on / three-quarter views, centered in each equal cell with generous transparent margins. Each cell 256x256 in a 1024x1024 sheet; each object occupies about 170x170 with all edges fully contained, no overlap between cells. No text, no letters, no numbers, no words, no watermark, no logo. Transparent background, no white backing or checkerboard."
+    }
+  ],
+  "ui": {
+    "json_generator": "Tools/generate_home_ui.py",
+    "unity_builder": "AIClient/AgentScripts/BuildHomeUi.cs",
+    "prefabs": [
+      "UI_MainHUD"
+    ],
+    "referenceResolution": [
+      1080,
+      1920
+    ],
+    "nodesPerTheme": 83,
+    "eventsPerTheme": 19,
+    "data": "Currency, level, task, chapter and rewards are design examples; feature buttons show existing dialog feedback until actual gameplay is connected. Network status and reconnection use the existing live implementation.",
+    "background": "Original static camp illustration; not a new interactive 3D scene."
+  },
+  "validation": {
+    "unityCompile": "completed",
+    "homeChecks": 310,
+    "existingThemeChecks": 52,
+    "resourceCollection": "6 UI prefab addresses and font/sprite dependencies verified",
+    "live": "8 feature entries and home tab passed EventSystem raycasts and Bootstrap dialog feedback at 1080x1920",
+    "previews": [
+      "UI_MainHUD.png",
+      "UI_MainHUD_tall.png",
+      "UI_MainHUD_reconnect.png"
+    ],
+    "liveScreenshot": "AIClient/Assets/Screenshots/home_live.png",
+    "scene": "Boot restored in Edit Mode, clean; previous Game View size restored",
+    "notRun": [
+      "Player build",
+      "mobile device validation",
+      "CDN deployment"
+    ]
+  },
+  "themeRemoval": {
+    "date": "2026-10-14",
+    "activeTheme": "candy",
+    "removed": [
+      "Studio",
+      "Mint",
+      "ThemeSwitcher"
+    ],
+    "note": "Earlier multi-theme checks are historical; current builder only generates Candy."
+  }
+}

Doc/Design/UI/UI_Themes.md

@@ -0,0 +1,41 @@
+# 当前 UI 风格：Candy
+
+2026-10-14 按用户要求删除 Studio 深绿工作室主题与 Mint 奶油薄荷绿主题。当前仅保留本项目 Candy 糖果风，设计分辨率 **1080×1920**。视觉规范见 `Doc/Design/UI_Design_Principles.md` 与 `Doc/Design/ui_design.jpg`。
+
+## 当前资源
+
+| 逻辑面板 | JSON | Prefab |
+| --- | --- | --- |
+| `UI_MainHUD` | `Doc/UIPrefabCreater/UI_MainHUD.json` | `AIClient/Assets/Bundles/UI/Prefab/UI_MainHUD.prefab` |
+| `UI_ConfirmDialog` | `Doc/UIPrefabCreater/UI_ConfirmDialog.json` | `AIClient/Assets/Bundles/UI/Prefab/UI_ConfirmDialog.prefab` |
+
+控件复用 `Texture/Common/`，营地插画与图标位于 `Texture/Home/`。2026-10-15 已接入 G0 本地玩法原型：首页资源、训练等级、教学目标和首通状态由 `PrototypeGame` 绑定，第三资源为弹珠；原登录、网络状态、确认弹窗、断线重连保留。其他支撑系统仍按基础设计待开发。
+
+2026-10-16营地扩展：底部“营地”打开`UI_PrototypeCamp`设施/休息区页，建造台打开`UI_PrototypeBuild`三处固定装饰槽位看板。两页沿用Candy、Common九宫格、Home图标与已制伙伴/装饰肖像，继续由JSON→Prefab生成。主界面插画仍作背景，未叠加房屋点击热点或恢复其他主题。
+
+任务/签到扩展：`MainHUD.Tasks`打开`UI_PrototypeTasks`，`MainHUD.Daily`打开`UI_PrototypeSignin`。首页新增已制作的任务红点节点；任务与签到红点仅代表可领取奖励。两页继续使用Candy、Common九宫格和已制弹珠图标，通过JSON→Prefab生成。
+
+背包/商店扩展：`MainHUD.Bag`打开四分类`UI_PrototypeBag`；`MainHUD.Shop`打开`UI_PrototypeShop`免费页，`MainHUD.Coin`打开金币商品页。两页复用已制Home图标、伙伴/装饰肖像与Common九宫格，金币购买使用原确认弹窗；JSON→Prefab流程不变。
+
+## 配置与加载
+
+- 当前 UI 仅支持 `candy`。`BootSettings.UiTheme`、`BootContext.UiTheme`、远程 `version.json.uiTheme` 字段保留以兼容旧序列化和版本文件；其他值会告警并回退 Candy。
+- `UiThemeCatalog.Resolve` 返回原逻辑面板名。业务仍使用 `UiManager.OpenAsync` 异步加载。
+- `Art/UI` 按 Prefab 文件名收集当前面板，贴图和字体随依赖进入包。菜单为 `Tools/UI/Setup UI Bundle Collector`。
+- 本地启动和 `LocalServerAutoStart` 不受影响，Boot 保留原 EventSystem。
+
+## 生成与验证
+
+`python Tools/generate_home_ui.py` 仅生成 Candy 主界面 JSON。通过 Unity Pipeline 执行 `AgentScripts/BuildHomeUi.cs` 的 `Build`、`Verify`、`Preview` 生成和验证 Prefab；主界面骨架继续严格使用 JSON→Prefab。
+
+预览：`Doc/Design/UI/Home/UI_MainHUD.png`、`UI_MainHUD_tall.png`、`UI_MainHUD_reconnect.png`。实际运行截图：`AIClient/Assets/Screenshots/home_live.png`。图片生成提示词与历史验证记录见 `Doc/Design/UI/Home/home_generation.json`。
+
+上述为主界面设计阶段的历史截图。G0 当前截图为 `AIClient/Assets/Screenshots/g0_home.png` 与 `g0_pinball.png`、`g0_pets.png`、`g0_formation.png`、`g0_battle.png`、`g0_result.png`。四个新页面沿用 Candy 与 JSON→Prefab 管线；构建与验证详见 `Doc/Design/G0_Implementation.md`，运行 `BuildPrototype.Build` 会一起更新主界面和原型资源。
+
+已删除两套主题的四个 Prefab、独立贴图目录、JSON、预览、配置示例及专用生成/验证脚本。已停用的 `UI_ThemeSwitcher` Prefab、JSON 和脚本也已移除。Unity 资源和 `.meta` 由 Pipeline 调用 AssetDatabase 删除；`Doc/ResDesc_Picture.md` 旧条目作为历史登记保留，并注明退役。
+
+收集配置随下一次正常资源包构建生效；本次不构建 Player，不发布 CDN。
+
+2026-10-16 新增 `UI_PrototypeStages` 五关列表，更新伙伴技能说明、布阵关卡提示、弹珠双资源奖励和下一关结算。业务仍为Candy JSON→Prefab，数值读取服务端统一配置；使用 `BuildProgression.Build` 可仅重建这五个玩法页。实际运行截图为 `Assets/Screenshots/progression_*.png`，见实现记录中的G2章节。
+
+删除后验证（2026-10-14）：Unity 编译完成；8 个退役 Unity 目标均不存在；Candy 主界面 116 项资源/绑定/点击/触控尺寸/重连检查通过；保留的主界面与确认弹窗无退役资源依赖。Art/UI 收集描述已更新，旧 Studio/Mint 配置正确回退 Candy，无新增错误，Boot 场景保持无未保存变化。