# UI 图集自动化方案（AIGame 精简版）

> 参考 AIC# `Unity_UI自动图集制作方案.md`。本仓库首期以 **目录约定 + 单图 Sprite + YooAsset** 为主；完整 SpriteAtlas 生成器作为后续里程碑。

## 1. 目标

- 美术/AI 把切图放入约定目录。
- 导入为 `Sprite (2D and UI)`，关闭 mipmap。
- Prefab / 运行时按 **Sprite 短名** 引用（与 JSON `assets.sprites` 一致）。
- 后续：按子目录自动生成 `.spriteatlas`，构建时原图与图集同包。

## 2. 目录

```text
AIClient/Assets/Bundles/UI/Texture/
  Common/          # 通用控件（对应 UI_*_Set）
  <Module>/        # 业务专用
AIClient/Assets/Bundles/UI/Atlas/   # （后续）自动生成的 .spriteatlas
```

中间产物仍可先落在 `Tools/output/`，再导入 Bundles。

## 3. 切图来源

1. 选图集级别：`UI_Simple_Set` / `UI_Normal_Set` / `UI_Pic_Set`。
2. `Tools/gpt_image_generate.py` 生成（>1K 用 `gpt-image-2-vip`，见 `ResourceCreate.md`）。
3. 风格：`Doc/Design/UI_Design_Principles.md` + `ui_design.jpg`。
4. 切片坐标以对应 `Doc/UI_*_Set.md` 为准；登记 `Doc/ResDesc_Picture.md`。

## 4. 导入建议

- Texture Type：`Sprite (2D and UI)`
- Sprite Mode：单图 `Single`；整图集再切为 `Multiple`
- Mesh Type：`Full Rect`（九宫格）
- Alpha Is Transparency：开
- 原图尽量不压缩；压缩留给图集/平台 override

## 5. 后续里程碑（对齐 AIC#）

1. `SpriteAtlasGenerator`：扫描 `Texture/UI` 子目录 → `Atlas/*.spriteatlas`
2. `AtlasEnum` / 名字索引生成
3. YooAsset 收集规则：图集与原图同组
4. 运行时 `SetSprite(atlas, name)` API（HotUpdate）
5. UI Prefab 依赖图集 JSON 审计

在里程碑完成前，JSON→Prefab 流水线使用 **Common 单图路径** 即可闭环。