daoqi/erqiwang_youle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
40 Commits 1 Branch 0 Tags
c4256c51dbacd85aca4ec89e206c1806a7321a1d
Commit Graph
40 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
joywayerandClaude Opus 5 c4256c51db 二七王合规文档：修正"全部符合"结论并补第三轮核对 
01 的「二次全量复核结论」写的是「服务端全部符合 design.md」，但该
轮核对完全按 design 章节组织，平台接入、客户端入参校验、下发面一
致性、协议红线这几类问题整类不在范围内——所以 270 项断言全绿的同
时，漏掉了 1 项阻断级（子游戏从未在 app.js 注册，运行时不可达）、
3 项严重（重复牌id 可伪造牌型、入参无类型校验、下发面 multiple 忽
略爬坡）与 data.success 红线缺失。

本次：
- 01 把结论限定为「就 design.md 的玩法规则维度而言符合」，并加警示
  「符合 design.md ≠ 实现完整正确」。
- 01 新增「第三轮核对」章节：A1/B1/B2/B3/C1/D1~D7 共 11 项的严重
  度、位置、实测现象与处置，并单列两项需外部输入的待办（D3 超时托
  管无定时器、D6 不查牌模式是否屏蔽出牌历史的规则歧义）。
- 02 测试计划更新断言总数 270→357，新增「第三轮补充：design 之外
  的可验证维度」覆盖表（入参校验/重复id/报无主刷新/success 成功包
  与失败回包/multiple 同源/甩牌下发面/pushlist 结构/相邻链花色），
  并写明两项仍无自动化覆盖的原因。
- 00 加一段说明前两轮的核对范围局限，指向 01 第三轮。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-12 04:25:15 +08:00
joywayerandClaude Opus 5 a049498f2c 二七王协议文档：补齐 success/errcode 约定并同步本轮字段变更 
协议文档开头一直写着「成败判定只看推送包里的 data.success」，但下
面没有任何一个包定义过该字段，代码里也没有——文档自相矛盾且与实
现不符。本轮代码补齐后同步文档：

- 新增「0. 通用约定」：0.1 所有服务器→客户端包必带 data.success；
  0.2 失败回包（rpc 与请求同名、只回请求者、success=false+errcode）
  与 errcode 取值表，另附 cards 牌id 入参约束（非空数组、0~107 整
  数、不重复，不做类型兜底）与 tishi 成功不回执的例外；0.3 说明
  deskinfo 的 success 归平台填写。
- 6 处 multiple 描述改为 get_base_bycall(call, climb)，列出爬坡与
  常规两套取值，并注明与结算包 aset.multiple 同源。
- chupai1 补 shuai 字段；cardtype 补完整取值说明与「甩牌会被压平、
  真实结构读 shuai」的告警。
- 3 处 info 描述补「有人报无主后三个座位同时刷新」。
- PushCards.pushlist 描述补「内层恒 3 个座位、按本局主牌花色排序」。
- mingpai / tishi 的「否则忽略」改为按 0.2 回对应 errcode 的失败包。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-12 04:22:53 +08:00
joywayerandClaude Opus 5 8948a2950f 二七王：chupai1 下发甩牌分量构成 shuai 
cardtype 只能表达单一牌型（1xx 单张 / 2xx 对子 / 3xx 拖拉机），而
甩牌是单张、对子、拖拉机自由混搭（design §5.4.3），会被 can_playcard
的牌型推导压平——例如「主K对 + 主5」得到 103、「两连对 + 散对」得到
203，客户端拿到 cardtype 无从还原分组，甚至看不出这是一次甩牌。

服务端本就已经算出了分量需求 shuai_demand（供跟牌逐分量强制匹配，
design §5.4.4），按「每个下发包必须携带前端界面所需的全部核心数据」
一并下发：chupai1 在合法甩牌时带 shuai = {tractors,pairs,singles}，
非甩牌与甩错退化为单张时不带此属性。

test_rpc 新增 8 项：合法甩牌带 shuai、非甩牌不带、甩错只打最小一张
且不带 shuai。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-12 04:21:11 +08:00
joywayerandClaude Opus 5 4276d38267 二七王：报无主后立即为全体三人刷新主牌统计 
design §9：「一旦有玩家的主牌全部打空，系统就为全体三人显示另外
两家各自的主牌数量、以及这些主牌里有多少对子」。

