HiDPI鼠标点击

技能简介

HiDPI Mouse 是 Linux 桌面自动化的通用鼠标坐标处理工具，解决 Claude 显示截图与实际屏幕坐标之间的缩放映射问题。通过自动检测或手动校准屏幕缩放因子，将 Claude 界面中的显示坐标转换为 xdotool 可用的实际屏幕坐标。

业务背景

在Linux桌面自动化场景中，开发团队常需通过Claude等AI工具远程控制图形界面。但高分辨率屏幕的缩放机制会导致AI识别的坐标与实际点击位置错位。HiDPI Mouse自动完成坐标换算，让自动化脚本精准执行鼠标操作，避免因坐标偏移造成的任务失败，提升桌面自动化可靠性。

落地案例：某运维团队使用Claude批量配置Linux服务器图形化工具。由于4K显示器启用200%缩放，Claude返回的按钮坐标始终偏离实际位置。部署HiDPI Mouse后，运行一次交互式校准即可建立缩放映射关系，后续所有点击、拖拽操作均自动转换坐标，脚本无需改写即可适配不同DPI环境。

能做什么

• 自动检测屏幕 DPI 和分辨率对应的缩放因子
• 支持单击、双击、右键点击、拖拽等多种鼠标操作
• 提供交互式校准流程，针对特定系统优化精度
• 缓存检测结果，避免重复计算
• 兼容多显示器环境（主显示器）

使用说明

安装依赖

# Debian/Ubuntu
sudo apt install xdotool scrot python3

首次使用建议校准

./scripts/calibrate.sh

校准流程：生成带标记点的测试图片 → 在 Claude 中查看并输入标记点位置 → 自动计算并保存缩放因子。

基础点击操作

# 按 Claude 显示坐标点击（自动缩放）
./scripts/click.sh 500 300

# 双击
./scripts/click.sh --double 500 300

# 右键点击
./scripts/click.sh --right 500 300

# 直接使用屏幕坐标（跳过缩放）
./scripts/click.sh --raw 1000 600

其他常用脚本

# 移动鼠标
./scripts/move.sh 500 300

# 拖拽
./scripts/drag.sh 500 300 800 600

# 查看当前配置
./scripts/calibrate.sh info

# 手动设置缩放因子
./scripts/calibrate.sh set 2.08

# 重置为自动检测
./scripts/calibrate.sh reset

输入与输出

见下方输入与输出表格。

风险提示

• 仅支持 X11 环境，Wayland 兼容性未验证
• 多显示器环境下仅作用于主显示器
• 修改显示设置后需重新校准
• 坐标转换错误可能导致点击位置偏移
• 依赖外部工具 xdotool，需确保已正确安装

来源信息

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