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 |
|
zimoyin
|
2cff06b550
|
统一遮挡规则:本工具自身窗口在所有画框路径都不算遮挡
「按 path 定位」仍用严格可见性判断(把自己工具窗口当遮挡),与悬浮条、
定位框、高亮跟随的规则不一致,导致在工具里按 path 定位时常常只显示
「控件位置读到了,但暂时不画框」。现在统一:只有别的程序挡住目标才不画框。
保留不动的例外:「绘制所有控件框」本来就要求目标窗口在前台,且需要按遮挡
精确裁剪绘制区域,那里仍严格判断(不画被遮住的部分)。
回归测试 23/23 通过。,
|
2026-10-13 16:13:02 +08:00 |
|
zimoyin
|
695b98dd35
|
监控列表定位后必然联动控件树,并把本工具窗口排除出定位框遮挡判断
用户反馈:在控件监控列表里定位显示已定位到「control」,但控件树不展开也不选中。
根因:MonitorEditorOnControlLocated 在画不出高亮框时直接 return,跳过了
SelectTreeNodeFor/EnsureTreeShows;而画不出框的常见原因就是本工具自己的窗口
压在目标上(CanShowLocateFrame 用的是严格可见性)。
- 定位成功一律先展开并选中控件树节点,画框与否只影响高亮框
- 画不出框时状态栏说明原因,但不再吞掉树联动
- HighlightFollower/CanShowLocateFrame 与本工具悬浮条统一规则:本工具自身
窗口不算遮挡,只有别的程序挡住目标才隐藏定位框
- EnsureTreeShows 返回已去读另一个窗口的树,避免状态栏提示被覆盖
- 实测(进程内宿主+镜像树模拟解析器返回的另一实例):定位后树中选中该节点、
祖先展开、切到控件树页、Path 横条同步;无矩形时同样选中
- 回归测试 23/23 通过
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-13 16:10:25 +08:00 |
|
zimoyin
|
a77e1b163a
|
控件树下方显示当前选中控件的 Path
- 控件树标签页底部新增 Path 横条:显示选中节点的 XPath,右侧「复制」按钮
- 选中节点、300ms 实时刷新换快照、清空/切换窗口时都会同步更新
- 布局自检加入该区域,避免像以前那样「加了控件但界面上看不到」
- 实测(进程内宿主 + 合成树):选中 Button 显示
/Window[1]/Button[@AutomationId='okButton'],选中其子 Text 显示
.../Text[1],清空后回到提示文本,横条在屏幕工作区内
- 回归测试 23/23 通过
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-13 16:03:19 +08:00 |
|
zimoyin
|
66ab309939
|
给全部源码补中文注释,并新增代码导览
- 67 个 .cs 文件加中文注释:每个文件顶部说明职责/调用方/线程与节拍/
已知限制/「要改什么就改哪里」,字段与方法逐条一行说明,复杂逻辑内插关键步骤
- 纯注释改动:脚本校验所有新增行都是注释、无非注释改动(仅 2 个文件的 BOM
随新头部注释下移,文件仍以 BOM 开头)
- 新增 docs/代码导览.md:模块地图、「我要改 X 看哪个文件」对照表、易踩的坑、
悬浮条显示规则、测试与验收指引
- 编译通过,回归测试 23/23 通过
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-13 15:44:15 +08:00 |
|
zimoyin
|
9eff3ec410
|
悬浮条:锚定窗口只需未被完全遮挡,并跳过最小化的同名窗口
两个原因让悬浮条一直不显示:
1) 可见性规则过严——锚定窗口只要被任何外部窗口压住一角就隐藏。现在改为
只要求“未被完全遮住”,部分遮挡不影响显示。
2) UWP 应用会留下最小化的同名框架窗口(矩形在 -32000),窗口匹配可能选中它,
于是报“矩形过小或不在屏幕范围内”。现在优先选可见窗口;只有最小化窗口时
明确说明原因。
实测(真实 Windows 设置窗口 + 本工具窗口压在其上 + 置顶小工具压住一角):
canShow=True,悬浮条在锚定窗口左上角显示,3 个按钮正常绘制。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-13 15:12:05 +08:00 |
|
zimoyin
|
0b2f84860e
|
悬浮条:本工具自身窗口不再算遮挡
在设置页里测试时,设置窗口正盖着锚定窗口,运行时判断因此一直隐藏悬浮条,
表现为“按钮不显示”。现在运行时的可见性判断与设置页检测一致:只把其他程序
的窗口当作遮挡,本工具窗口(主界面/设置窗口/覆盖层)一律忽略。
验证(独立宿主 + 真实窗口):
- 目标无遮挡 → 悬浮条显示(112x40,1 个按钮,逐像素透明)
- 本工具窗口完全盖住目标 → 悬浮条仍显示(修复前隐藏)
- 外部进程窗口盖住目标 → 隐藏,并在检测结果里点名该窗口
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-13 14:51:41 +08:00 |
|
zimoyin
|
4f53047429
|
修复悬浮条条件下拉显示与设置页遮挡误报
- 下拉建议框:DisplayMember 保证编辑区始终是实际进程名/窗口类/标题,
下拉列表用 OwnerDraw 显示友好描述;不再在选择提交时清空 SelectedIndex,
避免原生 CBN_SELCHANGE 把输入框覆盖为空
- 检测显示条件忽略本工具自身窗口(设置窗口正在遮挡目标),
并在结果里点名具体遮挡窗口;运行时判断保持严格
- 补 STA 回归:原生鼠标/键盘选择、刷新、保存重载,以及遮挡窗口分类
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-13 14:43:28 +08:00 |
|
zimoyin
|
05353928e6
|
合并 XPath 定位与控件监控改进
|
2026-10-13 13:13:17 +08:00 |
|
zimoyin
|
f31b50bb36
|
完善 XPath 定位与控件监控体验
- 增加简明到深入的 XPath 定位教程
- 保留增量控件树刷新与可编辑 Path
- 完善悬浮条条件选择和诊断
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-13 13:00:10 +08:00 |
|
zimoyin
|
ec785c4fb6
|
定位/高亮可见性、拾取展开、搜索面板、页面特征、焦点列、悬浮条配置
- 高亮框(定位与拾取预览)只在目标窗口真正可见时显示:新增 WindowVisibility,
检查窗口存在/可见/未最小化/矩形在屏内,并用取样点做遮挡判断(本工具自己的覆盖层不计入遮挡)
- 拾取完成后同时展开控件树(根 + 一层子节点)并选中该节点
- 控件树搜索的“更多”区域按内容自适应高度(之前固定高度把第二行条件截掉了)
- 选中控件树节点时,在“控件属性”标题栏显示该控件的页面特征(进程/窗口类/标题关键词),
并新增“复制页面特征”按钮,方便填到悬浮条条件里
- 监控列表“焦点”列改为“该控件是否获得焦点”的实时状态:默认显示“未读取”,
每 3 秒轮询一行(后台线程、单飞、可在工具栏关掉自动刷新)
- 悬浮按钮改为可配置的“悬浮条”:
每条悬浮条有名称/启用/透明度/相对锚定窗口的 XY/显示条件(进程、窗口类、标题关键词、
可导入监控项 path 作为“该控件出现才显示”)+ 按钮表格(按钮名称、点击执行操作、
快捷键、点击执行命令、启用)
运行时按条件显示、跟随锚点窗口按相对坐标定位、快捷键用 RegisterHotKey 注册
(冲突会记日志),拖动词条会把相对位置写回设置
- 新增共享 WindowMatcher(分级窗口匹配),定位与悬浮条条件使用同一套规则
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-12 15:37:19 +08:00 |
|
zimoyin
|
a2f7a6119f
|
修复:设置按钮无效、截图技术、定位框位置、窗口列表上色归属
- 设置按钮点击无效:SettingsForm 构造时按错误的顺序设置 SplitContainer 的
PanelMinSize(会按默认 SplitterDistance 校验并抛异常),对话框从未打开成功;
而异常只进了日志,所以按钮看起来毫无反应。改为在 OnLoad 里按“先定位置再收紧最小值”
设置,并且 ShowSettings 失败时弹框提示,不再静默
- 截图技术:客户区截图改为 PrintWindow(PW_CLIENTONLY|PW_RENDERFULLCONTENT),
位图尺寸即客户区;BitBlt 从窗口 DC 的客户区原点读取——不再是把整窗口渲染进客户区尺寸后裁剪
- 截图目标:优先“监控列表选中条目”对应的窗口,其次“窗口列表选中的窗口”,并在状态栏说明目标来源
- 定位框:画框前校验目标窗口存在/可见/未最小化、矩形落在可见屏幕内,否则不画并说明原因
(此前窗口未显示或最小化时会画在无意义的位置);UIA 节点每秒跟随控件矩形,控件消失即隐藏
- 定位结果新增 UsedFallback:走容错路径(宽匹配/内层窗口/跳过层级)命中时状态栏明确提示
“位置可能不准,建议重新添加该控件”
- 窗口列表:黄色改标“主要窗口分组里 Z 序最前的那一行”(此前标全局 Z 序第一,可能是其他窗口里的行,
用户看不到);组内保持 Z 序,最上方的窗口在第一位
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-12 15:07:13 +08:00 |
|
zimoyin
|
3cd27a8a32
|
段一+段二:窗口列表上色/定位联动/命令分组 + 截图与 OCR
段一(界面小修)
- 窗口列表:Z 序最前一行浅黄、真实前台浅绿、最小化灰字(此前只标前台,刷新时前台是本工具自己,所以看不到颜色)
- 控件树搜索命中改为加粗,颜色只留给窗口列表
- 点监控列表行头三角:在控件树里定位并选中该节点、属性网格联动、画高亮框;再点隐藏框;目标窗口关闭/最小化自动隐藏
- 命令设置改为“执行时机分组”(启动/退出/定时/单次)+ 新增删除时机、新增删除命令、立即执行、启停定时、输出框
段二(截图 + OCR)
- ScreenshotService:PrintWindow(PW_RENDERFULLCONTENT)/PrintWindow/BitBlt/屏幕拷贝依次尝试,并校验图像有效
(尺寸 + 颜色数),空白或全黑判为失败,绝不把无效图当成功
- 最小化窗口默认不截,仅授权后临时恢复并还原,提示会闪屏
- OcrClient:对接本机 ocr-server(healthz / upload(multipart) / i2t(轮询))
- 新 valueKey “OCR文本”;正常取值失败时按用户要求自动降级为“截图 + OCR”,并标注来源
- OCR 总开关默认关闭(关闭时完全不调用任何 OCR 服务);新增识别时保存截图与截图目录
- 主界面新增“窗口截图”“OCR 读取”;无界面新增 --ocr
- 监控定义的控制路径/页面特征/别名改为可选字段,使手写配置能走到中文校验提示而不是反序列化失败
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-12 14:47:12 +08:00 |
|
zimoyin
|
b4c736d58b
|
基线提交:三来源控件树/拾取 + 无界面读取 + 设置框架
在继续做界面收敛与监控引擎之前先固化当前可编译、可运行的状态,便于回退。
已完成:
- 控件树与拾取支持三种来源:UIA / MSAA(oleacc) / Win32(EnumChildWindows),可下拉切换与自动降级
- 列表读取:祖先链 + 向下查找 + 子元素遍历降级;区分「没找到」与「找到但取不到值」
- 无界面读取:--read-config / --read-saved,输出 JSON(含逐步 resolution 诊断)
- 监控列表:结构化定位字段(进程/窗口类/标题关键词/UIA 路径/MSAA PathKey/Win32 类名+序号)
- 设置框架:settings.json(随输出目录拷贝,不嵌入 exe)+ 设置界面 + 命令生命周期钩子 + 悬浮按钮
- 控制台日志、布局自检、控件树搜索、窗口列表前台高亮
已知未实现:OCR(仅配置占位)、截图、监控引擎(事件监听)。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2026-10-12 14:33:49 +08:00 |
|