Files
pacs_win_uia/tests
zimoyin 44fb305dc4 所有配置文件统一放到 exe 同目录
- control-monitors.json 从 %LocalAppData%\pacs_win_uia\ 改到 exe 同目录
  (settings.json / out.json / 截图与 OCR 目录本来就是 exe 同目录,现在一致)
- 首次读取时把旧位置的监控配置复制过来(只复制不删除),并记日志;
  exe 目录不可写时退化为直接读旧文件,保存会明确报错,不会丢配置
- ControlMonitorStore.GetDefaultFilePath()/GetLegacyFilePath() 公开,
  Program 的 --read-saved 与设置页「关于」都改用同一套路径
- 回归新增用例:默认配置与设置文件都必须在 exe 同目录、旧路径与当前路径必须不同
- 实测(隔离宿主):默认路径=exe 同目录;旧位置有 1 条配置被复制过来并能正常读出

测试 24/24 通过,
2026-10-13 16:18:57 +08:00
..

tests —— 可运行的测试夹具

这些测试怎么跑、失败怎么办

本目录有两块东西,目的不同:

  1. uia-fixture/ —— 一个独立进程的真实 WinForms 窗口(UiaFixture.exe),用来让工具 跨进程做 UIA 读取/拾取/定位的人工验证。UIA 在同一进程内自读自身控件树会崩溃,所以必须 跨进程。构建并启动:tests\run-fixture.cmd(默认 Debug,可传 Release)。
  2. regression/RegressionTests.csproj —— 自动化回归测试(net48 控制台程序),在纯内存快照或 本进程自建控件上跑断言,覆盖 XPath 定位、持久化/迁移、控件树增量刷新、悬浮条显示条件等。 它不用 UIA 读自身控件树(会崩溃)。

跑回归测试(不要在本目录直接 dotnet build,src 的 bin\Debug 可能被正在运行的工具进程锁定):

:: 用隔离的 OutputPath 构建,随后直接运行生成的 exe
dotnet msbuild tests\regression\RegressionTests.csproj -t:Build -p:Configuration=Debug ^
    -p:OutputPath=%TEMP%\pacs-regression\ -v:minimal
%TEMP%\pacs-regression\RegressionTests.exe
  • 退出码:0 = 全部用例通过;1 = 存在失败(便于脚本/CI 判断)。
  • 失败怎么办:在输出里找 FAIL <用例名>,其下会打印异常的 message(含 expected/actual)。 按用例名到 regression/*Tests.cs 的 Register(...) 里定位对应方法。下拉/刷新类用例可设 环境变量 PACS_REGRESSION_SCREENSHOTS=<目录>,失败或关键步骤会自动把窗体截图写入该目录以便比对。
  • 部分跳过是正常的:个别断言依赖桌面上是否存在其他进程的窗口(如遮挡诊断的外部窗口用例), 缺失时会打印 (... skipped) 并跳过,不算失败。

真实 PACS/OCS 客户端要么不暴露 UIA(CEF 套壳),要么树太大没法人工核对。 这里放一个普通 WinForms 窗口,控件类型、名称、层级都是已知的,用来验证本工具的读取链路。

运行

tests\run-fixture.cmd            :: Debug(默认)
tests\run-fixture.cmd Release    :: Release

脚本会先用 dotnet msbuild(没有 dotnet 时用 msbuild)构建 tests/uia-fixture, 然后启动 UiaFixture.exe。也可以直接在 Rider / VS 里打开 pacs_win_uia.sln 单独运行这个项目。

窗口内容

窗口 内容
UIA 测试夹具 「控件」页:按钮、文本框、复选框、单选、下拉、两列 ListView、TreeView、状态标签;「表格」页:5 行 × 3 列 DataGridView;「嵌套」页:三层嵌套容器里的 ListBox
UIA 测试夹具 - 第二个窗口 一个按钮(测试"选哪个窗口"、窗口列表分组与匹配)

两个窗口的标题与类名都固定,所以保存的监控条目、悬浮条显示条件可以长期复用。

建议的验证清单

  1. 控件树:选中 UIA 测试夹具 → 期望读到 Button/Edit/CheckBox/ComboBox/List/Tree 等节点, 「控件属性」里能看到控件Path、页面特征、焦点状态。
  2. 拾取:拾取「测试按钮」,期望拾取后控件树以顶层窗口为根展开并选中该按钮 (与窗口列表选中同一窗口得到的树一致),高亮框在拾取结束后消失。
  3. 列表读取:选中 DataGridView → 期望 5 行 × 3 列;ListView 走 MSAA/Win32 也应能读到行。
  4. path 往返:在控件树里选中任意节点 → 复制「控件属性 → 控件Path」→ 杂项 →「按 path 定位…」→ 粘贴 → 定位, 期望命中同一个控件并在树上选中(这是"复制的 path 能不能用"的回归测试)。
  5. 按 path 定位(故意写错):把路径中间一段改成不存在的名字,期望明确报出第几段没匹配, 而不是高亮到名字相同的另一个控件。
  6. 监控列表:添加一条指向「FixtureButton」的条目 → 点击该行立即出现红框、控件树展开到它; 点击标题、文本框、复选框那几行同样要有反应(点击任何位置都定位)。
  7. 绘制所有控件框:杂项 →「绘制所有控件框」,期望窗口里每个控件都套上一个细红框, 拖动/最小化目标窗口时框跟随/隐藏。
  8. 命令与退出:设置里加一条 启动 命令 start "" notepad.exe(测试用),退出工具后期望该进程被结束。
  9. 拾取不触发目标:拾取夹具窗口里的「测试按钮」时,期望按钮不会被按下(状态标签不变化, 见「控件」页右下角的状态文字),也不会抢走焦点。

注意:夹具只是测试目标,不要在里面放真实患者数据。

路径与持久化回归测试

regression/RegressionTests.csproj 是独立的 net48 console 测试工程。它引用主项目,在纯内存 ControlTreeNode 快照上覆盖 XPath、重复身份、转义、全节点 roundtrip、唯一性与不完整树;验证所有祖先 Name 改变后生成路径仍有效、稳定祖先锚定,以及 MSAA/Win32 来源不丢失。旧格式测试现在要求明确拒绝执行,旧文件仅保留用于人工编辑;保存前必须修正为 XPath。另验证动态字段不持久化、缺失刷新间隔默认300ms、悬浮条缺省启用值和显式停用值的区别,以及悬浮条窗口条件的严格匹配。测试不访问自身 UIA 或真实业务窗口。

新一轮界面验收:

  • 静置控件树不应不断清空/重绘;更改目标控件文字只更新该节点;展开状态、选中和滚动保持。
  • 双击监控 Path 打开多行编辑器;取消不改变配置,非法 XPath 不允许提交;编辑过程中不自动跳去定位。
  • 悬浮条进程/类名/标题可以输入和下拉选择;导入 XPath 后使用“检测显示条件”核对不显示原因。
  • Name 变化的定位方案见 docs/XPath定位.md。

在仓库根目录执行:

dotnet msbuild tests\regression\RegressionTests.csproj -t:Build -p:Configuration=Debug -v:minimal
tests\regression\bin\Debug\RegressionTests.exe