# Run as Administrator | 以管理员身份运行
PowerShell -ExecutionPolicy Bypass -File scripts\install_headless.ps1

# 1. Install dependencies | 安装依赖
pip install comtypes Pillow mss playwright
python -m playwright install chromium

# 2. Verify virtual display | 验证虚拟显示器
python -c "import ctypes; u=ctypes.windll.user32; print(f'Screens: {u.GetSystemMetrics(80)}')"
# Expected: Screens: 2 (with virtual display) | 预期: 2屏(含虚拟显示器)

# 3. Test route integrity | 测试路由完整性
python computer_control_enhanced.py route-status
# Expected: integrity ✅ OK, locked routes ✅ none

# 4. Start MCP server | 启动MCP服务器
python winctl_mcp_server.py --port 59322

# 5. Register with Hermes | 注册到Hermes
hermes mcp add winctl --url http://127.0.0.1:59322

# Route health | 路由健康检查
python computer_control_enhanced.py route-status --json

# Click with UIA COM (XAML-safe) | UIA COM点击(XAML安全)
python computer_control_enhanced.py click --pid 1234 --element 6

# Type text | 输入文本
python computer_control_enhanced.py type-text --pid 1234 "hello world"

# Screenshot | 截图
python computer_control_enhanced.py screenshot --pid 1234

# Cache info | 缓存信息
python computer_control_enhanced.py cache-info

from computer_control_enhanced import (
    capture, click, type_text, paste_text,
    type_keys, scroll, drag, list_apps,
    _check_routing_integrity, _get_route_status,
    _uia_com_invoke, _xaml_click,
)

# Check system health | 检查系统健康
assert _check_routing_integrity()["ok"]
status = _get_route_status()

# XAML-safe click via UIA COM | UIA COM点击(XAML安全)
result = _uia_com_invoke(
    pid=1234,
    element_name="文件(F)",   # File menu in Chinese Notepad
    hwnd=0x12345678
)

# SendInput real click | SendInput真实点击
from scripts.sendinput import send_click, send_type_text, send_hotkey
send_click(x=500, y=300)
send_type_text("Hello from Hermes!")
send_hotkey(['ctrl'], 's')

# Capture with occlusion support | 遮挡窗口截图
result = _capture_window_wgc(pid=1234, window_id=0x12345678)

# Async verification | 异步验证
_enqueue_verify(pid=1234, window_id=12345678, settle_ms=200)
# Returns immediately, verifier runs in background thread

windeep/                          ← Project root | 项目根目录
│
├── computer_control_enhanced.py  ← Main orchestration | 主编排层 (1425+ lines)
│                                      Route guard / Energy model / Async verify
│                                      UIA COM / XAML click / WGC capture
│
├── winctl_mcp_server.py          ← MCP Server (22 tools, HTTP :59322)
│
├── compress_image.py             ← Progressive compression pipeline | 渐进式压缩管线
│
├── scripts/
│   ├── sendinput.py              ← SendInput real keystrokes | 真实击键 (NEW v3.1)
│   ├── dxgi_capture.py           ← DXGI + fallback capture | DXGI截图管线 (NEW v3.2)
│   ├── clipboard_guard.py        ← Multi-format clipboard guard | 剪贴板守卫
│   ├── resilient_matcher.py      ← Weighted element matching | 弹性元素匹配
│   ├── layout_knowledge.py       ← Cross-session layout persistence | 布局知识
│   ├── ui_tree_cache.py          ← UI tree cache | UI树缓存
│   ├── element_fingerprint.py    ← SHA256 element fingerprints | 元素指纹
│   ├── ocr_finder.py             ← WinRT OCR engine | 原生OCR
│   ├── smart_matcher.py          ← 5-strategy smart matching | 智能匹配
│   ├── assertion_verifier.py     ← 4-type assertion system | 断言系统
│   ├── shared_ui_state.py        ← Cross-agent shared state | 共享状态
│   ├── action_queue.py           ← Deferred action queue | 延迟队列
│   └── install_headless.ps1      ← One-click deploy | 一键部署

UIA COM (comtypes, 10ms)
  ├─ ✅ XAML menus, buttons, text fields
  ▼ (fails)
SendInput (real keystrokes, 50ms)
  ├─ ✅ Electron/SPA/UWP apps
  ▼ (fails)
PostMessage (background-safe, 1ms)
  ├─ ✅ Win32 native controls
  ▼ (fails)
ctypes BM_CLICK (last resort)

DXGI Desktop Duplication
  ├─ ✅ Full desktop, occluded windows, Electron/DirectX
  ▼ (fails)
PrintWindow API
  ├─ ✅ Occluded Win32 windows
  ▼ (fails)
BitBlt + MSS
  ├─ ✅ Multi-monitor visible content
  ▼ (fails)
PIL ImageGrab
  ├─ ✅ Universal full-desktop fallback

# Run full system audit | 全系统审计
python -c "
import computer_control_enhanced as cce
# Route integrity | 路由完整性
assert cce._check_routing_integrity()['ok']
# Energy | 能量
assert cce._get_route_status()['energy_ok']
# No locked routes | 无锁定
assert not cce._get_route_status()['locked_routes']
# UIA COM | UIA COM可用
assert hasattr(cce, '_uia_com_invoke')
# XAML click | XAML点击可用
assert hasattr(cce, '_xaml_click')
# WGC capture | 截图可用
assert hasattr(cce, '_capture_window_wgc')
print('ALL CHECKS PASSED')
"