42 lines
4.4 KiB
Markdown
42 lines
4.4 KiB
Markdown
# 当前 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 场景保持无未保存变化。
|