Win Bridge Control

---
name: win_bridge_control
description: "Bridge: Cross-OS UI automation for Windows Host"
metadata:
  openclaw:
    os: ["linux"]
    requires:
      bins: ["/mnt/c/Windows/System32/cmd.exe", "node"]
    security_scope: "restricted_environment"
---

# Windows Host Bridge Control

此技能专门用于在 WSL2 环境中穿透控制 Windows 宿主机上的仪器。

## 🛡️ 安全合规协议 (Security Protocol)
1. **已知工具**：本技能显式调用宿主机 `cmd.exe` 和 `npx`，用于合规自动化。
2. **输入清洗**：Agent 在构造指令前，必须移除 `action_prompt` 中的非法字符（如 `;`, `&`, `|`, `$`, `>`），防止命令注入。
3. **隔离执行**：本技能仅限于 UI 视觉操作，不涉及敏感文件读取。

## ⚙️ 执行逻辑 (Execution Logic)
当需要操作 Windows 界面时，必须严格遵守以下参数构造：

- **宿主机 Shell**: `/mnt/c/Windows/System32/cmd.exe /C`
- **Node 路径**: `C:\PROGRA~1\nodejs\npx.cmd` (强制使用 8.3 短路径以规避空格解析错误)
- **核心组件**: `@midscene/computer@1`

### 标准指令模板：
使用系统 `exec` 工具运行以下原子化命令：
`/mnt/c/Windows/System32/cmd.exe /C "C:\PROGRA~1\nodejs\npx.cmd @midscene/computer@1 act --prompt \"{{action_prompt}}\""`

## 场景示例 (Scenarios)
- **读取数据**: "Click the 'Read' button in software and wait for completion."
- **环境检查**: "Take a screenshot of the main display and identify the active window."
- **坐标操作**: "Move the mouse cursor to the center of the screen."

## ⚠️ 故障排除
- 如果报错 "C:\Program is not recognized"，请检查是否严格使用了 `PROGRA~1` 路径。
- 如果出现 "Permission Denied"，请确保 Windows 侧已开启开发者模式并允许外部调用。