给全部源码补中文注释,并新增代码导览

- 67 个 .cs 文件加中文注释:每个文件顶部说明职责/调用方/线程与节拍/
  已知限制/「要改什么就改哪里」,字段与方法逐条一行说明,复杂逻辑内插关键步骤
- 纯注释改动:脚本校验所有新增行都是注释、无非注释改动(仅 2 个文件的 BOM
  随新头部注释下移,文件仍以 BOM 开头)
- 新增 docs/代码导览.md:模块地图、「我要改 X 看哪个文件」对照表、易踩的坑、
  悬浮条显示规则、测试与验收指引
- 编译通过,回归测试 23/23 通过

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
zimoyin
2026-10-13 15:44:15 +08:00
parent 9eff3ec410
commit 66ab309939
72 changed files with 3907 additions and 2 deletions
+11
View File
@@ -1,4 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!--
回归测试工程(net48 控制台程序,AssemblyName = RegressionTests)。
引用主项目 pacs_win_uia 与几个受测的 WinForms/服务类型,在纯内存快照或本进程
自建控件上跑断言;不调用 UIA 读自身控件树(会崩溃),真实 UIA 场景见 tests/uia-fixture。
运行:用隔离的 OutputPath 构建后再直接跑 exe,避免锁定 src 正在使用的 bin\Debug:
dotnet msbuild tests\regression\RegressionTests.csproj -t:Build -p:Configuration=Debug
-p:OutputPath=<隔离目录>\ -v:minimal
<隔离目录>\RegressionTests.exe (退出码 0 全通过 / 1 有失败)
-->
<Project ToolsVersion="15.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<PropertyGroup>
<Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
@@ -21,6 +30,7 @@
<Reference Include="System.Runtime.Serialization" />
<Reference Include="System.Xml" />
</ItemGroup>
<!-- 引用主项目:测试直接调用其 ControlPath / ControlLocatorService / Store / FloatingBarManager 等类型。 -->
<ItemGroup>
<ProjectReference Include="..\..\src\pacs_win_uia\pacs_win_uia.csproj">
<Project>{C74B0B3A-0FB4-47CB-9AE8-DC7E0D993202}</Project>
@@ -35,6 +45,7 @@
<Compile Include="FloatingConditionsTests.cs" />
<Compile Include="SettingsComboBoxTests.cs" />
<Compile Include="WindowVisibilityTests.cs" />
<!-- 把主项目的 ControlTreeReconciler 以链接方式编译进测试程序集(部分内部成员需要同程序集可见)。 -->
<Compile Include="..\..\src\pacs_win_uia\UI\ControlTreeReconciler.cs"><Link>ControlTreeReconciler.cs</Link></Compile>
</ItemGroup>
<Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />