二七王:庄家算奖统一口径为「冲关」
design §8.1 的「常规算奖」全面改称「冲关」,与服务端既有字段 chongguan、 界面「冲关分」「冲关牌型」对齐。理清三层关系并写进三份文档的术语表: 冲关 = §8.1,只计庄家(旧称常规算奖) 傍王 = §8.3,可选,庄闲都算 算奖 = 上位概念 = 冲关 + 傍王 → naward(总奖数)、grade_aw(算奖得分) 「算奖」作为上位概念保留——naward / grade_aw / §8.4 的结算模型都建立在 合并概念之上,去掉它这些字段无从命名。故未做无差别替换,而是逐处甄别: 指 §8.1 的改冲关,指合计的留算奖。 design:17 处「常规算奖」→「冲关」,另修正 §7.0 第 4 层一处笔误 (「8.2 傍王」应为「8.3 傍王」,§8.2 是亮牌);§8.1 开头加改名说明。 protocol:新增 §0.0c 算奖层级表;chongguan / naward / grade_aw 注释同步。 前端清单:界面文案与精灵键名统一(算奖牌型→冲关牌型、BTN_AWARD_CARDS→ BTN_CG_CARDS、AWARD_*→CG_* 等),§0.0 补层级表。 据更新后的 小局结算.png:「算奖分」→「冲关分」、「算奖牌型」→「冲关牌型」。 参考图 算奖牌型显示.png 已随之更名为 冲关牌型显示.png,文档 6 处引用同步; 已逐一核对 16 张图的文件名在文档中都能对上。 顺带记录一处标签不严谨:小局结算的「冲关分」取的是 grade_aw,而后者是按 合计后的 N 算出来的。没开傍王时两者相等;开了傍王时该数含傍王贡献,叫 「冲关分」偏窄。根因与 S-6 同源(两分量算钱前已合并、事后拆不开),待 S-6 落地后此标签才名副其实。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -39,6 +39,19 @@
|
||||
另有一组「底」字族专管发牌留桌的那 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`**(布尔):
|
||||
@@ -451,11 +464,11 @@
|
||||
|
||||
```json
|
||||
{
|
||||
"cards": [], // 算奖相关牌(王/冲关牌)列表
|
||||
"chongguan": 0, // 常规算奖奖数(只有庄家才计入自己的 N)
|
||||
"cards": [], // 冲关牌型:参与冲关的牌(王 + 冲关组合牌)列表,供「冲关牌型」界面展示
|
||||
"chongguan": 0, // 冲关奖数(design §8.1,旧称"常规算奖";只有庄家才计入自己的 N)
|
||||
"wang": 0, // 手牌中的王数(傍王按此计奖)
|
||||
"naward": 0, // 该家总奖数 N =(庄家?常规算奖:0)+(傍王?王数:0)
|
||||
"grade_aw": 0, // 算奖得分 = X×(2Ni−Nj−Nk),X 为每对子子数
|
||||
"naward": 0, // 该家总奖数 N =(庄家?冲关奖数:0)+(傍王?王数:0)
|
||||
"grade_aw": 0, // 算奖得分 = X×(2Ni−Nj−Nk),X 为每对子子数。注意这是【冲关 + 傍王合计】后的结果,两个分量事后拆不开(见 §0.0c)
|
||||
"grade_jf": 0, // 捡分子数得分
|
||||
"grade": 0, // 本局总分 = grade_aw + grade_jf
|
||||
"score": 0 // 累计得分
|
||||
|
||||
Reference in New Issue
Block a user