mirror of https://github.com/GeWuYou/GFramework.git synced 2026-05-13 22:25:37 +08:00

GeWuYou 60faf8eaff docs(core): 重写核心专题页文档

- 更新 architecture、context、lifecycle、command、query 与 cqrs 页面，使其对齐当前公开 API 与初始化语义
- 移除 Init、属性式总线、旧输入赋值示例和已移除的 Mediator 兼容入口等过时说明
- 补充 documentation-governance-and-refresh 主题的恢复点、验证结果与下一步专题页计划

2026-04-21 09:14:06 +08:00

3.7 KiB

Raw Blame History

Documentation Governance And Refresh 跟踪

目标

继续以“文档必须可追溯到源码、测试与真实接入方式”为原则，收敛 GFramework 的仓库入口、模块入口与 docs/zh-CN 采用链路，避免未来再次出现 API、安装方式与目录结构失真。

当前恢复点

恢复点编号：DOCUMENTATION-GOVERNANCE-REFRESH-RP-003
当前阶段：Phase 3
当前焦点：
- 已完成 docs/zh-CN/core/architecture.md、context.md、lifecycle.md、command.md、query.md 与 cqrs.md 的专题页重写
- core 关键专题页已改回当前 Architecture、ArchitectureContext、旧 Command/Query 兼容层与新 CQRS runtime 的真实入口语义
- 下一轮需要继续推进 docs/zh-CN/core/* 余下专题页，以及 docs/zh-CN/game/*、 docs/zh-CN/source-generators/* 的专题页核对

当前状态摘要

文档治理规则已收口到仓库规范，README、站点入口与采用链路不再依赖旧文档自证
高优先级模块入口与 core 关键专题页已回到可作为默认导航入口的状态
当前主题仍是 active topic，因为 core 其余专题页及 game、source-generators 栏目下仍可能包含与实现漂移的旧内容

当前活跃事实

旧 local-plan/ 的详细 todo 与 trace 已迁入主题内 archive/
当前分支 docs/sdk-update-documentation 已在 ai-plan/public/README.md 建立 topic 映射
active 跟踪文件只保留当前恢复点、活跃事实、风险与下一步，不再重复保存已完成阶段的长篇历史
core、game 与 source-generators 三个栏目入口页现在都以模块 README 与当前包拆分为准
docs 站点构建已验证通过，修正了 VitePress 对 docs/ 目录外相对链接的 dead-link 检查问题
core 关键专题页已移除 Init()、属性式 CommandBus / QueryBus、旧 Input 赋值式示例和已移除的 RegisterMediatorBehavior 等过时说明

当前风险

旧专题页示例失真风险：docs/zh-CN/core/*、game/* 与 source-generators/* 中仍可能保留看似合理但与真实实现不一致的示例
- 缓解措施：继续按源码、测试、*.csproj 与 ai-libs/ 下已验证参考实现核对，不把旧文档当事实来源
采用路径误导风险：根聚合包与模块边界若再次被写错，会继续误导消费者的包选择
- 缓解措施：保持“源码与包关系优先”的证据顺序，改动采用说明时同步核对包依赖与生成器 wiring
Active 入口回膨胀风险：后续若把栏目级重写过程直接追加到 active 文档，会再次拖慢恢复
- 缓解措施：阶段完成并验证后，继续把细节迁入本 topic 的 archive/

活跃文档

历史跟踪归档：documentation-governance-and-refresh-history-through-2026-04-18.md
历史 trace 归档：documentation-governance-and-refresh-history-through-2026-04-18.md

验证说明

旧 local-plan/ 的详细实施历史与文档站构建结果已迁入主题内归档
active 跟踪文件已按 ai-plan 治理规则精简为当前恢复入口
cd docs && bun run build

下一步

继续核对 docs/zh-CN/core/* 余下专题页，优先处理 events、property、state-management、coroutine 与 logging
再推进 docs/zh-CN/game/* 与 docs/zh-CN/source-generators/* 的专题页重写，优先处理仍引用旧安装方式或旧 API 的页面
若专题页批量重写完成且验证通过，将本轮 core 专题页收口和后续修订过程迁入本 topic 的 archive/

3.7 KiB Raw Blame History Unescape Escape