ZZufyUI文档首页DocumentationДокументацияDokumentationDocumentationDocumentación

正在准备文档Preparing your docsПодготовка документацииDokumentation wird geladenPréparation de la documentationPreparando la documentación

Language

For AI / v1.29.1

JSON / MCP debugging

Download Markdown

This document is shown in Chinese.

调试索引 · 客户端源码 · API

开启与发现

在目标应用中调用 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。

View sourcedocs/ai/debugging/json-mcp.md