象鱼引擎 - 124 行中国象棋引擎

项目说明

!Elephantfish

介绍

elephantfish 是受到 sunfish 启发而撰写的纯python的中国象棋引擎， 整个象棋引擎核心代码只有124行（见compressed.py）,棋力方面我仅进行过其与象棋小巫师傻瓜难度的一场对局，在我测试的对剧中，elephantfish赢得了比赛。

在几天前看到了sunfish这个项目(是一个国际象棋引擎，只有111行)，觉得很有意思，于是做了一个类似中国象棋版本，中国象棋和国际象棋略有不同，我仅仅单独完成了棋规部分，子力价值表直接的参考了 象眼 ,mtd search部分的代码由于原版sunfish写的非常通用，我也就一行未改。

如果你对于程序中的mtd search看不懂建议先看一些对弈基础理论,比如articles下的几篇文章，如对弈程序基本技术，其官方网址：

elephantfish默认会进行5秒钟的思考，当然实际一般会比5秒多一些，如果你想要它进行更长时间搜索以获得更好的性能可以对源码相应位置进行更改。

如同sunfish一样，我认为elephantfish会是一个很好的平台，由于其代码非常少，可以很方便的进行各种实验，希望各位感兴趣的同学可以尝试对其进行优化. 如果在优化后想要评估和目前版本的棋力差别，可以使用test.py中的self_arena来将你的代码和elephantfish进行对弈。

如果你觉得这个版本的象棋ai实力不够强，可以看看 XQpy

运行截图

Think depth: 6 My move: b9c7

9 俥．象士将士象傌俥
8 ．．．．．．．．．
7 ．砲傌．．．．砲．
6 卒．卒．卒．卒．卒
5 ．．．．．．．．．
4 ．．．．．．．．．
3 兵．兵．兵．兵．兵
2 ．炮．．炮．．．．
1 ．．．．．．．．．
0 车马相仕帅仕相马车
ａｂｃｄｅｆｇｈｉ

Your move:

Web UI:

!UI

运行elephantfish!

elephahtfish 自包含在 elephantfish.py 文件中，只是用了python的自带操作而没有使用任何第三方库. 建议使用 pypy 或者 pypy3 来获得更好的性能表现.

简单的使用命令 或者 就可以运行象棋程序,程序会利用自带一个命令行工具进行对局.

如果以 Web UI 方式下棋，用命令行启动服务 python ui-server.py，程序监听HTTP 8000端口，浏览器打开 ui/chess.html 即可，行棋时前端以 HTTP Post 方式与服务交互。

特性

1. 使用简单而高效的 MTD 二分搜索算法（见对弈程序基本技术）.
2. 使用众所周知的现代象棋引擎trick 比如空着裁剪.
3. 通过简单的子力价值表进行局面评估.
4. 使用python标准数据结构.

License

GNU GPL v3

技术栈

开发语言：Python

项目类型：124 行中国象棋引擎

Star 数：276

功能特点

这是一套124 行中国象棋引擎，代码结构清晰，适合开发者学习游戏的客户端渲染、服务端逻辑、场景管理与资源加载。项目涵盖了游戏的核心玩法、界面交互、地图与角色系统等模块，对理解游戏开发的完整流程具有较高的参考价值。

从技术实现角度看，游戏项目的难点在于：游戏循环与状态管理、资源加载与渲染优化、客户端与服务端的协议同步、以及多平台适配。本项目在这些方面提供了可运行的实现，开发者可以在此基础上进行二次开发或学习研究。

部署说明

1. 下载源码压缩包，解压到本地开发环境。

2. 根据项目类型准备对应的运行环境（Node.js / Go / C# / Unity / Godot 等）。

3. 按照 README 中的步骤配置依赖、数据库和配置文件。

4. 先启动服务端，再运行客户端，即可进入游戏进行测试。

注意：本项目仅供学习研究使用，请勿用于商业或非法用途。

学习价值

对于想进入游戏开发领域的开发者来说，这套源码是一个很好的入门参考。通过阅读代码，可以学习到游戏的核心玩法实现、场景与资源管理、网络协议设计、以及渲染优化等关键技术点。

同时，项目中的代码组织方式和模块划分，也展示了游戏项目在工程化方面的实践经验，值得开发者深入研究和借鉴。理解一个完整游戏项目的架构，对后续开发其他类型游戏也很有帮助。

免责声明

本资源来源于开源社区，仅供学习研究和技术交流使用，请勿用于任何商业或违法违规用途。使用本项目产生的一切后果由使用者自行承担。若涉及第三方权益，请联系删除。