# JSON 调试与 MCP

[调试索引](LLM.MD) · [客户端源码](../../../tools/zufyui_debug.py) · [API](../../src/API.md)

## 开启与发现

在目标应用中调用 `SetDebugEnabled(true)` 开启运行期通道。`ZUFYUI_DEBUG` 控制编译期日志，二者不等价。

```powershell
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`。
