unity-project-overviewlisted

# Unity 项目全景总览（一级模块 + 模块依赖架构文档） ## 目标 对当前 Unity 项目进行扫描，识别出**一级模块**（粗粒度功能域），并**重点梳理一级模块之间的依赖关系**，生成一份项目架构分析文档。本文档是后续技能（module-overview）的输入：通过它确定"有哪些一级模块"以及"它们之间如何依赖"。 **本文档只负责"一级模块层"——列出模块并刻画模块间依赖，不深入到具体子模块细节。** ## 前置依赖 - 若已指定 Unity 项目路径则直接使用，否则以当前目录为项目根目录。 - 若已知模块边界信息，可据此辅助划分一级模块。 ## 输出文档结构（必须包含以下章节） ### 1. 文档头部信息 ```markdown # [项目名称] — 代码架构分析文档 > **Unity 版本**: [从 ProjectSettings 读取] > **项目类型**: [3D/2D/3D+2D] [游戏类型描述] > **渲染管线**: [Built-in/URP/HDRP/自定义] > **热更新方案**: [如有，填写具体方案及版本] > **资源管理**: [AssetBundle/Addressables/YooAsset/其他] > **配置工具**: [如 Luban/Excel 导出工具/其他] > **框架基线**: [如有，填写框架来源及 commit] ``` ### 2. 项目概述 用 1-2 段话描述项目的核心定位、设计目标、关键特性（这是一个什么项目、解决什么问题、核心设计目标）。 ### 3. 技术栈全景（表格形式） | 类别 | 技术选型 | 版本/备注 | |------|------|------| | 游戏引擎 | Unity | [版本] | | 渲染管线 | ... | ... | | 主框架 | ... | ... | | 热更新 | ... | ... | | 资源管理 | ... | ... | | 配置表 | ... | ... | | 异步方案 | ... | ... | | 数据持久化 | ... | ... | | UI 系统 | ... | ... | | 物理系统 | ... | ... | | 导航系统 | ... | ... | | 序列化 | ... | ... | | 本地化 | ... | ... | | [其他关键技术] | ... | ... | > 识别方法：扫描 Packages/manifest.json、ProjectSettings/ProjectSettings.asset、Assets 下的插件目录、*.asmdef 文件及核心代码中的 using 命名空间综合推断。 ### 4. 架构分层图 使用 ASCII 图或 Mermaid 绘制架构分层图（引擎层 → 框架层 → 业务层 → 热更新层），标注各层通信方式。**注意：分层图与模块依赖关系是两回事**——分层展示纵向层级，依赖关系展示模块间横向耦合。 ### 5. 目录组织速查 #### 5.1 Assets 顶层目录 | 目录 | 职责 | |------|------| | Scripts/ | ... | | StreamingAssets/ | ... | | Editor/ | ... | | Resources/ | ... | | ... | ... | #### 5.2 核心代码目录细分 对最重要的代码目录进行二级细分： | 子目录 | 职责 | |