gewuyou/GFramework

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

gewuyou 241c9ffeb3 docs(source-generators): 补充迁移兼容说明并归档恢复历史

- 补充 Schema 配置生成器专题的迁移步骤、兼容边界与回退建议

- 更新 active tracking 与 active trace，只保留当前恢复事实、验证结果与归档指针

- 新增 RP-049 到 RP-052 的状态、验证与时间线归档文件

2026-05-01 13:22:14 +08:00

2.3 KiB

Raw Blame History

Documentation Full Coverage Governance Trace History (RP-049 to RP-052)

Scope

该归档记录 RP-049 到 RP-052 从 active trace 迁出的阶段时间线，保留每轮恢复点、核心决策与停止条件。
对应的验证明细继续保存在： ai-plan/public/documentation-full-coverage-governance/archive/todos/documentation-full-coverage-governance-validation-history-rp-049-to-rp-052-2026-05-01.md

2026-04-29 / RP-049

由于旧 PR 恢复路径已经失效，这一轮改用 origin/main 作为唯一 batch baseline，并重新确认当前分支仍为 docs/sdk-update-documentation。
本轮主要清理 godot、game 与少量 README 中仍显露内部证据、命令式导流和原始路径标签的 reader-facing 问题。
停止条件保持为 $gframework-batch-boot 50，但本轮并未逼近阈值。

2026-04-29 / RP-050

主线程继续沿低风险文案批次推进，接受 2 个 explorer 的热点排序，只处理“改句子即可闭环”的页面与 README 标签问题。
实际落地集中在 game/data.md、game/storage.md、godot/ui.md 与 2 个 README。
剩余命中已接近结构级 README 重写，因此被明确排除出这一轮批次。

2026-04-29 / RP-051

在确认 HEAD 与 origin/main 同步后，本轮把目标提升为新的 docs coverage 入口补链，而不是继续做纯措辞巡检。
接受的结论是：Game.SourceGenerators 需要独立专题页，而 SourceGenerators.Common 与各 *.SourceGenerators.Abstractions 只需要在 landing / API 入口内承担共享 diagnostics 与 attribute 契约说明。
与此同时，Cqrs.SourceGenerators 的真实缺口被限定为对 fallback 精度、分层策略和 GF_Cqrs_001 判断顺序的 reader-facing 解释，而不是继续新增第二张专题页。

2026-04-30 / RP-052

这一轮 coverage 扩展提交为 f88f96c3，提交后 branch diff 相对 origin/main 回落到 8 files / 337 lines`，重新释放了 stop-condition 余量。
active topic 后续仍可继续扩批，但更适合选择“已有 package README、但站内 docs 仍缺 reader-facing 专题”的切片，而不是继续给共享支撑层单开页面。
该状态也为后续用 $gframework-pr-review 精确跟进最新 review 线程提供了更清晰的恢复入口。