# autogui

**Repository Path**: lythu/autogui

## Basic Information

- **Project Name**: autogui
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-29
- **Last Updated**: 2026-06-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AutoGUI - 跨平台PC自动化工具

AutoGUI 是一款跨平台PC自动化应用，支持窗口捕获、OCR信息识别及模拟用户操作，适用于自动化测试、数据采集、重复性任务处理等场景。

## 核心功能

- **窗口捕获**：支持通过HWND（窗口句柄）或手动框选方式指定目标窗口区域
- **OCR识别**：基于PaddleOCR，支持中文和数字的高精度识别
- **模拟操作**：支持鼠标点击、滚动、滑动、键盘输入等操作
- **动作序列**：按预设顺序执行动作序列，支持循环执行
- **随机噪声**：所有操作参数加入随机噪声，模拟自然人为操作
- **可视化编辑**：通过GUI界面配置和修改动作参数
- **配置管理**：支持保存/加载JSON格式的动作配置文件

## 技术栈

- Python 3.10+
- PyQt6（跨平台GUI）
- PaddleOCR（OCR引擎）
- pyautogui + win32api（模拟操作）
- mss + Pillow（屏幕捕获）

## 快速开始

### 1. 安装依赖

#### 1.1 虚拟环境设置

推荐使用名称为 "qt" 的虚拟环境：

```bash
# 创建虚拟环境
python -m venv qt

# 激活虚拟环境
# Windows:
qt\Scripts\activate
# macOS/Linux:
source qt/bin/activate
```

#### 1.2 安装依赖包

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

#### 1.3 依赖说明

- **Python版本**：推荐使用 Python 3.10 - 3.12 以获得最佳兼容性
- **EasyOCR**：首次运行会自动下载模型，可能需要较长时间和稳定的网络连接
- **OpenCV**：Python 3.13 用户可能需要手动调整 opencv 版本以兼容 numpy 2.x

### 2. 运行程序

```bash
python main.py
```

### 3. 打包为可执行文件

```bash
python build.py
```

## 项目结构

```
autogui/
├── main.py                 # 应用入口
├── requirements.txt        # 依赖清单
├── build.py               # 打包脚本
├── src/
│   ├── core/              # 核心模块（捕获、OCR、执行）
│   ├── gui/               # 可视化界面
│   ├── config/            # 配置管理
│   ├── recorder/          # 动作录制（预留）
│   └── utils/             # 工具函数
├── docs/                  # 文档
└── configs/               # 配置文件示例
```

## 使用说明

1. 启动程序后，通过菜单「工具」→「选择目标窗口」指定要操作的窗口（如夜神模拟器）
2. 在左侧动作列表中编辑或添加动作
3. 配置每个动作的参数（坐标、区域、滚动量等）
4. 点击「开始执行」运行自动化序列

详细说明请参考 `docs/user_manual.md`。

## 许可证

MIT License