鼠标连点器 - 跨平台快捷键版

一个功能强大的跨平台鼠标连点工具，支持 macOS 和 Windows 系统，支持快捷键操作和位置记忆功能。

📦 版本说明

V1.0 - 基础版本：单位置点击，支持当前鼠标位置和自定义坐标
V2.0 - 多位置版本：支持多个点击位置，可指定点击顺序，按顺序循环点击
- V2.1 - 最新优化版本：增强键盘快捷键、智能重复检测、自动保存优化、用户体验提升等

✨ 功能特性

🎯 智能位置选择
- 支持当前鼠标位置点击
- 支持自定义固定坐标点击
- 一键获取鼠标当前位置
- 位置测试功能
🖥️ 跨平台支持
- ✅ macOS 系统（自动适配 ⌘ 键）
- ✅ Windows 系统（自动适配 Ctrl 键）
- 自动检测操作系统并适配界面和快捷键
- 原生系统外观和体验
⌨️ 快捷键支持（自动适配系统）
- macOS: ⌘1 / Windows: Ctrl+1 - 开始连点
- macOS: ⌘2 / Windows: Ctrl+2 - 停止连点
- macOS: ⌘P / Windows: Ctrl+P - 获取当前位置
- macOS: ⌘T / Windows: Ctrl+T - 测试点击位置
- macOS: ⌘S / Windows: Ctrl+S - 快速保存设置
- F12 - 备用快速获取位置（跨平台通用）
🖱️ 灵活的点击配置
- 可设置点击间隔（毫秒）
- 支持设置点击次数（0 = 无限）
- 支持左键、右键、中键
- 支持随机间隔模式（模拟真人操作）
- 极速模式：最大化点击速率，适合需要高速点击的场景
⚡ 性能优化
- Robot 自动延迟优化（设置为 0ms）
- 极速模式：点击延迟从 20-50ms 降至 1ms
- 鼠标移动延迟优化（极速模式下减少等待时间）
- 智能日志更新（极速模式下降低 UI 更新频率）
- 理论最高速率：每秒 80-100 次点击（取决于系统性能）
💾 设置持久化
- 自动保存用户设置
- 下次启动自动恢复配置

🚀 快速开始

环境要求

Java 8 或更高版本
macOS 或 Windows 系统
Maven 3.x（可选，用于构建）

环境配置

1. 检查 Java 是否已安装

打开终端（macOS/Linux）或命令提示符（Windows），输入以下命令：

java -version

如果显示 Java 版本信息（如 java version "1.8.0_xxx"），说明已安装，可直接使用。

2. 如果未安装 Java

Windows 用户：

访问 Oracle JDK 下载页面或 OpenJDK 下载页面
下载对应系统的 Java 8 或更高版本安装包
运行安装程序，按提示完成安装
重新打开命令提示符，验证安装：java -version

macOS 用户：

# 使用 Homebrew 安装（推荐）
brew install openjdk@8

# 或访问官网下载
# https://www.oracle.com/java/technologies/downloads/

3. 验证安装

安装完成后，重新打开终端/命令提示符，运行：

java -version
javac -version

两个命令都应该显示版本信息，说明安装成功。

4. 配置 PATH（如需要）

如果 java 或 javac 命令提示找不到，可能需要配置环境变量。详细教程：

编译运行

V1.0 版本（单位置版本）

# 克隆项目
git clone <your-repo-url>
cd MouseClickToolForMacOrWin

# 编译 V1.0 版本
javac --release 8 src/main/java/HotkeyPositionMouseClicker.java -d out

# 运行 V1.0 版本
java -cp out HotkeyPositionMouseClicker

V2.0 版本（多位置版本）✨ 推荐

# 编译 V2.0 版本
javac --release 8 src/main/java/HotkeyPositionMouseClickerV2.java -d out

# 运行 V2.0 版本
java -cp out HotkeyPositionMouseClickerV2

Windows 用户：

# V1.0 版本
javac --release 8 src/main/java/HotkeyPositionMouseClicker.java -d out
java -cp out HotkeyPositionMouseClicker

