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

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-20 18:50:00 +08:00
parent 79369e4473
commit 6c64210331
833 changed files with 998079 additions and 1042 deletions
@@ -57,7 +57,8 @@ Canvas、CanvasScaler、GraphicRaycaster、CanvasGroup、Image、TextMeshProUGUI

 - 糖果风：大圆角、描边、顶部高光；配色见 Design Principles。
 - 优先复用 Common 切图名（`ui_panel_*`、`btn_primary_*` 等）。
- 可拉伸控件 `"imageType": "Sliced"`；图标 Simple。
+- 标准控件底图（面板、按钮及各状态、输入框、列表项、页签、进度/滑条/滚动条、Toast、开关底）必须九宫格：`"imageType": "Sliced"`，对应 Sprite 必须有有效的非零 `Border`，Mesh Type=`Full Rect`；图标、插画等整图用 Simple。
+- Common 标准控件导入由 `UiSpriteNineSliceRules` 自动设置 Border；现有资源修复菜单为 `Tools/UI/Apply Standard Control Nine-Slice`。新增标准控件须补充切图清单和导入规则，不得只填 Sliced 而留 Border 为 0。
 - 文字仅 `TextMeshProUGUI`；浅色字加 Outline/Shadow（`#102033` / `#0B1724`）。
 - 按钮优先 SpriteSwap；缺 hover 图可用 ColorTint。
 - 缺图时在 `description` 标明，按 `ResourceCreate.md` 生成并登记 `Doc/ResDesc_Picture.md`。
@@ -56,8 +56,16 @@ Canvas、CanvasScaler、GraphicRaycaster、CanvasGroup、Image、TextMeshProUGUI
 ### 按钮 / 列表模板

 - 按钮：`Image`（Sliced）+ `Button`（SpriteSwap：normal/pressed/disabled；无 hover 切图可用 ColorTint）。
+- `Button.transition: ColorTint` 支持 `normalColor` / `highlightedColor` / `pressedColor` / `selectedColor` / `disabledColor` / `fadeDuration`；不填时沿用 Unity 默认。可选 `targetGraphic` 为 Graphic 节点名，可将点击区域与实际变色的子图标分开（Mint 关闭按钮）。
 - 列表：`ScrollRect` → Viewport（RectMask2D）→ Content（VerticalLayoutGroup + ContentSizeFitter）→ Item_Template。

+### 标准控件九宫格（必须）
+
+- 面板、按钮及所有状态、输入框、列表项、页签、进度条、滑条/滚动条、Toast、开关底图必须使用 `Image.imageType: Sliced`，Sprite 配置有效的非零 `Border` 和 `Full Rect`。
+- `UiSpriteNineSliceRules.cs` 自动维护 Common 的标准控件导入设置；已有资源执行 `Tools/UI/Apply Standard Control Nine-Slice` 后重建对应 JSON Prefab。边界取自 `UI_Normal_Set.md` 并按实际切图尺寸换算，包含 2px 透明留边；Unity 的 Border Vector4 顺序为 L,B,R,T。
+- 转换器检查标准控件的 Image 类型、Sprite 及 Border（包含 Button 状态图）；省略 Image 类型时默认 Sliced。
+- 新增标准控件须扩展切图清单与导入规则。图标、插画、带完整符号的关闭/返回图等整图保持 Simple、等比显示。
+
 ## Part C - 接管与排错

 1. 确认自动转换开启，或执行 `Convert Changed JSON Prefabs Now`。
@@ -39,7 +39,7 @@

 - `referenceResolution`: `[1080, 1920]`
 - 文字：仅 TextMeshPro，默认字体 `Assets/Bundles/UI/Font/siyuan_CN_Bold SDF.asset`（由 `siyuan_CN_Bold.otf` 生成，动态图集）；浅色字描边/阴影非纯黑。
- 九宫格：`imageType: Sliced`
+- 标准控件底图必须九宫格：`imageType: Sliced` + Sprite 有效非零 `Border` + `Full Rect`；按钮状态图同样设置。Common 导入规则：`UiSpriteNineSliceRules.cs`；修复菜单：`Tools/UI/Apply Standard Control Nine-Slice`。
 - 按钮：SpriteSwap 优先
 - `MonoBehaviour.typeName` 指向 HotUpdate 类型

@@ -48,6 +48,13 @@
 - **一律异步**（YooAsset）；禁止新写同步加载热更资源。
 - Prefab/贴图路径建议带 `Assets/Bundles/...`。

+## UI 风格
+
+- 当前仅使用 Candy 糖果风；Studio / Mint 主题与停用的切换入口已删除。
+- `BootSettings.UiTheme` / 远程 `version.json.uiTheme` 保留用于旧配置兼容，其他值回退 Candy。
+- 业务按逻辑名异步打开：`UiManager.OpenAsync`。
+- UI Prefab 收集进 Art/UI，图片与字体作为依赖进入资源包。
+
 ## 与图集方案关系

 - 现阶段允许 Common 下单图 Sprite 直接被 Prefab 引用。