mirror of https://github.com/GeWuYou/GFramework.git synced 2026-05-11 20:38:58 +08:00

GeWuYou a67aa8c305 docs(ai-plan): 迁移 analyzer 恢复文档到 ai-plan

- 新增 analyzer-warning-reduction topic 的 active 与 archive 恢复入口
- 归档 local-plan 中的 RP-001 tracking 和 trace 历史并移除旧目录
- 更新公共索引与 ai-plan-governance 记录并补充迁移验证

2026-04-19 16:12:32 +08:00

3.0 KiB

Raw Blame History

Analyzer Warning Reduction 跟踪

目标

继续以“优先低风险、保持行为兼容”为原则收敛当前仓库的 Meziantou analyzer warnings，并在首轮大规模清理完成后，判断剩余结构性 warning 是否值得在下一轮继续推进。

当前恢复点

恢复点编号：ANALYZER-WARNING-REDUCTION-RP-001
当前阶段：Phase 1
当前焦点：
- 已将旧 local-plan/ 迁入 ai-plan/public/analyzer-warning-reduction/，active 入口只保留当前恢复信息
- 基于现有剩余热点，评估 MA0051、MA0048、MA0046 与少量 MA0016 是否适合继续在同一主线上处理
- 若继续推进，优先选择不引入 API rename、公共契约漂移或 Godot 宿主不稳定测试的切入点

当前状态摘要

已完成 GFramework.Core、GFramework.Cqrs、GFramework.Godot 与部分 source generator 的低风险 warning 清理
已完成多轮 CodeRabbit follow-up 修复，并用定向测试与项目/解决方案构建验证了关键回归风险
当前剩余 warning 已集中到长方法、文件/类型命名冲突、delegate 形状和少量公共集合抽象接口问题

当前活跃事实

当前主题仍是 active topic，因为剩余结构性 warning 是否继续推进尚未决策
RP-001 的详细实现历史、测试记录和 warning 热点清单已归档到主题内 archive/
当前工作树分支 fix/analyzer-warning-reduction-batch 已在 ai-plan/public/README.md 建立 topic 映射

当前风险

结构性重构风险：剩余 MA0051 与 MA0048 可能要求较大的文件拆分或类型重命名
- 缓解措施：只在下一轮明确接受结构调整成本时再继续推进，不在恢复点模糊的情况下顺手扩面
测试宿主稳定性风险：部分 Godot 失败路径在当前 .NET 测试宿主下仍不稳定
- 缓解措施：继续优先使用稳定的 targeted test、项目构建和相邻 smoke test 组合验证
多目标框架 warning 解释风险：同一源位置会在多个 target framework 下重复计数
- 缓解措施：继续以唯一源位置和 warning 家族为主要决策依据，而不是只看原始 warning 总数

活跃文档

历史跟踪归档：analyzer-warning-reduction-history-rp001.md
历史 trace 归档：analyzer-warning-reduction-history-rp001.md

验证说明

RP-001 的详细 warning 清理、回归修复与定向验证命令均已迁入主题内历史归档
active 跟踪文件只保留当前恢复点、活跃事实、风险与下一步，不再重复保存已完成阶段的长篇历史

下一步

若要继续该主题，先读 active tracking，再按需展开历史归档中的 warning 热点与验证记录
从 MA0051、MA0048、MA0046 中只选一个结构性切入点继续，不要在同一轮同时扩多个风险面
若本主题确认暂缓，可保持当前归档状态，不需要再恢复 local-plan/

3.0 KiB Raw Blame History Unescape Escape