GeWuYou cc49b8638f docs(governance): 建立长期文档治理入口
- 新增 documentation-full-coverage-governance active topic 与首轮 inventory、trace 入口
- 补充 GFramework.Ecs.Arch.Abstractions README、抽象接口页面与导航映射
- 更新 API 参考页与根 README,明确内部支撑模块 owner 和阅读链路
2026-04-22 15:07:15 +08:00

1.4 KiB

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

抽象接口

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

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

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

阅读顺序

使用建议

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

当前边界

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

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