docs(game): 同步配置工作流入口边界

- 更新仓库根 README 的 AI-First 配置接入提示与共享子集边界说明

- 补充 GFramework.Game README 中的配置系统采用约束与 raw YAML 回退路径
This commit is contained in:
gewuyou 2026-04-30 11:57:19 +08:00 committed by GeWuYou
parent fdcb11c92c
commit 0721cafd03
2 changed files with 15 additions and 0 deletions

View File

@ -292,6 +292,13 @@ var registry = bootstrap.Registry;
- [内容配置系统](../docs/zh-CN/game/config-system.md)
接入前建议先记住当前采用边界:
- 正式契约以 `YamlConfigLoader``GFramework.Game.SourceGenerators` 共享支持的 schema 子集为准
- `additionalProperties` 当前只接受 `false`,用于保持对象字段集闭合
- `oneOf` / `anyOf` 这类会改变生成类型形状的组合关键字当前不属于采用路径
- VS Code 配置工具是内容维护辅助层;如果 schema 超出共享子集,应回退到 raw YAML 与 schema 本体设计
### 4. 接入 Scene / UI 路由
这里的最小前提不是“直接 new 一个 router”而是先补齐运行时依赖

View File

@ -15,6 +15,7 @@
- 想先跑一个最小例子:[快速开始](docs/zh-CN/getting-started/quick-start.md)
- 想先确认该装哪些包:[安装配置](docs/zh-CN/getting-started/installation.md)
- 想接入 AI-First 配置工作流:[配置系统](docs/zh-CN/game/config-system.md) / [VS Code 配置工具](docs/zh-CN/game/config-tool.md)
当前正式支持边界以 `GFramework.Game` Runtime 与 `GFramework.Game.SourceGenerators` 共享 schema 子集为准VS Code 工具是辅助层,不会单独扩出另一套配置契约
- 已经知道要用哪个模块:直接进入对应模块的说明页
## 模块地图
@ -74,6 +75,13 @@
- `GeWuYou.GFramework.*.SourceGenerators`
只在需要编译期生成代码时安装,版本应与运行时包保持一致。
如果你采用 AI-First 配置工作流,建议在进入实现前先确认两条边界:
- 当前共享子集接受闭合对象边界 `additionalProperties: false`
- `oneOf` / `anyOf` 这类会改变生成类型形状的组合关键字当前会被 Runtime / Generator / Tooling 直接拒绝
更复杂的 schema shape 需要先回到 schema 设计与 raw YAML 维护路径,而不是假定编辑器工具存在隐藏支持。
## 最小安装组合
```bash