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

- 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
+14
View File
@@ -1,3 +1,17 @@
// =====================================================================================
// UiaFixture —— 跨进程验证用的真实 WinForms 夹具(单独的可执行程序)。
//
// 为什么必须是独立进程:本工具靠 UIA 读取“别的进程”的控件树,而 UIA 在**同一进程内**
// 自读自己的控件树会崩溃(见 MEMORY:in-process UIA self-reads segfault)。
// 因此需要一个真正独立的进程暴露一棵已知且稳定的控件树,让工具跨进程去读、去拾取、
// 去按 path 定位——这样测的才是生产路径。夹具自身不做任何 UIA 调用。
//
// 这棵树的控件类型/名称/AutomationId 都固定,且窗口标题与类名在多次运行间保持不变,
// 所以保存的监控条目、悬浮条显示条件可以长期复用它。
//
// 打开方式:tests\run-fixture.cmd(或用 Rider/VS 直接跑本项目)→ 工具里
// 刷新窗口 → 选中「UIA 测试夹具」→ 检查选中窗口;验证清单见 tests\README.md。
// =====================================================================================
using System;
using System.Drawing;
using System.Windows.Forms;
+6
View File
@@ -1,4 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!--
UIA 测试夹具(net48 WinExe,AssemblyName = UiaFixture)。
这是一个**独立进程**的普通 WinForms 窗口,供本工具跨进程用 UIA 读取/拾取/定位。
必须是独立进程:UIA 在同进程内自读自身控件树会崩溃,跨进程读取才是被测的生产路径。
只引用基础框架程序集,不引用主项目、不调用 UIA。用 tests\run-fixture.cmd 构建并启动。
-->
<Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<PropertyGroup>
<Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>