原实现只在出牌者自己出牌时更新自己那一格 seatlist[seat][4]，所以
A 打空主牌报无主的那一刻，B、C 的主牌数/对子数仍是初始 [-1,-1]，
要等各自轮到出牌才补上，界面最多滞后两次出牌才完整。

改为：出牌后先判定出牌者主牌是否出空，一旦 have_baofu() 成立，就
按各家实际手牌为三个座位统一重算 [剩余主牌数, 剩余主对数] 及主花
色标志。重算幂等——主牌一旦出空不会再有，[4][0] 恒为 0。

test_rpc 的 mkChupai 原先只把 seatlist[1][4][0] 置 0 伪造报无主，
而不真的清空 seat1 的主牌；新逻辑按实际手牌重算会把这个假状态纠
正回去，导致 baozhu 断言失败。这是新实现更严格的正确表现，故改测
试造真状态（把 seat1 的主牌标为已出），不是放宽断言。

test_input 新增 6 项：报无主前三家均为 [-1,-1]；打空瞬间三家统计
与主花色标志同时刷新到实际值。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-12 04:20:03 +08:00
joywayerandClaude Opus 5 84774fa525 二七王：修正重连出牌历史 pushlist 的结构与排序 
get_deskinfo 的 PushCards.pushlist 排序段有两处错：

1. 内层循环上界误用 pushlist.length（轮次数）当座位数。轮次 >3 时
   会给内层数组写入下标 3..轮次-1，把本应恒为 3 个座位的数组撑成
   轮次长度并填满 undefined；轮次 <3 时又漏排后面的座位。实测 5 轮
   时内层长度变成 5 且含 undefined。
2. 排序传的是上一个 for 循环泄漏出来的 pai.flower。循环结束后 pai
   指向牌表最后一张（大王，flower=5），等于按「无主牌花色」排序，
   主牌不会排到副牌前面。

改为内层固定 3 个座位、按 paiju.flower 排序，并对缺失轮次加守卫。

test_rpc 新增 4 项：轮数、内层恒 3、无 undefined，以及排序判别用例
（seat0 同轮出「主5 + 副♥A」，主5 必须在前——旧代码下 副A 会排前）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-12 04:18:30 +08:00
joywayerandClaude Opus 5 5832b781c8 二七王：is_continuous 的 8→6 相邻补花色校验 
design §5.3 的「6 与 8 可组成拖拉机」是同花色内的相邻关系，但
is_8/is_6 只判 code % 100，不校验花色，导致
is_continuous(♥8=308, ♣6=206) 与 is_continuous(主8=1408, ♣6=206)
都返回 true。

影响面：get_chongguan 是唯一会拿整手牌（含各花色副牌）去扫描连对
链的调用点，连对链走到主 8 之后，手里任意花色的一对 6 都会被误判
为连续、多算 1 奖，并把链锚点带进副牌继续错误延伸（design §8.1
明确 A 到 5 这一段必须是选定花色的主牌）。其余调用点入参都是同花
色牌表或纯主牌表，不受影响。

改为要求牌编码相差 2（同花色的 8 与 6 恒差 2，跨花色差 100 的倍
数），并保留 is_8/is_6 守卫以免把「主A-主Q」这类差 2 组合放行。

test_arith 新增 5 项：同花色 8-6 连、三组跨花色 8-6 不连、差 2 但
非 8/6 的组合不连。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-12 04:17:32 +08:00
joywayerandClaude Opus 5 20b5425a65 二七王：下发面 multiple 按房间「爬坡」开关取值 
arith.get_multiple_bycall 写死 get_base_bycall(call, false)，被
mod.jiaofen（jiaofen/shangzhuang 两个包）与 export.get_deskinfo
的叫分/选主/埋牌/出牌四个阶段共 6 处使用，且都不传 roomtype。

后果：爬坡房里对局全程界面显示的是常规算子子数，与结算包
aset.multiple 不符。例如叫 45 分，界面显示 6 个子、结算按
design §7.3.1 实际是 7 个子。违反 server dev-guide「服务器权威 +
每个下发包必须携带前端界面所需的全部核心数据」与 engineering
SSOT（同一业务数据只有一个计算处）。

移除 get_multiple_bycall 这层写死 climb=false 的兼容包装，全部
改为直接调 get_base_bycall(call, cfg.climb)，cfg 由
class.config.parse(o_room.roomtype) 得到——与结算处
get_paiju_account 用的是同一个取值入口。get_deskinfo 内顺带复用
同一份 cfg，去掉 PushCards 分支里重复解析 roomtype 的调用。

test_rpc 新增 7 项：叫 45 分在常规房/爬坡房分别驱动到上庄，断言
上庄包与重连 ChooseMain 的 multiple 为 6/7，并与结算包
aset.multiple 逐一对齐。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-12 04:16:42 +08:00
joywayerandClaude Opus 5 c2a375eef5 二七王：补齐 data.success 成败标志与失败回包 
此前全仓（除协议文档开头一句说明外）没有任何下发包携带
data.success，且所有失败路径一律裸 return、不回任何包：前端点了
没反应，只能干等倒计时，同时违反 server dev-guide「成败标志唯一
是 data.success，主动推送的 data 必须自带 success」与 client
dev-guide「发包只请求、收包才表现」两条硬红线。

本次：
- 成功包一律补 data.success=true：fapai、zhunbei（class.desk.js）、
  jiaofen、shangzhuang、xuanzhu、maipai、chupai1/2/3、mingpai、
  tishi（mod.js），jiesuan 在 get_paiju_account 统一注入（覆盖
  正常/投降/解散三种结算来源）。
- 新增 youle_erqiwang.ERR 失败码表与 do_sendfail 统一回包封装：
  PLAYER/NODESK/STEP/SEAT/PARAM/RULE，失败只回发给请求者
  （conmode/fromid 取自请求包），data.success=false + errcode。
- 每个 handler 的每条失败分支都改为「回失败包 + return」，含
  check_player 不通过（平台侧只返回 null、不回包，前端会干等）。

tishi 成功时仍按 design §11 只转发给对家、不给发送者回执（该包不
含对局状态，属 fire-and-forget 提示），失败才回给发送者。

test_rpc 中原先以「不发包」表示被拒的断言，同步改为断言「恰好回
1 个 success=false 且 errcode 正确的包」——是随行为修正而加强，
不是软化。新增 test_success.js 29 项覆盖成功包 success 字段与各
handler 失败回包。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-12 04:15:31 +08:00
joywayerandClaude Opus 5 a4a8eb8408 二七王：补齐客户端牌id入参校验（重复/越界/非数组） 
check_cards_inhand 此前只逐个校验牌id是否在手上，不查重复、不查
类型与范围，且在牌已出/已埋时 return 空值而非 false，造成两个可
被利用的缺陷：

1. 重复牌id 可伪造牌型：do_playcard([方块K,方块K]) 实测返回
   result=true、cardtype=201（同一张牌被判成一对），可进而伪造
   拖拉机与甩牌分量，本轮结算时该分牌的 score 还会被重复累加。
2. 埋牌传 8 个相同 id 实测只埋下 1 张，庄家带 35 张进入出牌阶段，
   整局牌数错乱。
3. 越界 id 或非数组入参会在解引用处抛异常，中断 DoPack。

新增 check_cards_valid 作为唯一入参校验入口（非空数组、元素为本
局牌表内的整数牌id、互不重复），由 check_cards_inhand 先行调用；
mod.maipai/mod.chupai 在读取 cards.length 之前先过该校验。按
engineering §03「显式失败优于隐式兜底」直接拒绝，不做类型兜底。

新增 test_input.js 28 项正/反/边界用例回归上述三点。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-12 04:10:15 +08:00
joywayerandClaude Opus 5 391dffc04a 二七王接入平台：在 youle/app.js 注册 games/erqiwang/mod.js 
此前 app.js 只加载了 games2/jinxianmahjong/mod.js，全仓平台侧对
erqiwang 零引用，导致 youle_erqiwang 模块从不创建、pack.route
="erqiwang" 无法命中三层路由，整个子游戏服务端运行时不可达。

