# MouseClicker

**Repository Path**: ciaranchen/mouse-clicker

## Basic Information

- **Project Name**: MouseClicker
- **Description**: 一个功能强大的自定义鼠标连点器，支持多个位置设置、操作类型选择和快捷键启动。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-10
- **Last Updated**: 2026-01-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 鼠标连点器

一个功能强大的自定义鼠标连点器，支持多个位置设置、操作类型选择和快捷键启动。

## 功能特点

- 多位置支持：可以在屏幕上设置多个点击位置
- 操作类型：支持"只移动"、"单击"和"双击"三种操作
- 延迟设置：每个位置可以单独设置延迟时间（0-10000毫秒）
- 快捷键启动：支持F1-F12作为快捷键
- 循环控制：可设置循环次数或无限循环
- 编辑功能：可以随时修改已有位置的操作类型和延迟时间
- 可视化选择：通过全屏遮罩直观选择点击位置

## 系统要求

- Windows 10/11
- Python 3.7+

## 安装依赖

```bash
pip install -r requirements.txt
```

## 配置说明

- 首次运行程序时，会在用户主目录下创建 `mouse_clicker_config.json` 文件
- 该文件包含所有位置设置和程序配置，可手动编辑以进行自定义配置

## 运行程序

```bash
python mouse_clicker.py
```

## 使用方法

### 添加位置

1. 在"位置设置"区域选择操作类型（只移动/单击/双击）
2. 设置延迟时间（毫秒）
3. 点击"添加位置"按钮
4. 在半透明遮罩上点击想要的位置
5. 重复以上步骤添加多个位置

### 编辑位置

1. 在位置列表中点击选择一个位置
2. 修改操作类型或延迟时间
3. 点击"更新位置"按钮保存

### 删除位置

- 选中位置后点击"删除选中位置"按钮
- 或点击"清空列表"按钮删除所有位置

### 开始自动点击

1. 添加至少一个位置
2. 设置循环次数或勾选"无限循环"
3. 选择快捷键（默认F6）
4. 点击"开始"按钮
5. 按下快捷键开始/停止点击

## 打包成EXE

1. 安装 PyInstaller：
```bash
pip install pyinstaller
```

2. 打包程序：
```bash
pyinstaller --onefile --windowed --name "鼠标连点器" mouse_clicker.py
```

3. 生成的 EXE 文件位于 `dist` 目录中

### 打包参数说明

- `--onefile`: 打包成单个可执行文件
- `--windowed`: 不显示控制台窗口
- `--name`: 设置输出文件名

## 依赖库

- PyQt5: GUI 框架
- keyboard: 键盘快捷键监听
- pyautogui: 鼠标控制

## 注意事项

1. 程序需要管理员权限才能在某些应用中点击
2. 快捷键可能与系统或其他软件冲突，请选择不冲突的按键
3. 使用无限循环时，请确保可以随时停止程序
4. 建议先在安全的环境下测试，确认位置和操作正确

## 许可证

MIT License