简体中文 | English
「掼蛋教练」是一个单机牌类练习游戏,适合刚入门的玩家。首页可以选掼蛋或德州扑克,在浏览器里和电脑玩家对局,教练会给提示并点评每一步。
在线试玩:https://guandan-playground.vercel.app
- 掼蛋完整规则:全部牌型、逢人配、炸弹大小、升级、进贡与还贡、抗贡、接风,三次打 A 不过退回打 2
- 电脑玩家三档水平(新手 / 普通 / 进阶),对手和对家可以分别设置
- 教练:局面讲解、提示、每手牌的点评,可以隐藏
- 记牌器、花色筛选、找同花顺、理牌(自己组牌并调整顺序)
- 每局结束后复盘四家起手牌和出牌记录
- 进度保存在浏览器本地,不需要账号,也没有服务器
- 电脑和手机浏览器都能玩,横屏竖屏均可
- 牌桌可以在 2D(平面)和 3D(立体)之间切换
- 德州扑克:6 人桌或 9 人桌,在首页或设置里选;无限注,盲注 10/20,使用练习筹码。9 人桌多了枪口+1、枪口+2 和劫位这几个位置。教练给出胜率、底池赔率和建议;翻牌以后还会写出人能自己算的步骤:你的牌是什么、哪些牌能帮你、用二四法则估多少。每手结束后逐个点评你的决定,教练也可以关掉;电脑对手有新手、普通、进阶三档。输光筹码就出局,和真的比赛一样,你出局或者别人都出局了,这一桌就结束。每一步都自动保存在浏览器里,下次打开从离开的地方接着打,没打完的一手还是原来的牌,不会重发;设置里可以重新开始
电脑玩家和教练都是基于规则的程序,没有使用大语言模型。
需要 Node.js 22.12 或更高版本。
npm ci
npm run devnpm run check # 提交前跑这一条:代码检查、约定检查、测试、构建、包体积
npm run test:e2e # 改动界面后还要跑这一条:在真实浏览器里测试电脑和手机共四种屏幕尺寸
npm run test:e2e:install # 首次运行浏览器测试前执行一次:下载 Chromium 和 WebKit
npm run screenshots:accept -- <run-id> # CI 的截图对比失败且改动是有意的:把那次运行生成的新截图存为基准图
npm test # 规则引擎和界面测试
npm run bench # 三档电脑玩家互相对打的基准测试
npm run test:levels # 德州扑克三档电脑玩家互相对打,检查难度没有退步
npm run build # 生产构建npm run check 不包含浏览器测试。CI 两者都会跑,所以改了界面的话,提交前请把两条都跑一遍。
src/engine:掼蛋的规则引擎、对局流程和电脑玩家,不依赖界面src/holdem:德州扑克的规则、胜率估算、电脑玩家和教练,不依赖界面src/ui、src/App.tsx、src/Root.tsx:界面,使用 React 和@ui-sdk/react.agents/skills:给编程智能体看的掼蛋和德州扑克规则、打法要点和界面开发约定
当前版本号显示在游戏的“设置 → 关于”里。每个版本的改动见 CHANGELOG.md。
欢迎提交 Issue 和 Pull Request。流程和提交格式见 CONTRIBUTING.md,架构说明和 CI 检查项见 AGENTS.md。main 分支受保护,所有改动都通过 Pull Request 合并。