- 通用框架分类由项目框架改为核心框架 - 模块索引补录第三方插件并校准各模块状态 - 项目规则入口声明核心规则完整定义 - 20/40 规则文档中重复 Git 规则改为链接引用 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
3.7 KiB
3.7 KiB
模块索引
这里是 UnityAI / StrayFog 框架知识总入口。模块入口和状态以本文件为准,状态定义见 模块登记规则。
核心框架
| 模块 | 主要路径 | 职责 | 状态 |
|---|---|---|---|
| 通用框架 | Assets/StrayFog/Core/、GameGeneralScripte/ |
模拟行为、全局数据和通用工具 | 已完成 |
| 对象池 | CopyToHF/MemoryManager/ |
GameObject、脚本和类实例池 | 已完成 |
| 事件系统 | CopyToHF/Event/ |
CTC/STC 事件派发 | 已完成 |
| 资源管理 | CopyToHF/AssetBundle/、StrayFog/Core/SFSubPackageV2.cs |
AssetBundle、图集、卸载、分包 V2 和下载 | 已完成 |
| 相机系统 | GameHFScripte/ |
多相机、堆栈和渲染顺序 | 已完成 |
| 实体系统 | GameFunction/GameEntity/ |
实体、System、Model 和实体池 | 已完成 |
| UI 窗口系统 | CopyToHF/UIWindowMgr/、GameFunction/UIWindows/ |
窗口生命周期、加载、卸载和列表 | 已完成 |
| 技能系统 | GameFunction/GameEntity/ |
技能触发、释放和配置联动 | 已完成 |
| 场景系统 | GameFunction/SceneManager/ |
场景加载和生命周期 | 待验证 |
| 网络系统 | CopyToHF/Network/、GameFunction/WebSocket/ |
WebSocket、protobuf 和消息映射 | 待验证 |
| 数据配置 | 项目表格、proto 和生成目录 | 配置源、解析和代码生成 | 待验证 |
| Hotfix 启动 | GameFunction/GameRoot/、GameDllManager |
AOT、热更 DLL 和业务入口 | 待验证 |
项目框架
| 模块 | 主要路径 | 职责 | 状态 |
|---|---|---|---|
| 第三方插件 | Assets/ThirdPlugins/、Packages/ |
记录 HybridCLR、Spine、DOTween 等插件用途、边界、本地修改和升级风险 | 已识别 |
编辑器工具
| 模块 | 主要路径 | 职责 | 状态 |
|---|---|---|---|
| SF Editor | Assets/StrayFog/Editor/ |
StrayFog 生成器和 Editor 扩展 | 已完成 |
| 项目 Editor Assets | Assets/Editor/ |
项目级 Editor 工具 | 已识别 |
| UI 拼接工具 | Assets/Editor/Command/ |
UI Prefab 与 JSON 双向转换 | 已完成 |
| MCP 工具 | Tools/CodexUnityMcp/、Unity Bridge |
Codex 与 Unity Editor 工具桥 | 已完成 |
业务参考
- PlayBalloons:外部项目业务实现示例,不作为框架规范。
文档拆分
- 轻量模块只保留 README。
- 公共 API 较多时增加使用指南或开发指南。
- 特殊限制较多时增加注意事项。
- 一次性任务不扩展模块文档结构,具体规则见 工作流清单。
文档关联
| 文档 | 关联原因 |
|---|---|
| 模块登记规则 | 分类、状态和拆分规则 |
| 架构说明 | 模块代码分层和源码边界 |
| 框架架构 | 全局实现视角的框架分层 |
| 项目规则入口 | 项目知识入口 |
| AI 接入入口 | AI 必读模块索引 |