MCPcopy Create free account
hub / github.com/XMuli/ChineseChess

github.com/XMuli/ChineseChess @v7.4

Chat with this repo
repository ↗ · DeepWiki ↗ · release v7.4 ↗ · + Follow
131 symbols 156 edges 22 files 14 documented · 11% updated 2mo agov7.4 · 2026-02-23★ 8251 open issues

Browse by type

Functions 115 Types & classes 16
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

ChineseChess

项目介绍

English | 简体中文

macos-badge win-badge ubuntu-badge

  • 基于Qt5.15 和 Qt6.8开发的中国象棋网络对战平台(含通讯功能),实现了在单机或联网状态下,无论是单人还是多人,无论使用系统是否相同,均可以实现象棋游戏功能。

  • 本项目收录于 product

  • 演示效果:https://www.bilibili.com/video/av45509758

特性

该项目主要功能模块分为:

ⅰ 玩家与自己对战

ⅱ 玩家与电脑AI对战

ⅲ 多人网络对战(可跨不同系统)

ⅳ 对战计时

ⅴ 悔棋(可多步)

ⅵ 下棋轨迹

ⅵ 关于作品信息

运行演示:

视频演示:

ChineseChess 基于QT的跨平台网络象棋对战演示

win10系统演示:

Linux系统演示:

MacOS系统演示:

跨平台对战演示: MacOS 10.14 vs Win10

作者作品详情: 

更新(2019-2026 v7.x)

功能

  • 添加悔棋功能,无限制悔棋
  • 显示下棋轨迹,当前执手
  • 重新开始游戏,点击重开
  • 代码逻辑优化,新增注释
  • 下棋界面更新,使用古象棋棋字
  • 更新关于程序,添加贡献者姓名
  • Linux ARM64 deb 树莓派支持: apt.raspbian-addons.org

演示

开发教程

构建

本项目构建同时支持 QT 5 和 QT 6,更多项目集: https://product.xmuli.tech/

  • 环境: 本工程可以用 Qt 5.15.2 和 6.8.3 LTS 版本同时可编译通过;实测试最低构建 Qt 5.12,更低版本未验证
  • IDE: 推荐直接只用 Qt Creator 打开 CMakeLists.txt 进行构建
  • Other: 也可以自行 CMake 转 .sln 使用 Visual Studio 2022 构建

Windows 构建

  1. 安装 Qt (推荐 Qt 5.15 或者 Qt 6.8 LTS)
  2. 直接使用 Qt Crator IDE 打开 CMakeLists.txt
  3. 点击左下角构建-编译
  4. 可以看到成功运行,Enjoy~

Linux / Mac 构建

  1. 以 Debian 和 Ubuntu 为例,安装 Qt (推荐 Qt 5.15 或者 Qt 6.8 LTS)执行:

```bash # Ubuntu 20.04 STL, apt 默认 qt5.12.8 $ sudo apt install cmake qtbase5-dev qt5-default libqt5svg5-dev qtmultimedia5-dev qttools5-dev libqt5x11extras5-dev

# Ubuntu 24.04 STL, apt 默认 qt6.4.2 $ sudo apt install cmake g++ vim qt6-base-dev qt6-tools-dev qt6-svg-dev qt6-multimedia-dev ```

  1. 运行命令

bash $ git clone https://github.com/XMuli/ChineseChess.git $ cd ChineseChess $ mkdir build && cd build $ cmake .. $ make

  1. 或者,你可以跳过第 2 步,同样直接使用 Qt Creator 进行编译和运行,更加方便。

贡献者

感谢的小伙伴提交的贡献 🥳🥳:

XMuli Bruce-Ch BlueArvin Ubuntuser2012 kirayamatoo hmsjy2017
ryanfortner zjuyk sum2012 Codex

若是帮助到了你,或者觉得有用,可以点击该项目的的 ⭐Star🍴 Fork 的两个图标,方便抬手之间,表示点个赞,手有余香,其次才是一份冰的肥宅快乐水。

作者

alt text alt text alt text

系列教程

QtExamples 欢迎 star ⭐ 和 fork 🍴 这个系列的 C++ / QT / DTK 学习,这里你可以学到如何亲自编写这类软件的经验,这是一系列完整的教程,并且免费

Core symbols most depended-on inside this repo

Shape

Method 108
Class 14
Function 7
Enum 2

Languages

C++100%

Modules by API surface

ChessBoard.cpp60 symbols
NetworkGame.cpp15 symbols
MachineGame.cpp13 symbols
ChessVoice.cpp8 symbols
ChessPieces.cpp8 symbols
MachineGame.h4 symbols
PuzzleGame.h2 symbols
PuzzleGame.cpp2 symbols
PuzzleData.h2 symbols
NetworkGame.h2 symbols
ChooseMainWindow.h2 symbols
ChessStep.cpp2 symbols

For agents

$ claude mcp add ChineseChess \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page