# mouse-robot

**Repository Path**: ryan1981/mouse-robot

## Basic Information

- **Project Name**: mouse-robot
- **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-01-10
- **Last Updated**: 2026-01-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# mouse-robot 鼠标机器人

#### 介绍

一个基于 PyAutoGUI 的鼠标自动化控制工具，提供图形界面（GUI）和编程接口，支持鼠标位置获取、移动、拖拽以及基于图像识别的界面元素查找功能。

#### 功能特性

1. **获取鼠标位置** - 实时获取当前鼠标坐标
2. **移动鼠标** - 将鼠标移动到指定坐标，支持平滑动画
3. **拖拽操作** - 从坐标1拖动到坐标2，支持自定义持续时间
4. **图像识别** - 通过截图查找界面元素坐标（支持模糊匹配）

#### 安装依赖

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

#### 使用方法

##### 方式一：使用图形界面（推荐）

运行 GUI 应用：

```bash
python run_gui.py
```

或者直接运行：

```bash
python gui/app.py
```

GUI 界面包含四个主要功能模块：
- **获取鼠标位置**：点击按钮获取当前鼠标坐标
- **移动鼠标**：输入目标坐标和持续时间，点击移动按钮
- **拖拽操作**：设置起始和目标坐标，执行拖拽
- **查找元素**：输入图片路径和置信度，查找界面元素并移动到其位置

##### 方式二：使用编程接口

```python
from controller.controller1 import MouseController

# 创建控制器实例
controller = MouseController()

# 1. 获取鼠标位置
pos = controller.get_mouse_position()
print(f"当前位置: {pos}")

# 2. 移动鼠标到指定坐标
controller.move_to_position(100, 100, duration=0.5)

# 3. 从坐标1拖动到坐标2
controller.drag_from_to(100, 100, 200, 200, duration=0.5)

# 4. 查找界面元素（需要先截图保存为图片）
element_pos = controller.get_element_position("assets/img/1.png", confidence=0.75)
if element_pos:
    print(f"找到元素位置: {element_pos}")
    controller.move_to_position(element_pos[0], element_pos[1])
```

#### 依赖说明

- **pyautogui** - 鼠标控制核心库
- **Pillow** - 图像处理（必需）
- **opencv-python-headless** - 图像识别增强（可选，支持模糊匹配）
- **numpy** - OpenCV 依赖
- **flet** - GUI 框架

#### 注意事项

1. 图像识别功能需要先对要查找的界面元素进行截图
2. 如果未安装 OpenCV，图像识别将使用精确匹配模式
3. 安装 OpenCV 后可以使用 `confidence` 参数进行模糊匹配，更灵活
4. 默认启用了安全模式，将鼠标快速移动到屏幕角落可以紧急停止所有操作

#### 项目结构

```
mouse-robot/
├── controller/          # 控制器模块
│   └── controller1.py  # 鼠标控制器类
├── gui/                # GUI 应用
│   └── app.py          # Flet GUI 应用
├── assets/             # 资源文件
│   └── img/            # 截图图片
├── requirements.txt    # 依赖列表
├── run_gui.py         # GUI 启动脚本
└── README.md          # 项目说明
```

#### 版本历史

- v1.0.0 - 初始版本，支持基本鼠标控制和图形界面