# OpenClaw UI Inspector（桌面试验版 v0.8.1）

> **有焦点的窗口 = 采集目标**（与大小无关）。  
> 企微暖树：**只调用** `jiangchang_desktop_wake.ensure_ui_ready`（与技能同路径），不复制注入逻辑。  
> 主窗 → profile `wecom`；搜索浮层 `SearchResultWindow2` → profile `wecom_search`（需 kit≥1.2.6）。

## 启动

```powershell
cd D:\OpenClaw\client-commons\skill-template
# 建议使用已安装 jiangchang-platform-kit>=1.2.5 的 Python（与宿主共享 venv 一致）
python tools/ui_inspector/run.py --scene demo
```

依赖：

```powershell
pip install -r tools/ui_inspector/requirements.txt
# 企微自动暖树（强烈建议）
pip install "jiangchang-platform-kit>=1.2.5"   # 或指向你们 Gitea/本地 index
```

## 规则

1. 焦点在谁就采谁（排除 Inspector 自身 hwnd）  
2. **自动拾取默认勾选**；点「开始流程」后先 **5 秒倒数**，请在此期间点击目标窗  
3. Inspector **保持置顶**便于看进度；置顶 ≠ 焦点，不因此改采本面板  
4. **不强制最大化**目标窗，保持操作者当时的大小/位置（仅最小化时会还原）  
5. 不会因为窗口小 / FindAll 少而改采别的软件  
6. **企微自动暖树（无感）**：识别到 `WeWorkWindow` 时，在准备/拾取前静默调用  
   `ensure_ui_ready("wecom")`；已暖则快速返回。结果写入每步 `meta.json` → `dump_stats.kit_wake`

## 空壳说明

- **已装 kit**：冷企微应被 n2-wake 暖到 `findall` 较大、`provider_cold=false`。若仍冷，看状态栏 `kit_wake: FAILED …`。  
- **未装 kit**：行为与旧版相同，可能 `findall≈2`、`provider_cold=true`；状态栏会提示未安装 platform-kit。

## 验收建议（企微）

1. 打开并登录桌面企业微信  
2. 启动 Inspector →「开始流程」→ 倒数内点到企微主窗  
3. 看详情区 / 第一步 `meta.json`：`kit_wake.warm=true`，`findall` 通常 ≫ 80  
4. 再搜联系人、开会话，确认 `groupbuddyname` 的 Value 能采到  

## 冒烟（不弹 GUI）

```powershell
python tools/ui_inspector/smoke_check.py
```