第三梯队 · 线上与多端工程线上运行 · 持续迭代最近更新 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 / 系统架构

系统架构

轻棋局 Cloudflare 与 Java 服务部署架构图
浏览器通过 Cloudflare Worker 前门访问 Java Undertow 源站,规则服务再通过异步队列调度三大棋类引擎。
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 / 截图与运行记录

截图与运行记录

轻棋局线上首页桌面端真实截图
runtime已验收的生产首页(xiangqiarena.com),展示三棋入口与主导航。
轻棋局线上首页手机端真实截图
runtime390px 手机视口的生产验收记录。
10 / 继续验证

继续验证