# auto_click

**Repository Path**: jrcreat/auto_click

## Basic Information

- **Project Name**: auto_click
- **Description**: 自动点击
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-24
- **Last Updated**: 2026-04-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智能自动点击器

一个功能完善的Python GUI自动点击应用程序，支持点击位置记录、序列管理和间隔设置。

## 功能特性

- **自动点击功能**：模拟鼠标在屏幕指定位置的点击操作
- **位置记录**：记录并保存特定的点击位置和操作序列
- **间隔设置**：可调节的时间间隔参数，支持毫秒和秒两种单位
- **快捷键支持**：提供F9/F10/F11快捷键操作
- **序列管理**：支持点击序列的保存和加载
- **状态显示**：实时显示当前运行状态

## 系统要求

- Python 3.7+
- Windows/macOS/Linux

## 安装依赖

```bash
pip install PyQt5 pyautogui keyboard
```

## 使用方法

### 启动程序

```bash
python -m src.main
```

### 基本操作

1. **添加点击位置**
   - 在X坐标和Y坐标输入框中输入目标位置
   - 选择点击类型（左键单击、右键单击、双击）
   - 点击"添加位置"按钮

2. **捕获位置**
   - 方法一：点击"记录当前位置"按钮获取当前鼠标位置
   - 方法二：点击"捕获位置"按钮后，移动鼠标到目标位置按F9键

3. **设置间隔**
   - 在间隔时间输入框中输入数值
   - 选择单位（毫秒或秒）
   - 点击"应用设置"按钮

4. **控制操作**
   - 点击"开始"按钮启动自动点击
   - 点击"暂停"按钮暂停点击
   - 点击"停止"按钮停止点击

5. **序列管理**
   - 使用"上移"/"下移"按钮调整点击顺序
   - 使用"删除选中"按钮删除单个位置
   - 使用"清空列表"按钮清空所有位置
   - 使用"保存序列"按钮保存当前序列到文件
   - 使用"加载序列"按钮从文件加载序列

### 快捷键

| 快捷键 | 功能 |
|--------|------|
| F9 | 捕获当前鼠标位置 |
| F10 | 开始/暂停自动点击 |
| F11 | 停止自动点击 |

## 文件结构

```
auto_click/
├── src/
│   ├── __init__.py
│   ├── clicker.py      # 核心自动点击模块
│   └── main.py         # GUI主界面
├── requirements.txt     # 依赖列表
└── README.md           # 使用说明
```

## 核心模块说明

### clicker.py

包含两个主要类：

1. **ClickPoint**：表示一个点击位置
   - `x`: X坐标
   - `y`: Y坐标
   - `click_type`: 点击类型（left/right/double）
   - `duration`: 移动到位置的时间

2. **AutoClicker**：自动点击器核心类
   - `add_click_point()`: 添加点击位置
   - `remove_click_point()`: 删除点击位置
   - `set_interval()`: 设置点击间隔
   - `start()`: 开始点击
   - `pause()`: 暂停点击
   - `stop()`: 停止点击

## 注意事项

1. 使用时请确保目标窗口处于活动状态
2. 建议设置适当的间隔时间，避免操作过快
3. 停止程序前请确保点击操作已停止
4. 在Linux系统上可能需要安装额外依赖：
   ```bash
   sudo apt-get install python3-pyqt5 python3-xlib
   ```

## 许可证

MIT License