按 server dev-guide README「接入新游戏还需在 server/youle/app.js
里加一行 min_loadJsFile 加载其 mod.js」补上注册（该文件是唯一允许
触碰的平台文件，属游戏注册接入点）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-12 04:08:20 +08:00
joywayer 5c51f647d0 先关闭githooks 2026-08-11 22:18:22 +08:00
joywayer 3b7c103387 模板工程升级修改 2026-08-11 22:17:54 +08:00
joywayer 047561675b 新规hook 2026-07-06 17:16:05 +08:00
joywayerandClaude Opus 4.8 363f97cdbe 文档修复：移除指向不存在文件的失效链接引用 
client/02、client/03 中指向 docs/important/client/友乐游戏引擎精灵与资源管理接口规范.md
（该文件不在仓库）的 markdown 链接改为纯文字规范名，保留文意、去除失效链接。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 22:51:28 +08:00
joywayerandClaude Opus 4.8 f776e4c817 文档修复：校正开发指南编号与失效交叉引用 
- CLAUDE.md：前端指南编号由「01→05」订正为「01→06」（06 子游戏接入模式实存且已被本文件他处引用）；删除已过期的 server/docs 旧副本警告（该旧副本已从工作树删除）。
- 两份 development-guide README + 各章节正文：将旧路径 server/docs/development-guide、client/docs/development-guide 统一订正为 docs/server、docs/client；docs/engineering 订正为 docs/games/engineering。
- 客户端 README 阅读顺序补齐缺失的 06 篇。
- 服务端 README 移除指向不存在的 docs/important/server 的条目。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 22:39:37 +08:00
joywayerandClaude Opus 4.8 9456ab9319 二七王：实现 §11 闲家三提示(踩/没分/有分) + 明确副7/副2 成对语义 
全面符合性再审查(4 维度独立对抗核对)结论：与计分/发牌/出牌/跟牌/甩牌
相关规则均一致，无缺陷；仅 §11 闲家三提示服务端缺失、副7/副2 异花色
成对语义存疑两项待办。本次按用户裁定落地：

1. §11 三提示（新增 mod.tishi）：闲家在出牌阶段(step5)发 踩/没分/有分，
   服务端不校验真实性、只 SendPack 转发给对家(另一闲家 3-banker-seat)；
   庄家无对家不参与；非法 tip/非出牌阶段/庄家发均拒。
   协议补 packet_protocol §13.7/13.8；test_rpc +11 例(正反+边界)。
2. 副7/副2 成对语义：裁定"只同花色同点数两副成对"(代码本已如此，无需改)，
   在 design §3 补说明闭合该反复出现的存疑（异花色副7 不成对）。

compliance 文档同步：§11 状态转✅、首轮结论摘要加"非当前状态"说明、
计数 259→270。全套 270 项断言全绿(rpc 34→45)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 16:39:04 +08:00
joywayerandClaude Opus 4.8 5c9a78029a 二七王测试计划：同步跟牌覆盖度修复后的计数与状态 
test_follow 由 35→50 例、全套 244→259 项；§5.1/5.2 覆盖状态由"❌重大
缺口"更新为✅（含混合出牌、毙牌完全缺门、降级递归 else 欠约束修复回归）。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 07:19:23 +08:00
joywayerandClaude Opus 4.8 21e76b976a 二七王修复：拖拉机跟牌降级递归 else 分支欠约束（放行非法跟牌） 
get_followcard 降规格递归中，当某级"等长短拖拉机候选总对数 > 剩余需求"
时（class.arith.js else 分支），因 cantype 单一结构模型无法表达"任选其一
成拖拉机、其余自由"，直接返回宽松的"任意 N 对"，导致跟牌方明明有 2 连对
却被允许只出三个孤立对子（如首家 3 连对、跟牌方 AA KK JJ TT 88 66 时打
AA JJ 88），违反 design §5.2"能凑多长拖拉机就必须先凑多长"。

方案 2（根治，不引入过约束）：在 can_followcard 结构校验后新增"最大拖拉机
覆盖度"闸门 follow_tractor_cover_ok——
- tractor_run_lengths：把同花色对子按相邻拆成连对 run 长度表；
- max_tractor_profile：贪心最长优先取 K 对，得字典序最大规格档案 best；
- profile_less：跟牌自身档案 got 不得字典序劣于 best，否则拒。
仅在"跟牌整手=首家花色对子且该花色牌≥首家张数"时生效，垫/混合/对子不够
等一律放行。can_followcard 是唯一出牌闸门(paiju.js:605)，覆盖人工+托管。
get_followcard else 分支加注释指明由该闸门兜底。

