Sunfish 国际象棋引擎

Sunfish 国际象棋引擎

Sunfish 是一个用 Python 编写的极简国际象棋引擎，核心代码仅 111 行（去除注释和空白后 126 行）。它实现了完整的国际象棋规则（除 50 步和棋规则外），并支持标准 UCI 协议，可以轻松接入各种图形界面和比赛工具。

核心特点

• 极简代码：整个引擎压缩后仅约 3KB，适合学习和实验。
• UCI 支持：可通过 sunfish-uci 命令与 Arena、Cute Chess、PyChess 等 GUI 对弈。
• NNUE 版本：提供基于神经网络的 NNUE 版本，棋力比经典版高约 200 Elo，且整个引擎仅 4096 字节。
• 高效搜索：使用 MTD-bi（NegaC*）搜索算法和分段平方表评估函数。

快速开始

安装后直接在终端运行：

pip install sunfish
sunfish

或从仓库检出运行：

python sunfish.py

使用 UCI 工具

将引擎指向 sunfish-uci 或 ./sunfish.py 即可。例如使用 fastchess 进行命令行对弈：

fastchess -engine cmd=sunfish-uci name=sunfish \
          -engine cmd=<other> name=other \
          -each proto=uci tc=30+1 -rounds 10 -games 2

性能优化

Sunfish 会自动检测并使用 PyPy3（如果已安装），PyPy 下的搜索速度约为 CPython 的 2.7 倍，可提升约 100 Elo。

测试

项目使用 pytest 进行测试：

python3.12 -m pytest

衍生项目

Sunfish 拥有丰富的衍生版本，包括 MicroPython 版、Rust 移植版、Go 移植版、JavaScript 版等，适合不同平台和语言的学习者参考。