Quasi Engine（基于 Qt/QML 的 2D 游戏引擎框架）

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

项目在 GitHub 上以单一仓库维护客户端与服务端，网络协议由 pokerth.proto 统一定义，客户端与服务端共享引擎、网络与数据库层。除游戏本体外，仓库还包含专用服务器、官方服务器、聊天过滤服务以及若干辅助工具。

技术要点

• 语言与框架：C++23 与 Qt（QML 客户端基于 Qt Quick）。
• 依赖：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、OpenSSL，构建系统为 CMake ≥ 3.15，推荐 Ninja。
• 网络层：src/net 使用 Boost.Asio，包含 TLS 与面向浏览器客户端的 WebSocket。
• 协议单一来源：pokerth.proto 是客户端与服务端共同的协议定义，修改协议需同时保证与已发布版本的兼容性。
• 仓库结构：src/engine 为扑克引擎（手牌、下注轮次、本地与网络机器人逻辑）；src/db 与 src/dbofficial 为服务器数据库接口及官方服务器的异步 MySQL 后端；src/core、src/config 负责日志、加密、头像与配置文件；src/chatcleaner 为官方服务器使用的聊天过滤服务。
• 测试：tests 目录包含驱动运行中服务器的协议测试套件（Java）。

构建与运行

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）。