# UI 生成规则（AI JSON → Prefab）

> AIGame 竖屏微信小游戏版。精简系统提示词见 `Doc/Rule/UIGenerationPrompt.md`。总览见 `Doc/UI_AutoGen_Overview.md`。

## Part A - 流水线

```text
需求说明
  -> AI 读规则/设计/切图清单/样例 JSON
  -> 生成 Doc/UIPrefabCreater/{UIName}.json
  -> Unity 获焦或菜单 Tools/UI/...
  -> JsonUIPrefabBuilder 生成 Assets/Bundles/UI/Prefab/{UIName}.prefab
  -> HotUpdate C# 按节点名 / bindings / events 接管
```

不使用 HTML 中间层。转换器：

- `AIClient/Assets/Editor/UI/JsonUIPrefabBuilder.cs`
- `AIClient/Assets/Editor/UI/JsonUIAutoConvert.cs`

### 目录

| 类型 | 路径 |
| --- | --- |
| JSON | `Doc/UIPrefabCreater/{UIName}.json` |
| Prefab | `Assets/Bundles/UI/Prefab/{UIName}.prefab` |
| 通用贴图 | `Assets/Bundles/UI/Texture/Common/` |
| 业务贴图 | `Assets/Bundles/UI/Texture/<Module>/` |

## Part B - AI 契约

### 必读

- `Doc/Rule/UnityUIProject.md`
- `Doc/Design/UI_Design_Principles.md`
- `Doc/UI_Normal_Set.md` 或 `Doc/UI_Pic_Set.md`
- `Doc/UIPrefabCreater/UI_ConfirmDialog.json`（样例）
- 转换器当前支持的组件（以代码为准）

### 顶层字段

`schemaVersion`（`1`）、`prefabName`、`prefabPath`、`description`、`canvas`、`assets`、`nodes`、`bindings`、`events`。

`canvas.canvasScaler.referenceResolution` **必须为 `[1080, 1920]`**。

### 命名

英文节点：`UI_` / `Panel` / `Img_` / `Txt_` / `Btn_` / `Scroll_` / `Group_`。

### 可生成组件

Canvas、CanvasScaler、GraphicRaycaster、CanvasGroup、Image、TextMeshProUGUI、Button、Shadow、Outline、ScrollRect、RectMask2D、Mask、TMP_InputField、VerticalLayoutGroup、ContentSizeFitter、LayoutElement、MonoBehaviour。

未完整实现（跳过/告警）：Toggle、TMP_Dropdown、Slider、Scrollbar、ScrollView（请用 ScrollRect）。

### 按钮 / 列表模板

- 按钮：`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`。
2. 看 Console `[UIGen]` 日志。
3. 打开 Prefab 核对层级/Sprite/文字。
4. HotUpdate 挂控制器：`transform.Find` / 递归按名查找；`button.onClick.AddListener`。
5. 资源加载走 YooAsset **异步**（见 `ProjectDesign.md` / `UnityUIProject.md`）。

| 现象 | 处理 |
| --- | --- |
| JSON 不转换 | 获焦/手动菜单；确认 JSON 比 Prefab 新 |
| referenceResolution 错误 | 改为 `[1080,1920]` |
| 找不到 Sprite | 短名与 Common 切图一致；Texture Type=Sprite |
| 文字不可读 | Outline/Shadow，色 `#102033` / `#0B1724` |

### 提交前自检

- JSON 在 `Doc/UIPrefabCreater`；唯一根节点；`prefabName` 一致。
- 父先于子；Sprite 已登记；九宫格 `Sliced`；TMP；bindings/events 节点存在。

## Part D - 后续

优先补齐转换器：Toggle → Slider → Scrollbar → TMP_Dropdown。图集自动化见 `Doc/UI_Atlas_Pipeline.md`。