# weiqi-ai

**Repository Path**: gavin-james/weiqi-ai

## Basic Information

- **Project Name**: weiqi-ai
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-04-16
- **Last Updated**: 2025-04-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 围棋AI辅助程序使用文档

## 1. 软件介绍

围棋AI辅助程序是一款基于Python开发的围棋辅助工具，通过图像识别技术智能定位棋盘区域并解析棋局状态（黑棋、白棋位置），调用KataGo引擎进行分析，并模拟鼠标点击完成落子操作。本软件支持灵活配置棋盘参数、AI段位及KataGo引擎参数，适用于各类围棋对弈平台。

### 1.1 主要功能

- **图像识别**：自动识别屏幕上的围棋棋盘和棋子位置
- **AI分析**：调用KataGo引擎分析当前棋局，提供最佳落子建议
- **自动操作**：模拟鼠标点击，自动完成落子
- **可视化界面**：直观的图形界面，方便配置和监控

## 2. 安装说明

### 2.1 系统要求

- 操作系统：Windows/macOS/Linux
- Python 3.6+
- 显示器分辨率：建议1920×1080或更高

### 2.2 依赖安装

1. 确保已安装Python 3.6或更高版本
2. 下载本程序源代码
3. 在程序根目录下执行以下命令安装依赖：

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

### 2.3 KataGo引擎准备

1. 下载KataGo引擎：访问[KataGo官方GitHub](https://github.com/lightvector/KataGo/releases)下载适合您系统的版本
2. 下载KataGo神经网络模型：从[KataGo模型下载页面](https://katagotraining.org/networks/)下载最新模型
3. 准备KataGo配置文件：可使用KataGo提供的示例配置文件（如`analysis_example.cfg`）

## 3. 快速开始

1. 运行主程序：

```bash
python main.py
```

2. 在打开的图形界面中配置必要参数（详见下文）
3. 点击"启动引擎"按钮初始化KataGo引擎
4. 点击"启动"按钮开始自动分析和落子

## 4. 功能模块说明

### 4.1 图像识别模块

图像识别模块负责截取屏幕图像，识别棋盘区域、我方执子、我放落子状态状态。通过设置棋盘位置坐标，程序能够准确识别棋盘上的黑白棋子位置。

### 4.2 KataGo接口模块

KataGo接口模块负责与KataGo引擎交互，获取最佳落子位置。您可以调整AI强度等级（1-20），对应从业余1段到职业9段的水平。

### 4.3 自动操作模块

自动操作模块负责模拟鼠标点击完成落子操作。您可以设置延迟时间，避免过快落子被检测为异常操作。

### 4.4 程序控制模块

程序控制模块负责协调各个功能模块的工作，提供启动/停止控制，并实时显示当前操作状态。

## 5. 操作指南

### 5.1 棋盘配置

#### 5.1.1 设置棋盘大小

在"棋盘配置"区域，从下拉菜单中选择棋盘路数（9路、13路或19路）。

#### 5.1.2 设置棋盘位置

1. 在"棋盘配置"区域，手动输入棋盘的左上角和右下角坐标
2. 左上角坐标：在对应输入框中输入X和Y坐标值
3. 右下角坐标：在对应输入框中输入X和Y坐标值

#### 5.1.3 设置我方标识和状态标识

1. 我方标识：输入用于识别自己棋子颜色的屏幕坐标
2. 状态标识：输入用于识别当前轮到谁下棋的屏幕坐标

### 5.2 AI配置

#### 5.2.1 设置AI强度

在"AI配置"区域，从下拉菜单中选择AI强度等级（1、5、10、15或20）。数值越大，AI强度越高。

#### 5.2.2 设置延迟时间

在"延迟时间"输入框中，输入自动落子的延迟时间（单位：秒）。建议设置为1-3秒，避免过快落子被检测为异常操作。

### 5.3 KataGo配置

#### 5.3.1 设置引擎路径

1. 在"KataGo配置"区域，点击"引擎路径"后的"浏览"按钮
2. 选择KataGo引擎可执行文件（如`katago.exe`或`katago`）

#### 5.3.2 设置模型路径

1. 点击"模型路径"后的"浏览"按钮
2. 选择KataGo神经网络模型文件（通常是`.bin.gz`格式）

#### 5.3.3 设置配置文件

1. 点击"配置文件"后的"浏览"按钮
2. 选择KataGo配置文件（如`analysis_example.cfg`）

### 5.4 程序控制

#### 5.4.1 保存配置

点击"保存配置"按钮，将当前设置保存到配置文件中，下次启动程序时会自动加载。

#### 5.4.2 启动引擎

点击"启动引擎"按钮，初始化KataGo引擎。引擎启动成功后，按钮文字会变为"停止引擎"。

#### 5.4.3 启动/停止程序

点击"启动"按钮开始自动分析和落子。程序运行中，按钮文字会变为"停止"，再次点击可停止程序。

## 6. 常见问题解答

### 6.1 程序无法启动

**问题**：点击"启动"按钮后没有反应。

**解决方案**：
- 检查是否已成功启动KataGo引擎
- 检查棋盘位置是否正确设置
- 检查日志文件`weiqi_ai.log`查看详细错误信息

### 6.2 棋子识别不准确

**问题**：程序无法正确识别棋盘上的棋子。

**解决方案**：
- 确保棋盘位置坐标设置准确
- 调整屏幕亮度和对比度，提高识别准确率
- 尝试在不同的围棋平台上测试

### 6.3 KataGo引擎启动失败

**问题**：点击"启动引擎"按钮后提示初始化失败。

**解决方案**：
- 检查引擎路径、模型路径和配置文件路径是否正确
- 确保KataGo引擎版本与模型兼容
- 检查配置文件内容是否正确

### 6.4 自动落子不准确

**问题**：程序落子位置与预期不符。

**解决方案**：
- 重新设置棋盘位置坐标
- 增加延迟时间，给程序更多处理时间
- 检查棋盘大小设置是否与实际棋盘一致

## 7. 技术支持

如果您在使用过程中遇到任何问题，请查看程序生成的日志文件`weiqi_ai.log`，其中包含详细的运行信息和错误记录。

---

**注意**：本程序仅供学习和研究使用，请勿在正式比赛或评级对局中使用。使用本程序时请遵守相关围棋平台的用户协议。