回归测试：test_follow.js +5 条（303/304 三组 2 连对场景，含 else 欠约束
回归：出孤立对→拒、出尽量长拖→合法）。全套 259 项断言通过。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 07:18:42 +08:00
joywayerandClaude Opus 4.8 cab66bea01 二七王测试：固化 垫牌/混合出牌 回归用例（代码本已正确） 
对应 design.md 新成文的 垫牌(对子/拖拉机首家)与混合出牌概念。经探针
核对，can_followcard 早已让混合牌/垫牌 cardvalue=0、不争夺出牌权，
正式代码无需改。此前仅单张垫牌有覆盖、混合出牌零覆盖，现补 10 条：
- 垫：对子/拖拉机缺门出副牌散张，合法且 beat=false
- 混：有该副花色但不够、只能补主牌 → 合法、beat=false（等效垫牌），
  丢下必出的副牌只出主牌→拒；含"有对也压不过"边界
期望值取自 design 规则（不争权/须先出该花色），全套 254 项通过。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 07:02:43 +08:00
joywayerandClaude Opus 4.8 1edbe9cc24 二七王规则：新增"混合出牌"概念（副牌不够+补主牌，等效垫牌） 
场景：首家出副牌、跟牌方有该花色副牌但张数不够、又无其他副牌可垫，
只能用主牌补差额，打出"副牌+主牌"混合。核对 can_followcard：混合牌
组不成纯主牌牌型，cardvalue=0，压不过首家。此前文档未成文——补入
术语表并在 §5.2 数量不足段落指向，明确它既非垫牌也非毙牌、但与垫牌
等效、不争夺出牌权。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 06:58:25 +08:00
joywayerandClaude Opus 4.8 55db22f4b1 二七王规则：明确 §5.2 同花色牌数量不足时缺口补牌规则 
原第 150 行仅笼统一句"缺口部分可任意补其他牌"，未针对"首家出拖拉机"
点破缺口不必成对/成拖拉机，且易与层级 4(同花色够、对子不够→补同花色
单张)混淆。按 get_followcard 数量不足分支(cantype 落单张型、只校验张数)
改写为：该花色牌全部必出，缺口用任意其他花色牌补、不强制成对/成拖拉机，
并与"完全缺门"情形分段。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 06:48:38 +08:00
joywayerandClaude Opus 4.8 83545e8b80 二七王规则：修正 §5.2 毙牌成立条件为"完全缺门" 
原第 156 行写"没有该副牌花色的同长度拖拉机"即可毙，暗示手里有该
花色的牌但不成拖拉机时也能用主牌毙——与代码不符。核对
class.arith.js can_followcard：毙牌成功(cardvalue>0)仅出现在完全
缺门分支，只要手中还有首家花色的牌，get_followcard 即判为必出，
只能垫不能毙。将三条特殊情况统一收紧为"完全缺门"，并补前提说明。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 06:36:57 +08:00
joywayerandClaude Opus 4.8 93449c8a92 二七王规则：按代码实际行为补全 §5.2 拖拉机跟牌的强制降级层级 
design.md §5.2 原本只描述"两连对"最简情形，缺少 3 连对及以上的
强制层级。按 class.arith.js get_followcard 的实际实现补写为完整
优先级表：同长拖 > 更短拖拆凑 > 对子够 > 对子不够全出+补 > 单张补；
并修正对子行"同花不足两张必出现有同花"的措辞。§5.4.4 甩牌跟牌
加一句交叉引用，点明与正常跟牌共用同一层级原则。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 06:16:50 +08:00
joywayerandClaude Opus 4.8 0d9ea36c10 二七王测试：穷举跟牌方手牌分支，补主牌首出与拖拉机各分支 
回应"是否模拟了跟牌方所有手牌与边界"的核对，补齐：
- 主牌首出的跟牌（单/对）——原仅测副牌首出
- 对子首出·同花色仅1张（必出它+补1张）
- 拖拉机首出的跟牌方分支：对子不够(出仅有的对+补)、同花无对(补同花)、
  多候选拖拉机(cantype=3xx，回归 can_followcard 曾崩溃的 D1 分支)、
  3连对首出、富余对子中必出3连拖/拆散拒
