Commit Graph

6 Commits

Author SHA1 Message Date
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 f31b50bb36 完善 XPath 定位与控件监控体验
- 增加简明到深入的 XPath 定位教程
- 保留增量控件树刷新与可编辑 Path
- 完善悬浮条条件选择和诊断

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-13 13:00:10 +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