# V2.0 版本
javac --release 8 src/main/java/HotkeyPositionMouseClickerV2.java -d out
java -cp out HotkeyPositionMouseClickerV2

macOS/Linux 用户：

# V1.0 版本
javac --release 8 src/main/java/HotkeyPositionMouseClicker.java -d out
java -cp out HotkeyPositionMouseClicker

# V2.0 版本
javac --release 8 src/main/java/HotkeyPositionMouseClickerV2.java -d out
java -cp out HotkeyPositionMouseClickerV2

一键编译并运行：

# Windows (PowerShell) - V1.0
javac --release 8 src/main/java/HotkeyPositionMouseClicker.java -d out; java -cp out HotkeyPositionMouseClicker

# Windows (PowerShell) - V2.0
javac --release 8 src/main/java/HotkeyPositionMouseClickerV2.java -d out; java -cp out HotkeyPositionMouseClickerV2

# macOS/Linux - V1.0
javac --release 8 src/main/java/HotkeyPositionMouseClicker.java -d out && java -cp out HotkeyPositionMouseClicker

# macOS/Linux - V2.0
javac --release 8 src/main/java/HotkeyPositionMouseClickerV2.java -d out && java -cp out HotkeyPositionMouseClickerV2

注意：

如果遇到版本不匹配错误（UnsupportedClassVersionError），使用 --release 8 参数编译以确保与 Java 8+ 兼容
程序启动后会显示图形界面窗口
V2.0 版本 提供了更强大的多位置点击功能，推荐使用

📁 项目结构

MouseClickToolForMacOrWin/
├── src/
│   └── main/
│       └── java/
│           ├── HotkeyPositionMouseClicker.java      # V1.0 - 单位置版本源代码
│           └── HotkeyPositionMouseClickerV2.java    # V2.0 - 多位置版本源代码
├── out/                                             # 编译输出目录（自动生成，已忽略）
├── LICENSE                                          # MIT 许可证文件
├── README.md                                        # 项目说明文档
└── .gitignore                                      # Git 忽略文件配置

目录说明

src/main/java/ - Java 源代码目录（符合标准 Java 项目结构）
out/ - 编译输出目录，存放编译后的 .class 文件
LICENSE - 项目许可证文件（MIT）
README.md - 项目使用说明文档
.gitignore - Git 版本控制忽略规则配置

📖 使用说明

V1.0 版本（单位置版本）

基本使用

启动程序：运行 HotkeyPositionMouseClicker 类
选择点击位置：
- 选择"当前鼠标位置"：将在鼠标当前位置点击
- 选择"自定义位置"：输入 X、Y 坐标或使用快捷键获取当前位置（macOS: ⌘P, Windows: Ctrl+P）
配置点击参数：
- 设置点击间隔（毫秒）
- 设置点击次数（0 表示无限）
- 选择鼠标按钮类型
- 可选：开启随机间隔模式
- 可选：开启极速模式（最大化点击速率）
开始连点：
- 点击"开始"按钮或使用快捷键（macOS: ⌘1, Windows: Ctrl+1）
- 程序将在 3 秒倒计时后开始连点
停止连点：
- 点击"停止"按钮或使用快捷键（macOS: ⌘2, Windows: Ctrl+2）

V1.0 快捷键说明

功能	macOS 快捷键	Windows 快捷键
开始连点	`⌘1`	`Ctrl+1`
停止连点	`⌘2`	`Ctrl+2`
获取当前鼠标位置	`⌘P`	`Ctrl+P`
测试设置的位置	`⌘T`	`Ctrl+T`
快速保存设置	`⌘S`	`Ctrl+S`
快速获取位置（备用）	`F12`	`F12`

V2.0 版本（多位置版本）✨

核心功能

V2.0 版本在 V1.0 的基础上，新增了以下强大功能：

🎯 多位置管理：支持添加多个点击位置，可编辑坐标和备注
📋 位置列表表格：清晰的表格界面显示所有位置（序号、X坐标、Y坐标、备注）
🔄 顺序控制：支持上移/下移调整点击顺序，按指定顺序循环点击
💾 位置保存：所有位置配置自动保存，下次启动自动恢复

