# auto_fish

**Repository Path**: KiGer/auto_fish

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-20
- **Last Updated**: 2025-11-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 魔兽世界自动钓鱼机器人

一个基于动态视觉识别的魔兽世界自动钓鱼程序，能够自动检测鱼漂和鱼上钩，实现智能化钓鱼。

## 功能特性

- 🎣 **智能鱼漂检测**: 使用计算机视觉技术识别游戏中的鱼漂位置
- 🐟 **鱼上钩识别**: 实时监测鱼漂变化，准确检测鱼上钩时机
- 🖱️ **自动化控制**: 自动执行抛竿和收线动作
- 📊 **实时监控**: 提供详细的统计信息和运行状态
- ⚙️ **参数调整**: 支持自定义识别阈值、反应延迟等参数
- 🛡️ **安全保护**: 内置紧急停止功能和鼠标安全模式
- 📝 **详细日志**: 完整的操作日志记录，便于调试和优化

## 系统要求

- Windows 10/11 (64位)
- Python 3.8 或更高版本
- 魔兽世界游戏客户端
- 至少4GB内存
- 独立显卡推荐 (用于提高图像处理性能)

## 安装步骤

1. **克隆项目**
```bash
# 如果从Git仓库克隆
git clone https://gitee.com/KiGer/auto_fish.git
cd auto_fish

# 或者直接使用项目文件
```

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

3. **运行程序**
```bash
python main.py
```

## 使用说明

### 基本使用

1. **启动程序**: 运行 `python main.py` 启动图形界面
2. **启动游戏**: 确保魔兽世界正在运行
3. **配置参数**: 根据需要调整识别参数和按键设置
4. **开始钓鱼**: 点击"开始钓鱼"按钮，程序将自动检测和执行

### 重要配置

#### 游戏设置
- **窗口模式**: 建议使用窗口模式运行魔兽世界
- **分辨率**: 推荐1920x1080或更高分辨率
- **钓鱼技能**: 确保角色已学会钓鱼技能

#### 程序参数
- **截图延迟**: 控制截图频率，默认0.5秒
- **反应延迟**: 检测到鱼上钩后的响应时间，默认0.2秒
- **识别阈值**: 图像识别的敏感度，建议0.8
- **钓鱼按键**: 默认为空格键，可自定义

### 安全模式

- **鼠标安全**: 将鼠标移动到屏幕左上角(0,0)位置可立即停止程序
- **紧急停止**: GUI界面中的"紧急停止"按钮
- **ESC键**: 按下ESC键执行紧急停止

## 技术原理

### 图像识别算法

1. **颜色检测**
   - 使用HSV颜色空间检测红色/橙色鱼漂
   - 形态学操作优化检测效果

2. **形状检测**
   - 轮廓检测识别圆形鱼漂
   - 圆形度计算提高准确性

3. **模板匹配**
   - 预训练模板进行精确匹配
   - 支持自定义模板导入

### 检测流程

1. **屏幕捕获**: 实时获取游戏画面
2. **鱼漂定位**: 多算法融合定位鱼漂位置
3. **状态监控**: 持续监控鱼漂变化
4. **动作执行**: 检测到鱼上钩后自动收线

## 项目结构

```
auto_play_game/
├── main.py                 # 主程序入口
├── config.py               # 配置管理
├── screenshot_manager.py   # 屏幕捕获模块
├── image_detector.py       # 图像识别模块
├── automation_controller.py # 自动化控制模块
├── fishing_gui.py          # 图形用户界面
├── logger.py               # 日志管理
├── requirements.txt        # 依赖包列表
└── README.md              # 说明文档
```

## 配置文件说明

程序启动时会创建默认配置文件，可以手动编辑以下参数：

```python
# config.py 中的主要配置项
SCREENSHOT_REGION = None      # 截图区域 (left, top, width, height)
SCREENSHOT_DELAY = 0.5       # 截图间隔(秒)
REACTION_DELAY = 0.2         # 反应延迟(秒)
TEMPLATE_MATCHING_THRESHOLD = 0.8  # 匹配阈值
FISHING_ACTION_KEY = 'space'  # 钓鱼按键
LOG_LEVEL = "INFO"            # 日志级别
```

## 故障排除

### 常见问题

**Q: 程序无法找到游戏窗口**
A: 确保魔兽世界窗口标题包含"魔兽世界"，使用窗口模式运行

**Q: 鱼漂检测不准确**
A: 调整识别参数，或尝试不同的颜色阈值设置

**Q: 程序运行卡顿**
A: 增加截图延迟时间，或关闭其他占用CPU的程序

**Q: 鼠标移动异常**
A: 检查pyautogui的FAILSAFE功能是否被禁用

### 调试模式

启用调试模式获得更详细的日志信息：

```python
# 在config.py中设置
LOG_LEVEL = "DEBUG"
ENABLE_DEBUG = True
```

## 性能优化

1. **硬件优化**
   - 使用独立显卡加速图像处理
   - 确保足够的内存和CPU性能

2. **软件优化**
   - 调整截图区域大小
   - 优化识别算法参数
   - 使用多线程处理

3. **游戏设置**
   - 降低游戏图形设置
   - 关闭不必要的后台程序
   - 使用全屏窗口模式

## 法律声明

本软件仅供学习和研究使用。使用本软件时请遵守以下原则：

1. **个人使用**: 仅用于个人娱乐和学习
2. **不得商用**: 禁止商业用途或盈利目的
3. **遵守游戏规则**: 请遵守魔兽世界的用户协议
4. **风险自担**: 使用本软件的风险由用户自行承担

## 免责声明

- 本软件不保证100%的准确性和稳定性
- 使用本软件可能存在账号风险，请谨慎使用
- 作者不对使用本软件造成的任何损失承担责任
- 请在测试服务器上先进行充分测试

## 版本历史

### v1.0.0 (当前版本)
- 基础图像识别功能
- 自动钓鱼控制
- 图形用户界面
- 实时统计功能
- 多种检测算法

### 计划功能
- [ ] 支持多种鱼类检测
- [ ] 智能钓点选择
- [ ] 多账号支持
- [ ] 云端配置同步
- [ ] 机器学习优化

## 贡献指南

欢迎提交Issue和Pull Request！

1. Fork项目
2. 创建特性分支
3. 提交更改
4. 发起Pull Request

## 技术支持

如有问题，请：

1. 查看本文档的故障排除部分
2. 检查GitHub Issues
3. 提交新的Issue描述问题

---

**注意**: 请合法合规使用本软件，遵守游戏规则和当地法律法规。