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

gewuyou 704fdaa2c8 docs(core): 对齐 Core 模块文档入口

- 更新 Core 与 Core.Abstractions README 的目录映射和 XML 阅读入口

- 重写 Core Abstractions 页面，改为契约边界与最小接入路径说明

- 补充 Core landing page、API 参考入口和 ai-plan 跟踪记录

2026-04-22 15:32:22 +08:00

GFramework.Core

GFramework.Core 是框架的基础运行时，负责架构生命周期、组件注册、上下文访问，以及不依赖具体引擎的通用能力。

如果你只想先把框架跑起来，应先从这个模块开始。

模块定位

这一层提供：

它不负责：

直接依赖：
- GFramework.Cqrs
- GFramework.Cqrs.Abstractions
- GFramework.Core.Abstractions
常见上层模块：
- GFramework.Game
- GFramework.Godot

如果你只需要契约，不需要实现层，改为依赖 ../GFramework.Core.Abstractions/README.md。

目录	作用
`Architectures/`	架构入口、上下文、生命周期、模块安装与组件注册
`Services/`	服务模块注册、生命周期协调与模块管理
`Command/`	旧版命令执行器与同步 / 异步命令基类
`Query/`	旧版查询执行器与同步 / 异步查询基类
`Events/`	事件总线、事件作用域、统计与过滤
`Property/`	`BindableProperty<T>` 与相关解绑对象
`State/`	状态机与状态切换事件
`StateManagement/`	Store、selector、middleware 与状态诊断
`Coroutine/`	协程调度、快照、统计与优先级
`Time/`	默认时间提供器与协程时间源
`Resource/`	资源缓存、句柄和释放策略
`Pool/`	对象池系统与常用池化辅助实现
`Logging/`	logger、factory、配置与组合日志器
`Ioc/`	基于 `Microsoft.Extensions.DependencyInjection` 的容器适配
`Concurrency/`	键控异步锁与统计
`Configuration/`	配置管理器与配置监听解绑对象
`Environment/`	运行环境对象与上下文环境扩展
`Pause/`	暂停栈和暂停范围
`Localization/`	本地化表与格式化入口
`Rule/`	`ContextAwareBase` 等上下文感知基类
`Functional/`	`Option`、`Result` 等轻量函数式工具
`Extensions/`	上下文与集合等扩展方法

dotnet add package GeWuYou.GFramework.Core
dotnet add package GeWuYou.GFramework.Core.Abstractions

最小入口：

最小示例见：