- 手牌数==首出张数（全部必出）

全部单测 244 项断言全绿（test_follow 35）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 01:51:58 +08:00
joywayerandClaude Opus 4.8 c29aec140c 二七王测试：补全甩牌/跟甩牌全部情形 
回应"甩牌与跟甩牌测试是否完整"的核对，补齐缺口：
- 甩牌首出(§5.4)：甩错由主对分量/拖拉机分量/双对之一被压引发(原仅测单张分量)；
  纯双单张、纯双对(不连)、单张+拖拉机、单+对+拖三分量混合的合法；副牌禁甩·对手非缺门
- 甩错惩罚实际执行(§5.4.5)：do_playcard 收回甩牌、只强制打出最小一张、其余留手；合法甩牌整套打出
- 跟甩牌(§5.4.4)：拖拉机分量退化到单张(对子也不够)、多组拖拉机分量、混合demand逐分量对位
- 集成：首出合法甩牌→跟牌方拆散主对(违反§5.4.4)→ do_playcard 拒；正确对位→接受

全部单测 226 项断言全绿（arith 101 / paiju 31 等）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 01:34:02 +08:00
joywayerandClaude Opus 4.8 339e6e99e1 二七王测试：完成 P2 用例，达成测试计划 DoD 
- test_deal.js(新)：§2 发牌构成——92张/去3-4共16/三家各28+底8/分值(§6.1)
- test_arith.js：§3 编码排序（order_cards 降序=设计顺序、is_continuous 相邻链逐段+反例）、
  §7 每档小光/过庄分界+升3级补齐
- test_paiju.js：§8.2 亮牌更多边界（6个7仅qi、固定主9→null、固定主10仅zhu）
- test_config.js：§10 直接调 export.get_asetcount/get_needroomcard(_joinroom)
- test_rpc.js/_rpc.js：§12 端到端（真实驱动 叫分→上庄→选主→埋牌→出牌ready）、
  §9 maipai 亮牌门控 + get_deskinfo PushCards 门控
- 02-测试计划.md/README：P2 与 DoD 标记达成

全部单测 204 项断言全绿（node server/games/erqiwang/test/run.js）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 01:24:34 +08:00
joywayerandClaude Opus 4.8 6939e70ed7 二七王测试：完成 P1 用例（L3 RPC 层 + 坐庄轮换） 
- mod.js：加 module.exports 守卫，使其可被 Node require（友乐无 module 跳过）
- test/_rpc.js(新)：L3 脚手架——挂类全局、mock cls_mod/min_loadJsFile 装配 mod.js、
  捕获 SendPack/sendpack_toother 下发包
- test/test_rpc.js(新)：§9 明牌 mingpai(合法/不查牌·未报无主·非出牌阶段拒 + others结构)、
  §9 出牌 chupai 的 info/baozhu 查牌门控(可查有/不查无)、§4 投降 touxiang 条件(70·step2·庄家)、
  §4.2 mod.jiaofen 入参校验(>70/非5倍/首家必叫/后叫更低)、
  §4 70分上庄暗牌亮牌(真实 jiaofen 驱动到上庄，验证 bottomcards/ancard3s 门控)
- test/test_desk.js(新)：§4.6 坐庄轮换 do_prepare(庄赢连庄/闲赢·投降下家)
- 02-测试计划.md/README：P1 标记完成，剩余归入 P2

全部单测 156 项断言全绿（node server/games/erqiwang/test/run.js）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 01:14:33 +08:00
joywayerandClaude Opus 4.8 0049754988 二七王测试：完成 P0 用例（正常跟牌/结算集成/叫分坐庄/扣底触发） 
- test_follow.js(新)：§5.1/5.2 正常跟牌/毙牌/垫牌 17 例——单张/对子/拖拉机的
  必出、缺门毙牌数量对应(副单→主单/副对→主对/副N连→主N连)、垫牌、有对/拖却出散张被拒
