feat: integrate platform room entry, UI migration and erqiwang documentation

cocoscreator_projects/games/erqiwang/docs/design/design.md

@@ -0,0 +1,784 @@
+# 二七王 玩法设计文档
+
+> 本文档是二七王玩法的唯一权威规则说明。内容随讨论持续与规则设计者逐项确认、修订；文中标注"待确认"的地方是当前仍未有定论的开放问题，其余内容均已确认生效。
+
+## 目录
+
+1. [术语约定](#1-术语约定)
+2. [牌局构成](#2-牌局构成)
+3. [主牌顺序](#3-主牌顺序)
+4. [开局与坐庄流程](#4-开局与坐庄流程)
+5. [出牌规则](#5-出牌规则)
+   - [5.1 跟牌基本原则](#51-跟牌基本原则)
+   - [5.2 按牌型跟牌](#52-按牌型跟牌)
+   - [5.3 拖拉机定义与相邻关系](#53-拖拉机定义与相邻关系)
+   - [5.4 甩牌详细规则](#54-甩牌详细规则)
+6. [捡分与扣底](#6-捡分与扣底)
+   - [6.1 分牌](#61-分牌)
+   - [6.2 捡分规则](#62-捡分规则)
+   - [6.3 扣底](#63-扣底)
+7. [结算：子数与升级](#7-结算子数与升级)
+   - [7.0 四层关系总览 / 查表索引](#70-四层关系总览)
+   - [7.1 常规算子：叫分 → 基础子数](#71-常规算子叫分-→-基础子数未勾选爬坡时的默认规则)
+   - [7.2 常规算子的判定表](#72-捡分-vs-叫分庄家的过庄-小光-大光闲家的升级常规算子)
+   - [7.3 爬坡](#73-爬坡叫分-→-基础子数与保小光分段可选规则开房时勾选爬坡生效)
+8. [算奖规则](#8-算奖规则)
+   - [8.1 冲关](#81-冲关)
+   - [8.2 亮牌规则](#82-亮牌规则)
+   - [8.3 傍王（可选规则）](#83-傍王可选规则)
+   - [8.4 算奖如何影响最终结算](#84-算奖如何影响最终结算)
+9. [牌局查看模式](#9-牌局查看模式)
+10. [房间设置选项](#10-房间设置选项)
+11. [牌局交互提示](#11-牌局交互提示)
+12. [完整牌局游玩流程](#12-完整牌局游玩流程)
+
+---
+
+## 1. 术语约定
+
+| 术语 | 含义 |
+| --- | --- |
+| 主牌 / 副牌 | 庄家选定的花色为"主牌"，其余三个花色为"副牌"；主牌大于副牌 |
+| 固定主牌 | 不论选择哪个花色为主，大王、小王、以及所有花色的"2""7"恒为主牌 |
+| 正2 / 正7 | 选定花色的"2""7"，大于其余花色的"2""7"（口语里也叫"主2""主7"，本文档统一用"正2""正7"）|
+| 副2 / 副7 | 非选定花色的"2""7" |
+| 底牌 | 发牌时**没有发给玩家**、扣在桌面的 8 张牌；庄家确认后可摸起查看，摸起后就不再扣在桌面，而是并入庄家手牌 |
+| 埋牌底牌 | 庄家"埋牌"时从手牌中选出重新扣下的 8 张牌；"底牌"与"埋牌底牌"是两批不同的牌，不通用、不互换 |
+| 埋牌 | 庄家看到底牌、摸起查看后，从手牌中选出 8 张重新扣下，作为"埋牌底牌" |
+| 捡分 | 出牌中赢下的分牌（5、10、K）计入闲家总得分的过程 |
+| 扣底 | 出完所有手牌后的最后一轮，若被闲家用主牌牌型压过庄家，则埋下的 8 张埋牌底牌也计入闲家捡分，并按牌型翻倍 |
+| 亮牌 | 庄家埋牌后、出牌前，若手中固定主牌达到门槛（总数 ≥10 / 王 ≥3 / 7 ≥6 / 2 ≥6 任一），向两个闲家**亮出自己全部固定主牌的具体牌面**（见第 8.2 节）。不限叫分，仅可查牌模式 |
+| 余主公示 | 任一玩家主牌出空（报无主）后，为**全体三人**展示另外两家各自的**剩余主牌数与剩余主对数**（见第 9 节）。只给数量，不给具体牌面 |
+| 明牌 | 可查牌模式下，查看**另外两家**手中全部未出主牌的具体牌面（见第 9 节）。与"亮牌"同样给牌面，区别在：亮牌是**庄家公开自己的**，明牌是**去看别人的** |
+| 摸底 | 庄家坐定后把那 8 张**底牌**摸起查看并并入手牌（见第 4 节）。**非 70 分坐庄时只有庄家看得到这 8 张** |
+| 开底 | **70 分坐庄**时，在庄家摸底**之前**，先把这 8 张底牌向**所有玩家**翻开 3 秒，之后才由庄家摸入手牌（见第 4 节）。给的是具体牌面 |
+| 查底牌 | 对局中随时回看那 8 张底牌的功能（前端底栏按钮）。庄家全程可用；闲家仅在**开底**过的局（即 70 分坐庄）可用 |
+| 拖拉机 | 同一花色（含主牌）里点数相邻的连续对子，如 K K Q Q 为"两托"（两连对） |
+| 甩牌 | 首家出牌时，一次性打出多组主牌组合（单张 / 对子 / 拖拉机自由搭配）；仅主牌可以甩牌，副牌禁止甩牌，只能分单张 / 对子 / 拖拉机依次打出（见第 5.4 节） |
+| 毙牌 | 跟牌时手中没有本轮花色（缺门），改用主牌打出、且牌面大过本轮目前所有人的牌（见第 5.1 / 5.2 节） |
+| 垫牌 | 跟牌时手中没有本轮花色（缺门）、且不用主牌毙牌，随意出一张其他副牌，不参与、不争夺本轮的出牌权（见第 5.1 节） |
+| 混合出牌 | 首家出副牌，你手中有该花色副牌但张数不够凑齐首家总张数，又没有（或不用）别的副牌补差额，只能用主牌补足缺口——打出的是"该花色副牌 + 主牌"的混合牌。这既不是垫牌（不是缺门、不是纯副牌），也不是毙牌（不是纯主牌牌型、压不过首家），服务端判定其牌面为 0，**与垫牌等效：不参与、不争夺本轮出牌权**（见第 5.1 / 5.2 节） |
+| 子 | 结算时用于计算输赢筹码的单位，与"倍数"是两个独立概念（见第 7 节） |
+| 冲关 | 局末对固定组合（三王/四王、六 2/七 2/八 2、六 7/七 7/八 7、连续对子链等）的额外奖励结算，**只计庄家**（见第 8.1 节）。旧称"常规算奖"，现统一叫**冲关**；服务端字段名 `chongguan` 与此同源 |
+| 算奖 | **上位概念** = 冲关（8.1，只计庄家）＋ 傍王（8.3，可选、庄闲都算）。两个分量求和后才是某玩家的总奖数 `N`，据此结算（见第 8.4 节）。**说"冲关"指的是庄家那一份，说"算奖"指的是合计** |
+| 傍王 | 可选房间规则：勾选后每张王额外算一奖，庄家、闲家都要算；这是在 8.1 冲关之外**额外叠加**的奖励，与冲关互不冲突（见第 8.3 节） |
+| 爬坡 | 可选房间规则：改变叫分对应的基础子数与保小光分数线，未勾选时按"常规算子"结算（见第 7 节） |
+
+> **术语变更记录（2026-08-25）**：原「**暗牌**」（发牌留桌的 8 张）改称「**底牌**」；原「**底牌**」（庄家埋下的 8 张）改称「**埋牌底牌**」。
+>
+> 改名原因：前端界面上「底牌」按钮查看的正是发牌留桌那 8 张，旧命名与界面倒挂、极易写反。
+>
+> **本文已全文改用新术语。** 但 `docs/protocol/packet_protocol.md` 与服务端代码里的 `bottomcards` 字段名**尚未拆分**——两批牌目前仍共用这一个字段名，只靠「出现在哪个包」区分语义：`shangzhuang` / `ChooseMain` / `BuryCards` 里的是**底牌**，`maipai` / `PushCards` / 结算 `bottom` 分组里的是**埋牌底牌**。拆分计划见 `docs_dev/二七王-UI资源与精灵清单.md` §7.5 的 S-4。
+
+> **易混术语对照（都带"亮/明"字，但方向与粒度各不相同，务必分清）**：
+>
+> | 术语 | 谁公开给谁 | 给的是什么 | 触发条件 | 协议字段 |
+> | --- | --- | --- | --- | --- |
+> | **亮牌** | 庄家 → 两个闲家 | **具体牌面**（庄家全部固定主牌） | 庄家埋牌后手牌达门槛（§8.2） | `liangpai` |
+> | **余主公示** | 全体 → 全体 | **只有数量**（剩余主牌数、主对数） | 任一玩家报无主（§9） | `seatlist[seat][4]` + `baozhu` |
+> | **明牌** | 他家 → 请求者 | **具体牌面**（他家全部未出主牌） | 可查牌 + 报无主，主动点击（§9） | `mingpai.others[].zhucards` |
+> | **开底** | 桌面 → 所有玩家 | **具体牌面**（8 张底牌） | 70 分坐庄，**摸底之前** 3 秒（§4） | `ancard3s` + `bottomcards` |
+>
+> 一句话记：**只有「余主公示」是统计类（给数字），「亮牌」「明牌」「开底」都给具体牌面**——区别在给谁的牌：亮牌给庄家自己的、明牌给他家的、开底给桌上那 8 张。
+> 另有一组「底」字族专管那 8 张底牌：**摸底**（庄家摸起看）、**开底**（70 分时全场看 3 秒）、**查底牌**（随时回看）、**扣底**（末轮翻开埋牌底牌计分）。
+> 另注：**「亮主」不是本文档的术语**——它是前端选主界面的标题文案（庄家选主牌花色那一步），与上表四项无关。
+
+---
+
+## 2. 牌局构成
+
+两副扑克牌共 108 张，去掉两副牌中的"3"和"4"（2 种点数 × 4 花色 × 2 副 = 16 张），剩余 **92 张**：
+
+- 点数 5、6、7、8、9、10、J、Q、K、A、2：共 11 种点数，每种 8 张（2 副 × 4 花色）
+- 大王、小王：各 2 张（每副各 1 对）
+
+花色为黑桃 ♠、红桃 ♥、梅花 ♣、方块 ♦。
+
+---
+
+## 3. 主牌顺序
+
+每局开局前庄家选择一个花色作为本局主牌，其余三个花色为副牌。
+
+固定主牌（大王、小王、所有花色的 2 和 7）不论选择哪个花色为主，恒定属于主牌；选定花色里的其余普通牌也算主牌。
+
+主牌从大到小排列：
+
+| 顺序 | 牌 |
+| --- | --- |
+| 1 | 大王 |
+| 2 | 小王 |
+| 3 | 正 7（选定花色的 7） |
+| 4 | 副 7（其余花色的 7） |
+| 5 | 正 2（选定花色的 2） |
+| 6 | 副 2（其余花色的 2） |
+| 7 及以下 | 选定花色的其余普通牌：A、K、Q、J、10、9、8、6、5 |
+
+副牌（非选定花色，且非 2、7、王）从大到小：A、K、Q、J、10、9、8、6、5。
+
+> **关于"对子"的判定**：一副牌里同一张牌有两副（deck1 / deck2），"对子"指**同一张具体牌的两副**（如两张♦7、两张大王）。正 7、副 7、正 2、副 2 虽在上表中各占一个**大小等级**（用于排序与比大小时，同级的三张副 7 视为等大），但**成对只认同一花色同点数的两副**——即两张**不同花色**的副 7（如♠7 + ♥7）**不构成一对**，两张不同花色的副 2 同理。拖拉机的连对判定也以此为基础（每一节连对里的每个对子都须是同花色同点数两副）。
+
+---
+
+## 4. 开局与坐庄流程
+
+1. 每人摸 28 张牌，剩余 8 张扣在桌面作为"底牌"。
+2. 由暂定庄家开始，按逆时针方向依次叫分：
+   - 叫分范围 5 ~ 70 分，步进 5 分。
+   - 叫分数值代表"庄家承诺闲家捡分总数将严格低于该数值"（即闲家捡分只要达到或超过这个数值，庄家就算没达成承诺，见第 7 节）；数值越低代表叫分者越有信心，因此后叫的人必须叫出比当前更低的分数才能压过前者，不能叫相同或更高的分数。
+   - **暂定庄家必须叫分，不能"不叫"**：叫分从暂定庄家开始，他必须报出一个 5 ~ 70 之间的具体分数，不存在"暂定庄家弃权、三家都不叫"这种情况；起始叫分确定之后，后面的玩家才可以选择"叫出更低的分数"或"不叫"。
+   - 若某玩家直接叫出 5 分，则无人能再压过，立即确定为庄家。
+   - 若一家叫分后，另外两家都选择"不叫"，则该叫分玩家成为本局庄家。
+3. **摸底**：庄家确定后把 8 张底牌摸入手牌（摸完后庄家共 36 张）：
+   - **非 70 分坐庄**：桌面 8 张底牌**只有庄家可见**，庄家查看后摸入手牌。
+   - **70 分坐庄**（触发**开底**）：在庄家**摸底**之前，先把这 8 张底牌**向所有玩家（含两个闲家）翻开 3 秒**，然后才由庄家把它们摸入手牌。
+4. **选主 / 投降（同一决策点，二选一，互斥）**：
+   - **选主**：庄家在 4 个花色中选定一个作为本局主牌（见第 3 节）→ 进入下一步埋牌、随后出牌。
+   - **投降**：仅当**叫分为 70 分**时，此决策点才额外提供"投降"选项；选择投降表示放弃本局，**直接结束、不再选主、不埋牌、不出牌**，按 7.1 节"70 分坐庄 · 投降"的固定结果结算（基础子数 1 个，庄家直接输；算奖仍照常，见 8.4 节）。选主与投降互斥——**选了花色就等于放弃投降、正常打牌；选了投降就不再选主**。
+   - 叫分 < 70 分时没有投降选项，只能选主。
+   - （**开底**——70 分坐庄的 8 张底牌向所有玩家翻开 3 秒，发生在上一步"庄家摸底之前"，见步骤 3。）
+   - **前端表现**：此阶段界面显示 4 个花色选主按钮，且**每个花色按钮上要显示该花色在庄家手中有多少对**（供庄家判断选哪门为主）；70 分坐庄时并列再显示一个投降按钮。
+5. **埋牌**（仅"选主/打牌"路径）：庄家从 36 张里选出 8 张牌重新扣下（"埋牌"），作为"埋牌底牌"，供最后判断"扣底"使用；埋牌后庄家保留 28 张。（**本局先选主、后埋牌**——庄家先定主牌花色，知道主副后再决定埋哪 8 张。）
+6. 坐庄轮换规则（决定下一局的"暂定庄家"）：
+   - 第一局的暂定庄家为 **0 号座位**的玩家（此前没有打过任何牌局、还不存在"上一局的庄家"，故取固定座位）。
+   - 若庄家本局获胜（庄赢），下一局暂定庄家仍为该玩家（连庄）。
+   - 若庄家本局失败（闲家捡分达标 / 庄家投降），下一局暂定庄家变为该玩家的下家（按逆时针顺延）。
+
+---
+
+## 5. 出牌规则
+
+### 5.1 跟牌基本原则
+
+- 每一轮由上一轮牌面最大的一方先出牌；**每一局（每一手牌）的第一轮固定由庄家先出**——此时还没有"上一轮"可以比较，只能由庄家开局。
+- 首家出什么花色，其余两家必须跟出同花色的牌；若手中没有该花色的牌或数量不够（缺门），可以任选以下一种方式补齐：
+  - **毙牌**：改用主牌打出，且牌面要大过本轮目前所有人的牌，即可抢下本轮的出牌权；
+  - **垫牌**：随意出一张其他副牌，不参与、不争夺本轮出牌权。
+- 首家若出主牌，其余两家必须跟出主牌，规则同上（此时缺门只能垫副牌，不存在再用主牌毙牌的情况）。
+
+### 5.2 按牌型跟牌
+
+跟牌的总原则：**在本轮首家花色内，尽量凑出与首家相同的牌型结构；能凑出的高规格部分必须优先打出，凑不齐的部分才用低规格牌补足。** 服务端按此层级精确计算每名跟牌者的"必出牌"与"可选牌"，玩家无法跳过更高规格的强制部分。
+
+| 首家牌型 | 跟牌要求 |
+| --- | --- |
+| 单张 | 跟同花色任意单张；同花色缺门则任意牌补齐 |
+| 对子 | 有同花色对子必须打出对子；没有对子则打两张同花色单牌；同花色牌不足两张时，现有的同花色牌必须打出、不足部分任意补齐 |
+| 拖拉机（N 连对） | 见下方「拖拉机跟牌的强制层级」 |
+
+#### 拖拉机跟牌的强制层级（同花色牌足够时）
+
+首家出 N 连对拖拉机，跟牌者手中该花色牌数量 ≥ 首家张数时，按以下优先级**从高到低**确定必出部分，高一级能凑出就必须先凑，不允许跳过：
+
+1. **有同长（N 连对）的同花色拖拉机** → 必须打出该拖拉机；若手中有多组等长拖拉机，可任选其一打出。
+2. **没有 N 连对，但持有更短的同花色拖拉机（仅 3 连对及以上首家才会走到这一步）** → 必须先拆出手中能凑到的**最长**拖拉机作为强制部分，再用次长拖拉机 / 对子 / 单张继续补足到相同张数——即"能凑多长的拖拉机，就必须先凑多长"，不允许放着更长的拖拉机不出而只出零散对子。
+3. **没有任何同花色拖拉机，但对子数量足够（对子数 × 2 ≥ 首家张数）** → 用现有对子凑够张数打出（多余的对子可自选保留）。
+4. **对子数量不够（对子数 × 2 < 首家张数）** → 手中现有的同花色对子**全部**必须打出，剩余缺口用同花色单张补齐。
+5. **完全没有同花色对子** → 用同花色单张随意补齐张数。
+
+**同花色牌数量不足**首家张数时（手中还有该花色的牌，但张数不够——无论首家出的是单张、对子还是 N 连对拖拉机）：手中该花色的牌**全部必须打出**（不论它们是否成对、是否成拖拉机），不足的缺口用**任意其他花色的牌**补齐——补齐的牌**不要求成对、不要求成拖拉机、也不要求是主牌**，随意垫即可。特别地，**即便首家出的是拖拉机，缺口部分也不强制补成对子或拖拉机**（服务端只校验总张数，不校验缺口部分的结构）。若缺口只能用主牌补（手中没有别的副牌可垫），打出的就是"该花色副牌 + 主牌"的**混合出牌**：它不是缺门、不是毙牌，牌面判为 0，**与垫牌等效，不争夺本轮出牌权**（见术语表「混合出牌」）。
+
+若**完全缺门**（手中没有该花色的任何一张牌）：整手都可任意出，可选择垫牌或用主牌毙牌（见下）。
+
+毙牌的前提是**完全缺门**——手中**没有本轮首家花色的任何一张牌**。只要手里还剩该花色的牌（哪怕凑不成对子、凑不成拖拉机），都必须优先打出这些同花色牌（按上文 5.2 层级），**不允许留着该花色的牌改用主牌毙**。缺门后用主牌毙牌时，牌型与张数须与首家一一对应，才算"压过"、抢下出牌权：
+
+- 若首家出副牌单张，其余玩家**完全缺门**该副牌花色，可以任意出牌（含主牌）；但要压过首家，出的主牌也必须是单张（数量对应）。
+- 若首家出副牌对子，其余玩家**完全缺门**该副牌花色，要压过首家，出的主牌必须也是对子（不能用任意两张主牌顶替）。
+- 若首家出副牌拖拉机（N 连对），其余玩家**完全缺门**该副牌花色，要压过首家，出的主牌必须也是同样连对组数（N 连对）的主拖拉机，总张数完全对应；单张主牌或零散的主对子都不能顶替拖拉机。（注意：只要手里还有该副牌花色的牌，哪怕凑不成同长度拖拉机，也必须先出这些同花色牌，不能改用主牌毙。）
+
+### 5.3 拖拉机定义与相邻关系
+
+**拖拉机 = 在各自的大小序列里「位置相邻」的两个（或以上）对子**，如 K K Q Q 为两连对（两托），K K Q Q J J 为三连对（三托）。副牌与主牌各有自己的序列，相邻规则不同，分开说：
+
+#### 副牌拖拉机（非主花色）
+
+**必须同一花色**，点数在下面这条序列里相邻：
+
+```
+A - K - Q - J - 10 - 9 - 8 - 6 - 5
+```
+
+序列里没有 7 和 2（它们是固定主牌，见第 3 节），所以 **7 不与 6、8 相连，而 6 与 8 相连**（中间隔的 7 已被抽走）；同理 4、3 不在牌堆里（见第 2 节），5 是副牌序列的最小一档。**跨花色不构成连对**——♥K 对 + ♣Q 对不是拖拉机。
+
+#### 主牌拖拉机（主花色 + 固定主牌）
+
+主牌只有**一条**完整的大小序列（即第 3 节的主牌顺序）：
+
+```
+大王 - 小王 - 正7 - 副7 - 正2 - 副2 - 主A - 主K - 主Q - 主J - 主10 - 主9 - 主8 - 主6 - 主5
+```
+
+只要在这条序列里**位置相邻**的对子，就构成拖拉机，**不限花色**。因此「正7 对 + 副7 对」「副7 对 + 正2 对」「副2 对 + 主A 对」「大王对 + 小王对」都是合法的两连对，尽管两个对子的花色不同。序列末段（主A 到 主5）都是**选定花色**的普通牌，其中同样是 6 与 8 相连、7 不入此段。
+
+> **同一档位的两个对子不相邻**：「副7」在序列里只占**一个**位置，所以 ♥7 对 + ♣7 对是**两个平级的对子、不是拖拉机**；副2 同理。这与第 3 节「成对只认同花色同点数的两副」是同一条原则的两面——先按同花色同点数成对，再看这些对子在序列里的位置是否相邻。
+
+### 5.4 甩牌详细规则
+
+#### 5.4.1 基础定义
+
+**甩牌**：当你是本轮首家出牌人时，一次性打出多组主牌混合牌型（单张、对子、拖拉机自由组合），一轮打完多张主牌，无需分多轮依次打出。
+
+两条硬性基础禁令：
+
+1. **仅主牌允许甩牌，所有副牌完全禁止甩牌**：无论外面是否剩余该花色副牌，副牌只能分开单出、出对子、出拖拉机，不能一次性打包甩出。
+2. **只有本轮先手才能执行甩牌**：若他人先出牌，你只能跟牌、垫牌、用主牌毙牌，不具备甩牌资格。
+
+#### 5.4.2 生效条件（最大性原则）与报无主
+
+想要成功甩牌，必须同时满足：**剩余两名对手手中，不存在任何一张、一对、一组拖拉机能压制你甩出的整套主牌组合**。简单说，全场所有更大的主牌、更大的主对子、更长的主拖拉机必须全部在你手中，两家闲家没有任何牌型能盖过你的甩牌组合。
+
+**合法性由服务端在甩牌提交时自动判定**：服务端掌握全部玩家的手牌，甩牌一旦提交，立即检查另外两名玩家手中是否"持有"（不要求对方真正打出）能压过这套组合任意一部分的主牌；只要有人持有，就直接判定为甩错（见 5.4.5），不需要、也不会等到对方实际出牌反制才判定。
+
+"报无主"是给玩家参考的辅助信息，**不是合法性判定的依据**（合法性判定始终由服务端按全部手牌精确计算）：对局中非最后一轮，任意玩家手里没有主牌了，必须口头报无主，方便其他玩家在决定要不要甩牌前，大致判断风险：
+
+- **另外两家都报了无主**：全场只剩你自己持有主牌，甩牌必然合法，无需记牌。
+- **另外两家只有一家报了无主、还有一家没报**：那一家仍持有主牌，你若甩牌需要自行记牌估算风险；但即使判断失误，最终是否算甩错仍由服务端精确判定，不取决于你的记牌是否正确。
+
+#### 5.4.3 甩牌可包含的牌型组合
+
+甩牌仅限本局主牌（固定主牌 + 选定主花色的普通牌），内部可自由混搭任意数量、任意种类牌型：
+
+- **纯单张**：大王、小王、正 7、副 7、正 2、副 2、主花色单牌混合；
+- **纯对子**：大王对 / 小王对（各自成对，大王与小王点数不同，不能混成一对）、正七对、副七对、正二对、主花色数字对子；
+- **主拖拉机**：大小王拖拉机、七七连对、二二连对、主花色数字连对；
+- **混合搭配**：单张 + 对子 + 多连拖拉机一同甩出，无组合数量限制。
+
+#### 5.4.4 其余两家应对甩牌的强制跟牌规则
+
+甩牌一旦被判定合法（见 5.4.2：服务端已确认两名闲家都不持有能盖压这套组合任何一部分的主牌），闲家就不可能再用主牌把它压下去——"能不能盖压"在甩牌提交的那一刻就已经由服务端裁定完毕，不会走到"闲家出牌盖压"这一步。
+
+甩牌本身可能是单张、对子、多个不同长度拖拉机自由混搭的复杂组合（见 5.4.3）。闲家跟牌沿用 5.2「拖拉机跟牌的强制层级」同一原则（高规格能凑就必须先凑：拖拉机 → 对子 → 单张），只是这里要把整套甩牌**拆解成一个个独立的分量，逐个分量分别匹配**，而不是把整套甩牌当成一个笼统的整体来对待：
+
+1. **每一组拖拉机分量**：闲家手中若有同等连对数的主拖拉机，必须优先拆出来跟这一组；没有同等连对数的拖拉机，退而求其次用同等张数的主对子顶替；主对子也不够，才能拆主单张顶替。甩牌里若有多组不同长度的拖拉机，逐组分别按此规则处理。
+2. **每一组单独的对子分量**：闲家手中若有主对子，必须优先拆出来跟这一组；没有主对子，才能拆主单张顶替。
+3. **每一组单独的单张分量**：用主单张顶替即可。
+4. **闲家手中的主牌拆解完仍不够覆盖甩牌剩余的分量**：不够的那部分只能随意垫副牌。
+5. **闲家完全没有主牌**：只能随意垫任意副牌，本轮无法压制你的甩牌，本轮出牌权归你。
+
+无论怎么拆解跟牌，都不影响这套甩牌本身的合法性——合法性在提交时已经由服务端按 5.4.2 判定完毕，闲家的跟牌动作只是"凑够同等张数、同等结构"的手牌垫上去，不可能真正反超压制。
+
+#### 5.4.5 甩错判定与惩罚规则
+
+**甩错判定**：甩牌提交时，服务端按全部玩家的真实手牌自动检查——只要两名对手任意一人**持有**（不要求已经打出）能盖压你甩牌内任意一组牌型的主牌，本次甩牌立即判定为甩错，对方是否愿意打出来压制不影响判定结果。
+
+**统一惩罚标准**：
+
+- 本次甩牌全部收回手牌；
+- 本轮仅强制打出你甩出组合里最小的那一张牌；
+- 本轮失去再次甩牌、一次性多出牌的资格，剩余手牌只能分轮正常打出；
+- 线下娱乐、线上棋牌平台均统一执行该惩罚，不额外扣分。
+
+甩错判罚后，本轮实际只算打出了那一张最小的单张主牌，其余两家按 5.2 节的"单张"跟牌规则正常应对即可，不再涉及甩牌相关规则。
+
+---
+
+## 6. 捡分与扣底
+
+### 6.1 分牌
+
+牌面 5 记 5 分，牌面 10 记 10 分，牌面 K 记 10 分，其余牌不计分。
+
+### 6.2 捡分规则
+
+每一轮出完牌后比较牌面大小：
+
+- 若闲家最大，则本轮牌面上的分牌全部计入闲家捡分（两个闲家谁大不影响，都算闲家捡到）。
+- 若庄家最大，则本轮牌面上的分牌作废——不计入闲家捡分总数，也不属于庄家的个人分数（庄家本身没有"捡分"这个概念，庄家的输赢只看闲家捡分总数是否达到叫分，见第 7 节）。
+
+### 6.3 扣底
+
+所有手牌出完后，若最后一轮闲家**用主牌**（不论单张、对子、拖拉机）**牌面压过庄家**、赢下最后一轮，才视为"扣底"（若闲家赢了最后一轮但用的不是主牌，则不算扣底）。触发后，庄家埋下的 8 张埋牌底牌翻开，若有分则计入闲家捡分。
+
+埋牌底牌的分要不要翻倍、翻几倍，取决于闲家扣底所用的那手牌（赢下最后一轮的牌）本身是什么牌型：
+
+| 闲家扣底所用牌型 | 倍数 |
+| --- | --- |
+| 单张主牌 | 不翻倍，按原始分值计入 |
+| 主对子（一对主牌） | 2 倍 |
+| 两连对拖拉机 | 4 倍 |
+| 三连对拖拉机 | 6 倍 |
+| N 连对拖拉机 | 2 × N 倍，以此类推递增 |
+
+若最后一轮闲家是用第 5.4 节的**甩牌**（单张 + 对子 + 拖拉机混合的组合）扣底，取这套组合里**最高规格牌型**对应的倍数计算，其余较低规格的部分不额外叠加。例如甩出"单张 + 一对 + 两连对拖拉机"并以此扣底，最高规格是两连对拖拉机，整手按 4 倍计算。
+
+> **重要区分**：扣底翻的是**闲家的捡分得分（grade）**本身，属于"算分"阶段；这与第 7 节里"大光 ×3""小光 ×2""升 N 级 ×N"这些子数倍率是完全不同的两件事——那些乘的是**子数**，属于"算子"阶段。两者的先后顺序是：扣底先把埋牌底牌的分（可能翻倍）计入闲家的捡分总数，这个最终捡分总数再拿去跟庄家叫分比较，判定过庄 / 小光 / 大光 / 闲家赢（升级），最后才由判定结果决定子数乘几倍。
+
+---
+
+## 7. 结算：子数与升级
+
+叫分与结算涉及两套并存的数值：**倍数**（用于计算"捡分得分" grade）与**子数**（用于计算最终筹码输赢），两者是独立概念，不能混用。
+
+> **重要区分**：本节里提到的倍率（大光 ×3、小光 ×2、过庄 ×1、升 N 级 ×N），乘的都是**子数**（最终结算给玩家的筹码单位），不是对局过程中闲家捡到的分数（捡分得分）本身。捡分得分只用来判定庄家的过庄 / 小光 / 大光，或闲家的升级级数，一旦等级判定完成，实际相乘的对象是这一局最终要结算的子数。
+
+> **算子模式的选择**：7.1 + 7.2 描述的"常规算子"是默认结算方式；开房时勾选"爬坡"后，才改用 7.3 的子数梯度和保小光分段；未勾选"爬坡"时，一律按常规算子（7.1 + 7.2）结算，两套规则不会同时生效。
+
+### 7.0 四层关系总览
+
+结算分四层，前三层是"算子"（本节），第四层是"算奖"（第 8 节），一层的输出是下一层的输入：
+
+1. **叫分 → 基础子数**：叫分档位本身决定这一局的基础子数（见 7.1 / 7.3 的对照表），叫分越低（庄家承诺越苛刻），基础子数越高。
+2. **捡分 vs 叫分 → 判定结果**：局末闲家的捡分总数（含扣底，见 6.3 节）与庄家叫分作比较，只会落入互斥的两个分支之一：
+   - **闲家没达到叫分**（庄家赢）→ 结果记在**庄家**名下，分三级：**过庄 / 小光 / 大光**。
+   - **闲家达到或超过叫分**（闲家赢，庄家倒庄）→ 结果记在**闲家**名下，只有一个概念：**升级**（第几级）。
+   - **大光 / 小光和升级是两套完全独立的命名体系，分别只属于庄家一侧和闲家一侧，不能混用或类比**：庄家赢的时候没有"升级"，闲家赢的时候也没有"大光 / 小光"。
+3. **判定结果 → 子数倍率**：过庄 / 小光 / 大光 / 升级第几级，各自对应一个子数倍率，乘上第 1 层的基础子数，得到这一局的**子数结算结果 `X`**（前三层，即"算子"，到此为止）。`X` 是庄家与**每一个**闲家之间"一对一"结算的基础金额：庄家赢（过庄 / 小光 / 大光）时，两个闲家各输给庄家 `X` 子；闲家赢（升级）时，庄家各输给两个闲家 `X` 子。
+4. **算奖 → 结算倍率**：第 8 节算出的"奖数"（8.1 冲关 + 8.3 傍王，各玩家分别求和）**是"持有奖数的这个人"从其余两名玩家那里各自多收一笔钱的独立结算线，作用对象是这个人本身，不是整场结算的统一系数**——某玩家 P 这一局总共有 `N_P` 奖，则**另外两名玩家（不分庄闲）都要各自额外付给 P：`X × N_P` 子**。三名玩家可能同时都持有各自的奖数，会产生最多 3 条互相独立的额外支付线，与第 1~3 层的基础输赢结算加总，才是每个人这一局的最终盈亏。算奖的计算过程本身不受叫分、过庄 / 小光 / 大光、升级影响（只看手牌结构），详见 8.3 节的完整举例。
+
+> **例外**：70 分坐庄选择投降时不走第 1~3 层模型——直接固定基础子数 1 个、庄家输掉，不比较捡分、不判定过庄 / 小光 / 大光，见 7.1 末尾说明；但第 4 层算奖仍然照常叠加（投降是选主阶段的选择、未选主也未埋牌，按庄家"发牌 + 底牌"共 36 张、无主牌花色计算，见 8.4 节）。
+
+**查表索引**：本节按叫分档位给出了完整判定表，位置如下：
+
+| 叫分 | 常规算子（未勾选"爬坡"） | 爬坡（勾选"爬坡"） |
+| --- | --- | --- |
+| 70 分 | 7.2.1 末尾"70 分坐庄" | 与常规算子一致，见 7.3.3 末尾说明 |
+| 65 / 60 / 55 / 50 / 45 分 | 7.2.1 对应表格 | 与常规算子数值一致（45 分子数不同），见 7.3.3 末尾说明 |
+| 40 / 35 / 30 / 25 / 20 / 15 / 10 分 | 7.2.1"40 分及以下坐庄"通用规则 | 7.3.3 对应表格（子数、`Q` 值均与常规算子不同） |
+| 5 分 | 7.2.1"40 分及以下坐庄"内的"5 分坐庄没有小光"说明 | 7.3.3"5 分坐庄"（没有小光） |
+
+### 7.1 常规算子：叫分 → 基础子数（未勾选"爬坡"时的默认规则）
+
+叫分范围是 5 ~ 70 分（见第 4 节），常规算子下完整的"叫分 → 基础子数"对照：
+
+| 叫分 | 65 分 | 60 分 | 55 分 | 50 分及以下（50 / 45 / 40 / 35 / 30 / 25 / 20 / 15 / 10 / 5） |
+| --- | --- | --- | --- | --- |
+| 基础子数 | 2 个子 | 3 个子 | 4 个子 | 统一 6 个子，不再随叫分继续增加 |
+
+即叫分从 65 分往下每降 5 分子数依次是 2 → 3 → 4，但**到 50 分封顶**：50 分及以下所有档位（50、45、40、35、30、25、20、15、10、5）基础子数都固定是 6 个子，不会像爬坡那样继续往上加（爬坡的区别见 7.3）。
+
+70 分叫庄是特例，基础子数不接着上面的阶梯往下走，而是在"投降"和"打牌"两条路径下分别取值：
+
+- **选择投降**：基础子数按 **1 个**算，庄家直接输 1 个子（此时局面还没有真正出牌捡分，不经过 7.2 的大光 / 小光 / 升级判定，是一次性的固定结算）。
+- **选择打牌**：基础子数按 **2 个**算（与 65 分相同），之后**照样按 7.2 节的方法，用捡分总数判定大光 / 小光 / 过庄 / 升级**，不是不细分——完整判定表见 7.2.1。
+
+70 分叫庄时，发牌时桌面留下的那 8 张底牌（见第 4 节；不是埋牌时埋下的那 8 张「埋牌底牌」）需要**在庄家把它们摸入手牌之前、向所有玩家亮出 3 秒**，之后庄家才摸入手中；投降和打牌两种情况都适用（因为亮牌发生在选主 / 投降决策之前）。
+
+### 7.2 捡分 vs 叫分：庄家的过庄 / 小光 / 大光，闲家的升级（常规算子）
+
+#### 7.2.0 判定方法（对任意叫分档位通用）
+
+**大光的判定条件是固定的、不随叫分或算子模式变化**：闲家捡分 `grade == 0`（一分未捡到）就是大光，常规算子和爬坡完全一样。会随叫分变化的，是**小光 / 过庄**之间的分界线——常规算子下这条分界线**固定为 40 分**，不随叫分变化（这是与爬坡最核心的区别，爬坡的分界线 `Q` 会随叫分变化，见 7.3.2）。设叫分为 `call`，闲家捡分为 `grade`，按以下顺序依次判断（**必须先判断第 1 步，即是否达标，再判断大光 / 小光 / 过庄**，顺序不能颠倒）：
+
+1. **先判断是否达标**：若 `grade ≥ call`，闲家赢，判为**升级**——先升 1 级，此后每再多捡 40 分再升 1 级；子数倍率就是当前的级数本身：升 1 级 ×1、升 2 级 ×2、升 3 级 ×3……逐级 **+1**，不是逐级翻倍。
+2. **未达标（`grade < call`）时，再看捡分具体落在哪个区间**：
+   - `grade == 0`（一分未捡到）→ **庄家：大光**，子数倍率 ×3。
+   - `0 < grade < 40`（捡了一点，但没满 40 分）→ **庄家：小光**，子数倍率 ×2。
+   - `40 ≤ grade < call`（捡满 40 分，但仍没达标）→ **庄家：过庄**，子数倍率 ×1（即基础子数，不翻倍）。
+
+之所以要先判断"是否达标"：当叫分本身 ≤ 40 时（比如叫 35 分坐庄），闲家只要捡到 35 分就已经达标升级了，根本不可能出现"捡到 40 分却还没达标"这种情况——"过庄"这一档这时候是空的，直接从"小光"跳到"升级"（完整例子见 7.2.1"40 分及以下坐庄"）。
+
+**大光 / 小光只描述庄家（闲家没达标时，庄家赢得有多彻底）；升级只描述闲家（闲家达标之后，赢得有多彻底），两套命名不通用、不能互换。**
+
+#### 7.2.1 常规算子完整判定表
+
+按上面的方法，叫分 > 40 分的档位（65 / 60 / 55 / 50 / 45）"过庄"区间是存在的；叫分 ≤ 40 分的档位（40 / 35 / 30 / 25 / 20 / 15 / 10 / 5）"过庄"区间不存在，闲家捡分只要达到叫分就直接升级。
+
+**65 分坐庄（基础 2 个子）**
+
+| 闲家捡分 | 判定 | 倍率 | 最终子数 |
+| --- | --- | --- | --- |
+| 0 分 | 庄家：大光 | ×3 | 6 个子 |
+| 1 ~ 39 分 | 庄家：小光 | ×2 | 4 个子 |
+| 40 ~ 64 分 | 庄家：过庄 | ×1 | 2 个子 |
+| 65 ~ 104 分 | 闲家：升 1 级 | ×1 | 2 个子 |
+| 105 ~ 144 分 | 闲家：升 2 级 | ×2 | 4 个子 |
+| 145 分起，每再多 40 分 | 闲家：再升 1 级 | 再 +1 | 逐级 +2 个子 |
+
+**60 分坐庄（基础 3 个子）**
+
+| 闲家捡分 | 判定 | 倍率 | 最终子数 |
+| --- | --- | --- | --- |
+| 0 分 | 庄家：大光 | ×3 | 9 个子 |
+| 1 ~ 39 分 | 庄家：小光 | ×2 | 6 个子 |
+| 40 ~ 59 分 | 庄家：过庄 | ×1 | 3 个子 |
+| 60 ~ 99 分 | 闲家：升 1 级 | ×1 | 3 个子 |
+| 100 ~ 139 分 | 闲家：升 2 级 | ×2 | 6 个子 |
+| 140 分起，每再多 40 分 | 闲家：再升 1 级 | 再 +1 | 逐级 +3 个子 |
+
+**55 分坐庄（基础 4 个子）**
+
+| 闲家捡分 | 判定 | 倍率 | 最终子数 |
+| --- | --- | --- | --- |
+| 0 分 | 庄家：大光 | ×3 | 12 个子 |
+| 1 ~ 39 分 | 庄家：小光 | ×2 | 8 个子 |
+| 40 ~ 54 分 | 庄家：过庄 | ×1 | 4 个子 |
+| 55 ~ 94 分 | 闲家：升 1 级 | ×1 | 4 个子 |
+| 95 ~ 134 分 | 闲家：升 2 级 | ×2 | 8 个子 |
+| 135 分起，每再多 40 分 | 闲家：再升 1 级 | 再 +1 | 逐级 +4 个子 |
+
+**50 分坐庄（基础 6 个子）**
+
+| 闲家捡分 | 判定 | 倍率 | 最终子数 |
+| --- | --- | --- | --- |
+| 0 分 | 庄家：大光 | ×3 | 18 个子 |
+| 1 ~ 39 分 | 庄家：小光 | ×2 | 12 个子 |
+| 40 ~ 49 分 | 庄家：过庄 | ×1 | 6 个子 |
+| 50 ~ 89 分 | 闲家：升 1 级 | ×1 | 6 个子 |
+| 90 ~ 129 分 | 闲家：升 2 级 | ×2 | 12 个子 |
+| 130 分起，每再多 40 分 | 闲家：再升 1 级 | 再 +1 | 逐级 +6 个子 |
+
+**45 分坐庄（基础 6 个子——从这一档开始进入"50 分及以下统一 6 个子"的范围）**
+
+| 闲家捡分 | 判定 | 倍率 | 最终子数 |
+| --- | --- | --- | --- |
+| 0 分 | 庄家：大光 | ×3 | 18 个子 |
+| 1 ~ 39 分 | 庄家：小光 | ×2 | 12 个子 |
+| 40 ~ 44 分 | 庄家：过庄 | ×1 | 6 个子 |
+| 45 ~ 84 分 | 闲家：升 1 级 | ×1 | 6 个子 |
+| 85 ~ 124 分 | 闲家：升 2 级 | ×2 | 12 个子 |
+| 125 分起，每再多 40 分 | 闲家：再升 1 级 | 再 +1 | 逐级 +6 个子 |
+
+**40 分及以下坐庄（40 / 35 / 30 / 25 / 20 / 15 / 10 / 5，基础都是 6 个子；此时 `call ≤ 40`，没有"过庄"这一档）**
+
+| 闲家捡分 | 判定 | 倍率 | 最终子数 |
+| --- | --- | --- | --- |
+| 0 分 | 庄家：大光 | ×3 | 18 个子 |
+| 1 分 ~（叫分 − 1）分 | 庄家：小光 | ×2 | 12 个子 |
+| 达到叫分 | 闲家：升 1 级 | ×1 | 6 个子 |
+| 达到叫分 + 40 分 | 闲家：升 2 级 | ×2 | 12 个子 |
+| 此后每再多 40 分 | 闲家：再升 1 级 | 再 +1 | 逐级 +6 个子 |
+
+例如叫 10 分坐庄（基础 6 个子）：0 分为大光（18 子）；1 ~ 9 分为小光（12 子）；捡到 10 分起升 1 级（6 子）；捡到 50 分起升 2 级（12 子）；之后每再多 40 分再升 1 级（每级再 +6 子）。
+
+> **5 分坐庄没有"小光"**：分牌只有 5 分、10 分两种面值（见 6.1 节），闲家捡分永远是 5 的倍数。上面"1 分 ~（叫分 − 1）分为小光"这一行，在叫分为 5 分时对应区间是 `1 ~ 4 分`，里面不存在任何 5 的倍数，是空区间。所以叫 5 分坐庄时，闲家捡分只有 0（大光）和达到 5 分及以上（直接升 1 级，之后每再多 40 分再升 1 级）两种结果，没有小光这一档；这是"叫分 ≤ 40 分"这组档位里唯一的特例，其余档位（40/35/30/25/20/15/10）小光区间都至少包含一个 5 的倍数，正常存在。
+
+**70 分坐庄**
+
+- **投降**：基础子数按 1 个算，庄家直接输 1 个子，不经过大光 / 小光 / 过庄 / 升级判定（还没出牌捡分，直接放弃）。
+- **打牌**：基础子数按 2 个算，之后按 7.2.0 的方法正常判定，`Q` 同样固定为 40 分——判定表和 65 分坐庄完全一致，只是把"基础 2 个子"原样代入（数值恰好和 65 分相同）：
+
+| 闲家捡分 | 判定 | 倍率 | 最终子数 |
+| --- | --- | --- | --- |
+| 0 分 | 庄家：大光 | ×3 | 6 个子 |
+| 1 ~ 39 分 | 庄家：小光 | ×2 | 4 个子 |
+| 40 ~ 69 分 | 庄家：过庄 | ×1 | 2 个子 |
+| 70 ~ 109 分 | 闲家：升 1 级 | ×1 | 2 个子 |
+| 110 ~ 149 分 | 闲家：升 2 级 | ×2 | 4 个子 |
+| 150 分起，每再多 40 分 | 闲家：再升 1 级 | 再 +1 | 逐级 +2 个子 |
+
+### 7.3 爬坡：叫分 → 基础子数与保小光分段（可选规则，开房时勾选"爬坡"生效）
+
+#### 7.3.1 基础子数：叫分 → 子数的完整对照
+
+叫分从 65 分（2 个子）开始，每叫低 5 分加 1 个子，直到 50 分（6 个子）——这一段与常规算子的四档数值完全相同；50 分以下，继续按每叫低 5 分加 1 个子延伸，一直到叫分范围的下限 5 分：
+
+| 叫分 | 65 | 60 | 55 | 50 | 45 | 40 | 35 | 30 | 25 | 20 | 15 | 10 | 5 |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| 基础子数 | 2 | 3 | 4 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 |
+
+#### 7.3.2 保小光分段：叫分 → 小光 / 过庄分界线（Q 值）
+
+判定方法与 7.2.0 完全相同，只是把固定的 `Q = 40` 换成按叫分区间取值的 `Q`；**大光的判定条件不受 `Q` 影响，永远是 `grade == 0`**，常规算子和爬坡完全一样——`Q` 只决定"小光"和"过庄"之间的分界线：
+
+| 叫分区间 | 小光 / 过庄的分界线（Q） |
+| --- | --- |
+| ≥ 45 分（含 65 / 60 / 55 / 50 / 45） | 40 分 |
+| 40 / 35 分 | 20 分 |
+| 30 / 25 分 | 15 分 |
+| 20 / 15 分 | 10 分 |
+| 10 分 | 5 分 |
+| 5 分 | 5 分（升级级距仍是 5，只是"小光"这一档因为区间为空而不存在，见下方说明） |
+
+`≥ 45 分`这一档的 `Q = 40`，与 7.2 节常规算子沿用的分界线数值相同，只是子数改按 7.3.1 的公式取值（65/60/55/50 与常规算子数值一致，45 分是爬坡独有的新增档位）。
+
+**5 分档没有"小光"**：分牌只有牌面 5（5 分）和牌面 10 / K（10 分）两种面值（见 6.1 节），闲家的捡分总数（`grade`）因此永远是 5 的倍数（0、5、10、15…），不可能出现 1 ~ 4 这样的中间值。当叫分是 5 分时，"小光"原本对应的区间是 `0 < grade < 5`，这个开区间里不存在任何 5 的倍数，也就是说这个区间**必然是空的**——闲家捡分要么是 0（大光），要么一旦捡到任何分牌（最少 5 分）就已经达到叫分、直接升级，中间不存在"捡到了一点、但没达标"的"小光"状态。所以 5 分档只有**大光**和**升级**两种结果，没有"小光"这一档；但 `Q` 值本身仍然是 5（与 10 分档一样），只是在"小光 / 过庄分界线"这个用途上区间恰好收窄为空，`Q = 5` 仍然继续作为"升级级距"生效（见 7.3.3 的 5 分坐庄判定表）。
+
+**升级级距的通用规则**：不管哪个叫分档位，闲家赢了之后，"超过叫分多少分算升一级"，用的分数差**就是该档位的 `Q` 值**——即上表里每一档的 `Q` 值，既是"小光 / 过庄"的分界线，也是"升级"的级距单位，两者共用同一个数字。例如叫分 40 分时 `Q = 20`：闲家捡分达到 40 分先升 1 级，之后每再多捡 20 分（60、80、100…）就再升一级。
+
+#### 7.3.3 各分段的完整判定表（按 7.2.0 的方法代入对应 `call`、`Q`、基础子数）
+
+**40 分坐庄（基础 8 个子，Q = 20）**
+
+| 闲家捡分 | 判定 | 倍率 | 最终子数 |
+| --- | --- | --- | --- |
+| 0 分 | 庄家：大光 | ×3 | 24 个子 |
+| 1 ~ 19 分 | 庄家：小光 | ×2 | 16 个子 |
+| 20 ~ 39 分 | 庄家：过庄 | ×1 | 8 个子 |
+| 40 ~ 59 分 | 闲家：升 1 级 | ×1 | 8 个子 |
+| 60 ~ 79 分 | 闲家：升 2 级 | ×2 | 16 个子 |
+| 80 分起，每再多 20 分 | 闲家：再升 1 级 | 再 +1 | 逐级 +8 个子 |
+
+**35 分坐庄（基础 9 个子，Q = 20）**
+
+| 闲家捡分 | 判定 | 倍率 | 最终子数 |
+| --- | --- | --- | --- |
+| 0 分 | 庄家：大光 | ×3 | 27 个子 |
+| 1 ~ 19 分 | 庄家：小光 | ×2 | 18 个子 |
+| 20 ~ 34 分 | 庄家：过庄 | ×1 | 9 个子 |
+| 35 ~ 54 分 | 闲家：升 1 级 | ×1 | 9 个子 |
+| 55 ~ 74 分 | 闲家：升 2 级 | ×2 | 18 个子 |
+| 75 分起，每再多 20 分 | 闲家：再升 1 级 | 再 +1 | 逐级 +9 个子 |
+
+**30 分坐庄（基础 10 个子，Q = 15）**
+
+| 闲家捡分 | 判定 | 倍率 | 最终子数 |
+| --- | --- | --- | --- |
+| 0 分 | 庄家：大光 | ×3 | 30 个子 |
+| 1 ~ 14 分 | 庄家：小光 | ×2 | 20 个子 |
+| 15 ~ 29 分 | 庄家：过庄 | ×1 | 10 个子 |
+| 30 ~ 44 分 | 闲家：升 1 级 | ×1 | 10 个子 |
+| 45 ~ 59 分 | 闲家：升 2 级 | ×2 | 20 个子 |
+| 60 分起，每再多 15 分 | 闲家：再升 1 级 | 再 +1 | 逐级 +10 个子 |
+
+**25 分坐庄（基础 11 个子，Q = 15）**
+
+| 闲家捡分 | 判定 | 倍率 | 最终子数 |
+| --- | --- | --- | --- |
+| 0 分 | 庄家：大光 | ×3 | 33 个子 |
+| 1 ~ 14 分 | 庄家：小光 | ×2 | 22 个子 |
+| 15 ~ 24 分 | 庄家：过庄 | ×1 | 11 个子 |
+| 25 ~ 39 分 | 闲家：升 1 级 | ×1 | 11 个子 |
+| 40 ~ 54 分 | 闲家：升 2 级 | ×2 | 22 个子 |
+| 55 分起，每再多 15 分 | 闲家：再升 1 级 | 再 +1 | 逐级 +11 个子 |
+
+**20 分坐庄（基础 12 个子，Q = 10）**
+
+| 闲家捡分 | 判定 | 倍率 | 最终子数 |
+| --- | --- | --- | --- |
+| 0 分 | 庄家：大光 | ×3 | 36 个子 |
+| 1 ~ 9 分 | 庄家：小光 | ×2 | 24 个子 |
+| 10 ~ 19 分 | 庄家：过庄 | ×1 | 12 个子 |
+| 20 ~ 29 分 | 闲家：升 1 级 | ×1 | 12 个子 |
+| 30 ~ 39 分 | 闲家：升 2 级 | ×2 | 24 个子 |
+| 40 分起，每再多 10 分 | 闲家：再升 1 级 | 再 +1 | 逐级 +12 个子 |
+
+**15 分坐庄（基础 13 个子，Q = 10）**
+
+| 闲家捡分 | 判定 | 倍率 | 最终子数 |
+| --- | --- | --- | --- |
+| 0 分 | 庄家：大光 | ×3 | 39 个子 |
+| 1 ~ 9 分 | 庄家：小光 | ×2 | 26 个子 |
+| 10 ~ 14 分 | 庄家：过庄 | ×1 | 13 个子 |
+| 15 ~ 24 分 | 闲家：升 1 级 | ×1 | 13 个子 |
+| 25 ~ 34 分 | 闲家：升 2 级 | ×2 | 26 个子 |
+| 35 分起，每再多 10 分 | 闲家：再升 1 级 | 再 +1 | 逐级 +13 个子 |
+
+**10 分坐庄（基础 14 个子，Q = 5——这一档同样没有"小光"）**
+
+分牌只有 5 分、10 分两种面值，捡分永远是 5 的倍数。`Q = 5` 时，"小光"对应的区间 `0 < grade < 5` 里不存在任何 5 的倍数，同样是空区间：闲家捡分不可能停在 1 ~ 4 分，只要捡到分就已经是 5 分（直接落入"过庄"区间）。
+
+| 闲家捡分 | 判定 | 倍率 | 最终子数 |
+| --- | --- | --- | --- |
+| 0 分 | 庄家：大光 | ×3 | 42 个子 |
+| 5 ~ 9 分 | 庄家：过庄（没有小光这一档） | ×1 | 14 个子 |
+| 10 ~ 14 分 | 闲家：升 1 级 | ×1 | 14 个子 |
+| 15 ~ 19 分 | 闲家：升 2 级 | ×2 | 28 个子 |
+| 20 分起，每再多 5 分 | 闲家：再升 1 级 | 再 +1 | 逐级 +14 个子 |
+
+**5 分坐庄（基础 15 个子，没有"小光"，见 7.3.2 的说明）**
+
+5 分是叫分范围的下限，捡分只能是 5 的倍数：一旦捡到任何分牌就已经是 5 分，等于直接达标（`grade ≥ call = 5`）。所以"小光"和"过庄"这两个区间都不存在，闲家捡分只有 0（大光）和达到 5 分及以上（直接升 1 级）两种结果。
+
+| 闲家捡分 | 判定 | 倍率 | 最终子数 |
+| --- | --- | --- | --- |
+| 0 分 | 庄家：大光 | ×3 | 45 个子 |
+| 5 ~ 9 分 | 闲家：升 1 级（没有小光、过庄这两档） | ×1 | 15 个子 |
+| 10 ~ 14 分 | 闲家：升 2 级 | ×2 | 30 个子 |
+| 15 分起，每再多 5 分 | 闲家：再升 1 级 | 再 +1 | 逐级 +15 个子 |
+
+`≥ 45` 分档（65 / 60 / 55 / 50 / 45）判定逻辑与 7.2.1 完全相同（Q = 40），只是 45 分档基础子数按 7.3.1 取 7 个子，其余数值套用 7.2.1 对应叫分的表即可，此处不重复列出。
+
+70 分叫庄时与常规算子规则一致（见 7.2.1 末尾"70 分坐庄"：投降固定基础子数 1 个，打牌基础子数 2 个并正常套用大光 / 小光 / 过庄 / 升级判定），不适用本节的保小光分段。
+
+---
+
+## 8. 算奖规则
+
+算奖在**每个小局结算时**计算（与第 7 节的子数结算属于同一次小局结算，不是等大局所有局数打完才统一算，也不是在出牌过程中途算）。8.1 冲关只计入庄家；8.3 傍王是额外叠加的独立奖励，庄家、闲家都要算——两者的计入范围不同，注意区分。
+
+**8.1 冲关只认庄家的身份，不看闲家的手牌是否达标**：即使某位闲家的手牌结构凑巧也满足 8.1 表里的条件（比如手里也有 3 张王），这份冲关也**不会**计入这位闲家——冲关从规则上就只针对庄家一人。闲家想要获得算奖，只能靠 8.3 傍王（且必须房间勾选了这条可选规则）。
+
+**算奖依据的手牌快照时间点**：不管是 8.1（只看庄家）还是 8.3 傍王（庄闲都算），都按**静态初始手牌**计算——庄家是埋牌完成后的那一刻手牌（28 张），闲家是发牌完成后的那 28 张手牌；这个快照全程固定，不随之后的出牌、被吃、被打出而改变。**例外**：70 分投降局庄家未选主也未埋牌，其快照为"发牌 + 底牌"共 36 张（无主牌花色），见 8.4 节。
+
+**算奖（8.1 / 8.3）与亮牌（8.2）是两个互不干涉的独立概念**：算奖是结算阶段"该给多少额外结算分"的规则；亮牌只是出牌开始前"要不要向对手公开一部分手牌"的展示规则。两者各自有自己的触发条件，只是恰好都以庄家埋牌后的手牌结构为依据，因此部分门槛数值相同——但达成亮牌的条件不代表一定触发算奖，反之亦然，具体对照见 8.2 末尾的说明。
+
+### 8.1 冲关
+
+> **旧称「常规算奖」**，现统一叫**冲关**（与服务端字段 `chongguan`、界面「冲关分」「冲关牌型」同口径）。
+> 它只是「算奖」的**其中一个分量**——另一个是 8.3 傍王；两者求和才是某玩家的总奖数 `N`（见 8.4）。
+
+
+| 组合 | 奖数 |
+| --- | --- |
+| 三个王 | 1 奖 |
+| 四个王 | 3 奖 |
+| 六个 7 | 1 奖 |
+| 七个 7 | 2 奖 |
+| 八个 7 | 3 奖 |
+| 六个 2 | 1 奖 |
+| 七个 2 | 2 奖 |
+| 八个 2 | 3 奖 |
+
+三王 / 四王在拥有"正 7"及以后连续对子的情况下，每多一对连续对子再加 1 奖，连续顺序为：
+
+```
+正7 - 副7 - 正2 - 副2 - A - K - Q - J - 10 - 9 - 8 - 6 - 5
+```
+
+其中从 A 到 5（即 A、K、Q、J、10、9、8、6、5 这一段普通点数）都必须是选定花色的主牌，才能计入连续对子——非主花色的普通对子不算数，链条到这里就断了。
+
+### 8.2 亮牌规则
+
+**亮牌与算奖（8.1 / 8.3）是两个独立概念，互不干涉**：亮牌只是"要不要向对手公开一部分手牌"的展示规则，本身不产生任何奖数、不影响结算；算奖该怎么算、算多少，完全按 8.1 / 8.3 的规则来，不因为触发了亮牌而增加或减少。
+
+**亮牌要求**（仅针对庄家）：庄家**埋牌后**、**出牌开始前**，若手中剩余的**固定主牌**满足下表任一条件，就要向两个闲家**亮出自己全部固定主牌的具体牌面**。
+
+| 触发条件（任一满足即亮牌） |
+| --- |
+| 固定主牌（双王 + 全部 2 + 全部 7）总数 ≥ 10 张 |
+| 王 ≥ 3 张 |
+| 7 ≥ 6 张 |
+| 2 ≥ 6 张 |
+
+**亮出的内容是固定的一份**——**庄家手中全部固定主牌的具体牌面**（双王 + 全部 2 + 全部 7；**不含**主花色的普通牌 A/K/Q/J/10/9/8/6/5）。不论是被上表哪一条触发、还是同时满足多条，亮出的都是这同一份牌，不因触发条件不同而增减。
+
+- **不限叫分**：任何叫分档位都适用，不是 70 分坐庄专有。
+- **仅可查牌模式**：房间勾选了"不查牌"时，闲家看不到亮牌（见第 9 节）。
+- **只亮庄家的**：闲家不亮牌。
+- 亮牌依据的是**埋牌后**的手牌，与 8.1 冲关用的是同一份静态快照（见第 8 节开头），全局固定、不随之后出牌缩水。
+
+> **亮牌给的是牌面，不是统计**。这一点与「余主公示」（只给剩余主牌数与对子数，见第 9 节）不同；与「明牌」（查看**他家**全部未出主牌的牌面，见第 9 节）也不同——亮牌是**庄家主动公开自己的**，明牌是**闲家去看别人的**。
+
+**亮牌门槛与 8.1 冲关起点的数值巧合，不代表两者是同一条规则**：王 ≥ 3 张 / 7 ≥ 6 张 / 2 ≥ 6 张这三个门槛，数值上恰好分别与 8.1 表里"三个王""六个 7""六个 2"的冲关起点相同，达到时会同时触发"亮牌"和"冲关"这两件独立的事——但它们是各自独立判定后凑巧同时发生，不是"亮牌导致冲关"或者"冲关导致亮牌"。这一点在"固定主牌 ≥ 10 张"这一档表现得最清楚：它只在亮牌这条规则里有定义、会触发亮牌，但 8.1 的冲关表里根本没有为这一档定义奖数，所以**不产生任何冲关奖**——如果亮牌和冲关是同一回事，这里就该矛盾；现在不矛盾，正说明两者互不干涉。
+
+### 8.3 傍王（可选规则）
+
+开房时勾选"傍王"后，每张王额外算一奖：这个奖是**庄家、闲家都要各自计算**（每个人按自己手里的王算，不限庄家）。
+
+**傍王奖是在 8.1 冲关之外额外叠加的一份奖励，与冲关互不冲突、不互相替代**：庄家照常按 8.1 的规则算冲关（只计庄家），同时如果勾选了傍王，庄家、闲家还要**各自另外**再按自己手里的王数算一份傍王奖；两份奖励分开计算，最后相加。
+
+### 8.4 算奖如何影响最终结算
+
+**算奖是"持有奖数的那个人"从其余两名玩家那里各自多收一笔钱的独立结算线，不是把第 7 节算出的输赢结果整体重新乘一遍**：设第 7 节前三层算出的结算子数为 `X`（庄家与每个闲家之间"一对一"结算的基础金额，见 7.0 第 3 层），玩家 P 这一局总共积累了 `N_P` 奖（8.1 冲关 + 8.3 傍王，各自求和后相加；只有庄家可能有 8.1 的分量，8.3 傍王则庄闲都可能有）：
+
+- 若 `N_P > 0`，**另外两名玩家（不分是庄家还是闲家）都要各自额外付给 P：`X × N_P` 子**；
+- 若 `N_P = 0`，P 没有额外收入。
+
+三名玩家可能同时都持有各自的奖数，这时会产生最多 3 条互相独立、方向不同的额外支付线，互不冲突、按各自的 `N` 值同时生效，最后与第 1~3 层的基础输赢结算加总，才是每个人这一局的最终盈亏。
+
+**举例**（`X = 6` 个子，庄家为 A，闲家为 B、C）：
+
+- 若庄家 A 本局有 1 奖（`N_A = 1`）：B、C 各自额外付给 A `6 × 1 = 6` 子。
+- 若闲家 B 同时勾选了"傍王"、本局有 2 奖（`N_B = 2`）：A、C 各自额外付给 B `6 × 2 = 12` 子。
+- 这两条支付线同时成立、互不影响：A 从 B、C 各多收 6 子，B 从 A、C 各多收 12 子——包括"闲家 C 要付给闲家 B"这样的支付，即使 B、C 之间在第 1~3 层的基础输赢结算里并不直接结算（基础结算只发生在"庄家 vs 单个闲家"之间），算奖这一层是单独叠加在所有玩家两两之间的。
+
+以下三点已确认：
+
+- **庄家倒庄（闲家达标升级）时，8.1 冲关仍然生效**：冲关只看庄家埋牌后的手牌结构，与本局谁输谁赢无关。
+- **70 分投降时，仍叠加算奖倍率**：投降只是跳过了第 1~3 层的叫分 / 捡分判定（此时 `X = 1`）。投降是选主阶段的选择，庄家**未选主、未埋牌**，故算奖按庄家"发牌 + 底牌"共 36 张手牌计算——因没有选定主牌花色，**没有连对链**，只有三 / 四王、六~八个 7、六~八个 2 这些组合，以及（勾选傍王时）按王数的傍王奖计入；8.1（及勾选傍王时的 8.3）照常计算并叠加。
+- **算奖对象的身份限制会带进 `N` 的计算**：8.1 只算庄家、8.3 傍王勾选后才不分庄闲（见第 8 节开头说明），把这名玩家实际适用的分量求和，才是他自己的 `N`；"其余两人向他支付 `X × N`"这条支付规则本身不因身份而改变，但闲家的 `N` 从一开始就不可能包含 8.1 的分量。
+
+---
+
+## 9. 牌局查看模式
+
+"查牌"指的是**回看那些不该随时可见的信息**：已经打过去的牌、他家手里还剩多少主牌、他家主牌的具体牌面。房间的"查牌模式"开关决定下列四项功能**整体**是否提供。
+
+- **可查牌模式**（四项功能全部提供）：
+  1. **出牌历史**：当前牌局中，所有玩家已经打出的牌（含之前每一轮打出、已被收走的牌），任何时候都可以回看。
+  2. **余主公示**：一旦有玩家的主牌全部打空（即 5.4.2 节所说的"报无主"状态；"主牌"指大王、小王、所有花色的 2、所有花色的 7，以及主花色的其余普通牌，见第 3 节），系统就为**全体三人**（含刚刚报无主的这位玩家自己）显示另外两家各自的主牌数量、以及这些主牌里有多少对子。**只给数量、不给具体牌面**——要看具体牌面是下一条的"明牌"。
+  3. **明牌**：同时**为这三个人都**出现一个"明牌"按钮——判定依据是「**场上有人**报无主」，不是「**自己**报无主」，所以报无主的那位和另外两位一样都能点。点击后可以查看另外两家手中全部主牌的**具体牌面**（不只是数量 / 对子结构），再点一次取消查看、恢复隐藏；**不限次数，整个出牌阶段随时可查**。
+  4. 庄家若触发了 8.2 节的"亮牌要求"，两个闲家可以看到**庄家全部固定主牌的具体牌面**（见 8.2 节）。
+
+- **不可查牌模式**：以上四项**一项都不提供**——
+  - **不提供出牌历史**：之前各轮打出过什么牌一律不能回看，只能靠玩家自己记牌；
+  - **不提供余主公示**：即使有玩家报无主，也不会显示任何人的主牌数量、对子结构，也没有"明牌"按钮；
+  - 庄家即使触发了 8.2 节的亮牌条件，闲家也看不到那些牌（见 8.2 节）。
+
+> **"查牌"与"当前这一轮桌面上的牌"是两回事**：本轮已经出过牌的玩家、打在桌面上的这几张牌，**两种模式下都必须对全体可见**——否则后出的人无从跟牌、也无从判断本轮谁最大。查牌模式管的是**已经收走的往轮牌**与**他家手牌信息**能不能回看，不影响当前这一轮的正常出牌展示（断线重连回到牌桌时同理：当前轮桌面上的牌照常恢复，往轮历史则按本节的模式开关决定给不给）。
+
+---
+
+## 10. 房间设置选项
+
+创建页依次提供：**局数、扣卡方式、查牌模式、傍王、爬坡**。前三项各自为独立的单选必选组，每组必须且只能选一项；傍王与爬坡为两个独立可选开关，可以都不选、只选一个或同时勾选。
+
+### 10.1 局数与牌局扣卡方式
+
+局数：6 局 / 12 局，单选必选。扣卡方式：房主扣卡 / AA 制（每人扣卡），单选必选。两个选项组分别选择，费用按下表联动展示。
+
+| 扣卡方式 | 6 局 | 12 局 |
+| --- | --- | --- |
+| AA 制（每人扣卡） | 每人 1 张 | 每人 2 张 |
+| 房主扣卡 | 2 张 | 4 张 |
+
+### 10.2 查牌模式
+
+可查牌 / 不查牌，单选必选（见第 9 节）。
+
+### 10.3 附加规则
+
+傍王、爬坡：分别为可选开关，允许不勾选；两者可以同时勾选（互不冲突），不属于互斥单选组。未勾选傍王时不计算傍王奖励；未勾选爬坡时使用常规算子。
+
+### 10.4 创建参数与默认选择
+
+默认选择为：6 局、房主扣卡、可查牌；傍王和爬坡均不勾选。单选必选表示始终保留一个有效选项，不要求用户额外点击已默认选中的选项。
+
+`roomtype` 为 **11 位字符串**，前 5 位依次表示局数、扣卡方式、查牌模式、傍王、爬坡；后 6 位为预留，不显示为创建选项，也不赋予玩法含义。具体编码以 [协议 §0.5](../protocol/packet_protocol.md#05-roomtype-房间选项位串) 为唯一来源。预留位的固定填充值尚待确认。
+
+---
+
+## 11. 牌局交互提示
+
+- 选主阶段：4 个花色选主按钮上各显示"该花色在庄家手中的对子数"（供庄家判断选哪门为主）；70 分坐庄时并列再显示一个投降按钮——选主与投降是同一决策点的互斥选择（见第 4 节）。
+- 首家出主牌时可以甩牌，甩牌的生效条件、跟牌规则、甩错惩罚详见 5.4 节。
+- 牌局结束需要亮出埋牌底牌。
+- 闲家在出牌时需要有 3 个提示选项：
+  1. **踩**：提示对家"我能大过庄家"。
+  2. **没分**：提示对家"我手上没分了"。
+  3. **有分**：提示对家"我手上有分"。
+- **倒计时只作展示，不触发任何自动操作**：叫分 / 选主 / 埋牌 / 出牌四个阶段都会给出一个倒计时秒数，用于界面提醒当前该谁操作。**倒计时归零后不做任何代打**——不自动叫分、不自动选主、不自动埋牌、不自动出牌，也不判负、不跳过该玩家；轮到谁而谁不操作，牌局就停在这一步一直等。
+
+> **"无超时托管"是确认过的规则，不是待实现的缺口**：本局不设服务端代打/AI 托管，也不因超时改变任何对局状态。若玩家长时间不操作导致牌局停住，由玩家走房间的**解散**流程收场，按当前累计分结算（见 12.2）。**后续核对不要把"没有超时动作"当成缺陷去补"超时托管/自动出牌"。**
+
+---
+
+## 12. 完整牌局游玩流程
+
+本节把前面各节的规则串成一局（一个"小局"）从头到尾的完整流程，供整体理解与实现参照。这里只给出**步骤与先后顺序**，每一步的具体细则以其对应章节为准（避免与细则重复而产生分歧）。
+
+### 12.1 一个小局的完整流程
+
+1. **开局准备**：房间按第 10 节的设置（局数、扣卡方式、傍王、爬坡、查牌）建好后开战。第一局的暂定庄家为 0 号座位；之后每局按 4.6 的轮庄规则确定暂定庄家。
+
+2. **发牌**（第 2 节）：92 张牌洗匀，三家各摸 28 张，剩余 8 张扣在桌面作为"底牌"。
+
+3. **叫分坐庄**（4.2）：由暂定庄家起、按逆时针依次叫分。暂定庄家必叫（5~70 分、步进 5，不能"不叫"）；其后每家只能叫比当前更低的分，或选择"不叫"；有人叫出 5 分即立即坐庄，或一家叫分后另外两家都"不叫"也即坐庄。叫分越低表示庄家对"压住闲家捡分"越有信心，对应的基础子数越高（第 7 节）。
+
+4. **摸底**：庄家坐定后把 8 张底牌摸入手牌（摸完共 36 张）。非 70 分：这 8 张仅庄家可见。**70 分坐庄先触发「开底」：庄家摸底之前，先把这 8 张向所有玩家翻开 3 秒，再摸入手牌**（4.4 / 第 4 节）。
+
+5. **选主 / 投降（同一决策点，二选一，互斥）**（第 4 节）：
+   - **选主**：庄家选定一门花色为本局主牌（大王、小王、所有花色的 2、7 恒为主牌）→ 进入下一步埋牌。前端此阶段每个花色按钮上要显示该花色在庄家手中的对子数；70 分坐庄时并列显示投降按钮。
+   - **投降**：仅 70 分坐庄才有此选项；选投降即放弃本局，**不选主、不埋牌、不出牌**，直接按 7.1"70 分 · 投降"结算（算奖仍按下方 8 计，但用庄家 36 张、无主牌花色）。选花色就等于放弃投降、正常打牌。
+   - （**开底**——70 分的 8 张底牌翻开 3 秒，发生在步骤 4"摸底之前"。）
+
+6. **埋牌**（第 4 节，仅"选主/打牌"路径）：庄家从 36 张里选 8 张重新扣下作为"埋牌底牌"（供最后"扣底"判断），保留 28 张。（**先选主、后埋牌**。）
+
+7. **出牌对局**（第 5、6 节）：
+   - 第一轮固定由庄家先出；此后每轮由上一轮牌面最大的一方先出。
+   - 首家出什么花色 / 牌型，其余两家按 5.1~5.3 跟牌（同花色不够时可用主牌"毙牌"抢权，或"垫牌"不争）。
+   - 首家出主牌时可"甩牌"（5.4）：一次性打出多组主牌组合；服务端按全场手牌判定"最大性"，甩错则按 5.4.5 收回、只强制打出最小一张。副牌一律不能甩。
+   - 每轮比大小定出胜者：闲家赢下的那一轮，牌面上的分牌（5→5 分、10→10 分、K→10 分）计入闲家捡分；庄家赢的轮分牌作废（6.1~6.2）。
+   - 过程中：有玩家主牌出空需"报无主"，可查牌模式下触发**余主公示**（为全体展示他家主牌数量 / 对子结构，第 9 节）；庄家手牌达到 8.2 的门槛时触发**亮牌**。
+
+8. **末轮扣底**（6.3）：所有手牌出完后，若最后一轮由闲家**用主牌**赢下，则庄家埋的 8 张埋牌底牌翻开，其中的分按闲家赢牌的牌型翻倍（单张 ×1、主对 ×2、N 连对 ×2N）后计入闲家捡分。
+
+9. **小局结算**（第 7、8 节，两部分同时结算）：
+    - **算子**：闲家总捡分（含扣底）与庄家叫分比较 → 判定庄家的**过庄 / 小光 / 大光**，或闲家的**升级第几级** → 结合叫分档的基础子数，得到庄家与每个闲家"一对一"的结算子数 `X`（勾选爬坡则改用 7.3 的梯度与分段）。
+    - **算奖**：以静态初始手牌（正常局：庄家埋牌后 28 张、闲家发牌后 28 张；**70 分投降局**：庄家用发牌+底牌共 36 张、无主牌花色）计算奖数 `N` —— 冲关（8.1）**只计庄家**；勾选傍王（8.3）则庄闲每张王各算一奖。持有 `N` 奖的玩家从另外两人各多收 `X × N`（8.4）。
+    - 以上两部分加总即各家本局盈亏；牌局结束需亮出埋牌底牌（第 11 节）。
+
+10. **进入下一局**（4.6）：庄家本局赢则连庄（暂定庄家仍是他）；庄家输（闲家捡分达标 / 庄家投降）则暂定庄家顺延到其下家。回到第 2 步开新的一小局。
+
+### 12.2 大局与结束
+
+按房间设定的局数（6 局或 12 局，见第 10 节）打满全部小局后，进行大局结算（累计各家总分并记录战绩）；若中途解散，则按当前累计分结算。
+
+### 12.3 阶段速览
+
+```
+建房(§10) → 发牌(§2) → 叫分坐庄(§4.2) → 摸底[70分先开底] → 选主(§3) → 埋牌(§4)
+      → [70分:投降/打牌决策(§4.4)] → 出牌对局(§5,§6.1-6.2) → 末轮扣底(§6.3)
+      → 小局结算=算子(§7)+算奖(§8) → 轮庄(§4.6) → 下一局 …… 打满局数 → 大局结算
+```
+

cocoscreator_projects/games/erqiwang/docs/protocol/packet_protocol.md

@@ -0,0 +1,717 @@
+# 二七王协议包列表
+
+说明：`data` 均为发送方与接收方之间约定的 JSON 内容；成败判定只看推送包里的 `data.success`。
+
+---
+
+## 0. 通用约定（所有包适用，下文各表不再逐一重复）
+
+### 0.0 术语：底牌 vs 埋牌底牌（先读这一条）
+
+本项目于 2026-08-25 修订了这两个术语（`design.md` §1 已同步，本文亦已改用新称）：
+
+| 术语 | 指哪 8 张 | 旧称 |
+| --- | --- | --- |
+| **底牌** | 发牌时**没有发给玩家**、扣在桌面的 8 张 | ~~暗牌~~ |
+| **埋牌底牌** | 庄家**埋牌**时从手里扣下的 8 张 | ~~底牌~~ |
+
+**两批牌的字段名已拆分**（2026-08-25，原先共用 `bottomcards`）：
+
+| 字段名 | 含义 | 出现在 |
+| --- | --- | --- |
+| **`bottomcards`** | **底牌** | `shangzhuang`、`deskinfo.ChooseMain`、`deskinfo.BuryCards` |
+| **`burycards`** | **埋牌底牌** | `maipai`、`deskinfo.PushCards` |
+| `bottom.cards` | **埋牌底牌** | 结算包的 `bottom` 分组（分组名已表明是抠底相关，字段未改名） |
+
+同一个包里不会同时出现这两个字段。**下发面**：`burycards` 与 `bottomcards`（非 70 分时）都**只发给庄家**，闲家两者皆无——已由 `test/test_leak.js` 的泄露审计覆盖。
+
+### 0.0b 四类「公开信息」术语（都带亮/明字，别读混）
+
+| 术语 | 谁公开给谁 | 给的是什么 | 触发 | 本文相关字段 |
+| --- | --- | --- | --- | --- |
+| **亮牌** | 庄家 → 两个闲家 | **具体牌面**（庄家全部固定主牌） | 庄家埋牌后固定主牌达门槛（design §8.2） | `liangpai.cards` |
+| **余主公示** | 全体 → 全体 | **只有数量**（剩余主牌数、主对数） | 任一玩家报无主（design §9） | `seatlist[seat][4]`、`baozhu` |
+| **明牌** | 他家 → 请求者 | **具体牌面**（他家全部未出主牌） | 可查牌 + **任一**玩家报无主 → **三家均可点、随时可查**（design §9） | `mingpai.others[].zhucards` |
+| **开底** | 桌面 → 所有玩家 | **具体牌面**（8 张底牌） | 70 分坐庄，**摸底之前** 3 秒（design §4） | `ancard3s` + `bottomcards` |
+
+一句话记：**只有「余主公示」是统计类（给数字），「亮牌」「明牌」「开底」都给具体牌面**——区别在给谁的牌：亮牌给庄家自己的、明牌给他家的、开底给桌上那 8 张。
+
+另有一组「底」字族专管发牌留桌的那 8 张：**摸底**（庄家摸起看，仅庄家）、**开底**（70 分时全场看 3 秒）、**查底牌**（对局中随时回看）、**扣底**（末轮翻开埋牌底牌计分）。
+（「亮主」不是术语，是前端选主界面的标题文案，与上表无关。）
+
+
+### 0.0c 算奖 = 冲关 + 傍王
+
+| 术语 | 范围 | 相关字段 |
+| --- | --- | --- |
+| **冲关** | design §8.1，**只计庄家**。旧称"常规算奖"，现统一叫冲关 | `chongguan`（奖数）、`cards`（冲关牌型） |
+| **傍王** | design §8.3，可选规则，勾选后**庄闲都算**，每张王 1 奖 | `wang`（王数）、`bangwang`（开关） |
+| **算奖** | **上位概念** = 冲关 ＋ 傍王 | `naward`（总奖数 N）、`grade_aw`（算奖得分） |
+
+说「**冲关**」指庄家那一份，说「**算奖**」指两者合计。界面上小局结算显示「冲关分」、按钮叫「冲关牌型」。
+
+> ⚠️ `grade_aw` 是按合计后的 `N` 算出来的，**冲关与傍王的贡献事后无法拆分**。大局结算若要分别显示「冲关分」「傍王分」，须服务端在算钱时就分开代入公式——见前端清单 §7.5 **S-6**。
+
+### 0.1 成败标志 `data.success`
+
+**每一个「服务器 → 客户端」的包，`data` 都必带 `success`**（布尔）：
+
+- `success: true` —— 操作成功 / 正常推送。下文各包的字段表描述的都是这种情况，表里不再重复列 `success` 这一行。
+- `success: false` —— 操作失败，见 0.2。
+
+前端一律 `if (!data.success)` 判成败，**不看 `status` / `code`，也不写 `status` 兼容兜底**。
+
+### 0.2 失败回包
+
+服务端受理请求时，任一校验不通过都会**回一个失败包**（此前是静默丢弃、前端只能干等倒计时）：
+
+- **rpc 与请求包同名**（如 `chupai` 失败回 `chupai`，而不是 `chupai1/2/3`）；
+- **只回发给请求者**（`conmode`/`fromid` 取自请求包），其他两家收不到；
+- `data` 只含 `success: false` 与 `errcode`，无业务字段。
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| success | 布尔 | 恒为 `false` |
+| errcode | 整数 | 失败原因，见下表 |
+
+`errcode` 取值（服务端 `youle_erqiwang.ERR`，`mod.js`）：
+
+| 值 | 名称 | 含义 |
+| --- | --- | --- |
+| 1 | PLAYER | 玩家/房间/座位校验不通过（平台 `check_player` 返回 null） |
+| 2 | NODESK | 牌桌或牌局不存在 |
+| 3 | STEP | 当前阶段不允许该操作（如非出牌阶段发 `chupai`） |
+| 4 | SEAT | 位置不符，或还没轮到该玩家操作 |
+| 5 | PARAM | 参数非法：类型/范围/张数不对、牌不在手上、牌id 重复 |
+| 6 | RULE | 规则不允许：叫分未更低、出牌不合法、投降条件不满足、房间模式禁止等 |
+
+> **牌id 列表的入参约束**（`cards` 字段，`maipai`/`chupai`）：必须是**非空数组**，元素必须是 `0 ~ 107` 的**整数**牌id，且**互不重复**。字符串形式的数字（如 `"5"`）、小数、越界值、重复值一律按 `PARAM` 拒绝，服务端不做类型兜底转换。
+
+> **例外：`tishi` 成功时不回执**。该包是闲家给对家的主观提示、不含任何对局状态，服务端只转发给对家（design §11），发送者收不到成功包；只有失败才回给发送者。
+
+### 0.3 `countdown` 只是展示用的秒数
+
+多个包带 `countdown`（叫分 / 选主 / 埋牌 / 出牌倒计时，取自 `class.desk.js` 的四个常量）。它**只供客户端显示提醒，服务端不据此做任何事**：
+
+- 服务端**没有**对应的定时器，倒计时归零后**不会**自动叫分 / 选主 / 埋牌 / 出牌，也不判负、不跳过该玩家；
+- 轮到谁而谁不操作，牌局就停在该阶段一直等，`step` 与 `playproc` 都不变；
+- 这是 design §11 确认过的规则（无超时托管），不是未实现的功能。牌局因此停住时，由玩家走平台的**房间解散**流程收场（平台回调子游戏 `get_disbandRoom` → 解散结算，见 §14）。
+
+因此**客户端不要在倒计时归零时做任何乐观的界面推进**（不要自行跳阶段、不要清控制权），一切仍以收到服务端推送为准。
+
+### 0.4 断线重连包不在此约定内
+
+`deskinfo` 由平台组装在 `pack.data.deskinfo` 下（见文末「断线重连」），`data.success` 由**平台**填写，子游戏不注入。
+
+### 0.5 `roomtype` 房间选项位串
+
+`roomtype` 是建房时由客户端生成、经平台建房流程存入 `o_room.roomtype` 的 **11 位字符串**。前 5 位依次为：**局数、扣卡方式、查牌模式、傍王、爬坡**；后 6 位预留。下表的位索引从 0 开始，与 `charAt` 一致，“前 5 位”即索引 0～4。
+
+| 位索引 | 含义 | '0' | '1' | 创建页控件 | design |
+| --- | --- | --- | --- | --- | --- |
+| 0 | 局数 | 6 局（默认） | 12 局 | 单选必选 | §10.1 |
+| 1 | 扣卡方式 | 房主扣卡（默认） | AA 每人扣卡 | 单选必选 | §10.1 |
+| 2 | 查牌模式 | 可查牌（默认） | 不查牌 | 单选必选 | §9 / §10.2 |
+| 3 | 傍王 | 关（默认） | 开 | 独立可选 | §8.3 / §10.3 |
+| 4 | 爬坡 | 常规算子（默认） | 爬坡 | 独立可选 | §7.3 / §10.3 |
+| 5～10 | 预留 | 尚未定义 | 尚未定义 | 无控件 | §10.4 |
+
+前三组各自必须且只能选中一个选项；傍王与爬坡互不排斥，允许均不选、任选其一或同时选择。可选开关未勾选也必须编码为对应位的 '0'，不能省略该位或缩短字符串。
+
+默认选项的**前 5 位**为 `"00000"`，表示 6 局 / 房主扣卡 / 可查牌 / 无傍王 / 常规算子。例：前 5 位 `"10010"` 表示 12 局 / 房主扣卡 / 可查牌 / 傍王开 / 常规算子；`"00100"` 表示 6 局 / 房主扣卡 / 不查牌 / 无傍王 / 常规算子。这些仅是有效选项部分，**不是可直接发送的完整 roomtype**。
+
+**待确认：后 6 位预留位的固定填充值。** 目前已确认总长度与预留位置，不能把未确认的全零填充写成已生效协议，也不能将预留位解释为额外规则。
+
+本节为二七王位编码的唯一文档定义；玩法侧解析入口为 `class.config.js` 的 `parse()`，其他消费方使用解析结果。`multiple` / `bangwang` / `climb` / `baozhu` / `seatlist` / `liangpai` / `pushlist` 按相应选项取值或门控。
+
+此次按规则设计者更正了长度和位序；尚未核验服务端实现是否已采用该定义。旧文档关于缺失、非字符串或过短值自动按 '0' 处理的描述，不构成前端补齐或静默容错的授权。前端应在编码入口生成完整合法参数，错误显式暴露，不改变服务器协议。
+
+对应的房卡与局数（`export.get_asetcount` / `get_needroomcard` / `get_needroomcard_joinroom`，design §10.1）：
+
+| 扣卡方式（位1） | 局数（位0） | 房主开房扣 | 加入者扣 |
+| --- | --- | --- | --- |
+| 房主扣卡 `'0'` | 6 局 | 2 张 | 0 |
+| 房主扣卡 `'0'` | 12 局 | 4 张 | 0 |
+| AA 每人 `'1'` | 6 局 | 1 张 | 1 张 |
+| AA 每人 `'1'` | 12 局 | 2 张 | 2 张 |
+
+### 0.6 「一手出牌」的顺序口径
+
+同一份业务数据「某一手打出的牌」会出现在**三个下发位置**：
+
+| 位置 | 字段 |
+|---|---|
+| 出牌推送 | `chupai1` / `chupai2` / `chupai3` 的 `data.cards` |
+| 本轮进行态 | `playproc.cards[座位]`（`chupai*` 与重连包 `PushCards` 都带）|
+| 重连出牌历史 | `PushCards.pushlist[轮次-1][座位]` |
+
+**这三处的数组内容逐元素完全相等**——顺序统一为「按**本局主牌花色**从大到小」的**权威顺序**。
+服务端只在落牌那一刻归一化一次（`class.paiju.js` 的 `order_playcards`），随后：
+出牌推送读它、`playproc.cards` 存它、出牌历史 `playhistory` 归档它，下游一律**只读、不重排**。
+
+因此前端**「增量回放」与「重连重建」得到的出牌历史必定一致**，两条路径可以复用同一份解析。
+
+> ⚠️ **请求包里的 `cards` 顺序无意义**：那是玩家的点击顺序，同一手牌每次都可能不同。
+> 服务端不采信、不回显、也不据它判定牌型（server dev-guide 04 §8「前端不是数据源」）。
+> 一手单张时看不出差别；**一手多张（甩牌 / 对子 / 拖拉机）时才会显形**，尤其是同编码的一对牌
+> ——排序本身区分不了它们，只有「出牌当场归档」这一个写入处才能保证两条路径给出同一个数组。
+
+---
+
+## 1. 发牌（fapai）
+
+发包者：服务器　收包者：游戏　app：youle　route：erqiwang　rpc：fapai
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| asetidx | 整数 | 当前局数 |
+| asetcount | 整数 | 总局数 |
+| cards | 数组 | 自己得到的牌id列表 |
+| step | 整数 | **本局阶段**（发完牌恒为 `1` 叫分；取值 1叫分 2选主/投降 3埋牌 5出牌 6结算）。阶段由服务端唯一维护、逐包显式给出，客户端**不得按 rpc 名反推**（server 03 §1.4「任何状态变更都要有包承载」/ 前端红线「数据驱动、前端无对局状态机」）。与同一时刻的重连包 `deskinfo.step` 同源同值 |
+| seat | 整数 | **控制权**：当前等待叫分者的位置。与重连包 `CallRun.seat` 同源（`get_callgrade_seat()`）|
+| countdown | 整数 | 叫分倒计时 |
+
+---
+
+## 2. 叫分或不叫（jiaofen，客户端→服务器）
+
+发包者：游戏　收包者：服务器　app：youle　route：erqiwang　rpc：jiaofen
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| agentid | 字符 | 代理id |
+| playerid | 整数 | 玩家id |
+| gameid | 字符 | 游戏id |
+| roomcode | 整数 | 房间号 |
+| seat | 整数 | 叫分者的位置序号 |
+| call | 整数 | 分数，0表示不叫 |
+
+---
+
+## 3. 叫分或不叫（jiaofen，服务器→客户端）
+
+发包者：服务器　收包者：游戏　app：youle　route：erqiwang　rpc：jiaofen
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| seat | 整数 | 叫分者的位置序号 |
+| call | 整数 | 分数，0表示不叫 |
+| currcall | 整数 | 当前叫到的分数 |
+| multiple | 整数 | 叫分对应的基础子数 `get_base_bycall(call, climb)`，**随房间「爬坡」开关取值**（roomtype 位4）：常规算子 65→2 60→3 55→4 50及以下→6；爬坡 65→2 60→3 55→4 50→6 45→7 40→8 35→9 30→10 25→11 20→12 15→13 10→14 5→15；两种模式下 70→2；无叫分→0。与结算包 `aset.multiple` 同源同值（design §7.1/§7.3.1）|
+| step | 整数 | **本局阶段**（叫分尚未结束，恒为 `1`；取值 1叫分 2选主/投降 3埋牌 5出牌 6结算）。阶段由服务端唯一维护、逐包显式给出，客户端**不得按 rpc 名反推**（server 03 §1.4「任何状态变更都要有包承载」/ 前端红线「数据驱动、前端无对局状态机」）。与同一时刻的重连包 `deskinfo.step` 同源同值 |
+| nextseat | 整数 | **控制权**：下一个叫分者的位置序号，即本包之后「轮到谁」。与重连包 `CallRun.seat` 同源（`get_callgrade_seat()`）|
+| countdown | 整数 | 叫分倒计时 |
+
+---
+
+## 4. 上庄（shangzhuang）
+
+发包者：服务器　收包者：游戏　app：youle　route：erqiwang　rpc：shangzhuang
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| seat | 整数 | 叫分者的位置序号 |
+| call | 整数 | 分数，0表示不叫 |
+| banker | 整数 | 庄家的位置序号 |
+| grade | 整数 | 庄家的叫分 |
+| step | 整数 | **本局阶段**（叫分结束、进入选主/投降，恒为 `2`；取值 1叫分 2选主/投降 3埋牌 5出牌 6结算）。阶段由服务端唯一维护、逐包显式给出，客户端**不得按 rpc 名反推**（server 03 §1.4「任何状态变更都要有包承载」/ 前端红线「数据驱动、前端无对局状态机」）。与同一时刻的重连包 `deskinfo.step` 同源同值 |
+| nextseat | 整数 | **控制权**：本包之后「轮到谁」——恒为 `banker`，因为选主与投降都只由庄家做（服务端 `mod.xuanzhu`/`mod.touxiang` 的座位校验同样以 `banker` 为准）。<br>⚠️ **别和本包的 `seat` 混用**：`seat` 是**最后一个叫分者**，不是控制权。与重连包 `ChooseMain.seat` 同源同值 |
+| multiple | 整数 | 叫分对应的基础子数 `get_base_bycall(call, climb)`，**随房间「爬坡」开关取值**（roomtype 位4）：常规算子 65→2 60→3 55→4 50及以下→6；爬坡 65→2 60→3 55→4 50→6 45→7 40→8 35→9 30→10 25→11 20→12 15→13 10→14 5→15；两种模式下 70→2；无叫分→0。与结算包 `aset.multiple` 同源同值（design §7.1/§7.3.1）|
+| bottomcards | 数组 | 8 张**底牌**（发牌时没发给玩家、扣在桌面的 8 张）。**庄家恒有**；**闲家仅当 70 分坐庄时才有**（供 3 秒亮牌用），非 70 分时闲家没有该属性（底牌只有庄家可见，design §4）。<br>**顺序在发牌结束时即冻结**（服务端 `paiju.bottomcards`，按「还没有主牌」的口径排一次）：底牌是在**选主之前**翻给庄家看的，那时主牌花色尚不存在，故不按主牌花色排。本包与重连包 `ChooseMain.bottomcards` / `BuryCards.bottomcards` 三处**同序**，客户端存一次即可全程复用（含「查底牌」回看）|
+| ancard3s | 整数 | **开底**标志。仅 70 分坐庄时出现且为 `1`：表示庄家**摸底**之前，需将 `bottomcards` 这 8 张**底牌**向所有玩家翻开 3 秒（design §4/§7.1）；非 70 分无此属性 |
+| cards | 数组 | 拿了底牌后手上的牌（36 张，含底牌），庄家才有此属性，闲家没有该属性 |
+| countdown | 整数 | 选主倒计时 |
+| touxiang | 整数 | 是否允许投降 0：不允许 1：允许（仅 70 分坐庄为 1）。投降与选主互斥、同为选主阶段(step2)的决策，见 touxiang 包与 design §4 |
+| curmultiple | 整数 | **当前抓分倍数**（design §7.2.0）：按此刻累计捡分实时算出的判定倍率，**带符号**，与结算包 `aset.upgrade` 同口径——`3`/`2`/`1` = 庄家 大光/小光/过庄，`-N` = 闲家升 N 级，`0` = 叫分未定。上庄时捡分恒为 0，故必为 `3`。三家同值（捡分本就公开）。**不含扣底**——扣底要到末轮才产生。<br>顶部「抓分」角标只关心倍数大小，取 `Math.abs` 即可；**符号供客户端的判定动画分辨该播哪个**（不能取绝对值，否则 3 大光与 -3 升3级会撞在一起）|
+
+---
+
+## 5. 投降（touxiang，客户端→服务器）
+
+发包者：游戏　收包者：服务器　app：youle　route：erqiwang　rpc：touxiang
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| agentid | 字符 | 代理id |
+| playerid | 整数 | 玩家id |
+| gameid | 字符 | 游戏id |
+| roomcode | 整数 | 房间号 |
+| seat | 整数 | 庄家的位置序号。投降是**选主阶段（step 2）与选主互斥**的选择：`mod.touxiang` 仅在 `step==2`、`banker==seat`、`call==70` 时受理；点投降即直接结算，不选主、不埋牌、不出牌（design §4） |
+
+---
+
+## 6. 选主（xuanzhu，客户端→服务器）
+
+发包者：游戏　收包者：服务器　app：youle　route：erqiwang　rpc：xuanzhu
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| agentid | 字符 | 代理id |
+| playerid | 整数 | 玩家id |
+| gameid | 字符 | 游戏id |
+| roomcode | 整数 | 房间号 |
+| seat | 整数 | 选主者的位置序号 |
+| flower | 整数 | 花色 1方块 2梅花 3红心 4黑桃 |
+
+---
+
+## 7. 选主（xuanzhu，服务器→客户端）
+
+发包者：服务器　收包者：游戏　app：youle　route：erqiwang　rpc：xuanzhu
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| banker | 整数 | 庄家的位置序号 |
+| flower | 整数 | 花色 1方块 2梅花 3红心 4黑桃 |
+| step | 整数 | **本局阶段**（选主完成、进入埋牌，恒为 `3`；取值 1叫分 2选主/投降 3埋牌 5出牌 6结算）。阶段由服务端唯一维护、逐包显式给出，客户端**不得按 rpc 名反推**（server 03 §1.4「任何状态变更都要有包承载」/ 前端红线「数据驱动、前端无对局状态机」）。与同一时刻的重连包 `deskinfo.step` 同源同值 |
+| nextseat | 整数 | **控制权**：本包之后「轮到谁」——恒为 `banker`，埋牌只由庄家做（服务端 `mod.maipai` 的座位校验以 `banker` 为准）。与重连包 `BuryCards.seat` 同源同值 |
+| countdown | 整数 | 埋牌倒计时 |
+| cards | 数组 | 选主后自己手上的牌id列表 |
+
+---
+
+## 8. 埋牌（maipai，客户端→服务器）
+
+发包者：游戏　收包者：服务器　app：youle　route：erqiwang　rpc：maipai
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| agentid | 字符 | 代理id |
+| playerid | 整数 | 玩家id |
+| gameid | 字符 | 游戏id |
+| roomcode | 整数 | 房间号 |
+| seat | 整数 | 埋牌者的位置序号 |
+| cards | 数组 | 埋牌的id列表 |
+
+---
+
+## 9. 埋牌（maipai，服务器→客户端）
+
+发包者：服务器　收包者：游戏　app：youle　route：erqiwang　rpc：maipai
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| 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>**可见性**：全部字段由桌面公开信息推出（此刻尚无一张牌打出），三家整体下发、不逐座位裁剪 |
+| step | 整数 | **本局阶段**（埋牌完成、进入出牌，恒为 `5`；取值 1叫分 2选主/投降 3埋牌 5出牌 6结算）。阶段由服务端唯一维护、逐包显式给出，客户端**不得按 rpc 名反推**（server 03 §1.4「任何状态变更都要有包承载」/ 前端红线「数据驱动、前端无对局状态机」）。与同一时刻的重连包 `deskinfo.step` 同源同值 |
+| seat | 整数 | **控制权**：出牌者的位置序号（即将首出的庄家）。服务端取自权威的 `playproc.currseat`，与重连包 `PushCards.playproc.currseat` 同源同值 |
+| 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 张，但包含之后已打出的牌），全局固定不随出牌缩水，故重连包里取值一致 |
+
+---
+
+## 10. 出牌（chupai，客户端→服务器）
+
+发包者：游戏　收包者：服务器　app：youle　route：erqiwang　rpc：chupai
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| agentid | 字符 | 代理id |
+| playerid | 整数 | 玩家id |
+| gameid | 字符 | 游戏id |
+| roomcode | 整数 | 房间号 |
+| seat | 整数 | 出牌者的位置序号 |
+| cards | 数组 | 出牌的id列表 |
+
+---
+
+## 11. 第一个玩家出牌（chupai1）
+
+发包者：服务器　收包者：游戏　app：youle　route：erqiwang　rpc：chupai1
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| seat | 整数 | 出牌者的位置序号 |
+| cards | 数组 | 实际打出的牌id列表；**甩错时**（见 `shuaicuo`）为被强制打出的那一张最小主牌单张。**顺序：按本局主牌花色从大到小（权威顺序）**，不是客户端提交时的点击顺序——请求包里的 `cards` 顺序服务端不采信、不回显（见 [§0.6](#06-一手出牌的顺序口径)）|
+| shuaicuo | 整数 | 甩错标志，仅甩错时出现且为 `1`（design §5.4.5：甩牌未通过最大性判定，整套甩牌收回，本轮只强制打出最小一张、失去本轮甩牌资格）；正常出牌无此属性 |
+| seatlist | 数组 | 三家座位牌况 `o_paiju.seatlist`（长度 3，下标 = 座位序号），**仅可查牌模式下发**（不查牌无此属性，design §9）。每个座位为 5 元素数组：前 4 个对应花色1~4 的 `[无该花色标志, 该花色无对标志]`（0/1），第 5 个为**余主公示**数据 `[剩余主牌数, 剩余主对数]`（初始 `[-1,-1]`，代码内旧称「报副」）。**一旦全场有人报无主，服务端会按各家实际手牌同时刷新三个座位并整表下发**（design §9「为全体三人显示另外两家」），无需等另两家各自出牌才补。字段名与结构同重连包 `PushCards.seatlist` |
+| count | 整数 | 出牌数量（甩错时为 1） |
+| flower | 整数 | 出牌花色 |
+| cardtype | 整数 | 出牌牌型：`>100` 单张（101 一张、102 两张…）、`>200` 对子（201 一对、202 两对…）、`>300` 拖拉机（302 两连对、303 三连对…），见 `class.pai.js` 顶部注释。**注意：cardtype 只能表达单一牌型**，而甩牌是单张/对子/拖拉机自由混搭（design §5.4.3），会被牌型推导压平成 1xx 或 2xx（例如「主K对 + 主5」得 103、「两连对 + 一散对」得 203）。**甩牌的真实结构请读 `shuai`，不要据 cardtype 反推** |
+| shuai | json | 甩牌分量构成，**仅本次出牌是合法甩牌时才有**（非甩牌、以及甩错退化为单张时都没有该属性）。结构 `{ tractors: [连对数...], pairs: 独立对子数, singles: 单张数 }`，例如「主K对 + 主5」为 `{tractors:[],pairs:1,singles:1}`。与服务端跟牌时逐分量强制匹配用的 `shuai_demand` 同源（design §5.4.3/§5.4.4）|
+| nextseat | 整数 | 下一个出牌者的位置序号 |
+| countdown | 整数 | 下一个出牌者的出牌倒计时 |
+| baozhu | 整数 | 是否已有玩家报无主（主牌出空）0否 1是；对应服务端 `have_baofu()`（任一玩家 `seatlist[seat][4][0]==0`）。**仅可查牌模式**下才可能为 1，是**余主公示**与"明牌"按钮的开关；**不查牌模式恒为 0**（design §9）|
+| cardsinhand | 数组 | 出牌者出牌后手上剩下的牌id列表，只有出牌者才有此属性 |
+| curmultiple | 整数 | **当前抓分倍数**（design §7.2.0）：**带符号**，与结算包 `aset.upgrade` 同口径（`3`/`2`/`1` 庄家大光/小光/过庄，`-N` 闲家升 N 级，`0` 叫分未定）。同源同算法，差别仅在此处**不含扣底**。三家同值，随本包下发、不另开推送。符号是「谁赢」的区分，客户端判定动画靠它分辨 |
+| playproc | json | <a id="playproc-def"></a>**本轮进行态**（design §5.1）。**`chupai1/2/3` 三个包恒有，三家同值**；结构与重连包 [`PushCards.playproc`](#断线重连deskinfo) **完全一致**（服务端同一个快照函数 `get_playproc()`，前端增量回放与重连重建复用同一份解析）。<br>字段：`round` 第几轮、`start` 本轮首出位置、`currseat` 当前该谁出、`startcount` 首出张数、`startflower` 首出花色、`starttype` 首出牌型、`maxseat` 本轮暂时最大者、`maxcard` 其牌编码、`cards` 本轮三家各自出的牌（**定长 3，下标 = 座位序号**，未出的位置为 `null`）、`shuai_demand` 首家甩牌的分量需求 `{tractors:[连对数...],pairs,singles}`（非甩牌为 `null`）。<br>⚠️ **`chupai3` 带的是【下一轮】的进行态**（`round+1`、`cards` 全空、`currseat == nextseat == maxseat`）：本轮第三家一出完，服务端就地开了新一轮。这与「此刻断线重连拿到的 `PushCards.playproc`」完全相同——本轮那三手牌客户端已由 `chupai1/2/3` 各自的 `seat`+`cards` 收到，收牌动画后即清台。**唯一例外**：`chupai3` 打完最后一张牌时本包会转成 `jiesuan`（见 §14），那种情况下**不带** `playproc`。<br>**可见性**：全部字段都由桌面公开信息推出（`cards` 就是已摊在桌上的牌，`shuai_demand` 与 `chupai1.shuai` 等价且甩出的牌本身已公开），故三家整体下发、不逐座位裁剪 |
+| mustcard | 数组 | **下一个出牌者本轮跟牌的必出牌**（design §5.2），供其客户端自动选中。**只发给 `nextseat` 那一家**，其余两家无此属性——它是该玩家自己手牌的子集，整表下发会泄露他家手牌结构。以下情形不下发：`nextseat` 是本轮首家、首家为**甩牌**（甩牌跟牌走逐分量匹配，见 design §5.4.4）、或算出的必出牌为空 |
+
+---
+
+## 12. 第二个玩家出牌（chupai2）
+
+发包者：服务器　收包者：游戏　app：youle　route：erqiwang　rpc：chupai2
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| seat | 整数 | 出牌者的位置序号 |
+| cards | 数组 | 出的牌id列表。**顺序：按本局主牌花色从大到小（权威顺序）**，不是客户端提交时的点击顺序（见 [§0.6](#06-一手出牌的顺序口径)）|
+| seatlist | 数组 | 三家座位牌况 `o_paiju.seatlist`（长度 3，下标 = 座位序号），**仅可查牌模式下发**（不查牌无此属性，design §9）。每个座位为 5 元素数组：前 4 个对应花色1~4 的 `[无该花色标志, 该花色无对标志]`（0/1），第 5 个为**余主公示**数据 `[剩余主牌数, 剩余主对数]`（初始 `[-1,-1]`，代码内旧称「报副」）。**一旦全场有人报无主，服务端会按各家实际手牌同时刷新三个座位并整表下发**（design §9「为全体三人显示另外两家」），无需等另两家各自出牌才补。字段名与结构同重连包 `PushCards.seatlist` |
+| nextseat | 整数 | 下一个出牌者的位置序号 |
+| countdown | 整数 | 出牌倒计时 |
+| baozhu | 整数 | 是否已有玩家报无主（主牌出空）0否 1是；对应服务端 `have_baofu()`（任一玩家 `seatlist[seat][4][0]==0`）。**仅可查牌模式**下才可能为 1，是**余主公示**与"明牌"按钮的开关；**不查牌模式恒为 0**（design §9）|
+| cardsinhand | 数组 | 出牌后出牌者手上剩下的牌id列表，只有出牌者才有此属性 |
+| playproc | json | **本轮进行态**，恒有、三家同值，结构见 [§11 `playproc`](#11-第一个玩家出牌chupai1)。此时 `cards` 已含首家与本家两手牌，`currseat` 指向第三家 |
+| mustcard | 数组 | **下一个出牌者本轮跟牌的必出牌**（design §5.2），供其客户端自动选中。**只发给 `nextseat` 那一家**，其余两家无此属性——它是该玩家自己手牌的子集，整表下发会泄露他家手牌结构。以下情形不下发：`nextseat` 是本轮首家、首家为**甩牌**、或算出的必出牌为空 |
+
+---
+
+## 13. 第三个玩家出牌（chupai3）
+
+发包者：服务器　收包者：游戏　app：youle　route：erqiwang　rpc：chupai3
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| seat | 整数 | 出牌者的位置序号 |
+| cards | 数组 | 出的牌id列表。**顺序：按本局主牌花色从大到小（权威顺序）**，不是客户端提交时的点击顺序（见 [§0.6](#06-一手出牌的顺序口径)）|
+| seatlist | 数组 | 三家座位牌况 `o_paiju.seatlist`（长度 3，下标 = 座位序号），**仅可查牌模式下发**（不查牌无此属性，design §9）。每个座位为 5 元素数组：前 4 个对应花色1~4 的 `[无该花色标志, 该花色无对标志]`（0/1），第 5 个为**余主公示**数据 `[剩余主牌数, 剩余主对数]`（初始 `[-1,-1]`，代码内旧称「报副」）。**一旦全场有人报无主，服务端会按各家实际手牌同时刷新三个座位并整表下发**（design §9「为全体三人显示另外两家」），无需等另两家各自出牌才补。字段名与结构同重连包 `PushCards.seatlist` |
+| nextseat | 整数 | 下一个出牌者的位置序号 |
+| countdown | 整数 | 出牌倒计时 |
+| baozhu | 整数 | 是否已有玩家报无主（主牌出空）0否 1是；对应服务端 `have_baofu()`（任一玩家 `seatlist[seat][4][0]==0`）。**仅可查牌模式**下才可能为 1，是**余主公示**与"明牌"按钮的开关；**不查牌模式恒为 0**（design §9）|
+| cardsinhand | 数组 | 出牌后出牌者手上剩下的牌id列表，只有出牌者才有此属性 |
+| maxseat | 整数 | 本轮出牌谁最大，只有本轮最后一个玩家出牌后才有此属性 |
+| grade | 整数 | 本轮闲家得分，只有本轮最后一个玩家出牌后且闲家有得分才有此属性 |
+| curmultiple | 整数 | **当前抓分倍数**（design §7.2.0）：**带符号**，口径同 `aset.upgrade`。同源同算法，差别仅在此处**不含扣底**。三家同值，随本包下发、不另开推送 |
+| playproc | json | **本轮进行态**，三家同值，结构见 [§11 `playproc`](#11-第一个玩家出牌chupai1)。⚠️ 本包带的是**下一轮**的进行态（`round+1`、`cards` 全空、`currseat == nextseat == maxseat`），与此刻重连拿到的 `PushCards.playproc` 一致。**牌局在本包打完（转为 `jiesuan`）时不带此属性** |
+
+---
+
+## 13.5 明牌（mingpai，客户端→服务器）
+
+发包者：游戏　收包者：服务器　app：youle　route：erqiwang　rpc：mingpai
+
+查看另外两家手中全部主牌的具体牌面（design §9）。服务端仅在**可查牌模式、出牌阶段(step5)、且已有【任一】玩家报无主**（`have_baofu()`）时受理——注意判定的是「场上有人报无主」而非「请求者本人报无主」，报无主那位与另外两位同样有权查看（design §9.3）；不满足时按 0.2 回 `mingpai` 失败包（不查牌 / 未报无主 → `RULE`，非出牌阶段 → `STEP`）。
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| agentid | 字符 | 代理id |
+| playerid | 整数 | 玩家id |
+| gameid | 字符 | 游戏id |
+| roomcode | 整数 | 房间号 |
+| seat | 整数 | 请求者的位置序号 |
+
+## 13.6 明牌（mingpai，服务器→客户端）
+
+发包者：服务器　收包者：游戏　app：youle　route：erqiwang　rpc：mingpai　（只回发给请求者）
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| seat | 整数 | 请求者的位置序号 |
+| others | 数组 | 另外两家各自未出的全部主牌，元素 `{ seat: 位置序号, zhucards: [主牌id列表] }` |
+
+> "再点一次取消查看"是客户端的显示开关，无需再请求服务端。
+
+## 13.7 出牌提示（tishi，客户端→服务器）
+
+发包者：游戏　收包者：服务器　app：youle　route：erqiwang　rpc：tishi
+
+闲家在出牌阶段向对家（另一闲家）发"踩/没分/有分"提示（design §11）。服务端仅在**出牌阶段(step5)、且发起者为闲家**（`seat != banker`）、**tip 合法(1/2/3)** 时受理；**不校验提示真实性**（玩家可主观发送）；庄家无对家，不受理。不满足时按 0.2 回 `tishi` 失败包给发送者（庄家发 → `RULE`，非出牌阶段 → `STEP`，tip 非法或缺失 → `PARAM`）。**成功时不给发送者回执**，只转发给对家。
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| agentid | 字符 | 代理id |
+| playerid | 整数 | 玩家id |
+| gameid | 字符 | 游戏id |
+| roomcode | 整数 | 房间号 |
+| seat | 整数 | 发出提示的闲家位置序号 |
+| tip | 整数 | 提示类型：1=踩（我能大过庄家）、2=没分（我手上没分了）、3=有分（我手上有分） |
+
+## 13.8 出牌提示（tishi，服务器→客户端）
+
+发包者：服务器　收包者：游戏　app：youle　route：erqiwang　rpc：tishi　（**只转发给对家**，即另一闲家 `3 - banker - seat`）
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| seat | 整数 | 发出提示的闲家位置序号 |
+| tip | 整数 | 提示类型：1=踩、2=没分、3=有分 |
+
+---
+
+## 14. 结算（jiesuan）
+
+发包者：服务器　收包者：游戏　app：youle　route：erqiwang　rpc：jiesuan
+
+结算包由以下几个子结构拼装而成。三种结算来源的组成不同：
+
+- **正常出牌结算**（`mod.chupai` 中最后一张牌出完，`get_paiju_account(0, ...)`）：含 `chupai` + `bottom` + `aset`（末局再加 `account`）。
+- **投降结算**（`mod.touxiang`，`get_paiju_account(1, ...)`）：只含 `aset`（末局再加 `account`），无 `chupai`、无 `bottom`。
+- **解散结算**（`export.get_disbandRoom`，`get_paiju_account(2, ...)`）：只含 `aset` + `account`，无 `chupai`、无 `bottom`。**投递方式与上面两种不同，见 §14.1。**
+
+上面这张表头（`route: erqiwang / rpc: jiesuan`）**只适用于前两种**——正常出牌结算与投降结算，由子游戏自己 `sendpack_toother` 广播，客户端在 `rpc == "jiesuan"` 的分支里按 `data.aset` 取值。
+
+### 14.1 解散结算的投递方式（与前两种不同，客户端需单独处理）
+
+解散**不是**由子游戏发包，而是平台在解散流程里回调 `youle_erqiwang.export.get_disbandRoom(o_room)`，把**返回值整个对象**塞进**房间路由**的解散包里下发（平台 `server_room/rpc.js`、`server_room/class.room.js`）。因此客户端收到的是：
+
+```json
+{
+  "app": "youle", "route": "room", "rpc": "free_room",
+  "data": {
+    "seats": [],
+    "deskfree": {
+      "rpc": "jiesuan",
+      "data": { "success": true, "aset": {}, "account": [] }
+    }
+  }
+}
+```
+
+要点（照 §14 的表去 `data.aset` 取值会取空）：
+
+- **rpc 是平台的 `free_room`（route 也是 `room`），不是 `erqiwang/jiesuan`**；子游戏返回的 `rpc: "jiesuan"` 只是嵌在 `deskfree` 里的一个普通字段。
+- **多一层 `data` 包装**：真实取值路径是 `data.deskfree.data.aset` 与 `data.deskfree.data.account`。
+- 本包的成败标志有两层：外层 `data.success` 由**平台**填写（解散流程本身成功与否），子游戏结算自带的 `success` 在 `data.deskfree.data.success`。§0.1「每个包 `data` 必带 `success`」说的是子游戏自己发的包；本包外层归平台。
+- `aset` / `account` 的字段结构与下面 §14 的表完全一致（`aset.multiple = 0`、`upgrade = 0`、各家 `grade = 0`，即解散局不结算子数与算奖；`account` 恒有，见 design §12.2「按当前累计分结算」）。
+- 若解散发生在**开战后、首局牌发出前**的窗口内（本游戏首局由 `makewar` 延迟 1 秒创建），`get_disbandRoom` 返回 `null`，平台走「不带 `deskfree`」分支——客户端需容忍 `data.deskfree` 缺失。
+
+**顶层字段（三种结算来源恒有）**
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| success | 布尔 | 恒 `true`（§0.1）|
+| step | 整数 | **本局阶段**，结算包恒为 `6`。三种结算来源（正常/投降/解散）统一由 `get_paiju_account` 给出——解散在此之前 `step` 可能还停在 1/2/3/5，由它落定为 6。客户端**不得按 rpc 名硬编码**，一律读此字段 |
+
+**chupai（出牌包，仅正常出牌结算存在）**
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| seat | 整数 | 出牌者的位置序号，投降和解散无此属性 |
+| cards | 数组 | 出的牌id列表，投降和解散无此属性 |
+| maxseat | 整数 | 本轮出牌谁最大，投降和解散无此属性 |
+| grade | 整数 | 本轮闲家得分，投降和解散无此属性 |
+| gradecards | 数组 | 本轮闲家得分分牌列表，投降和解散无此属性。**注意：当前源码中赋值语句被注释（`class.paiju.js`/`mod.js` 中相关行均被注释掉），该字段实际永远不会出现在下发的包里，属于失效字段** |
+
+**bottom（抠底包，仅正常出牌结算存在；`cards` 恒有，其余仅闲家抠底时有）**
+
+> 本分组的 `cards` 是**埋牌底牌**（庄家埋下的 8 张），不是发牌留桌的底牌。
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| cards | 数组 | **埋牌底牌**（庄家埋下的 8 张），投降和解散无此属性 |
+| multiple | 整数 | 闲家抠底倍数，闲家没抠底无此属性，投降和解散无此属性 |
+| grade1 | 整数 | 埋牌底牌的分数，闲家没抠底无此属性，投降和解散无此属性 |
+| grade2 | 整数 | 闲家抠底得分，闲家没抠底无此属性，投降和解散无此属性 |
+
+**aset（单局结算包）**
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| banker | 整数 | 庄家的位置序号，-1：无庄 |
+| call | 整数 | 庄家叫分，-1：无叫分 |
+| multiple | 整数 | 基础子数 `get_base_bycall(call, climb)`（design §7.1/§7.3.1）：常规算子 65→2、60→3、55→4、50 及以下→6、70打牌→2；投降固定 1、解散 0；无叫分 0 |
+| flower | 整数 | 主牌花色，-1：无主牌花色 |
+| grade | 整数 | 闲家捡分（含抠底） |
+| upgrade | 整数 | 判定倍率（带符号，design §7.2.0）：3大光 / 2小光 / 1过庄 / -N升N级（倒庄）/ -99投降 / 0解散或无判定 |
+| bangwang | 整数 | 本局是否启用傍王规则 0否 1是（roomtype 位3） |
+| climb | 整数 | 本局是否启用爬坡规则 0否 1是（roomtype 位4） |
+| seatlist | 数组 | 玩家列表，元素结构见下 |
+
+`seatlist` 数组元素结构：
+
+```json
+{
+  "cards": [],      // 冲关牌型：参与冲关的牌（王 + 冲关组合牌）列表，供「冲关牌型」界面展示
+  "chongguan": 0,   // 冲关奖数（design §8.1，旧称"常规算奖"；只有庄家才计入自己的 N）
+  "wang": 0,        // 手牌中的王数（傍王按此计奖）
+  "naward": 0,      // 该家总奖数 N =（庄家?冲关奖数:0）+（傍王?王数:0）
+  "grade_aw": 0,    // 算奖得分 = X×(2Ni−Nj−Nk)，X 为每对子子数。= grade_cg + grade_bw
+  "grade_cg": 0,    // 其中的【冲关】分量（design §8.1，不含傍王）
+  "grade_bw": 0,    // 其中的【傍王】分量（design §8.3；未勾傍王时恒 0）
+  "grade_jf": 0,    // 捡分子数得分
+  "grade": 0,       // 本局总分 = grade_aw + grade_jf
+  "score": 0        // 累计得分
+}
+```
+
+> 结算数值模型（design §7~§8）：每「庄–闲」对子的基础金额 `X = multiple × |upgrade|`（投降 X=1、解散 X=0）。捡分子数：庄赢时两闲家各付庄家 X、庄家收 2X；闲赢（升级）时庄家各付两闲家 X。算奖：持有 N 奖的玩家从另外两人各多收 `X×N`，三家两两独立叠加（含闲–闲），即 `grade_aw = X×(2Ni−Nj−Nk)`。
+>
+> **算奖的两个分量**（供大局结算分项展示）：`N = N_冲关 + N_傍王`（冲关只计庄家、傍王勾选后庄闲都算）。
+> 服务端把两个分量**分别代入同一公式**各算一次，得到 `grade_cg` 与 `grade_bw`。
+> 公式对 `N` 是线性的，因此恒有 **`grade_cg + grade_bw == grade_aw`**，且两个分量各自零和。
+> 之所以必须在算钱时就拆，是因为两个 `N` 一旦相加就再也分不开——事后无法从 `grade_aw` 反推各自占比。
+
+**account（大局结算包）**
+
+> 仅当打到最后一局（`o_paiju.idx >= o_room.asetcount`）或房间中途解散（解散结算）时，`jiesuan` 包才会带上此分组；普通的中间局结算包没有 `account` 字段（`class.paiju.js` `get_paiju_account`）。
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| account | 数组 | 玩家列表（长度 3，下标 = 座位序号），元素结构见下 |
+
+```json
+[
+  { "score": 0, "grades": [], "grade_jf_total": 0, "grade_cg_total": 0, "grade_bw_total": 0 },
+  { "score": 0, "grades": [], "grade_jf_total": 0, "grade_cg_total": 0, "grade_bw_total": 0 },
+  { "score": 0, "grades": [], "grade_jf_total": 0, "grade_cg_total": 0, "grade_bw_total": 0 }
+]
+```
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| score | 整数 | 累积总分（全部小局 `aset.seatlist[i].grade` 之和） |
+| grades | 数组 | 每局总分列表，按局序 |
+| grade_jf_total | 整数 | **基础分**累计：各局 `grade_jf`（捡分子数得分）之和 |
+| grade_cg_total | 整数 | **冲关分**累计：各局 `grade_cg` 之和（design §8.1，**不含**傍王） |
+| grade_bw_total | 整数 | **傍王分**累计：各局 `grade_bw` 之和（design §8.3；未勾傍王时恒 0） |
+
+> 恒等式：`grade_jf_total + grade_cg_total + grade_bw_total == score`，供大局结算面板分项展示（基础分 / 冲关分 / 傍王分 / 总分）。
+>
+> ⚠️ **结构变更（2026-08-26）**：原为 `[[累积得分, [每局得分...]], ...]` 的二元数组，现改为**对象数组**并增加三项分解。数组下标语义不清，且前端尚未开工，此时改代价最小。
+
+---
+
+## 15. 准备（zhunbei，客户端→服务器）
+
+发包者：游戏　收包者：服务器　app：youle　route：erqiwang　rpc：zhunbei
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| agentid | 字符 | 代理id |
+| playerid | 整数 | 玩家id |
+| gameid | 字符 | 游戏id |
+| roomcode | 整数 | 房间号 |
+| seat | 整数 | 位置序号 |
+
+---
+
+## 16. 准备（zhunbei，服务器→客户端）
+
+发包者：服务器　收包者：游戏　app：youle　route：erqiwang　rpc：zhunbei
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| seat | 整数 | 位置序号 |
+
+---
+
+## 断线重连（deskinfo）
+
+> 由平台在玩家进入房间/断线重连时回调 `youle_erqiwang.export.get_deskinfo(o_room, seat)` 生成并下发（服务器→客户端）；下发的 app/route/rpc 由平台的进房/重连流程决定，不在本子游戏代码内固定。平台把它挂在 `pack.data.deskinfo` 下，**`data.success` 由平台填写、子游戏不注入**（见 0.4）。下列字段即该函数返回的 `deskinfo` 对象结构，按当前 `paiju.step` 只带对应阶段的分组。
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| count | 整数 | 总局数 |
+| idx | 整数 | 当前局数 |
+| PlayerInfo | 数组 | 三个玩家目前的总积分 `[0,0,0]` |
+| step | 整数 | 牌桌状态：1发完牌叫分 2选主/投降 3埋牌 5出牌 6结算（无独立投降阶段——投降在 step2 与选主互斥；埋牌后直接进入 step5 出牌） |
+| MyCards | 数组 | 自己手上的牌 |
+
+**CallRun（不在叫分阶段无此属性）**
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| seat | 整数 | 当前叫分位置 |
+| countdown | 整数 | 叫分倒计时 |
+| nowcall | 整数 | 当前叫分 |
+| multiple | 整数 | 叫分对应的基础子数 `get_base_bycall(call, climb)`，**随房间「爬坡」开关取值**（roomtype 位4）：常规算子 65→2 60→3 55→4 50及以下→6；爬坡 65→2 60→3 55→4 50→6 45→7 40→8 35→9 30→10 25→11 20→12 15→13 10→14 5→15；两种模式下 70→2；无叫分→0。与结算包 `aset.multiple` 同源同值（design §7.1/§7.3.1）|
+| call | 数组 | 三家叫分 `[null,0,65]`，null还未叫分，0不叫，>0叫了多少分 |
+
+**ChooseMain（step 2 选主/投降阶段，不在此阶段无此属性）**
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| seat | 整数 | **控制权**：此刻轮到谁操作——恒为 `banker`（选主与投降都只由庄家做）。字段名与 `CallRun.seat` 一致：**各阶段分组里的 `seat` 统一表示「轮到谁」**。与增量推送 `shangzhuang.nextseat` 同源同值；客户端据此设控制权，**不要自己用 `banker` 反推**（那是把「选主=庄家」这条规则搬到前端）|
+| banker | 整数 | 庄家 |
+| call | 整数 | 叫分 |
+| multiple | 整数 | 叫分对应的基础子数 `get_base_bycall(call, climb)`，**随房间「爬坡」开关取值**（roomtype 位4）：常规算子 65→2 60→3 55→4 50及以下→6；爬坡 65→2 60→3 55→4 50→6 45→7 40→8 35→9 30→10 25→11 20→12 15→13 10→14 5→15；两种模式下 70→2；无叫分→0。与结算包 `aset.multiple` 同源同值（design §7.1/§7.3.1）|
+| countdown | 整数 | 选主倒计时 |
+| bottomcards | 数组 | 8 张**底牌**（发牌留桌的 8 张），**只有庄家有此属性**（底牌仅庄家可见；70 分的 3 秒亮牌是上庄时的一次性事件，重连不重放）。顺序取发牌时冻结的快照，与 `shangzhuang.bottomcards`、`BuryCards.bottomcards` **完全同序**（见 §4）|
+| touxiang | 整数 | 是否允许投降 0：不允许 1：允许（仅 70 分坐庄为 1）。投降与选主互斥、同一决策点，见 touxiang 包与 design §4 |
+| curmultiple | 整数 | **当前抓分倍数**（design §7.2.0）：**带符号**，与 `shangzhuang.curmultiple` 同源同值。选主阶段一张牌都还没出、捡分恒为 0，故**必为 `3`**（大光）。三家同值。有此字段，重连后顶部「抓分」角标才不会掉回 0 |
+
+> 选主阶段前端需在每个花色按钮上显示"该花色在庄家手中的对子数"（design §4/§11）——庄家的完整手牌由 `MyCards` 提供（庄家为 36 张），对子数由前端据此计算，服务端不额外下发。
+
+**BuryCards（step 3 埋牌阶段，不在此阶段无此属性）**
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| seat | 整数 | **控制权**：此刻轮到谁操作——恒为 `banker`（埋牌只由庄家做）。与增量推送 `xuanzhu.nextseat` 同源同值 |
+| banker | 整数 | 庄家 |
+| call | 整数 | 叫分 |
+| multiple | 整数 | 叫分对应的基础子数 `get_base_bycall(call, climb)`，**随房间「爬坡」开关取值**（roomtype 位4）：常规算子 65→2 60→3 55→4 50及以下→6；爬坡 65→2 60→3 55→4 50→6 45→7 40→8 35→9 30→10 25→11 20→12 15→13 10→14 5→15；两种模式下 70→2；无叫分→0。与结算包 `aset.multiple` 同源同值（design §7.1/§7.3.1）|
+| flower | 整数 | 主牌花色 |
+| countdown | 整数 | 埋牌倒计时 |
+| bottomcards | 数组 | 8 张**底牌**（发牌留桌的 8 张），**只有庄家有此属性**（底牌仅庄家可见；70 分的 3 秒亮牌是上庄时的一次性事件，重连不重放）。顺序取发牌时冻结的快照，与 `shangzhuang.bottomcards`、`ChooseMain.bottomcards` **完全同序**——**不**按本局主牌花色重排（见 §4）|
+| curmultiple | 整数 | **当前抓分倍数**（design §7.2.0）：**带符号**，与 `shangzhuang.curmultiple` 同源同值。埋牌阶段同样一张牌未出、捡分恒为 0，故**必为 `3`**（大光）。三家同值 |
+
+> 埋牌阶段无投降（投降是 step2 与选主互斥的选择，选主后即不可再投降）。
+
+**PushCards（step 5 出牌阶段，不在此阶段无此属性）**
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| banker | 整数 | 庄家 |
+| call | 整数 | 叫分 |
+| multiple | 整数 | 叫分对应的基础子数 `get_base_bycall(call, climb)`，**随房间「爬坡」开关取值**（roomtype 位4）：常规算子 65→2 60→3 55→4 50及以下→6；爬坡 65→2 60→3 55→4 50→6 45→7 40→8 35→9 30→10 25→11 20→12 15→13 10→14 5→15；两种模式下 70→2；无叫分→0。与结算包 `aset.multiple` 同源同值（design §7.1/§7.3.1）|
+| flower | 整数 | 主牌花色 |
+| countdown | 整数 | 出牌倒计时 |
+| burycards | 数组 | **埋牌底牌**（庄家埋下的 8 张），只有庄家有此属性。注意与 `ChooseMain`/`BuryCards.bottomcards`（**底牌**）是两批不同的牌，见 §0.0。与 `maipai.burycards` **同源同序**（同一个 `get_burycard()`，按本局主牌花色从大到小）|
+| grade | 整数 | 当前的捡分分数 |
+| gradecards | 数组 | 当前的捡分分牌，只有闲家有此属性 |
+| playproc | json | **本轮进行态**，与 `chupai1/2/3.playproc` **同源同结构**（服务端同一个 `get_playproc()` 快照函数，见 [§11 `playproc`](#11-第一个玩家出牌chupai1)）：`round` 第几轮、`start` 本轮首出位置、`currseat` 当前出牌位置、`startcount` 首出张数、`startflower` 首出花色、`starttype` 首出牌型、`maxseat` 本轮最大者位置、`maxcard` 最大牌编码、`cards` 本轮三家各自出的牌（**定长 3**，下标=位置序号，未出为 `null`）、`shuai_demand` 首家甩牌的分量需求 `{tractors:[连对数...],pairs,singles}`（非甩牌为 null，供跟牌逐分量强制匹配，design §5.4.4）。**两种查牌模式下恒有此属性**——`cards` 是当前这一轮桌面上的牌，不属于「查牌」，屏蔽了后出的人就无从跟牌（design §9 末尾）|
+| baozhu | 整数 | 是否已有玩家报无主（主牌出空）0否 1是，**恒有此属性**；与 `chupai1/2/3` 的 `baozhu` **同源同值同门控**（同一个 `have_baofu()` + 同一个查牌位）。它是**余主公示**与“明牌”按钮的开关，重连必须一并恢复，否则重连后按钮凭空消失；**不查牌模式恒为 0**（design §9）|
+| seatlist | 数组 | 三家座位牌况，与上文 `maipai` / `chupai1/2/3` 包的 `seatlist` 同名同结构（每个玩家一个 5 元素数组：4 个花色的 `[无该花色,无对]` + 报副 `[剩余主牌数,剩余主对数]`）。**仅可查牌模式下有此属性**（design §9）|
+| liangpai | json | **亮牌**，结构同 maipai 包的 `liangpai`（`{ cards: [牌id...] }`）；**仅可查牌模式、且请求者为闲家、且庄家达标时有**（供闲家重连后仍能看到，design §8.2）|
+| pushlist | 数组 | 出牌历史 `[[[], [], []], [[], [], []], ...]`，外层下标=轮次（从第 1 轮起，含进行中的当前轮），内层**恒为 3 个数组**、按位置序号存该轮各家出的牌id。**每一手与当时那个 `chupai1/2/3` 包的 `cards` 逐元素完全相等**（同一份数据、同一个顺序口径，见 [§0.6](#06-一手出牌的顺序口径)），因此前端“增量回放”与“重连重建”得到的出牌历史必定一致。**仅可查牌模式下有此属性**——往轮打出、已被收走的牌属于「查牌」范畴，不查牌模式一律不下发（design §9）。注意当前这一轮桌面上的牌由 `playproc.cards` 恢复，**两种模式下都有**，否则后出的人无从跟牌 |
+| curmultiple | 整数 | **当前抓分倍数**（design §7.2.0）：**带符号**，与 `chupai1/2/3` 同源同值，供重连后顶部「抓分」角标与判定动画状态立即正确 |
+| mustcard | 数组 | **本轮跟牌的必出牌**（design §5.2）。**仅当 `playproc.currseat == 请求者座位` 时才有**，且只算请求者自己的手牌；未轮到本家、本轮首家、甩牌局面、必出牌为空时均无此属性 |
+
+**Balance（不在结算阶段无此属性）**
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| readystate | 数组 | 所有玩家的准备状态 |
+| aset | json | 单局结算包，同上面结算包中的 `aset`，只有当自己的准备状态为0时才有此属性 |
+| bottom | json | **抠底包**，结构同 §14 的 `bottom`，与该局 `jiesuan` 推送的 `data.bottom` **同源同值**（服务端在 `get_paiju_account` 末尾冻结的同一份快照）。**仅正常出牌结算才有**（投降/解散没有抠底这一步）；同样受「自己的准备状态为 0」门控。<br>**为什么必须有**：结算面板还开着时断线重连/硬刷新，只恢复 `aset` 会让抠底明细整块空白——同一份数据两条路径给的不一样（server 红线「发全下发面」）。<br>**可见性**：埋牌底牌在本局结算时已随 `jiesuan` 广播给三家（design §11 结束亮底），此处不构成额外泄露 |
+| account | json | **大局结算包**，结构同 §14 的 `account`，与该局 `jiesuan` 推送的 `data.account` **同源同值**。**仅末局或中途解散才有**，与 `jiesuan` 的取舍完全一致（有就带、没有就不带）|
+
+---
+
+## 战绩（大局列表）gameinfo1
+
+> 非客户端收发包：大局结束/解散时由 `class.desk.js` `get_desk_account` 组装，经 `import.save_grade(o_room, o_gameinfo1, o_gameinfo2, 1)` 传给平台战绩服务持久化（服务器→平台）。
+
+| 参数名 | 类型 | 说明 |
+| --- | --- | --- |
+| roomcode | 整数 | 房号 |
+| asetcount | 整数 | 实际局数 |
+| createtime | 字符 | 开房时间 |
+| makewartime | 字符 | 开战时间 |
+| players | 数组 | 玩家列表，元素结构见下 |
+
+`players` 数组元素结构：
+
+```json
+{
+  "seat": 0,          // 座位
+  "playerid": 100001, // 玩家ID
+  "name": "",         // 昵称
+  "avatar": "",       // 头像
+  "score": 0          // 成绩
+}
+```
+
+---
+
+## 战绩（大局）gameinfo2
+
+> 非客户端收发包：与 gameinfo1 同批，由 `import.save_grade` 的第 3 个参数传给平台战绩服务（服务器→平台）。
+
+牌局列表，数组元素结构：
+
+```json
+{
+  "starttime": "",        // 开始时间
+  "endtime": "",          // 结束时间
+  "seatlist": [6, -6, 0], // 玩家成绩
+  "callproc": [],         // 叫分过程，详情见代码中的注释
+  "banker": 0,            // 庄
+  "call": 0,              // 叫分
+  "flower": 0,            // 主牌花色
+  "result": 0,            // 牌局结果
+  "cards": []             // 发牌出牌情况，详情见代码中的注释
+}
+```