HiDPI 鼠标技能

面向桌面自动化、适配多种屏幕配置的通用鼠标坐标处理能力。

🚀 快速开始

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

# 首次使用？运行校准以获得最佳精度
./scripts/calibrate.sh

📐 工作原理

当 Claude 显示截图时，会对其进行缩放。本技能完成如下坐标转换：

Claude 显示坐标 → 缩放因子 → xdotool 屏幕坐标

缩放因子取决于以下因素：

• 屏幕分辨率（1080p、1440p、4K 等）
• DPI 设置（96、144、192 等）
• Claude 的显示视口

🔧 脚本说明

click.sh —— 在指定坐标执行点击

./scripts/click.sh             # 自动缩放点击
./scripts/click.sh --raw       # 不缩放（直接使用屏幕坐标）
./scripts/click.sh --double    # 双击
./scripts/click.sh --right     # 右键点击

calibrate.sh —— 设置与配置

./scripts/calibrate.sh              # 交互式校准
./scripts/calibrate.sh info         # 显示当前配置
./scripts/calibrate.sh test         # 测试当前缩放因子
./scripts/calibrate.sh set 2.08     # 手动设置缩放因子
./scripts/calibrate.sh reset        # 恢复为自动检测模式

detect-scale.sh —— 获取缩放因子

./scripts/detect-scale.sh           # 输出缩放因子（例如：2.08）

其他脚本

./scripts/move.sh             # 移动鼠标
./scripts/drag.sh      # 拖拽操作
./scripts/reliable_click.sh   [--window "Name" --relative]

🎯 校准（新系统强烈推荐）

为在您的特定系统上实现最高精度，请执行：

./scripts/calibrate.sh

该命令将：

1. 生成一张包含已知位置标记的校准图像
2. 提示您指出这些标记在 Claude 显示界面中的实际位置
3. 计算并保存精确的缩放因子

📊 常见缩放因子参考

🔍 故障排查

点击位置偏移

# 运行校准
./scripts/calibrate.sh

# 或手动调整缩放因子
./scripts/calibrate.sh set 2.1  # 尝试不同数值

查看当前配置

./scripts/calibrate.sh info

重置全部配置

./scripts/calibrate.sh reset
rm -f /tmp/hidpi_scale_cache

📁 配置文件

• ~/.config/hidpi-mouse/scale.conf —— 用户自定义缩放因子（优先级最高）
• /tmp/hidpi_scale_cache —— 自动检测得到的缩放因子缓存（有效期 1 小时）

🌐 全平台兼容性

本技能可自动适配以下环境：

• ✅ 多种屏幕分辨率（1080p 至 4K 及更高）
• ✅ 多种 DPI 设置（96、120、144、192 等）
• ✅ HiDPI / Retina 显示屏
• ✅ 多显示器配置（主显示器）

💡 使用建议

1. 务必在校准新系统后使用，以确保 100% 定位准确
2. 修改显示设置后需重新校准
3. 若已有屏幕坐标，请使用 --raw 参数
4. 运行 calibrate.sh info 查看当前配置详情

📝 示例工作流

# 1. 截取屏幕
scrot /tmp/screen.png

# 2. 在 Claude 中查看截图，识别按钮在显示坐标系下的位置（例如：500, 300）

# 3. 执行点击
./scripts/click.sh 500 300

# 4. 若点击偏差较大，则进行校准
./scripts/calibrate.sh

已在 Ubuntu/Debian（X11 环境）及多种分辨率和 DPI 设置下完成测试