Kerry Mahjong

Kerry Mahjong 是一个本机可托管的国标麻将桌面版。它把 Vue 3 前端、Socket.io 实时服务、AI 补位和公网分享入口打包进一个 Windows 应用。

功能

• 单人开局：一名玩家即可开始，AI 自动补足四人牌桌。
• 多人联机：本机作为服务器，同一房间内实时同步。
• 公网分享：大厅里可尝试生成公网链接，复制给朋友加入。
• 桌面软件：Electron 打包，提供 Setup 安装器和 Portable 便携版。
• 设计系统：已按 nextlevelbuilder/ui-ux-pro-max-skill 生成并落地 design-system/mahjong/MASTER.md。

本地运行

npm install
npm --prefix server install
npm --prefix client install
npm run build
npm run electron:dev

开发时也可以分别启动：

npm --prefix server run dev
npm --prefix client run dev

访问 http://localhost:5173。

打包

npm run dist

产物在 release/：

• Kerry Mahjong-Setup-1.0.0-x64.exe
• Kerry Mahjong-Portable-1.0.0-x64.exe

验证

npm --prefix server test
npm run build

单人 AI smoke 检查需要先启动服务或桌面程序：

node scripts/smoke-single-ai.cjs

技术栈

• Frontend: Vue 3, Pinia, Vue Router, Vite, Lucide icons
• Backend: Express, Socket.io, TypeScript, sql.js/SQLite
• Desktop: Electron, electron-builder
• Tunnel: localtunnel

发布

推送 tag 后，GitHub Actions 会构建 Windows Setup/Portable 并上传到 Release：

git tag v1.0.0
git push origin main --tags