鼠标左键自动单击器

📖 功能概述

鼠标左键自动单击器是一个基于kuai格式规范的Python脚本工具，提供便捷的鼠标自动点击功能。支持两种点击模式，可通过热键灵活控制启停，适用于需要重复点击的各种场景。

✨ 主要特性

• 🎮 热键控制：支持F1-F10功能键快速启停
• 📍 双模式支持：固定位置点击 / 跟随鼠标点击
• ⏱️ 精确控制：可设置点击间隔（0.01-60秒）和运行时长
• 📊 实时反馈：显示点击统计和运行状态
• 🛡️ 安全可靠：异常处理和自动停止机制

🔧 参数配置

启动快捷键

• 类型：下拉选择
• 选项：F1, F2, F3, F4, F5, F6, F7, F8, F9, F10
• 默认：F9
• 说明：用于启动和停止自动点击的热键

点击位置模式

• 类型：单选按钮
• 选项：
  • 固定位置：启动时记录鼠标位置，后续点击始终在该位置
  • 跟随鼠标：实时跟随鼠标移动，在当前位置点击
• 默认：固定位置

点击间隔时间

• 类型：浮点数输入
• 范围：0.01 - 60.0 秒
• 精度：0.01秒
• 默认：1.0秒
• 说明：每次点击之间的等待时间

运行总时长

• 类型：整数输入
• 范围：1 - 36000 秒（10小时）
• 默认：10秒
• 说明：自动点击的总运行时间

启动时显示提示

• 类型：开关按钮
• 默认：开启
• 说明：控制是否显示详细的配置信息和操作提示

🎯 使用方法

固定位置模式使用流程

1. 定位目标：将鼠标移动到需要点击的目标位置
2. 启动脚本：在kuai客户端中启动脚本
3. 开始点击：按设定的热键（如F9）开始自动点击
4. 停止点击：再次按热键停止，或等待时间到达自动停止

跟随鼠标模式使用流程

1. 启动脚本：在kuai客户端中启动脚本
2. 开始点击：按设定的热键开始自动点击
3. 移动鼠标：自由移动鼠标，程序会在当前位置点击
4. 停止点击：按热键停止或等待自动停止

📊 运行状态显示

启动提示

========================================
🖱️  鼠标自动单击器
========================================
⚙️  配置信息
   热键：F9
   间隔：1.0秒
   时长：30秒
   模式：固定位置
   说明：启动时锁定位置，重复点击
========================================
🎮  按 F9 键开始/停止点击
========================================
✅ 热键 F9 已就绪
🎯 等待热键输入...

运行反馈

• 开始点击：🚀 开始点击！间隔1.0秒，持续30秒
• 位置锁定：📍 锁定位置：(500, 300)
• 进度统计：📊 已点击20次 | 运行5.2秒
• 完成提示：✅ 完成！共点击30次，耗时30.1秒

⚠️ 注意事项

使用建议

• 合理设置间隔：避免过快的点击频率影响系统稳定性
• 注意目标应用：确保目标应用程序可以正常响应鼠标事件
• 适当休息：长时间运行时建议设置合理的时长限制

安全提醒

• 遵守规则：请确保使用场景符合相关软件的使用条款
• 避免误操作：启动前确认鼠标位置和目标应用程序
• 及时停止：如发现异常情况请立即按热键停止

🔍 故障排除

常见问题

Q：热键无响应

• A：检查是否有其他程序占用了相同的热键
• A：尝试更换不同的F键

Q：点击位置不准确

• A：确保在固定位置模式下启动时鼠标已定位到目标位置
• A：检查目标应用程序是否支持程序化鼠标输入

Q：点击频率过快/过慢

• A：调整"点击间隔时间"参数到合适的值
• A：建议间隔时间不低于0.1秒

📝 版本信息

• 脚本版本：kuai 1.0
• 兼容性：kuai客户端
• 更新日期：2025年

---

注：本工具仅供学习和合法用途使用，请遵守相关法律法规和软件使用条款。