二七王:修正 design 全量重核发现的 3 项不一致(亮牌快照/报无主下发面/甩牌张数上限)

- §8.2 亮牌改用埋牌后 28 张静态快照 get_seat_cards_award,不再用
  get_seat_cards(只含未出的牌)——否则闲家重连时 get_deskinfo 按庄家
  当前剩余手牌重算,亮牌统计缩水甚至变 null。
- §9 出牌包由只带出牌者一家的 info 改为整表下发三家 seatlist,与重连包
  PushCards.seatlist 同名同构;报无主后另两家的主牌数/对子数不再滞后两次出牌。
- §5.4.3 甩牌"无组合数量限制":can_playcard 去掉规则外的 14 张硬上限,
  改为结构性上界 28(单人手牌上限,牌型编码在此范围内不溢出)。

协议文档同步改写 chupai 三处 info 条目与 liangpai 口径;合规文档补记第四轮
核对(流程层无缺环,规则层 3 项已收口)。全套单测 368 项通过。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-08-16 19:33:06 +08:00
co-authored by Claude Opus 5
parent b6aeba412f
commit 916066ba96
9 changed files with 72 additions and 15 deletions
@@ -95,6 +95,27 @@
---
## 第四轮核对(全量重核 design.md:先流程、后规则细节)
> 从 design.md §1~§12 重新逐条对照当前代码(含流程阶段机与全部规则细则),**流程层无缺环**(发牌→叫分→摸暗牌/70分亮3秒→选主/投降互斥→先选主后埋牌→出牌→末轮扣底→算子+算奖→轮庄→大局/解散结算,`step` 迁移 1→2→3→5→6 闭合)。规则层新发现 3 项不一致,已全部修复并补回归单测。
| # | 严重度 | 位置 | 问题 | 处置 |
| --- | --- | --- | --- | --- |
| E1 | 🟧 中等 | `class.paiju.js` `get_liangpai` | 亮牌统计取 `get_seat_cards`(只含未出的牌),而 §8.2 的依据是**庄家埋牌后的手牌**。埋牌那一刻算对,但 `get_deskinfo` 在 step5 重连时会按庄家**当前剩余手牌**重算:实测「4王+6个7」的庄家打掉 2 大王 + 1 对♦7 后,重连再取从 `{zhu:10,zhupair:5,zhutuo:1,wang:4,qi:6}` 变成 `null`,闲家重连即丢失亮牌 | 改用已有的静态快照 `get_seat_cards_award(o_paiju, banker)`(埋牌后 28 张、含之后已打出的),并在函数注释里固化"不得用 get_seat_cards"的原因;补 3 条回归用例(快照 / 打出后重连不缩水 / 已埋牌不计入) |
| E2 | 🟨 轻微 | `mod.js` `chupai` | 第三轮 D4 只修了服务端状态(`do_playcard` 里已按 `have_baofu()` 同时刷新三个座位),**下发面没跟上**:出牌包仍只带 `info = seatlist[seat]` 一家,另两家的主牌数/对子数要等它们各自出牌才送达,仍最多滞后两次出牌,与 §9「一旦有人报无主,立即为全体三人显示另外两家」不符 | 出牌包改发整表 `seatlist`(三家),字段名/结构与重连包 `PushCards.seatlist` 统一;协议文档三处 `info` 条目同步改写;补「整表带三家 + 含非出牌者统计」用例 |
| E3 | 🟨 轻微 | `class.arith.js` `can_playcard` | 开头 `if (cards.length > 14)` 是"规则外的约定"硬上限,与 §5.4.3「甩牌无组合数量限制」冲突:手持 15 张以上顶级主牌时的合法甩牌会被整个拒掉(如 4王+8个7+正2对+副2对 共 16 张) | 上限改为结构性上界 28(出牌阶段单人最多持 28 张,且 28 张内牌型编码不溢出 1xx/2xx/3xx 区间),不再设规则性限制;补 16 张合法甩牌用例 |
**非缺陷的观察(本轮确认,勿再重提)**:
- 70 分「暗牌亮 3 秒」:服务端在上庄包里一次性下发 8 张暗牌 + `ancard3s=1`,"摸入前亮 3 秒"的先后由前端表现;重连不重放该一次性事件。design 未要求服务端表达先后,**按现状即合规**。
- §4/§11「选主按钮显示各花色对子数」:design 标注为**前端表现**,服务端已把庄家全部手牌下发,前端可自算,**不是下发面缺口**。
### 尚未处置
**无。** E1/E2/E3 已全部改代码 + 补单测(全套 368 项全绿),协议文档同步。
---
## 结论摘要
> **注**:下表是**首轮核对**的初始发现快照(保留以记录起点)。其中 §4.4、§5.4、§6.3、§7、§8.1-8.4、§9、§10、§11 等标 🟥/🟧/🟨 的项**后续均已修复并验证**——当前逐节状态以本文档后面的分节详情及全套单测(270 项全绿)为准。