Commit Graph

5 Commits

Author SHA1 Message Date
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