CLAUDE.md

CLAUDE.md

请使用中文写提案和回答 这个文件为 Claude Code (claude.ai/code) 提供指导，用于处理此代码库中的代码。

TEngine 基于 HybridCLR + YooAsset + UniTask + Luban 构建。

核心原则

1. 异步优先：IO 操作用 UniTask，禁止同步加载/Coroutine
2. 模块访问：通过 GameModule.XXX 访问，而非 ModuleSystem.GetModule<T>()
3. 资源必须释放：LoadAssetAsync 对应 UnloadAsset，GameObject 用 LoadGameObjectAsync
4. 热更边界：GameScripts/Main 不热更，GameScripts/HotFix/ 全部热更
5. 事件解耦：模块间用 GameEvent，UI 内部用 AddUIEvent

程序集分层

GameScripts/Main/       → 主包（不热更）
GameScripts/HotFix/
  ├── GameProto/        → Luban 配置代码
  └── GameLogic/        → 业务逻辑（GameApp.cs 入口）

依赖：GameLogic → TEngine.Runtime（单向）

文档参考

详细文档见 skills/tengine-dev/references/：

核心开发：

• architecture.md - 项目结构/启动流程
• modules.md - 模块 API（Timer/Scene/Audio/Fsm）
• ui-development.md - UI 开发
• event-system.md - 事件系统
• resource-management.md - 资源加载
• hotfix-development.md - 热更代码
• luban-config.md - 配置表
• conventions.md - 代码规范
• troubleshooting.md - 问题排查

Unity Editor 自动化（unity-skills）：

• unity-mcp-guide.md - MCP 工具索引
• ui-prefab-builder.md - UI Prefab 拼接
• scene-gameobject.md - 场景/GameObject 操作
• script-asset-workflow.md - 脚本/资源管理