第三梯队 · 线上与多端工程线上运行 · 持续迭代最近更新 2026-09-27
轻·棋局 XiangqiArena
- xiangqiarena.com 线上运行
- Java 11 + Undertow
- 三棋引擎进程池
基于 Java 11 + 原生 Undertow HTTP/WebSocket + PostgreSQL 构建的三棋实时对战与 AI 复盘生产级 Web 平台(中国象棋 / 五子棋 / 围棋),通过 Cloudflare Worker/Tunnel 前门部署于 xiangqiarena.com。
01 / 项目概览与状态
项目概览与状态
持续稳定运行于 xiangqiarena.com,完成双人实时对战、房间重开、断线重连与三大外部引擎进程池调度;支持走子高亮、将军播报、AI 异步复盘与 390px 移动端抽屉式适配。
02 / 要解决的问题
要解决的问题
把中国象棋、五子棋与围棋的异构规则校验、低延迟双人房间同步以及高算力本地 AI 引擎(Pikafish / Rapfi / KataGo)收束到同一套高可用 Java 服务中,并兼顾桌面与手机端对局体验。
03 / 我的职责
我的职责
我负责项目发起、需求梳理、Java 后端与引擎池研发、Cloudflare/VPS 部署与跨端验收。
- 01设计并实现三棋统一站点、WebSocket 房间状态同步与独立棋规校验服务
- 02封装 Pikafish / Rapfi / KataGo 引擎进程池与超时取消机制,防止高并发阻塞
- 03搭建 VPS + Caddy + Cloudflare 生产发布与软链接回滚流程,完成桌面与手机真机验收
04 / AI 参与边界
AI 参与边界
AI 辅助
- —辅助生成局部前端样式草案、测试建议和排查假设
由我负责
- —系统架构选型、并发队列治理、问题复现、代码审查、生产部署与最终线上验收
05 / 系统架构
系统架构
06 / 关键实现
关键实现
- 01Java 11 + 原生 Undertow 非阻塞 HTTP/WebSocket 服务 + HikariCP/PostgreSQL 持久化
- 02中国象棋 / 五子棋 / 围棋统一站点结构与独立规则引擎边界
- 03外部引擎进程池调度与异步任务队列(Pikafish 象棋、Rapfi 五子棋、KataGo 围棋)
- 04Cloudflare Worker 前门 + Tunnel + Linux VPS 容器化可回滚部署链路
- 05在线双人对战房间邀请、重开机制、走子路径高亮、战术播报与移动端适配
07 / 一次真实问题与修复
一次真实问题与修复
问题
公开房间与对手走子在移动端偶发状态不同步,且浏览器频繁请求 AI 时易造成后端引擎队列堆积。
排查
用真实双端房间流程复现,结合请求日志与引擎进程句柄定位过期异步任务与刷新通知链路。
修复
在服务端取消过期异步 AI 推理任务,收敛房间状态广播路径,并针对移动端棋谱与观战页面补充自适应重绘。
结果
桌面与 390px 手机流程完成重复验收,线上服务长期稳定运行,对应提交记录可公开复查。
08 / 验证证据
09 / 截图与运行记录
截图与运行记录


10 / 继续验证