Windows鼠标控制

技能简介

通过调用user32.dll实现Windows系统下的原生鼠标控制，支持相对移动、绝对定位、点击与拖拽操作。

业务背景

该技能让自动化流程能够直接操控Windows图形界面，无需人工介入即可完成点击、拖拽等交互动作。适用于批量处理桌面软件操作、自动化测试验证、或与其他系统配合完成端到端业务流程，显著降低重复性手工劳动。

落地案例：财务团队每月需从 legacy ERP 导出报表：机器人先移动鼠标至菜单栏坐标，点击「报表」→「月度汇总」，拖拽选择日期范围后点击生成。全程无需人工值守，将原本30分钟的手工操作压缩为自动执行，避免人为点错导致的返工。

能做什么

• 按像素偏移量相对移动鼠标指针
• 将鼠标移动到屏幕指定绝对坐标
• 执行左键/右键/中键的单击操作
• 按住或释放指定鼠标按键（用于拖拽）

使用说明

1. 保存win-mouse.cmd.txt为win-mouse.cmd
2. 保存scripts/win-mouse.ps1.txt为scripts/win-mouse.ps1
3. 运行命令：
   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对象。

输入与输出

见下方输入与输出表格。

风险提示

• 仅支持Windows系统，其他平台无法运行
• 坐标超出屏幕范围可能导致不可预期行为
• 自动化操作前建议先小幅度测试
• 需管理员权限时可能执行失败

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/lurklight/win-mouse-native/SKILL.md
来源类型：GitHub仓库