# gomoku-basic

**Repository Path**: spider1462/gomoku-basic

## Basic Information

- **Project Name**: gomoku-basic
- **Description**: 一个基于Python的五子棋游戏实现，包含命令行版本和图形界面版本。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-01
- **Last Updated**: 2026-02-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Gomoku Game (五子棋)

一个基于Python的五子棋游戏实现，包含命令行版本、图形界面版本和高级AI对战版本。

## 项目介绍

Gomoku是一个经典的五子棋游戏实现。玩家可以与AI对战，通过在15x15的棋盘上放置黑白棋子来争夺胜利。当任意一方形成连续五个或以上同色棋子时即获胜。

## 功能特性

- **人机对战**：与AI进行智能对战
- **四种界面版本**：
  - 命令行版本（gomoku.py）
  - 图形界面版本（gomoku_gui.py）
  - 高级AI图形界面版本（gomoku-advance.py）
  - GLM5模型生成的AI图形界面版本（gomoku-GLM5.py）
- **游戏规则**：
  - 棋盘大小为15x15
  - 黑棋先行
  - 连成五个或以上同色棋子即获胜
  - 支持平局判断

## 游戏玩法

### 命令行版本
```bash
python gomoku.py
```

在命令行中输入坐标来下棋，格式为"row col"（例如：7 7），坐标范围从0到14。

### 图形界面版本
```bash
python gomoku_gui.py
```

通过鼠标点击棋盘进行游戏。图形界面提供了更直观的游戏体验。

### 高级AI对战版
```bash
python gomoku-advance.py
```

包含更强大的AI算法，能够评估位置价值、优先阻止对手获胜或创造自己的连子机会，并提供更流畅的游戏体验。

### GLM5模型生成的AI版本
```bash
python gomoku-GLM5.py
```

使用GLM5模型生成的AI对战版本，具有独特的界面设计和智能评估算法。

## 游戏规则

- 黑棋先行，双方轮流下棋
- 棋子放置在棋盘的交叉点上
- 当任意一方形成连续五个或以上同色棋子时获胜（横、竖、斜均可）
- 如果棋盘填满而无人获胜，则为平局

## AI智能级别对比

### 基础AI版本 (gomoku.py)
1. **基础评估**：能够评估位置的价值
2. **策略判断**：优先阻止对手获胜或创造自己的连子机会
3. **随机性**：在早期阶段加入随机因素以增加趣味性
4. **中心开局**：第一手棋会下在棋盘中央

### 高级AI版本 (gomoku-advance.py)
1. **评分机制**：基于多种棋型的复杂评估系统
2. **方向判断**：综合考虑四个方向（横、竖、左斜、右斜）的连子情况
3. **优先级算法**：
   - 成五（获胜）：最高优先级 (100,000分)
   - 活四（两头空）：极大威胁 (10,000分)
   - 冲四（一头堵）：高威胁 (1,000分)
   - 活三、眠三、活二、眠二等棋型也有相应评分
4. **智能策略**：能识别和阻挡对手的威胁，同时创造自己的连子机会

## 项目结构

```
Gomoku/
├── gomoku.py          # 命令行版本游戏逻辑
├── gomoku_gui.py      # 图形界面版本游戏逻辑
├── gomoku-advance.py  # 高级AI图形界面版本游戏逻辑
├── gomoku-GLM5.py     # GLM5模型生成的AI图形界面版本游戏逻辑
└── README.md          # 本说明文档
```

## 运行环境要求

- Python 3.x

## 开发者信息

该项目由Qwen Coder、Qwen Coder Next、GLM5开发测试。