50 lines
2.1 KiB
Markdown
50 lines
2.1 KiB
Markdown
# 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
|
||
```
|