- test_callgrade.js(新)：§4.2 叫分坐庄 do_callgrade 6 例（叫5立即/两家不叫/后叫更低）
- test_paiju.js：§7/§8 结算集成扩充(大光/过庄/升级/爬坡/傍王+算奖参与/对照)、
  §6.3 扣底触发 get_bottom_account(主对×2/两连对×4/副牌不扣/庄赢不扣)
- 02-测试计划.md/README：P0 全部标记完成

全部单测 123 项断言全绿（node server/games/erqiwang/test/run.js）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 01:03:01 +08:00
joywayerandClaude Opus 4.8 5a5165a319 二七王：制定服务端合规测试计划 
- docs/compliance/02-测试计划.md：按 design 章节的"规则→用例"覆盖矩阵
  （标注被测函数/测试层L1-L3/正反边界/覆盖状态），缺口清单按优先级排序，
  以及 L2 局内集成 / L3 RPC 层所需脚手架
- test/README.md：链接测试计划

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-05 00:02:52 +08:00
joywayerandClaude Opus 4.8 6d663c8a66 二七王：新增 Node 单元测试，CLAUDE.md 记录测试命令 
- test/_shim.js：平台全局垫片(min_ary_include/deduct、min_random/now/ontimeout、
  youle_erqiwang.import mock)，忠实复刻 minhttp.js；仅测试用，不进正式代码
- test/_assert.js + run.js：极简断言与总运行器
- test/test_arith.js(扣底/算子常规+爬坡/算奖/甩牌/跟牌分量) test_config.js(位串/局数扣卡)
  test/test_paiju.js(亮牌/结算 get_paiju_account 集成)，共 89 项断言全过
- test/README.md：运行方式与双运行时原理
- CLAUDE.md：常用命令补测试入口，说明服务端双运行时规范

（CLAUDE.md 内另含此前一处措辞微调，随本次文档更新一并纳入）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-04 23:51:12 +08:00
joywayerandClaude Opus 4.8 60271175d6 二七王：逻辑文件补双运行时守卫，解锁 Node 单测 
按 dev-guide 01 §1「一套代码，两个运行时」补齐 erqiwang 缺失的守卫（此前只支持友乐全局加载模型）：
- 顶部：跨模块依赖走 `if (typeof require!=='undefined') var X=require('./class.X.js')`
  （config/pai/arith 无跨模块依赖；paiju 依赖 arith/config/pai；desk 依赖 paiju；export 依赖 arith/config/desk）
- 底部：`if (typeof module!=='undefined') module.exports = cls_X`
- export/import 的平台接线 `youle_erqiwang.X=...` 加 `typeof youle_erqiwang` 守卫，Node 无此全局时跳过

纯增量：友乐无 require（浏览器模型），守卫全部跳过、全局名仍无条件暴露，线上行为不变；
仅在 Node 下额外启用 require/module.exports，从而可用 node 直接单测。min_*/youle_erqiwang 等平台全局仍按全局名引用（Node 侧由测试 shim 提供）。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-04 23:51:12 +08:00
joywayerandClaude Opus 4.8 e31bdd854d 二七王文档：记录二次全量复核结论 + §5.4.4 修复同步 
- compliance/01：新增二次对抗性复核结论（服务端全部符合 design.md）；
  §5.4 标记全部完成、§5.4.4 已修；修正过时的 §10.1 数组下标描述
- packet_protocol.md：playproc 补 shuai_demand 字段说明

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-04 23:20:09 +08:00
joywayerandClaude Opus 4.8 257615aed9 二七王：实现 §5.4.4 强制跟牌分量拆解 
原缺陷：混合甩牌在 can_playcard 牌型计算中被塌缩为扁平"多单张/多对"，
跟牌只强制"同花色凑张数"，未强制"拖拉机→对子→单张"的分量优先级。

修复：
- 合法甩牌时 can_playcard 记录分量需求 shuai_demand{tractors,pairs,singles}，
  do_playcard 存入 playproc、new_playround 复位
- 新增 arith.flush_follow_ok：在"同花色凑张数、主牌最大化"之上追加逐分量强制匹配
  ——能凑同长主拖必凑、能凑主对必凑（不足则退化为对子/单张），不得拆散去垫
- 新增 arith.remove_pairs 辅助
- 跟牌时 do_playcard 在 can_followcard 通过后再过 flush_follow_ok

