← 回成果库

德州扑克 · 边玩边学(带语音讲解)—— 交付报告


一、这是什么

一张 6 人无限注德州扑克(NLHE)教学桌:你 + 5 个性格不同的电脑对手,盲注 10/20,起始筹码 2000。

参考主席另一个「三国杀」项目的形态做的:同一套深色顶栏工具条 + 实况解说侧栏 + 语音播报架构,换成赌桌绿绒。

它和网上那些扑克小游戏最大的区别:讲解不是贴上去的漂亮话,是引擎真算出来的数


二、教学是怎么做的(四层)

1. 教学面板(每次轮到你,下方绿框)

显示项怎么来的
你当前的牌型7 张里枚举 C(7,5)=21 种组合取最强
真实胜率蒙特卡洛模拟(翻前 900~1500 次、翻后 1000~1800 次随机发完剩余牌)
底池赔率门槛要跟的钱 ÷ (底池 + 要跟的钱),算式直接写在界面上
出路 outs逐张枚举 52 张未知牌,数出哪些能让牌型升级,并区分「真听牌(同花/顺子)」和「只是配对」
4-2 法则对照口诀估算值 和模拟真值并排显示,让你亲眼看到这条心算口诀有多准
建议 + 理由胜率 vs 门槛 vs 对手人数的公平份额,三者一起判

另外当你的最强 5 张一张底牌都没用上时,面板会明确警告「⚠️ 打的是公共牌」——

这是新手最常见的错觉之一(以为自己有一对 Q,其实全桌都有)。

2. 🎙️ 解说 —— 电脑为什么这么打

每个 AI 的每一步都会把它自己算出来的数摊给你看,例如:

> 🎙️ 🦈鲨鱼:一对 K,胜率 71% 既高过跟注门槛 24%、也高过 3 家的公平份额 25% → 我是领先方,加注要价值

5 种性格各有明确的可学习特征(这是本作最有教学价值的设计):

对手类型特征你该怎么打他
🐢 老僧紧弱只玩超强牌,几乎不诈唬他一跟你就是真有牌,别硬碰
🦈 鲨鱼紧凶标准赢家打法最难打的对手
🔥 疯子松凶玩很多牌、爱诈唬用强牌让他自己撞上来
🐟 小鱼松弱什么都跟(跟注站)别对他诈唬,只做价值下注
🎓 教授均衡严格按赔率 + 平衡频率常规打法

3. 🧠 军师 + 📋 复盘

军师每次给你建议和理由;每手结束自动复盘「你的选择 vs 建议」并给一致率,

明确写着:看的是决策质量,不是这一次输赢

4. 📖 11 章系统教程 + 💡 12 条情境提示

教程从「一分钟看懂」到牌型/流程/动作/位置/起手牌(Chen 公式)/底池赔率/听牌 4-2 法则/为什么下注/新手十大错误/术语表。

情境提示是打到那个局面才弹的:第一次坐按钮位、第一次拿到同花听牌、第一次面对 3-Bet、第一次赔率不够……


三、语音(主席点名要的)

语音开着时游戏节奏会等它读完再走,不会音画分裂;TTS 坏掉连续超时两次自动降级,绝不卡死游戏。

其他控制:⏸️暂停 / 🚶速度四档 / 🎓教学开关 / 🧠军师开关 / 🎙️解说开关 / 🏆牌型速查侧栏 /

快捷键 F 弃牌·C 过牌或跟注·R 加注。手机端已单独适配版式。


四、怎么验的(真凭据,不是"我测过了")

① 引擎正确性 —— 用公开基准对

校验项本引擎公开基准
AA vs 1 家85.0%85.2%
AKs vs 1 家67.4%67.0%
72o vs 1 家34.1%35.1%
AA vs 5 家49.6%49.3%
同花听牌 outs99
两头顺听牌 outs88

牌型评估另测了皇家同花顺 / 轮子顺(A2345)/ 四条 / 葫芦 / 同花 / 顺子 / 两对 / 高牌 / 踢脚比较,全部正确。

② 真浏览器端到端回归测试(e2e-test.mjs,可复跑)

60 手压测结果:126 次玩家操作(含全下)、13 次边池派发、35 次摊牌、

筹码每一步都守恒(所有人筹码 + 本轮下注 + 底池 ≡ 12000 + 补码总额)、

0 条运行时错误;六个开关全部实测可切,教程 11 章齐全。

③ 上线核实

线上 4 个文件与仓库源文件逐字节一致(cmp 全绿),并把线上抓下来的那份字节

在真浏览器里又跑了 15 手,0 错误。

说明:容器里的 Chromium 走不通出网代理(curl 可以),所以"真浏览器驱动线上 URL"这一步

是用「抓线上字节 → 本地真浏览器跑」等价完成的,如实记录,不含糊带过。

④ 测试期间抓到并修掉的两个真 bug

1. 筹码凭空翻倍:奖池派发后 G.pot 没清零,被守恒断言当场抓住。

2. 会教坏人的建议:胜率"领先"判定没按对手人数折算,41% 胜率对 1 家被误判成"价值加注"。

已改成同时看「跟注门槛」和「对 N 家的公平份额 1/(N+1)」——赔率划算但还没领先时,

明确告诉你那是半诈唬,不是价值下注


五、诚实边界(该说的短板)

它会按赔率做正确决定,但不会读你的打法、不做诈唬平衡博弈。当陪练够用,别当最优解。

该补钱的人一定要行动,但理论上他们只能跟不能再加,本作允许再加。不影响正常牌局。


六、还可以往下做(等主席试玩后定)

1. 牌局回放:把每手牌存下来,可以逐街倒回去看"当时该怎么打"

2. 起手牌 169 格范围表可视化:把 Chen 分打成一张彩色矩阵,一眼看懂该玩哪些牌

3. 难度分级:新手桌(全是鱼)→ 进阶桌(全是鲨鱼)

4. 统计面板:你的入池率 VPIP / 加注率 PFR / 军师一致率长期曲线 —— 让进步可量化