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

- 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
+17
View File
@@ -1,3 +1,18 @@
// =====================================================================================
// SettingsComboBoxTests —— 设置页悬浮条「进程/类名/标题」下拉的原生选择回归。
//
// 覆盖范围:用真实的 Win32 消息(鼠标点击列表项 + 关闭下拉、方向键选择)驱动下拉,
// 断言 CBN_SELENDOK/SELCHANGE/CLOSEUP 之后原生 EDIT 文本与 ComboBox.Text 一致,
// 并且刷新建议列表 / 切换悬浮条 / 手动输入后选值仍然保留;最后 Save+Load 校验持久化。
//
// 为什么这样测:这是 WinForms 自身控件与其 Win32 子窗口(Edit/List)之间的同步问题,
// 只能靠真实的消息循环验证;用例运行在 Program.Main 的 STA 线程上,所有 HWND 消息
// 只发给本用例自己创建的控件,不涉及 UIA、真实目标窗口枚举、SendInput 或杀进程。
// 截图仅在设置了 PACS_REGRESSION_SCREENSHOTS 环境变量时写出(失败时也有留存)。
//
// 新增用例:加到 Register(...) 列表并实现 private static void 方法,断言走 Check.*;
// 私有成员通过反射访问(Field/PrivateCombo/InvokePrivate)。
// =====================================================================================
using System;
using System.Collections.Generic;
using System.Drawing;
@@ -19,6 +34,8 @@ namespace PacsWinUia.RegressionTests
{
public static void Register(IList<KeyValuePair<string, Action>> tests)
{
// 防:原生选择后 ComboBox.Text 与 EDIT 文本不同步(经典“显示回退成上一个值”)、
// 刷新或手动输入丢值、以及保存后进程/类名/标题未持久化。
tests.Add(new KeyValuePair<string, Action>(
"Floating suggestions native mouse/keyboard selection, refresh and persistence",
SelectionRefreshAndPersistence));