不影响捡分/输赢（合法甩牌仍恒不可反超），仅补齐闲家被迫垫牌的结构约束。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-04 23:20:09 +08:00
joywayer 592b51fff4 添加规则 2026-07-04 22:37:25 +08:00
joywayerandClaude Opus 4.8 dcf8e09f7d 二七王文档：同步 design 流程/协议，新增合规核对 
design.md
- 修正选主/埋牌顺序笔误（确认「先选主后埋牌」）
- 投降改为选主阶段与选主互斥的选择（不选主/不埋牌直接结算），算奖用庄家36张、无连对链
- 70分暗牌改为「庄家摸牌之前、向所有玩家亮3秒」
- 选主阶段前端显示每花色对数、70分并列投降按钮
- 新增 §12「完整牌局游玩流程」（含大局与阶段速览）

packet_protocol.md（随代码如实同步）
- 结算 aset/seatlist 新结构（multiple=基础子数、upgrade 判定倍率、bangwang/climb、
  chongguan/wang/naward/grade_aw）；shangzhuang bottomcards 按70分门控 + ancard3s
- maipai/PushCards 亮牌 liangpai；chupai info/baozhu 按查牌门控；新增 mingpai 收发包
- step 枚举去掉废弃的投降4；删除 Surrender 重连视图

docs/compliance/（新增）
- 00 初步不一致清单、01 design 合规逐节核对（含整改进度与 roomtype 位串约定）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-04 22:34:06 +08:00
joywayerandClaude Opus 4.8 6120580505 二七王服务端：按 design.md 整改结算/算奖/甩牌，roomtype 改位串 
结算与算奖（§6.3/§7/§8）
- 扣底倍数改线性：单张×1、主对×2、N连对×2N
- 算子实现常规算子 + 爬坡两套（大光×3、Q=40 / 爬坡分段），X=基础子数×判定倍率
- 常规算奖只计庄家；连对链修复（传实际主花色）；移除 ≥10 老主误加奖与设计外的
  「冲关必叫/四王必踢」作废；算奖快照取庄家埋牌后28张（新增 get_seat_cards_award）
- 算奖并入结算改为 X×(2Ni−Nj−Nk)；傍王按房间开关、庄闲每王1奖

出牌与甩牌（§5.4）
- 副牌绝对禁甩；甩牌最大性按对手全部手牌逐分量判定（新增 trump_rank/
  decompose_trump/opp_can_beat_flush）；甩错惩罚（收回、只打最小一张、下发 shuaicuo）
- 修复 can_followcard 引用未定义 tuolaji_list 的崩溃、can_playcard 14张上限失效

开局/投降/暗牌（§4）
- 投降改为选主阶段(step2)与选主互斥、不埋牌、算奖用庄家36张；埋牌后直进出牌(删废弃step4)
- 70分暗牌摸牌前向所有玩家亮3秒(+ancard3s)，非70分不再泄露暗牌给闲家；叫分上限≤70

查牌/亮牌（§8.2/§9）
- 新增亮牌 get_liangpai（庄家埋牌后28张按阈值统计）；报无主统计与亮牌按查牌位门控
- 新增 mingpai 明牌 RPC（可查牌+已报无主时查看他家全部主牌）

房间与配置（§10）
- 局数6/12、房主扣卡2/4；新增 class.config.js 以位串解析 roomtype（唯一入口 SSOT）
- 清理 do_choiceflower 死代码

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-04 22:32:53 +08:00
joywayer 96372d713c 规则文档理清楚，开始代码层面对比和校对 2026-07-04 09:52:49 +08:00
joywayerandClaude Opus 5 911cc9cc23 CLAUDE.md：补充测试纪律说明 
明确测试代码可不守 ES5、正式代码禁止为测试服务、禁止为通过率降标准、
测试失败先裁根因、用例需覆盖正反面与边界。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-07-01 18:34:43 +08:00
joywayerandClaude Opus 5 7c24f9732d CLAUDE.md：补充 Git 提交纪律说明，允许及时自动提交 
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-07-01 18:29:22 +08:00
joywayerandClaude Opus 5 594820d393 初始化仓库：友乐/gameabc 房卡游戏平台脚手架（client + server + docs） 
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-07-01 18:13:26 +08:00