PokerTH（C++/Qt 开源德州扑克游戏）

PokerTH 是一款用 C++ 与 Qt 编写的开源德州扑克游戏，自 2006 年持续开发至今。玩家既可以与最多九名电脑对手进行单机对局，也可以经由官方服务器或自行搭建的专用服务器，与真人玩家联网对战。项目采用 AGPLv3 许可，README 明确说明不含广告、不涉及真钱赌博、不做追踪。当前版本为 2.1.11，构建要求 Qt 6.7 及以上与 C++23 编译器。

技术要点

• 引擎：src/engine 负责手牌、下注轮次与机器人逻辑（本地与网络两种变体）。
• 网络：src/net 基于 Boost.Asio，包含 TLS 与面向浏览器客户端的 WebSocket。
• 协议：pokerth.proto 是客户端与服务器共同的唯一事实来源。
• 数据库：src/db 与 src/dbofficial 提供服务器数据库接口及官方服务器的异步 MySQL 后端。
• 核心与配置：src/core、src/config 涵盖日志、加密、头像处理与配置文件。
• 聊天过滤：src/chatcleaner 为官方服务器使用的聊天过滤服务。
• 测试：tests 为驱动运行中服务器的协议测试套件（Java）。

构建与运行

依赖要求

• Qt ≥ 6.7.0（推荐 6.9.2 LTS）
• Boost ≥ 1.83：thread、filesystem、date_time、program_options、iostreams、asio、regex、random、uuid
• Protocol Buffers ≥ 2.3.0（构建时需 protoc，运行时需 libprotobuf）
• OpenSSL
• CMake ≥ 3.15、C++23 编译器，推荐 Ninja

Linux 构建

cmake -DCMAKE_BUILD_TYPE=Release -S . -B ./build -G Ninja
cmake --build ./build --config Release --target all
sudo cmake --install ./build

可将 all 替换为单个目标：pokerth_qml-client、pokerth_client、pokerth_dedicated_server、pokerth_official_server、pokerth_chatcleaner。若需包含测试证书与数据目录的干净构建，可先运行 bash clean_build.sh，详见 INSTALL。

其他平台

发布构建通过 Docker 镜像与 GitHub Actions 工作流实现可复现，而非手工构建：Windows 见 docker/windows（MinGW 交叉构建）；Android 见 docker/android 与 build_android_qml.sh；macOS/iOS 见 build_macos_combined.sh 与 build_ios_qml.sh；AppImage/deb/ZIP/Snap/Flatpak 见 docker/linux。上述构建在 .github/workflows 中均有手动触发的工作流。

运行专用服务器

cmake --build ./build --target pokerth_dedicated_server
./build/bin/pokerth_dedicated_server

服务器从 PokerTH 配置文件读取设置，并将日志写在配置文件旁。端口、防火墙、TLS 证书与服务器列表条目等完整步骤见 docs/server_setup_howto.txt。周边工具包括：pokerth_bot（用于负载与协议测试的无头客户端）、pokerth_globalnotice（向服务器全体发送通知）、tools/analyze_server_log.py（将服务器日志渲染为 SVG）。