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

- 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
+16
View File
@@ -1,3 +1,17 @@
// =====================================================================================
// WindowVisibilityTests —— 悬浮条遮挡诊断的窗口归属判断回归。
//
// 覆盖范围:WindowVisibility.IsOwnProcessWindow 对零句柄/本进程窗体/外部窗口的分类,
// 以及 DescribeOccluders 生成的遮挡说明——本工具自己的窗口必须被单列为“本工具窗口/
// 设置页自检”,外部窗口则只能被称作普通遮挡,绝不能反过来把遮挡归咎于本工具。
//
// 为什么这样测:只用本测试进程自建的 WinForms 窗体句柄与手工构造的 IntPtr 列表;
// WindowEnumerationResult 天然排除本进程,所以它返回的窗口一定属于外部进程。
// 不调用 UIA、也不操作真实目标窗口。外部窗口很可能不存在(由外部环境决定),
// 因此相关断言在无外部窗口时会打印提示并跳过,属于预期内的“部分跳过”。
//
// 新增用例:加到 Register(...) 列表并实现 private static void 方法,断言走 Check.*。
// =====================================================================================
using System;
using System.Collections.Generic;
using System.Windows.Forms;
@@ -16,7 +30,9 @@ namespace PacsWinUia.RegressionTests
{
public static void Register(IList<KeyValuePair<string, Action>> tests)
{
// 防:本工具自身窗口被误判为外部遮挡窗口(或外部窗口被误判为本进程)。
tests.Add(new KeyValuePair<string, Action>("Own-process detection classifies tool windows", OwnProcess));
// 防:遮挡提示把外部窗口也算作本工具窗口,或本工具窗口不被单独说明。
tests.Add(new KeyValuePair<string, Action>("Occluder message names the blocker and never blames the tool wrongly", OccluderMessages));
}