# Win Bridge Control

> Bridge: Cross-OS UI automation for Windows Host

- Skill: `lord1egypt/win-bridge-control` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lord1egypt/win-bridge-control`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lord1egypt/win-bridge-control/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Lord1Egypt (https://skillmd.com/u/lord1egypt)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/lord1egypt/win-bridge-control

---


# 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 侧已开启开发者模式并允许外部调用。