核心用法
hidpi-mouse是一款专为Linux桌面环境设计的鼠标自动化控制技能，核心解决Claude AI助手显示截图与实际屏幕坐标之间的映射问题。当Claude展示屏幕截图时，图像会被缩放以适应对话窗口，而用户点击的坐标需要精确转换为系统级屏幕坐标才能执行真实操作。该技能通过click.sh、move.sh、drag.sh等脚本提供完整的鼠标控制能力，支持单击、双击、右键点击、拖拽等多种操作模式。
使用流程分为三个层次：首次使用时建议运行calibrate.sh进行交互式校准，通过生成标记图像并识别Claude显示位置来计算精确缩放比例；日常使用时直接调用click.sh <x> <y>，脚本会自动读取缓存的缩放因子进行坐标转换；高级用户可通过--raw参数跳过缩放直接使用物理屏幕坐标，或使用reliable_click.sh实现窗口相对定位等复杂场景。
显著优点
精准的自适应机制：自动检测屏幕分辨率（1080p至4K+）、DPI设置（96至192+）及多显示器配置，内置常见配置的参考比例表，首次校准后可长期稳定使用。
完整的自动化能力：不仅支持基础点击，还涵盖鼠标移动、拖拽操作、窗口相对定位、双击打等完整交互模拟，可满足从简单按钮点击到复杂UI操作的全场景需求。
零网络依赖设计：纯本地执行，所有计算和配置存储均在用户设备完成，无数据上传或外部API调用，隐私安全性极高。
模块化脚本架构：6个独立脚本各司其职，用户可按需调用，同时支持命令行参数灵活组合（如--double、--right、--window等）。
潜在缺点与局限性
平台限制严格：仅支持Linux系统且依赖X11显示服务器，Wayland环境、macOS及Windows完全不可用，适用范围显著受限。
外部依赖较重：核心功能依赖xdotool、scrot、python3及PIL库，任何依赖缺失都会导致功能失效，且不同发行版包名可能存在差异。
校准流程繁琐：首次使用必须进行交互式校准，涉及生成测试图像、人工识别标记位置等步骤，无法做到开箱即用，对非技术用户门槛较高。
输入验证薄弱：坐标参数缺乏数值范围校验，异常输入（如负数或超大值）可能直接传递给xdotool导致不可预期行为。
来源可信度待提升：当前为本地个人项目，未发布至GitHub等开源平台，缺乏社区审查、版本历史追溯及作者信誉背书。
适合的目标群体
该技能主要面向三类用户：一是在Linux环境下使用Claude等AI助手进行桌面自动化的开发者和技术人员；二是需要批量执行重复性UI测试或操作的QA工程师和系统管理员；三是运行HiDPI/Retina显示器、受坐标映射问题困扰的高级Linux用户。对于普通办公用户或跨平台需求者则不适用。
使用风险与注意事项
依赖可用性风险：xdotool等工具在某些最小化安装环境中可能缺失，建议部署前执行依赖检查。脚本已通过set -e启用错误终止，但部分场景使用|| true忽略了失败状态。
权限与安全问题：配置目录~/.config/hidpi-mouse/和缓存文件建议设置600权限防止其他用户读取屏幕缩放信息；xdotool执行需要X11会话权限，在SSH无头环境中需配置DISPLAY变量。
校准失效场景：更换显示器、调整分辨率或修改DPI设置后，缓存的缩放因子将失效，需重新运行calibrate.sh，否则点击位置会出现系统性偏移。
多显示器限制：当前主要支持主显示器场景，跨显示器坐标转换可能存在边界情况需要额外测试验证。