二七王：maipai 补发 playproc（增量路径与重连路径对齐）

前端一致性测试剩余 3 红的根因：do_burycard() 内部已调 new_playround 初始化好 round-1 的进行态，但 mod.js 组 maipai 包时没有放 playproc（协议 §9 字段表也没有），「埋牌完成 → 庄家首出」这段窗口增量路径 table.playproc 为 null，重连路径却已有初值—— 与上一个 commit（8452535）给 maipai 补 seatlist 是同一个窗口、同一条理由，被漏在了同一处。修法：复用既有的 get_playproc() 快照函数（与 chupai1/2/3、PushCards.playproc 同源，本身就是逐字段深拷贝，不引入活引用风险）。可见性：此刻一张牌未出，round/start/currseat 等全部由桌面公开信息推出，cards 全空、shuai_demand 为 null，不含私密信息，故与 chupai1/2/3.playproc 一样三家整体下发、不受查牌模式门控。协议文档 §9 同步补字段说明。test_rpc.js 新增 5 checks：庄闲同值、与重连快照比对、 round-1 初值断言、不查牌模式下仍恒有、深拷贝守卫；已用「退回修复必转红」反向验证（3/5 转红）。既有 121 checks 未改一条断言，全绿（17 脚本 / 675 checks）。未涉及 shared/。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-27 19:46:32 +08:00
parent 729128aa9d
commit cdf2bc730e
3 changed files with 39 additions and 0 deletions
@@ -258,6 +258,7 @@
 | cards | 数组 | 埋牌后手上的牌，去掉了埋牌，庄家才有此属性，闲家没有该属性 |
 | burycards | 数组 | **埋牌底牌**（庄家埋下的 8 张），庄家才有此属性，闲家没有该属性。注意与 `shangzhuang.bottomcards`（**底牌**，发牌留桌 8 张）是两批不同的牌，见 §0.0。<br>**取服务端权威快照 `get_burycard()`，不是客户端请求包里 `cards` 的原序**：按本局主牌花色从大到小排好，与重连包 `PushCards.burycards` **同源同序** |
 | seatlist | 数组 | 三家座位牌况，**仅可查牌模式下发**（不查牌无此属性，design §9），结构与门控同 `chupai1/2/3.seatlist` 与重连包 `PushCards.seatlist`。<br>埋牌完成时它是刚初始化的**空表**（每家 `[[0,0],[0,0],[0,0],[0,0],[-1,-1]]`）——下发它是为了让「埋牌完成 → 庄家首出」这段窗口内，增量路径与重连路径拿到同一张表，客户端无需为这段窗口特判 |
+| playproc | json | **本轮进行态**（design §5.1），**恒有、三家同值**，结构与门控同 [`chupai1.playproc`](#11-第一个玩家出牌chupai1)/重连包 `PushCards.playproc`（同一个快照函数 `get_playproc()`）。`do_burycard` 内部已 `new_playround` 就地初始化好 round-1 的进行态，此包带的正是这份初值：`round=1`、`start`/`currseat` 均为即将首出的庄家、`cards` 全空、`shuai_demand` 为 `null`。<br>**可见性**：全部字段由桌面公开信息推出（此刻尚无一张牌打出），三家整体下发、不逐座位裁剪 |
 | seat | 整数 | 出牌者的位置序号（即将首出的庄家）|
 | countdown | 整数 | 出牌倒计时 |
 | liangpai | json | **亮牌**（design §8.2）。**只有闲家、且可查牌模式、且庄家达门槛时才有**；不达标或不查牌则无此属性。结构：`{ cards: [牌id...] }`——**庄家手中全部固定主牌的具体牌面**，按本局主牌序从大到小排好。<br>**固定主牌 = 双王 + 全部花色的 2 + 全部花色的 7**，**不含**主花色的普通牌 A/K/Q/J/10/9/8/6/5。<br>**门槛**（任一满足即下发）：固定主牌总数 ≥10 / 王 ≥3 / 7 ≥6 / 2 ≥6。**不限叫分**。<br>亮出的是**固定的一份**，不随被哪条门槛触发而增减；也**不给数量统计**——数量前端自己数 `cards.length` 即可。<br>口径是庄家**埋牌后的静态快照**（排除已埋的 8 张，但包含之后已打出的牌），全局固定不随出牌缩水，故重连包里取值一致 |