lms
ee1ff7f444
- 删除 01~05 旧中文教程目录 - 将 03 核心功能教程拆分为各 framework 模块的子文档 - 06 工具脚本移入 modules/frameworks/编辑器工具/UI工具/ - 非框架内容合并进 rules/20-开发规则.md 与 rules/40-工作流清单.md - 更新所有交叉链接与文档关联表 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
3.7 KiB
3.7 KiB
业务功能 → StrayFog 框架能力映射
本文档是 PlayBalloons 业务参考的“接口文档”。> 它不描述业务实现细节，而是说明每个业务功能用到了 StrayFog 框架的哪些能力，以及应该参考哪些框架文档。
来源说明
以下业务功能来自 PlayBalloons 实际项目，仅作参考，不是 StrayFog 框架本身。
原始业务文档位于 features/ 目录。
业务功能映射表
| 业务功能 | 涉及 StrayFog 框架能力 | 参考文档 | 状态 |
|---|---|---|---|
| 登录 | 单例管理器、网络协议、UI 窗口、事件链 | 网络框架、UI 框架、Hotfix 启动 | 可提炼示例 |
| 背包 | 单例、RB_Tree 存储、事件驱动、增量同步 | 事件框架、网络框架、数据/配置框架 | 可提炼示例 |
| 商店 | 网络协议、Map 数据结构、UI 窗口 | 网络框架、UI 框架、数据/配置框架 | 部分接入 |
| PVE 战斗 | 场景、实体、波次管理、伤害管理器 | 实体框架、场景框架、网络框架 | 半接入 |
| 塔养成 | 单例、编队数据、实体属性联动 | 实体框架、数据/配置框架 | 未完整实装 |
| GM 调试 | GM 协议包装、参数配置、模块化窗口生命周期 | 网络框架、UI 框架 | 可提炼示例 |
| 奖励展示 | 通用 Tips、事件监听、资源组件 | UI 框架、事件框架、资源框架 | 可提炼示例 |
| 地图进度 | 地图加载、波次配置、进度奖励 | 场景框架、数据/配置框架 | 半接入 |
| PVP | — | — | 未发现实现 |
可复用模式索引
从业务文档中提炼出的通用模式，可作为使用 StrayFog 框架实现类似系统的参考：
1. 单例管理器 + 初始化模式
HFGameStart.InitManager()
-> 各业务 Manager.Instance 初始化
-> Manager 监听 STC 事件
对应框架能力：
2. 事件驱动数据流
服务器消息 S2C
-> 反射创建 STC 事件
-> 业务 Manager 监听并更新数据
-> 派发 CTC 事件通知 UI
对应框架能力：
3. GM 命令统一包装
GM 窗口
-> 选择 msgId 和参数
-> 包装成 GMC2S
-> 发送真实业务 Network_MsgId
对应框架能力：
4. 通用弹窗 / Tips 展示
业务逻辑调用 HFFunCatalogue.Tips.ShowCommonRewardTips(rewardItems)
-> 打开通用奖励窗口
-> 窗口内资源组件监听背包事件刷新
对应框架能力：
使用说明
- AI 阅读时应先读框架文档，再读业务参考。
- 业务参考中的具体类名、协议号不可直接套用到其他项目。
- 如需新增业务参考，放入
business-reference/<project>/features/，并在本文件补充映射。
文档关联
当本文档发生变更时，应同步检查以下关联文档，避免信息不一致。
| 文档 | 关联原因 |
|---|---|
| 业务参考总入口.md | 业务参考总入口指向本映射文档 |
| features/*.md | 每个业务功能文档都应在映射表中有对应行 |
| modules/模块索引.md | 模块索引可链接到业务参考区 |