# GomokuPy

**Repository Path**: eppear/gomoku-py

## Basic Information

- **Project Name**: GomokuPy
- **Description**: python 版本的五子棋，用于Python学习和算法的练习
- **Primary Language**: Python
- **License**: MPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-31
- **Last Updated**: 2026-10-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GomokuPy

## 介绍
python 版本的五子棋，用于Python学习和算法的练习

## 软件架构
软件架构说明


### 开发环境配置

#### 安装【必备软件】
python 版本 3.12.6


建议安装python版本管理器：pyenv-win(或 pyenv)

相关参考：https://gitcode.com/gh_mirrors/py/pyenv-win

安装pyenv后，更新配置以加速下载：

1. 打开.pyenv\pyenv-win\.versions_cache.xml
2. 把地址开头（https://www.python.org/ftp/ ） 替换为：https://registry.npmmirror.com/-/binary/

```xml
<version x64="false" webInstall="false" msi="true">
    <code>2.4-win32</code>
    <file>python-2.4.msi</file>
    <URL>https://www.python.org/ftp/python/2.4/python-2.4.msi</URL>
</version>

<!--替换URL为如下格式-->
<version x64="false" webInstall="false" msi="true">
    <code>2.4.1-win32</code>
    <file>python-2.4.1.msi</file>
    <URL>https://registry.npmmirror.com/-/binary/python/2.4/python-2.4.msi</URL>
</version>
```


之后选择该项目依赖版本：python 3.12.6版本

```shell
   pyenv install 3.12.6
   pyenv global 3.12.6
```

其它相关依赖安装，参考requirements.txt文件


#### 配置【相关环境变量】
 
将代码存储库克隆到本地机器

#### 运行【初始化命令】安装项目依赖

```shell
   pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ -r .\requirements.txt
   # 或者执行下边的
   pip install -i https://pypi.mirrors.ustc.edu.cn/simple/ -r .\requirements.txt
```
更新依赖文件：

```shell
   pip freeze > .\requirements.txt
```

### 优化记录

`ChessAI_V4` 使用 V0 的棋型评估与 Alpha-Beta 搜索，通过增量邻居计数和非根节点最多 16 个候选点减少搜索开销；根节点保留最多 20 个候选点，并直接处理胜着和必须防守的单点威胁。AI 对战模式可在版本列表中选择 V4。

 下一步优化建议：

1. 调整开局策略：V2 执白时表现较弱，可以考虑优化开局库或调整先手/后手的评估权重。 
2. 增强防守识别：原版在部分对局中能够找到 V2 的防守漏洞，可能需要加强 V2 对对手威胁的识别能力。 
3. 动态时间分配：V2 在复杂局面（如中盘）的思考时间波动较大，可以引入动态时间分配策略，确保关键时刻有足够时间。


#### 使用说明

1.  xxxx
2.  xxxx
3.  xxxx

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)