本地鼠标控制

技能简介

molt-mouse 是一个基于 ydotool 的本地鼠标控制封装工具，支持在 Linux 环境下通过命令行方式移动鼠标指针、执行点击操作以及模拟按键保持与释放。

能做什么

• 相对移动：按指定像素偏移量移动鼠标
• 绝对定位：将鼠标移动到屏幕指定坐标
• 点击操作：左键、右键、中键的单击
• 长按控制：模拟鼠标按下与释放（用于拖拽场景）

使用说明

安装要求

需先安装 ydotool 及 molt-mouse 可执行文件：

# 安装 ydotool（以 Ubuntu/Debian 为例）
sudo apt install ydotool

# 确保 molt-mouse 在系统 PATH 中可用
which molt-mouse

基本用法

所有命令通过 exec 工具在 gateway 主机上执行，且必须以 molt-mouse 开头：

# 相对移动：向右100像素，向下50像素
molt-mouse move 100 50

# 绝对定位：移动到屏幕坐标 (500, 300)
molt-mouse abs 500 300

# 左键单击
molt-mouse click left

# 左键按下（长按开始）
molt-mouse click 0x40

# 左键释放（长按结束）
molt-mouse click 0x80

注意事项

若用户指令中的数字缺失或含义模糊，需向用户确认具体数值后再执行。

输入与输出

见下方输入与输出表格。

风险提示

• 需要图形会话环境，纯 SSH 终端无法使用
• 坐标值超出屏幕范围时行为取决于 ydotool 实现
• 长按操作后务必配对释放，否则可能导致鼠标状态异常
• 多显示器环境下绝对坐标可能因布局复杂而偏离预期

来源信息

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