开启与发现
在目标应用中调用 SetDebugEnabled(true) 开启运行期通道。ZUFYUI_DEBUG 控制编译期日志,二者不等价。
python tools/zufyui_debug.py --list
python tools/zufyui_debug.py --help
python tools/zufyui_debug.py --mcp
MCP 使用标准输入输出;目标是本机正在运行、已开启通道的窗口。具体参数以客户端 --help 和工具 schema 为准。
工具地图
- 读取:
list_windows、tree、inspect、stats、logs、config_get、config_export。 - 控件操作:
set_value、invoke、toggle、focus。 - 样式:
style_set、style_reset、style_undo。 - 配置与定位:
config_set、highlight、highlight_clear、repaint。
先发现窗口,再读取树和元素 ID。操作后重新读取状态,避免使用已销毁窗口或旧元素 ID。
超时与统计
调试器发送命令必须有超时;目标忙碌时返回明确失败,不无限等待。UI 线程命令与 UIA 回调的线程约束分别处理。
stats 的框架时序和计数只能说明其测量范围,不能直接当作屏幕显示 FPS。测试运行 python -m unittest discover -s tests -p test_debug_client.py。