Win Mouse Native (Windows)

Win Mouse Native 综合评估

核心用法

Win Mouse Native 是一套面向 Windows 平台的原生鼠标自动化控制方案，通过调用 Win32 API（SetCursorPos、SendInput 等）实现对系统指针的底层操控。该工具以 ClawHub bundle 形式分发，包含文档与脚本文件，用户需将 .txt 后缀文件保存为可执行格式后使用。

支持的命令类型：

• 相对移动：move <dx> <dy> — 基于当前位置的偏移移动
• 绝对定位：abs <x> <y> — 直接跳转到屏幕指定坐标
• 点击操作：click left|right|middle — 单键点击
• 按下/释放：down/up 配合键位参数 — 支持拖拽组合操作

典型调用流程：OpenClaw 接收到用户鼠标控制指令后，通过 exec 执行 win-mouse 命令，返回单行 JSON 格式结果。

显著优点

• 系统级可靠性：直接调用 user32.dll，绕过高层封装，响应延迟极低
• 确定性控制：基于 Win32 API 的标准化行为，坐标计算与点击状态可预期
• 轻量部署：仅需两个文本文件转换，无复杂依赖或运行时安装
• 灵活交互模式：相对/绝对坐标双模式，满足脚本自动化与精准定位双重需求

潜在缺点与局限性

• 平台锁定：仅限 Windows，macOS/Linux 用户无法使用
• 无视觉反馈机制：执行后需依赖返回值确认，无内置屏幕截图或元素识别验证
• 坐标盲区风险：绝对坐标模式下，若目标分辨率与预设不符可能导致点击错位
• 权限敏感性：部分环境（UAC 提升窗口、安全桌面）可能拦截合成输入
• 无防误触保护：连续快速指令可能导致意外操作，建议分步验证

适合人群

• Windows 自动化脚本开发者
• 需要模拟人机交互的测试工程师
• 辅助功能/无障碍工具集成场景
• 本地工作流自动化需求用户（非远程/跨平台场景）

常规风险提示

• 谨慎使用 abs 绝对坐标，建议先用 move 小步验证
• 涉及系统关键区域（如关闭按钮、确认对话框）时，优先人工复核坐标
• 多显示器环境下，坐标系原点与 DPI 缩放可能影响定位精度
• 游戏/全屏应用可能禁用合成输入，需提前确认兼容性

核心用法

win-mouse-native 是一款专为 Windows 平台设计的原生鼠标自动化工具，通过直接调用系统级 user32.dll API 实现指针控制。支持两种安装后的命令调用方式：

坐标控制

• win-mouse move <dx> <dy> — 相对当前位置的偏移移动
• win-mouse abs <x> <y> — 绝对屏幕坐标定位（基于屏幕分辨率）

按键操作

• win-mouse click left|right|middle — 完整点击（按下+释放）
• win-mouse down left|right|middle — 仅按下（用于拖拽起始）
• win-mouse up left|right|middle — 仅释放（用于拖拽结束）

所有命令返回单行 JSON 格式结果，便于程序化处理。

显著优点

1. 原生系统集成：直接调用 Win32 SetCursorPos 与 SendInput，无模拟层延迟，响应精准
2. 零攻击面：纯本地执行，无网络通信、无第三方依赖，彻底杜绝供应链攻击与数据外泄风险
3. 轻量极简：176 行代码实现完整功能，无冗余依赖，审计成本极低
4. 跨场景兼容：支持相对/绝对坐标双模式，覆盖单点点击、拖拽绘制、路径跟随等自动化需求
5. 安全认证完备：静态分析、动态分析、依赖审计、网络分析、隐私合规、威胁情报六项满分通过

潜在局限

• 平台锁死：仅限 Windows 系统，macOS/Linux 需寻找替代方案
• 权限隐性依赖：实际执行需当前用户会话具备 GUI 交互权限，远程桌面/服务会话可能受限
• 无视觉反馈：执行过程无高亮、轨迹等可视化提示，调试时需依赖日志
• 坐标系陷阱：多显示器环境下绝对坐标需考虑主屏偏移，高 DPI 缩放场景可能出现定位偏差
• 无防误触机制：直接执行系统级输入，无二次确认，误操作可能影响当前工作

适合人群

• 自动化测试工程师：需集成到 CI/CD 流程的 UI 自动化测试
• 无障碍辅助开发者：构建鼠标替代输入方案
• 效率工具用户：创建宏脚本实现重复性界面操作
• 系统管理员：批量配置或远程维护场景下的界面自动化

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| 意外中断工作流 | 自动化鼠标操作可能覆盖用户当前操作 | 执行前确保目标应用已激活，避免全屏抢占 |

| 坐标计算错误 | 多屏/缩放环境导致点击位置偏移 | 先用小幅度移动测试，确认坐标系后再执行精确操作 |

| 拖拽中途失败 | 程序崩溃或权限变化导致鼠标按键未释放 | 实现超时释放机制，或手动 `win-mouse up` 复位 |

| 安全工具误报 | 低信誉程序调用鼠标 API 可能触发杀软 heuristic 检测 | 代码签名或提前向安全团队报备 |

技术实现细节

底层通过 P/Invoke 调用：

• SetCursorPos(int x, int y) — 绝对定位
• SendInput(INPUT[] inputs, int size) — 合成硬件级输入事件

输入参数经基础类型转换校验，无字符串拼接注入风险。