mirror of https://github.com/GeWuYou/GFramework.git synced 2026-05-14 06:34:30 +08:00

GeWuYou 9b904709d6 docs(ai-plan): 收口主题内归档与恢复入口

- 新增 活跃主题的 archive 目录并归档已完成且已验证的历史 tracking 与 trace\n- 更新 ai-plan 治理规则、README 与 boot skill，明确 active todo 和 trace 必须保持精简\n- 收短 ai-plan-governance、ai-first-config-system 与 cqrs-rewrite 的默认恢复入口并补充归档索引

2026-04-19 15:11:50 +08:00

2.9 KiB

Raw Blame History

AI-First Config System 跟踪

目标

基于当前 GFramework 设计结论，继续推进 AI-First 游戏配置系统，并把主线保持在 C# Runtime + Source Generator + Consumer DX。

当前恢复点

恢复点编号：AI-FIRST-CONFIG-RP-002
当前阶段：C# Runtime + Source Generator + Consumer DX
当前焦点：
- 在当前稳定 format 子集与 object-focused allOf 之后，继续评估仍不改变生成类型形状的下一批组合关键字
- 优先考察 if / then / else 是否能在 Runtime / Generator / Tooling 三端保持一致语义
- 继续把 VS Code 工具能力视为非阻塞项，不让复杂 UI 编辑器需求反过来拖慢 C# 主线

当前状态

已完成 Runtime、YAML Loader、Source Generator 与 VS Code Extension 的首轮可用版本
已落地项目级聚合注册入口、GeneratedConfigCatalog、GameConfigBootstrap、GameConfigModule
已补齐一批共享 JSON Schema 子集，包括：
- enum、const、not、pattern
- format 稳定子集：date、date-time、duration、email、time、uri、uuid
- minItems、maxItems、exclusiveMinimum、exclusiveMaximum、multipleOf、uniqueItems
- minProperties、maxProperties、dependentRequired、dependentSchemas、allOf
当前最细粒度的下一阶段 backlog 保留在独立文件：
- ai-plan/public/ai-first-config-system/todos/ai-first-config-system-csharp-experience-next.md

当前未完成项

继续扩展“不会改变生成类型形状”的共享关键字支持
继续降低复杂 schema 与多配置域项目的接入成本
让 VS Code 表单支持更深层对象数组嵌套，减少 raw YAML 回退
为复杂结构提供比“顶层标量 / 标量数组”更强的批量编辑能力
在真实 VS Code 宿主中完成对象数组编辑与复杂 schema 的交互式手工验证

活跃文档

当前 backlog：ai-first-config-system-csharp-experience-next.md
历史跟踪归档：ai-first-config-system-history-through-2026-04-17.md
历史 trace 归档：ai-first-config-system-history-through-2026-04-17.md

验证说明

2026-04-17 之前的详细实现记录与定向验证命令已归档到历史 tracking / trace
active 跟踪文件只保留当前恢复点、当前状态和下一步，不再重复堆积已完成阶段的完整历史

下一步

先检查 GFramework.Game/Config/YamlConfigSchemaValidator.cs、GFramework.SourceGenerators/Config/SchemaConfigGenerator.cs、tools/gframework-config-tool/src/configValidation.js
评估 if / then / else 是否能在不引入生成类型形状漂移的前提下落地
若结论是否定，再选择下一批仍能共享解释的关键字，而不是先回到工具 UI 深挖

2.9 KiB Raw Blame History Unescape Escape