V2.0 最新优化（v2.1）

⌨️ 键盘快捷键增强：
- 新增 Delete 键删除选中位置（表格聚焦时）
- 提升操作效率和便捷性
🔍 智能重复检测：
- 添加位置时自动检测重复坐标
- 重复位置提醒确认，避免误添加
- 启动时自动检测并提示所有重复位置
💾 自动保存优化：
- 表格编辑后自动保存（无需手动点击保存按钮）
- 添加/删除位置后自动保存配置
- 清空位置后自动保存
✨ 用户体验提升：
- 添加位置后自动选中新添加的行
- 删除位置后智能保持选中状态（选中相邻位置）
- 清空位置时显示位置数量，操作更明确
- 验证失败时自动选中问题位置，便于快速定位
🧪 测试功能增强：
- 新增"测试所有位置"按钮
- 按顺序测试所有位置，验证整体流程
- 测试过程实时反馈
🛡️ 输入验证增强：
- 表格编辑时进行严格的输入验证（空值检查、数字格式验证）
- 坐标范围自动验证（屏幕边界检查）
- 更友好的错误提示（包含操作建议和位置信息）
📊 表格编辑优化：
- 表格编辑事件异步处理（避免 UI 阻塞）
- 空值自动处理（备注字段允许为空）
- 实时数据同步

V2.0 使用步骤

添加多个点击位置：
- 将鼠标移动到第一个目标位置
- 点击"添加位置"按钮或按快捷键 ⌘P/Ctrl+P
- 重复以上步骤，添加所有需要点击的位置
- ⚠️ 如果添加重复坐标，程序会提示确认
调整点击顺序：
- 在表格中选中某个位置行
- 点击"上移"或"下移"按钮调整顺序
- 程序会按照表格中的顺序依次点击
编辑位置信息：
- 直接在表格中双击单元格可编辑坐标或备注
- 修改后自动保存（无需手动点击保存按钮）
- 程序会自动验证坐标的有效性和范围
管理位置：
- 删除位置：
  - 选中后点击"删除选中"按钮
  - 或按 Delete 键（表格聚焦时）快速删除
- 测试位置：
  - "测试选中位置"：单独测试选中的位置
  - "测试所有位置"：按顺序测试所有位置，验证整体流程
- 清空所有：点击"清空所有"可清空所有位置（显示数量并需确认）
配置点击参数：
- 设置点击间隔（毫秒）
- 设置循环次数（0 = 无限循环）
- 选择鼠标按钮类型
- 可选：开启随机间隔模式或极速模式
开始循环点击：
- 点击"开始循环点击"或按 ⌘1/Ctrl+1
- 程序会按照表格顺序依次点击所有位置
- 完成一轮后自动开始下一轮循环
- 日志会显示每轮循环和每个位置的点击状态
保存配置：
- 配置会自动保存（表格编辑、添加/删除位置时）
- 也可以手动点击"保存设置"按钮确保保存

V2.0 快捷键说明

功能	macOS 快捷键	Windows 快捷键
开始循环点击	`⌘1`	`Ctrl+1`
停止	`⌘2`	`Ctrl+2`
添加当前位置	`⌘P`	`Ctrl+P`
删除选中位置	`Delete`	`Delete`

V2.0 应用场景

🎮 游戏操作：按特定顺序点击多个按钮或区域
📝 表单填写：按顺序点击多个输入框
🔄 自动化流程：执行需要按顺序点击的多步骤操作
⚙️ 批量操作：对多个位置进行有序的重复点击

V2.0 与 V1.0 对比

功能	V1.0	V2.0
点击位置数量	单个位置	多个位置（无限制）
点击模式	单点重复	按顺序循环点击
位置编辑	单个坐标编辑	表格批量管理
位置备注	❌	✅
顺序控制	❌	✅（上移/下移）
重复检测	❌	✅（自动检测并提示）
键盘快捷键	基础快捷键	✅（包含Delete键）
自动保存	手动保存	✅（编辑即保存）
批量测试	❌	✅（测试所有位置）
适用场景	单点重复点击	多位置有序点击

