gewuyou/GFramework
1
0
Fork 0
mirror of https://github.com/GeWuYou/GFramework.git synced 2026-05-07 00:39:00 +08:00
Code Issues Packages Projects Releases Wiki Activity
GFramework/ai-plan/public/analyzer-warning-reduction/traces/analyzer-warning-reduction-trace.md
gewuyou 6ff07ad3d9 fix(godot): 清理 Godot 模块与测试项目告警 
- 优化 GodotYamlConfigEnvironment 目录枚举逻辑，拆分 helper 以消除 MA0051

- 修复 Godot 生命周期 await 的上下文声明，显式保留主线程同步上下文

- 更新 Godot.Tests 异步断言与字符串 comparer，用例项目构建收敛到 0 warning(s)

- 补充 analyzer-warning-reduction 跟踪与 trace，记录 RP-053 的批次结果与验证
2026-04-24 17:04:53 +08:00

10 KiB
Raw Blame History

Analyzer Warning Reduction 追踪

Analyzer Warning Reduction 追踪

2026-04-24 — RP-053

阶段：GFramework.Godot / GFramework.Godot.Tests 小批次 warning 清理

  • 触发背景：
    • 用户以 $gframework-batch-boot 75 要求继续按批次推进 analyzer warning reduction，并以 origin/main 作为累计分支 diff 基线
    • 当前 worktree fix/analyzer-warning-reduction-batch 相对 origin/main 的已提交分支 diff 为 0 个文件，具备继续落一个低风险 warning batch 的空间
    • solution-level dotnet clean GFramework.sln -c Release 仍在 ValidateSolutionConfiguration 阶段失败，因此本轮继续用直接 dotnet build GFramework.sln -c Release 建立热点观察值
  • 主线程实施：
    • 运行 dotnet build GFramework.sln -c Release，确认当前整仓观测值为 1122 warning(s)，并从输出中挑选 GFramework.Godot 的小范围热点作为本轮批次
    • 在 GodotYamlConfigEnvironment.cs 中按“普通文件系统 / Godot 路径”拆分目录枚举 helper，消除 MA0051
    • 在 AbstractArchitecture.cs 与 SceneBehaviorBase.cs 中将必须保留 Godot 主线程上下文的 await 显式改为 .ConfigureAwait(true)，清理 MA0004 并把线程意图写入注释
    • 在 GFramework.Godot.Tests 中补齐异步断言的 .ConfigureAwait(false)，并让 RichTextMarkupTests 的测试字典显式指定 StringComparer.Ordinal
  • 验证里程碑：
    • dotnet clean GFramework.sln -c Release
      • 结果：失败；停在 ValidateSolutionConfiguration，0 Warning(s)、0 Error(s)
    • dotnet build GFramework.sln -c Release
      • 结果：成功；1122 Warning(s)、0 Error(s)
    • dotnet build GFramework.Godot/GFramework.Godot.csproj -c Release
      • 第一轮修复后：成功；12 Warning(s)、0 Error(s)，仅剩 MA0004
      • 第二轮修复后：成功；0 Warning(s)、0 Error(s)
    • dotnet test GFramework.Godot.Tests/GFramework.Godot.Tests.csproj -c Release --filter "FullyQualifiedName~AbstractArchitectureModuleInstallationTests|FullyQualifiedName~GodotYamlConfigLoaderTests|FullyQualifiedName~RichTextMarkupTests"
      • 结果：成功；Passed: 15、Failed: 0
    • dotnet build GFramework.Godot.Tests/GFramework.Godot.Tests.csproj -c Release
      • 并行验证时：成功；1 Warning(s)、0 Error(s)；MSB3026 为与并行 dotnet test 竞争输出 DLL 的文件占用
      • 串行复验：成功；0 Warning(s)、0 Error(s)
  • 当前结论：
    • GFramework.Godot 与 GFramework.Godot.Tests 本轮直接涉及的 warning 已全部清零
    • 当前待提交代码批次相对 origin/main 的源码 diff 为 6 个文件、107 行，距离 $gframework-batch-boot 75 主停止阈值仍有充足余量
    • 继续推进的下一批候选将主要落在 GFramework.Game 等高 warning 基线模块，已不再属于当前同等级低风险切片，因此本轮在这里收口并进入提交

2026-04-24 — RP-052

阶段：PR review follow-up（comparer 契约 + ConfigureAwait(false) 收尾）

  • 触发背景：
    • 当前分支 PR #283 的最新 review 中，greptile-apps[bot] 仍有一个未解决线程，指出 UnifiedSettingsDataRepository.CloneFile fallback 会静默丢失原 comparer
    • CodeRabbit 另指出 AutoRegisterExportedCollectionsGeneratorTests.cs 中还残留 5 处 await test.RunAsync();，与同项目其他测试文件的 .ConfigureAwait(false) 风格不一致
  • 主线程实施：
    • 复核 PR review JSON、UnifiedSettingsDataRepository.cs、UnifiedSettingsFile.cs 与 AutoRegisterExportedCollectionsGeneratorTests.cs 的当前代码，确认只有 comparer 契约线程仍属最新 head 上的实质问题
    • 将 UnifiedSettingsFile.Sections 的 XML 注释补充为显式 comparer 契约，并把默认字典初始化改为 StringComparer.Ordinal
    • 将 CloneFile fallback 从隐式默认 comparer 改为显式 StringComparer.Ordinal，并同步修正文档注释，避免继续暗含“保留原语义”的错误表述
    • 把 AutoRegisterExportedCollectionsGeneratorTests 中剩余的 5 处 await test.RunAsync(); 统一为 .ConfigureAwait(false)，同时让 VerifyDiagnosticsAsync 内部也消费 ConfigureAwait(false)
  • 验证里程碑：
    • dotnet build GFramework.Game/GFramework.Game.csproj -c Release
      • 结果：成功；533 Warning(s)、0 Error(s)；GFramework.Game 仍有既有 warning 基线，本轮 follow-up 仅处理 PR review 指向的 comparer 契约与测试异步等待一致性
    • 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
      • 首次并行复验：失败；FileNotFoundException，原因是 --no-build 测试在 Release DLL 落盘前启动
      • 串行复验：成功；Passed: 48、Failed: 0
  • 当前结论：
    • PR #283 当前仍打开的 comparer review thread 已在本地代码与 XML 注释层面得到对应修复
    • AutoRegisterExportedCollectionsGeneratorTests 的异步等待风格已与同项目其他测试保持一致
    • 当前改动已通过直接受影响测试项目的 Release build 与串行 Release test 复验，可进入提交阶段

2026-04-24 — RP-051

阶段：GFramework.Godot.SourceGenerators.Tests warning 清零

  • 触发背景：
    • 用户要求直接运行 dotnet clean，不再添加额外 shell 包装；solution-level dotnet clean 仍然在 ValidateSolutionConfiguration 阶段失败
    • 直接执行仓库根目录 dotnet build 成功，并输出 1184 warning(s)，说明当前真实热点已从 GFramework.Godot.SourceGenerators 转移到对应测试项目
  • 主线程实施：
    • 以 GFramework.Godot.SourceGenerators.Tests 为独立批次，先确认该项目本地基线为 24 warning(s)
    • 在 BindNodeSignalGeneratorTests.cs、AutoSceneGeneratorTests.cs、AutoUiPageGeneratorTests.cs、GetNodeGeneratorTests.cs、AutoRegisterExportedCollectionsGeneratorTests.cs、GodotProjectMetadataGeneratorTests.cs 中抽取共享 source / diagnostic helper，压缩重复长方法
    • 在 Core/GeneratorTest.cs 中补充 ConfigureAwait(false)，清除项目内唯一 MA0004
    • 把 GFramework.Godot.SourceGenerators.Tests 项目 warning 从 24 降到 0
  • 验证里程碑：
    • 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)
      • 第一批（BindNodeSignal + GeneratorTest）后：16 Warning(s)
      • 第二批（AutoScene / AutoUiPage / GetNode）后：8 Warning(s)
      • 第三批（Registration / Project）后：1 Warning(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
  • 当前结论：
    • GFramework.Godot.SourceGenerators.Tests 已在 Debug / Release 构建下达到 0 warning(s)
    • 按 origin/main merge-base 计算并只纳入当前暂存批次时，累计分支 diff 为 23 个文件，低于 $gframework-batch-boot 75 的主停止阈值
    • 仓库根目录 dotnet clean 仍无法稳定产出新的 clean 基线，需要在下一轮单独排查
    • 当前 worktree 已有与本批次无关的既有改动；提交时必须只暂存 analyzer warning reduction 相关文件

2026-04-24 — RP-050

阶段：clean-build 基线修正与 GFramework.Godot.SourceGenerators 切片清零

  • 触发背景：
    • 用户确认之前的 0 Warning(s) 来自增量构建假阴性；只有先 dotnet clean 再 dotnet build，warning 才会重新出现
    • 用户给出 clean solution build 的真实结果：Build succeeded with 1193 warning(s)
  • 主线程实施：
    • 纠正当前 topic 的 active todo / trace，把 clean build 作为新的 warning 检查真值
    • 在 BindNodeSignalGenerator.cs、GetNodeGenerator.cs、GodotProjectMetadataGenerator.cs 中完成分阶段方法抽取与字符串比较修正
    • 在 Registration/AutoRegisterExportedCollectionsGenerator.cs 中拆分 TryCreateRegistration，清除最后一个 MA0051
    • 更新 AGENTS.md，明确 warning 检查必须先 dotnet clean 再 dotnet build
  • 验证里程碑：
    • dotnet clean GFramework.Godot.SourceGenerators/GFramework.Godot.SourceGenerators.csproj -c Release
      • 结果：成功；0 Warning(s)、0 Error(s)
    • dotnet build GFramework.Godot.SourceGenerators/GFramework.Godot.SourceGenerators.csproj -c Release
      • 首次验证：成功；1 Warning(s)，剩余 Registration/AutoRegisterExportedCollectionsGenerator.cs(182,25) MA0051
      • 修复后复验：成功；0 Warning(s)、0 Error(s)
  • 当前结论：
    • GFramework.Godot.SourceGenerators 已在 clean Release build 下从 9 个 warning 降到 0 个 warning
    • 整仓库 warning 基线仍以用户确认的 clean solution build 1193 warning(s) 为准
    • 下一轮应继续从 clean solution build 输出中选择新的低风险热点

Archive Context