# match3_bot

**Repository Path**: nanchengHorizon/match3_bot

## Basic Information

- **Project Name**: match3_bot
- **Description**: 消消乐match3_bot
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-24
- **Last Updated**: 2025-10-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 消消乐自动化工具

针对 WeChatAppEx 窗口的智能消消乐自动操作工具。

## 功能特性

✨ **核心功能**
- 🎯 自动识别棋盘网格和方块类型
- 🤖 智能计算可消除的移动
- 🖱️ 自动执行拖拽操作
- 🎮 支持手动和自动两种模式
- 🐛 调试模式可视化识别结果

## 项目结构

```
match3-bot/
├── main.py                    # 主程序入口
├── requirements.txt           # Python 依赖
├── README.md                 # 项目说明文档
├── SETUP.md                  # 安装指南
├── USAGE.md                  # 使用说明
├── config/
│   ├── board.json           # 棋盘配置（自动生成）
│   ├── board_example.json   # 棋盘配置示例
│   └── blocks/              # 方块模板图片
│       ├── block_0.png
│       ├── block_1.png
│       └── ...
├── utils/
│   ├── __init__.py          # 包初始化
│   ├── window.py            # 窗口操作
│   ├── matcher.py           # 方块识别
│   ├── move.py              # 鼠标控制
│   ├── move_calculator.py   # 移动计算器
│   ├── move_strategy.py     # 移动策略
│   └── move_calculation_strategy.py  # 移动计算策略模式
├── run.bat                  # Windows 运行脚本
├── setup.bat                # Windows 安装脚本
└── install_tesseract.bat    # Tesseract OCR 安装脚本
```

## 快速开始

### 1. 环境要求
- Windows 操作系统
- Python 3.7 或更高版本

### 2. 一键安装（推荐）

```bash
# 运行安装脚本
setup.bat
```

### 3. 手动安装

```bash
# 安装依赖
pip install -r requirements.txt

# 运行程序
python main.py
```

### 4. 详细安装说明

请参考 [SETUP.md](SETUP.md) 获取详细的安装指南。

## 使用说明

### 快速开始

```bash
# 启动程序
python main.py

# 调试模式（推荐首次使用）
python main.py --debug
```

### 详细使用指南

请参考 [USAGE.md](USAGE.md) 获取完整的使用说明，包括：
- 首次配置设置
- 棋盘区域设置
- 方块模板设置
- 手动模式和自动模式
- 调试功能说明

## 功能特性

### 核心功能
- 🎯 **智能识别**：自动识别棋盘网格和方块类型
- 🤖 **智能计算**：使用策略模式计算最佳移动
- 🖱️ **自动操作**：自动执行拖拽操作
- 🎮 **双模式**：支持手动和自动两种操作模式
- 🐛 **调试模式**：可视化识别过程和结果

### 技术特点
- **策略模式**：可扩展的移动计算策略
- **模板匹配**：高精度的方块识别
- **智能优化**：避免重复移动和死循环
- **可视化调试**：完整的识别过程可视化

## 技术架构

### 核心模块
- **window.py**：窗口捕获和定位
- **matcher.py**：方块识别和模板匹配
- **move.py**：鼠标控制和操作执行
- **move_calculator.py**：移动计算和策略
- **move_calculation_strategy.py**：策略模式实现

### 工作流程
```
窗口定位 → 棋盘识别 → 方块匹配 → 移动计算 → 执行操作
```

## 常见问题

### 无法找到窗口
- 确保游戏窗口已打开且可见
- 程序支持交互式窗口选择

### 识别不准确
- 重新设置方块模板，选择清晰的样本
- 使用调试模式检查识别结果
- 确保游戏界面稳定，无动画干扰

### 鼠标操作不生效
- 确保窗口在前台且未最小化
- 检查是否有其他程序占用鼠标控制

### 程序卡住
- 按 `Q` 键停止自动模式
- 按 `Ctrl+C` 强制退出

## 高级配置

详细的高级配置说明请参考 [USAGE.md](USAGE.md)。

## 注意事项

⚠️ **重要提示**：
- 本工具仅供学习和研究使用
- 使用自动化工具可能违反某些游戏的服务条款
- 请勿用于商业目的或作弊行为

## 许可证

MIT License

## 贡献

欢迎提交 Issue 和 Pull Request！