gewuyou/GFramework

mirror of https://github.com/GeWuYou/GFramework.git synced 2026-05-06 16:16:44 +08:00

gewuyou 121479835a docs(governance): 收口 PR 审查遗留文档问题

- 修复抽象层入口页与生命周期文档中的语义化导航和初始化入口说明
- 更新教程与排障文档中过时的架构级 Init() 示例，区分 OnInitialize()、InstallModules() 与 OnInit()
- 归档 active tracking 的详细验证历史并补充 RP-048 trace

2026-04-28 08:52:07 +08:00

1.4 KiB

Raw Blame History

title, description

title	description
抽象接口	GFramework 各抽象层模块的阅读入口与使用边界。

抽象接口

GFramework.*.Abstractions 用来承载跨模块协作所需的契约，而不是运行时实现。

适合阅读这部分内容的场景：

你要做模块拆分，只想依赖接口，不想直接引用完整运行时
你要为测试、编辑器工具或插件提供替身实现
你在维护生成器、适配层或二次封装，需要先理解契约边界

阅读顺序

Core 抽象层：Core 抽象层说明
Game 抽象层：Game 抽象层说明
Ecs.Arch 抽象层：Ecs.Arch 抽象层说明

使用建议

如果你只是想直接使用框架功能，优先从对应运行时模块说明和栏目页开始。
只有在明确需要“契约层而非实现层”时，才单独依赖 *.Abstractions 包。
抽象层页面会解释接口分组与职责；实际安装与接入路径，仍应以对应运行时模块说明和快速开始为主。

当前边界

GFramework.Core.SourceGenerators.Abstractions
GFramework.Godot.SourceGenerators.Abstractions
GFramework.SourceGenerators.Common

这些目录当前不作为独立抽象接口栏目维护，而是作为源码生成器家族的内部支撑模块，分别跟随所属模块 README 和 source-generators 栏目维护。