gewuyou/GFramework

mirror of https://github.com/GeWuYou/GFramework.git synced 2026-05-07 00:39:00 +08:00

gewuyou 0722ba6dbd docs(batch-boot): 收口公开入口页文案

- 更新 source-generators、game、api-reference 与 abstractions 入口页的 reader-facing 标题和导航口吻

- 优化 godot setting 页的继续阅读标题，移除文件名式与指挥式表述

- 补充 documentation full coverage active topic 的 RP-045 跟踪与验证记录

2026-04-28 07:37:19 +08:00

1.4 KiB

Raw Blame History

title, description

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

抽象接口

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

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

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

阅读顺序

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

使用建议

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

当前边界

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

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