通用高级功能（V1.0 和 V2.0 都支持）

随机间隔模式：开启后，点击间隔会在设定的最小值和最大值之间随机变化，模拟真人操作，避免被检测为机器人操作
极速模式：
- 最大化了点击速率，适合需要高速点击的场景
- 启用后，点击延迟从 20-50ms 降至 1ms
- 鼠标移动延迟从 50ms 降至 10ms
- 日志更新频率自动降低（每 10 次更新一次），减少 UI 开销
- 建议配合较小的点击间隔使用（如 10-20ms）
- 注意：极速模式下动作较为机械化，容易被检测为自动化操作
位置测试：
- V1.0：测试单个位置是否正确
- V2.0：可以单独测试表格中选中的位置
设置保存：所有配置和位置会自动保存，下次启动时自动恢复

性能优化建议

为了获得最高的点击速率，建议：

启用极速模式：在"点击设置"面板中勾选"极速模式（最大化点击速率）"
设置较小的点击间隔：建议设置为 10-20ms（极速模式下）
关闭随机间隔：在追求最高速率时，关闭随机间隔模式
使用固定位置：如果点击位置固定，使用"自定义位置"而不是"当前鼠标位置"，可减少鼠标移动的时间
减少日志输出：极速模式下日志会自动降低更新频率，无需手动设置

性能对比：

普通模式：点击延迟 20-50ms，适合大多数场景
极速模式：点击延迟 1ms，配合 10ms 间隔，理论最高速率可达每秒 80-100 次点击

🛠️ 技术栈

Java 8+
Java Swing（GUI）
Java AWT Robot（鼠标控制）
Java Preferences API（设置持久化）

📝 注意事项

系统权限：
- macOS：需要授予应用程序"辅助功能"权限（系统偏好设置 → 安全性与隐私 → 辅助功能）
- Windows：可能需要以管理员权限运行（某些情况下控制鼠标需要管理员权限）
坐标范围：自定义坐标必须在屏幕范围内，程序会自动验证
点击间隔：
- 普通模式：建议设置合理的点击间隔（50ms 以上），过快的点击可能影响系统稳定性
- 极速模式：可以设置较小间隔（10-20ms），但需注意系统负荷
固定位置模式：使用固定位置点击时，程序会在结束后恢复鼠标到原始位置
自动适配：程序会自动检测操作系统，界面文字和快捷键会自动适配当前系统
极速模式使用：
- 极速模式会最大化点击速率，但动作较为机械化
- 建议在游戏或需要快速操作的场景中使用
- 注意：某些应用可能会检测到极速模式下的自动化操作

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

👤 作者

zhouzh

创建日期：2025年10月27日

🙏 致谢

感谢所有使用和贡献本项目的开发者！

Name		Name	Last commit message	Last commit date
Latest commit History 20 Commits
src/main/java		src/main/java
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md

License

zhousirsohandsome/MouseClickToolForMacOrWin

Folders and files

Latest commit

History

Repository files navigation

鼠标连点器 - 跨平台快捷键版

📦 版本说明

✨ 功能特性

🚀 快速开始

环境要求

环境配置

1. 检查 Java 是否已安装

2. 如果未安装 Java

3. 验证安装

4. 配置 PATH（如需要）

编译运行

V1.0 版本（单位置版本）

V2.0 版本（多位置版本）✨ 推荐

📁 项目结构

目录说明

📖 使用说明

V1.0 版本（单位置版本）

基本使用

V1.0 快捷键说明

V2.0 版本（多位置版本）✨

核心功能

V2.0 最新优化（v2.1）

V2.0 使用步骤

V2.0 快捷键说明

V2.0 应用场景

V2.0 与 V1.0 对比

通用高级功能（V1.0 和 V2.0 都支持）

性能优化建议

🛠️ 技术栈

📝 注意事项

🤝 贡献

📄 许可证

👤 作者

🙏 致谢

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages