2026-07-07 18:36:15 +08:00
|
|
|
|
# UnityAI - StrayFog 框架文档中心
|
2026-05-22 10:41:34 +08:00
|
|
|
|
|
2026-07-07 18:36:15 +08:00
|
|
|
|
本仓库是 **StrayFog 框架的知识库**,同时服务两类读者:
|
2026-05-22 10:41:34 +08:00
|
|
|
|
|
2026-07-07 18:36:15 +08:00
|
|
|
|
- **人工开发者**:通过 `modules/frameworks/` 下的框架模块文档和 `rules/` 下的规则文档学习使用 StrayFog 框架。
|
|
|
|
|
|
- **AI 工具**:通过 `ai/`、`rules/`、`modules/`、`hooks/` 下的规则、模块、hook 文档快速理解框架结构和工作方式。
|
2026-05-22 10:41:34 +08:00
|
|
|
|
|
2026-07-07 18:36:15 +08:00
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 🚀 快速入口
|
|
|
|
|
|
|
|
|
|
|
|
| 读者 | 入口 |
|
|
|
|
|
|
|------|------|
|
|
|
|
|
|
| AI 工具 | [AGENTS.md](AGENTS.md) / [CLAUDE.md](CLAUDE.md) / [RULES.md](RULES.md) → [ai/AI接入入口.md](ai/AI接入入口.md) |
|
|
|
|
|
|
| 人工开发者 | 继续阅读下方中文文档索引 |
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 🤖 AI 工具说明
|
|
|
|
|
|
|
|
|
|
|
|
处理本仓库任务时,AI 工具应:
|
|
|
|
|
|
|
|
|
|
|
|
1. 读取 [ai/AI接入入口.md](ai/AI接入入口.md)
|
|
|
|
|
|
2. 读取 [rules/项目规则入口.md](rules/项目规则入口.md)
|
|
|
|
|
|
3. 按需读取 [modules/模块索引.md](modules/模块索引.md) 中的框架模块
|
|
|
|
|
|
4. 如需了解外部项目业务参考,读取 [business-reference/playballoons/业务框架映射接口.md](business-reference/playballoons/业务框架映射接口.md)
|
|
|
|
|
|
|
|
|
|
|
|
---
|
2026-05-22 10:41:34 +08:00
|
|
|
|
|
2026-07-07 18:36:15 +08:00
|
|
|
|
## 📋 中文文档索引
|
2026-05-22 16:58:41 +08:00
|
|
|
|
|
2026-07-07 18:36:15 +08:00
|
|
|
|
### 框架架构
|
|
|
|
|
|
- [通用框架](modules/frameworks/通用框架/README.md) — General/StrayFog Core 通用能力
|
|
|
|
|
|
- [框架架构分析](modules/frameworks/通用框架/框架架构.md) — StrayFog 整体架构分析
|
2026-05-29 15:01:50 +08:00
|
|
|
|
|
2026-07-07 18:36:15 +08:00
|
|
|
|
### 核心框架
|
|
|
|
|
|
- [实体系统](modules/frameworks/实体系统/README.md)
|
|
|
|
|
|
- [Entity 开发指南](modules/frameworks/实体系统/开发指南.md)
|
|
|
|
|
|
- [Unity Entities 注意事项](modules/frameworks/实体系统/注意事项.md)
|
|
|
|
|
|
- [技能系统](modules/frameworks/技能系统/README.md)
|
|
|
|
|
|
- [通用技能系统使用指南](modules/frameworks/技能系统/使用指南.md)
|
|
|
|
|
|
- [UI 窗口系统](modules/frameworks/UI窗口系统/README.md)
|
|
|
|
|
|
- [UI 开发指南](modules/frameworks/UI窗口系统/开发指南.md)
|
|
|
|
|
|
- [UI 界面拼接设计指南](modules/frameworks/UI窗口系统/界面拼接.md)
|
|
|
|
|
|
- [事件系统](modules/frameworks/事件系统/README.md)
|
|
|
|
|
|
- [事件系统使用指南](modules/frameworks/事件系统/使用指南.md)
|
|
|
|
|
|
- [对象池与运行时对象管理](modules/frameworks/内存对象管理/README.md)
|
|
|
|
|
|
- [对象池使用指南](modules/frameworks/内存对象管理/使用指南.md)
|
|
|
|
|
|
- [相机系统](modules/frameworks/相机系统/README.md)
|
|
|
|
|
|
- [相机系统使用指南](modules/frameworks/相机系统/使用指南.md)
|
|
|
|
|
|
- [资源管理](modules/frameworks/资源管理/README.md)
|
|
|
|
|
|
- [资源管理使用指南](modules/frameworks/资源管理/使用指南.md)
|
2026-07-07 19:07:27 +08:00
|
|
|
|
- [资源加载重构方案](modules/frameworks/资源管理/资源加载重构方案.md)
|
2026-07-07 18:36:15 +08:00
|
|
|
|
- [场景系统](modules/frameworks/场景系统.md)
|
|
|
|
|
|
- [网络系统](modules/frameworks/网络系统.md)
|
|
|
|
|
|
- [数据配置框架](modules/frameworks/数据配置框架.md)
|
|
|
|
|
|
- [Hotfix 启动](modules/frameworks/Hotfix启动.md)
|
|
|
|
|
|
- [第三方插件](modules/frameworks/第三方插件.md)
|
2026-05-22 11:21:57 +08:00
|
|
|
|
|
2026-07-07 18:36:15 +08:00
|
|
|
|
### 编辑器工具
|
|
|
|
|
|
- [编辑器工具](modules/frameworks/编辑器工具/README.md)
|
|
|
|
|
|
- [UI 拼接工具](modules/frameworks/编辑器工具/UI拼接工具.md)
|
2026-07-07 19:07:27 +08:00
|
|
|
|
- [MCP 工具](modules/frameworks/编辑器工具/MCP工具/README.md)
|
2026-05-22 10:41:34 +08:00
|
|
|
|
|
2026-07-07 18:36:15 +08:00
|
|
|
|
### 项目规则
|
|
|
|
|
|
- [项目规则入口](rules/项目规则入口.md)
|
|
|
|
|
|
- [架构说明](rules/10-架构说明.md)
|
|
|
|
|
|
- [开发规则](rules/20-开发规则.md)
|
|
|
|
|
|
- [工作流清单](rules/40-工作流清单.md)
|
2026-05-22 10:41:34 +08:00
|
|
|
|
|
2026-07-07 18:36:15 +08:00
|
|
|
|
### 编辑器工具脚本
|
|
|
|
|
|
- [UI 工具](modules/frameworks/编辑器工具/UI工具/) — UI 预制体与 JSON 双向转换工具
|
2026-05-27 15:56:18 +08:00
|
|
|
|
|
2026-05-22 10:41:34 +08:00
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 🎯 快速入门
|
|
|
|
|
|
|
|
|
|
|
|
| 场景 | 推荐文档 |
|
|
|
|
|
|
|-----|---------|
|
2026-07-07 18:36:15 +08:00
|
|
|
|
| 新人开发 | [开发规则](rules/20-开发规则.md) |
|
|
|
|
|
|
| 使用对象池 | [对象池与运行时对象管理](modules/frameworks/内存对象管理/README.md) |
|
|
|
|
|
|
| 使用事件系统 | [事件系统](modules/frameworks/事件系统/README.md) |
|
|
|
|
|
|
| 遇到问题 | [开发规则/常见问题](rules/20-开发规则.md#常见问题) |
|
|
|
|
|
|
| AI 工具接入 | [ai/AI接入入口.md](ai/AI接入入口.md) |
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 📦 业务参考
|
|
|
|
|
|
|
|
|
|
|
|
- [business-reference/playballoons/](business-reference/playballoons/) — 来自 PlayBalloons 实际项目的业务参考,与 StrayFog 框架核心分离。
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 文档关联
|
|
|
|
|
|
|
|
|
|
|
|
> 当本文档发生变更时,应同步检查以下关联文档,避免信息不一致。
|
|
|
|
|
|
|
|
|
|
|
|
| 文档 | 关联原因 |
|
|
|
|
|
|
|---|---|
|
|
|
|
|
|
| [ai/AI接入入口.md](ai/AI接入入口.md) | AI 工具入口说明 |
|
|
|
|
|
|
| [rules/项目规则入口.md](rules/项目规则入口.md) | 项目规则总入口 |
|
|
|
|
|
|
| [modules/模块索引.md](modules/模块索引.md) | 框架模块索引 |
|
|
|
|
|
|
| [rules/00-项目概览.md](rules/00-项目概览.md) | 项目概览中的人工开发者使用方式 |
|
2026-05-22 10:41:34 +08:00
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
**版本**: v1.0
|
2026-07-07 18:36:15 +08:00
|
|
|
|
**适用项目**: GiftGameX
|