# AIGame 项目说明

> 本文件为人类可读摘要。Agent **始终遵循** 的规则在：`.cursor/rules/aigame-basics.mdc`（`alwaysApply: true`）。

进行 Unity 开发时，必须阅读并遵循 [UNITY-GUIDE.md](UNITY-GUIDE.md)。

制作 UI 时，必须阅读并遵循 [Doc/UI_AutoGen_Overview.md](Doc/UI_AutoGen_Overview.md) 与 [Doc/Rule/UIGenerationPrompt.md](Doc/Rule/UIGenerationPrompt.md)。

## 基础规则

1. **资源登记（必须）**：所有资源生成完成后，必须按类型追加到对应描述文件，并写明简要说明（用途、路径、生成方式等）。未登记视为流程未完成。
   - 索引：`Doc/ResDesc.md`
   - model → `Doc/ResDesc_Model.md`
   - animation → `Doc/ResDesc_Animation.md`
   - picture → `Doc/ResDesc_Picture.md`
   - sound → `Doc/ResDesc_Sound.md`
   - effect → `Doc/ResDesc_Effect.md`

2. **3D 游戏网格**：导出 FBX 为 Y-up、原点在底面中点、局部 **+Z 为正面**。摆放时 +Z 朝向目标，与 Unity `transform.forward` 一致。旧 -Z 资产按明确的旧资源配置兼容，不自动翻转。细则见 [GameResProductProc.md](GameResProductProc.md) 附录 B。

3. **UI 自动生成（必须）**：业务面板走 JSON→Prefab，禁止用运行时代码临时拼业务 UI 骨架替代 Prefab。
   - 总览：`Doc/UI_AutoGen_Overview.md`
   - JSON 目录：`Doc/UIPrefabCreater/`
   - Prefab 输出：`AIClient/Assets/Bundles/UI/Prefab/`
   - 设计分辨率：竖屏 `[1080, 1920]`