GFramework/ai-plan/public/analyzer-warning-reduction/todos/analyzer-warning-reduction-tracking.md

Analyzer Warning Reduction 跟踪

目标

继续以“直接看构建输出、直接修构建 warning”为原则推进当前分支，并保持 active recovery 文档只保留当前真值。

当前恢复点

• 恢复点编号：ANALYZER-WARNING-REDUCTION-RP-051
• 当前阶段：Phase 51
• 当前焦点：
  • 2026-04-24 本轮已完成 GFramework.Godot.SourceGenerators.Tests warning 清理
  • 当前主线程切片从生成器实现转到对应测试项目，并已把 GFramework.Godot.SourceGenerators.Tests 从 24 个 warning 降到 0
  • 当前批次按 origin/main merge-base 计算的累计分支 diff 预计为 23 个文件，仍低于 $gframework-batch-boot 75 的主阈值
  • 当前工作树除未跟踪的 .codex 目录外，还存在与本批次无关的既有文档 / 跟踪文件修改；提交当前批次时必须只包含本 topic 相关文件

当前活跃事实

• 之前记录的 plain dotnet build 0 Warning(s) 属于增量构建假阴性，不能再作为 warning 检查真值
• 本轮已完成 GFramework.Godot.SourceGenerators warning 清理：clean Release build 从 9 个 warning 降至 0 个 warning
• 当前已确认解决的文件包括 BindNodeSignalGenerator.cs、GetNodeGenerator.cs、GodotProjectMetadataGenerator.cs、Registration/AutoRegisterExportedCollectionsGenerator.cs
• 本轮直接执行仓库根目录 dotnet clean 仍在 ValidateSolutionConfiguration 阶段失败，输出未提供具体 error 文本
• 本轮直接执行仓库根目录 dotnet build 成功，并给出 1184 warning(s) 的真实输出
• GFramework.Godot.SourceGenerators.Tests 已通过测试辅助模板抽取与 ConfigureAwait(false) 修正，当前 Debug / Release 构建均为 0 Warning(s)
• 本轮已验证 dotnet test GFramework.Godot.SourceGenerators.Tests/GFramework.Godot.SourceGenerators.Tests.csproj -c Release --no-build，结果为 Passed: 48

当前风险

• 如果后续继续依赖增量 dotnet build，容易再次把 warning 数量误判为 0
  • 缓解措施：每轮 warning 检查前先执行 dotnet clean，再执行目标 dotnet build
• 仓库根目录 dotnet clean 目前仍然无法给出新的 clean 基线
  • 缓解措施：若下一轮继续做整仓 warning reduction，先定位 dotnet clean 的 solution-level 失败原因，或明确继续沿用用户确认的 1193 warning(s) clean 基线与本轮 1184 warning(s) direct build 观测值
• 当前 worktree 已存在与本批次无关的未提交改动
  • 缓解措施：提交当前批次时只暂存 GFramework.Godot.SourceGenerators.Tests 与对应 ai-plan 文件，避免混入其他 topic 变更

活跃文档

• 当前轮次归档：
  • analyzer-warning-reduction-history-rp042-rp048.md
• 历史跟踪归档：
  • analyzer-warning-reduction-history-rp001.md
  • analyzer-warning-reduction-history-rp002-rp041.md
• 历史 trace 归档：
  • analyzer-warning-reduction-history-rp001.md
  • analyzer-warning-reduction-history-rp002-rp041.md
  • analyzer-warning-reduction-history-rp042-rp048.md

验证说明

• dotnet clean
  • 结果：失败；停在 solution ValidateSolutionConfiguration，0 Warning(s)、0 Error(s)，未输出更具体的 error 文本
• dotnet build
  • 结果：成功；1184 Warning(s)、0 Error(s)
• dotnet build GFramework.Godot.SourceGenerators.Tests/GFramework.Godot.SourceGenerators.Tests.csproj
  • 初始结果：成功；24 Warning(s)、0 Error(s)
  • 本轮收尾结果：成功；0 Warning(s)、0 Error(s)
• dotnet build GFramework.Godot.SourceGenerators.Tests/GFramework.Godot.SourceGenerators.Tests.csproj -c Release
  • 结果：成功；0 Warning(s)、0 Error(s)
• dotnet test GFramework.Godot.SourceGenerators.Tests/GFramework.Godot.SourceGenerators.Tests.csproj -c Release --no-build
  • 结果：成功；Passed: 48、Failed: 0

下一步建议

1. 提交当前 GFramework.Godot.SourceGenerators.Tests 清理批次，并确认提交只包含本 topic 相关文件
2. 如果继续 warning reduction，优先重新评估仓库根目录 dotnet clean 的 solution-level 失败，再决定是继续从整仓 dotnet build 输出挑热点，还是先修复 clean 基线采集问题