daoqi/erqiwang_youle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
174 Commits 1 Branch 0 Tags
52ad71f8b2dff1126a245e53533a0c18b2b06ef1
Commit Graph
174 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
joywayerandClaude Opus 5 857bc955bb 框架：订正 setNumberImage 帧序注释的自相矛盾（1-based） 
方法头「帧序号：0-9对应数字，10='.'...」与方法体内「字母'b'-'g'→帧10-16」
互相矛盾，且均与代码实际不符：'0' 的 charCode 48 减 47 得帧1，'.'→'b' 的
charCode 98 减 87 得帧11，故正确读法是 1-based：帧1-10=数字0-9、
帧11='.'、帧12='+'、帧13='-'、帧14='x'、帧15='/'、帧16=可变后缀。
补充说明编码表故意跳过 'a'（97-87=10 会与 '9'→帧10 撞帧）的原因。
只改注释，不动一行代码。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-27 00:47:00 +08:00
joywayerandClaude Opus 5 717e405292 二七王：SubGameHooks 注释去掉已作废的 NumberRenderer 提法 
事件链路本身不变，只把注释里对已回退方案的引用换成实际存在的例子
（248 号协议勾选的绘制回调）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-27 00:07:55 +08:00
joywayerandClaude Opus 5 35ee85e1d6 二七王：回退自造的图集叠绘，改用平台既有 SpriteManager.setNumberImage 
方案作废并纠正认知：多帧图片精灵【不是】只能显示一位数——SpriteManager 第 1154 行
早有 setNumberImage(spriteId, text, charWidth)：把整串文本设给一个多帧图片精灵，
引擎按字符逐帧渲染，精灵宽度按「字符数 × charWidth」自动调整。bc75e40 造的
drawImageRegion + NumberRenderer 是重复轮子，本次整体回退（revert bc75e40）。

- 回退：删除 gameabc-framework/ui/NumberRenderer.js 与其单测，SpriteManager 与
  index.html 恢复到改动前（与 bc75e40^ 逐字节一致）。
- ImageResources.js：数字类资源改为 16 帧、固定帧序 0123456789.+-x/p，逐条写明
  各帧含义、第16帧后缀（选主张数=「张」；结算/叫分的后缀标注待美术与规则确认，未瞎填）、
  单字符宽高与整图尺寸（16 × 单字宽），并说明帧序不可重排、不可省略占位。
- LayoutConstants.js：NUM_STYLE 改为 setNumberImage 所需的 res/charWidth/charHeight/suffix。
- Layout_Action.js：两个数字节点 h 取 charHeight（SSOT），w 留运行时注入
  （宽度由 setNumberImage 按字符数自动改，随位数变）。
- Sprites_Action.js / Sprites_Result.js：注释改为 setNumberImage 用法；
  结算玩家栏 ACC_TPL_SCORE_NUM 是复制精灵也能用（该接口不依赖绘制回调）。
- test_constants.js：NUM_STYLE 守卫改为校验 charWidth/charHeight/suffix 与
  「h 同源、w 运行时注入」；suffix 限定为 setNumberImage 支持的 分/倍/张。
- 文档：清单 §1.3/§1.5/§3.6/§5.4/§6.8 与前端 02 的那一节全部按 setNumberImage 重写，
  三种机制改为「文字精灵 / setFrame 切帧 / setNumberImage」，并记下这次误判作为反例。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-27 00:07:35 +08:00
joywayerandClaude Opus 5 dbdd6607d7 二七王：文档同步图集叠绘数字（清单 §1.3/§1.5/§3.6/§5.4/§6.8 + 前端 02 新增一节） 
- docs_dev 清单：§3.6 数字资源改为「等宽连续排列的一张图」并给出字符顺序/单字宽高/整图尺寸，
  §1.3 说明叫分档位分数为何必须改叠绘（14 档里 13 档两位数、每档一个精灵），
  §1.5/§5.4 选主张数由 8 个精灵改回 4 个（1678–1681 记跳号不复用），
  §6.8 布局节点合并 + 新增 NUM_STYLE 数字样式表；各处均带 2026-08-26 修订说明与缘由。
- 前端 02：新增「三种显示机制：文字精灵 / 多帧图片精灵 / 图集叠绘」一节，
  给出三问选用判据、多位数误用 setFrame 的坑与真实事故、叠绘的三条前提与出图规格；
  §5 补一条「转发必须接上且参数对齐，否则事件静默失效」的警示；DO/DON'T 各补一行。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 23:56:32 +08:00
joywayerandClaude Opus 5 2fe0f661b4 二七王：数字改回「一个数字一个精灵」，数字资源改为等宽连续图 
有了图集叠绘能力，多位数不再需要每位一个精灵：

- Sprites_Action.js：选主花色张数从每花色两个（_TENS/_ONES）改回每花色一个
  （MAIN_SUIT_COUNT_1..4 = 1674–1677），空出的 1678–1681 按本文件既有写法记跳号、不复用；
  叫分档位 CALL_BTN_NUM_1..14 数量不变，注释改为图集叠绘（现在能正确显示两位数）。
- ImageResources.js：NUM_COUNTDOWN / NUM_RESULT_WIN / NUM_RESULT_LOSE / NUM_CALL_SCORE /
  NUM_MAIN_SUIT_COUNT 不再是编辑器配帧的多帧资源，改为等宽连续排列的一张图，
  逐条写明字符排列顺序、单字符宽高、整图尺寸（给美术的出图规格）。
- Layout_Action.js：张数的十位/个位两节点合并为一个；两个数字节点的 w/h 直接引用
  NUM_STYLE（SSOT），不再由调用方运行时注入。
- Sprites_Result.js：记下 ACC_TPL_SCORE_NUM 是复制精灵、无法用 NumberRenderer 的风险。
- 单测：精灵总数 382→378、布局节点 62→61（按实际更新，未放宽下界）；
  新增 NUM_STYLE 资源键/字段合法性与「布局节点 w/h 与样式同源」守卫。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 23:53:16 +08:00
joywayerandClaude Opus 5 3789e0814e 二七王：接通平台精灵事件链路（SubGameHooks → SpriteEventController） 
SubGameHooks 原是空骨架，Game_Modify.* → SubGameHooks.* → SpriteEventController
这条链是断的：不仅数字叠绘的绘制回调不会触发，转发壳里已注册的 13 号战绩按钮、
150 号帮助按钮、248 号协议勾选也收不到事件。

实现 utlmousedown / utlmousedown_nomove / mouseup / utlmousemove /
utlgamemydrawbegin / gamemydraw 六个 hook，只做转发、不写业务逻辑，
参数顺序逐个对齐 SpriteEventController.handleXxx 的签名（错位会让事件静默失效），
转发前判断依赖存在，防御风格与转发壳一致。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 23:53:03 +08:00
joywayerandClaude Opus 5 bc75e40acc 二七王：新增图集叠绘数字能力（SpriteManager 源矩形 API + NumberRenderer） 
多帧图片精灵一次只显示一帧＝只能显示一位数，两位数就得两个精灵，
14 个叫分档位（13 档两位数）每档只配一个精灵时根本渲染不出来。

- SpriteManager.drawImageRegion：把 GameABCUtils.Draw.drawImage 的源矩形
  能力暴露到业务层（drawImage 只透传了整图版），校验/日志/返回值风格照现有
  drawImage 一致；注明必须在精灵绘制回调中调用。
- gameabc-framework/ui/NumberRenderer.js：游戏中立，bind/setValue/clear/unbind，
  绘制回调里按字宽逐位裁源矩形画在同一个精灵上；layout 抽为纯函数可脱离引擎单测；
  字符映射不到显式抛错，不静默跳过。
- EQW_Layout.NUM_STYLE：5 套数字的字宽/字高/字间距/对齐/绘制区宽集中配置（零裸值），
  资源只存键名（与 CARD_SIZE.res 同一约定）。
- client/tests/test_numberrenderer.js：43 checks（多位/单位/正负号/三种对齐/负字间距/
  空值/自定义 charMap/非法字符与非法样式抛错/5 套真实样式画得下）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 23:52:56 +08:00
joywayerandClaude Opus 5 b81e800f22 二七王：选主面板按美术实际出图方式（一张图5帧）重做资源与精灵定义 
BTN_SUIT_CHOOSE 改为 5 帧（4 花色按钮各含底+图标+角标底、帧5=投降按钮含底+文字），
删除独立的 SUIT_ICON_L(512)/BTN_SURRENDER(534)/花色图标精灵/角标底精灵/投降文字精灵；
花色张数从单个文字精灵改为图片数字精灵(十位+个位)，新增资源 NUM_MAIN_SUIT_COUNT(636)。
同步规格清单文档与两个测试文件里被钉死的精灵总数(387→382)。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 23:30:12 +08:00
joywayerandClaude Opus 5 be3e8d0837 二七王：清单 §5.2 手牌标记改为每张牌一个 
原表「牌型分组标记 ×8」与 §1.6「三种标记互斥、每张牌至多一个」矛盾。
裁决按每张牌——§1.6 是行为规格更权威，且三种标记本就是逐张判定的属性；
实测一手 28 张常带 13 个以上标记，8 个远远不够。

号段 1236–1243 太窄且其后 1250 起已被底牌区占用，改为 2100–2135。
前端 Sprites_Cards.js 与 core/CardMark.js 已按此落地。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 22:32:10 +08:00
joywayerandClaude Opus 5 503ad4b374 二七王：SeatMap 座位号显式校验，去掉恒真断言 
- toDisplay 此前不校验入参：toDisplay(seat, undefined) 会算出 NaN，NaN 既不等于 0
  也不等于 1，最后落到 return 'LEFT'——一个看起来很合理的错误答案。现与兄弟方法
  toSeat 一样对非 0/1/2 显式抛错；toSeat 的 mySeat 同样校验（否则算出 NaN 座位号）。
  补 8 条反面用例 + 1 条「合法组合不被误伤」的正面用例。
- test_cardcodec.js 删掉 t.eq('deck1/deck2 全部同帧', true, true) 这条恒真断言，
  改为收集不匹配项后断言为空——恒真断言在上面的循环被删掉后仍会 PASS。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 22:27:05 +08:00
joywayerandClaude Opus 5 d1b60275a4 二七王：建房选项配置补精灵键、bit 统一挂到 item、补 || {} 保护声明 
Sprites_CreateRoom.js 的注释说「配置里每个选项声明自己用哪个精灵键」，但 EQW_RoomOptions
的 items 只有 label/value，渲染器只剩「按下标拼字符串」一条路——而那正是同文件明文禁止的；
何况也拼不对（组的 key 是 'rules'，精灵却叫 ROOM_BOX_RULE_1）。

- 每个类别加 titleSprite，每个选项加 box/text 精灵键，房卡附注加 noteSprite。
- bit 统一挂到每个 item 上（单选组各项写同一个 bit），拼 roomtype 的循环对
  radio/checkbox 是同一个形状（item → 写 value 到 bit），不再按组/项两种层级分支；
  checkbox 项补上 value:'1'。
- 补上其他常量文件都有的 `|| {}` 保护性声明。
- 守卫新增：精灵键必须存在且互不重复、必须恰好覆盖建房 View 预置的全部选项精灵、
  bit 不得再挂在组上、单选组内 bit 一致、多选组 bit 互异、位号刚好铺满 0–4
  （对齐服务端 class.config.js 的 IDX_ASET..IDX_NOCHECK）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 22:26:21 +08:00
joywayerandClaude Opus 5 ee65871694 二七王：手牌标记精灵扩到与手牌一一对应（36 个），并钉死精灵总数 
清单 §5.2 表格写的是「牌型分组标记 ×8」，但 §1.6 明确规定三种标记互斥、【每张牌】
至多一个，core/CardMark.js 也是按每张牌返回标记的。一手 28 张牌通常带 13 个以上标记、
36 张埋牌手更多，8 个远远不够。§1.6 是行为规格、比表格措辞更权威，故按 §1.6 裁决：
HAND_MARK_1..36 与 HAND_CARD_1..36 一一对应。

- ID 另起 2100–2135 整段空号：1236 往后接不下 36 个连号（1250 起已是底牌/埋牌区），
  换空号段比给别的 View 重新编号更安全；仍落在子游戏段 1001–2999，无重复。
- 守卫补「手牌与标记 1..36 一一对应且同群组」检查。
- 精灵总数由「> 200」改为钉死 387（test_constants / test_spriteindex 两处同一个数），
  布局节点数同理已钉死——松下界删掉整个 View 都还能通过。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 22:25:19 +08:00
joywayerandClaude Opus 5 92edb6a3f5 二七王：布局求解器补齐显式失败与运行时注入契约，配置补 runtime/targetKind 声明 
求解器（ui/LayoutSolver.js）：
- 按方向校验 anchor：竖排只收 top/bottom/center、横排只收 left/right/center，
  未知 direction 一并拒绝。框架 AlignmentUtils 的 switch 对写错方向的 anchor 落到
  default（居中），笔误会被静默吞掉——ROOM_CATEGORY_COLUMN 就是这么把前两行摆到画布外的。
- grid 校验合并 ctx 后的 cols/rows 必须是数字：缺 rows 时 capacity=NaN 让超载守卫失效、
  循环一次不跑，静默返回空数组（一个矩形都不产出）。
- line/fan/grid 要求 anchorX/anchorY 必须是数字（框架的 anchorY||0 会把缺失变成 0）；
  point 要求 x/y 必须是数字。
- apply() 精灵数与矩形数不等时抛错，不再静默截断：截断会让多余精灵停在上一手牌的旧坐标上。
- 统一运行时注入：ctx 里的 INJECT_KEYS（target/x/y/w/h/anchorX/anchorY/rows/
  itemWidth/itemHeight）覆盖配置同名字段，优先级 ctx > bySeat > base。
- line + items 竖排显式拒绝（只实现了水平）。

配置：
- ROOM_CATEGORY_COLUMN anchor 由 'left' 改为 'top'（竖排语义）。
- ROOM_OPTION_OVERFLOW_GRID 补 rows（runtime）、槽尺寸与 anchor 沿用 ROOM_OPTION_ROW，
  cols 直接引用 ROOM_OPTION_MAX_PER_ROW；ROOM_OPTION_ROW 补上注释里已声明的 itemHeight。
- 所有依赖运行时注入的节点加 runtime 声明，所有 attach 节点加 targetKind
  （sprite / layout / platform），显式区分「忘了写」与「故意延后到运行时」。

守卫（tests/test_constants.js）：
- 求解冒烟改为只对 runtime 声明过的键注入假值，没声明却缺字段的照常抛错变红。
- 补矩形数量断言（line/fan/grid 按项数、point/attach 恒 1）——此前只查数组与坐标类型，
  空数组照样通过，「少画了几张牌」对守卫完全不可见。
- attach.target 改为只在 targetKind 指定的那一个命名空间里校验存在。
- 补 runtime 声明自身的合法性检查与布局节点总数（62）钉死。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 22:24:16 +08:00
joywayerandClaude Opus 5 b81be36f6e 二七王：拖拉机极大连续段扫描与牌编码区间常量收敛进 shared 
前后端此前各写了一遍「分对子 → is_continuous 扫极大连续段 → ≥2 对算拖拉机」：
服务端 class.arith.js decompose_trump 与前端 core/CardMark.js。规则内容（什么算连续、
几对起算拖拉机）散在两处，正是 shared/ 要消除的重复。

- shared/cards.js 新增 group_tractor_runs(mainflower, pairlist)：返回极大连续段数组，
  孤立对子作为长度 1 的段返回，拼接后恰好还原入参；阈值导出为 TRACTOR_MIN_PAIRS。
- shared/cards.js 导出牌编码区间边界具名常量（CODE_ZHU_MIN / CODE_ZHENG2_* /
  CODE_FU2_* / CODE_ZHENG7_* / CODE_FU7_* / CODE_XIAOWANG / CODE_DAWANG /
  CODE_A_IN_ZHU），并在 id_to_code / is_continuous / trump_rank 内部改用它们。
- decompose_trump 改调共享扫描，对外行为完全不变（分量类型、顺序、cards 归属不变）。
- CardMark 删掉本地扫描改调共享版本，区间判定与标记值改引用常量，去掉 1000/3000/
  4000/8000/9000 裸字面量。
- 前端副本经 sync_shared.cmd 同步；服务端单测 624→645 checks 全绿，前端 8 个测试全绿。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 22:17:09 +08:00
joywayerandClaude Opus 5 b22558d0b3 二七王：前端接入骨架与 index.html 加载段 
SubGameHooks 从模板复制、本阶段保持空骨架（无 hook 时转发壳走平台默认）。
index.html 按 client 06 §3 的顺序加入 codes 段：config → shared → core → ui
→ SubGameHooks → 三文件转发壳，三个转发壳一字未动。
Node vm 依序加载验证无异常，全部 EQW_* 与 SubGameHooks 就绪；两端测试全绿。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 21:51:53 +08:00
joywayerandClaude Opus 5 a05cc7b7fa 二七王：常量层机械守卫测试补 ctx.w/ctx.h 求解冒烟兜底 
求解冒烟第一次跑真实跑出 9 个节点（叫分档位分数文字、花色数量文字、牌角标、
结算文案等）因配置有意不写 w/h（真实宽高等文案渲染出来才知道）而求解失败；
裁决方向是给 LayoutSolver 补 ctx.w/ctx.h 运行时注入通道（已由 6390ce7 落地，
与既有 ctx.target 对称）。本次让冒烟测试的合成 ctx 对称跟进：仅在配置（含
bySeat 覆盖后）确实缺失 w/h 时才注入假尺寸，不覆盖配置自带的值，保证两条
路径都被真实覆盖到。60 个布局节点、84 次求解全部通过。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 21:46:41 +08:00
joywayerandClaude Opus 5 6390ce74c2 二七王：LayoutSolver attach 加 ctx.w/ctx.h 运行时尺寸注入通道 
求解冒烟守卫拿真实布局配置跑出 9 个失败节点：叫分档位分数文字、花色数量
文字、牌角标、结算文案等动态文字标签配置里有意不写 w/h（真实宽高要等
文案渲染出来才知道），此前的按对齐模式校验因此在 hAlign=center/right、
corner=topRight/bottomRight 时正确地抛错，但没给调用方注入真实尺寸的通道。

补 ctx.w/ctx.h，语义与已有的 ctx.target 对称：优先于配置里的 n.w/n.h，
校验与求解都用合并后的值，返回的 width/height 也用合并后的值（不再是
可能为 undefined 的配置原值）；两处都缺且用得到该维度时仍抛错，错误信息
点明"配置未写 X，且 ctx.X 未给出"两条路径。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 21:43:33 +08:00
joywayerandClaude Opus 5 ec954ea4fe 二七王：补建房折行 grid 的 cols 字段，补庄标 kind 覆盖注释 
按复审意见修 2 处 Minor：ROOM_OPTION_OVERFLOW_GRID 补上清单原文给出的
cols:maxPerRow；P_BANKER_MARK.bySeat.SELF 补注释说明有意将 kind 由
attach 覆盖为 point（底栏庄标是定点，不贴附头像框，与左右上家不同）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 21:35:44 +08:00
joywayerandClaude Opus 5 949702dc90 二七王：Task 13 守卫加入「求解冒烟」 
拿真实布局配置逐节点实际调用求解器，断言不抛错且坐标非 NaN。
字段名写错、缺 w/h、kind 不认识、bySeat 缺座位都会当场炸出来，
而不是等到界面上静默摆歪——这是配置与求解器之间契约的最强守卫。

attach.target 的解析范围同时改为三者并集（子游戏精灵 / 布局节点名 / 平台精灵）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 21:32:48 +08:00
joywayerandClaude Opus 5 91f0eb116c 二七王：LayoutSolver attach 支持运行时 target 注入，按对齐模式校验 w/h 
配置落地后暴露两个缺口：叫分档位/花色图标/牌角标等 attach 目标要运行时
才确定，配置写不出固定 target，需要 ctx.target 覆盖/补全（优先于 n.target，
两者皆无则抛错）；纯文字标签没有固定 w/h，此前缺失时会静默算出 NaN 坐标。
改为按本次实际走的对齐分支（hAlign/vAlign/corner）逐一核对 AlignmentUtils
源码确认是否用到 sprite.width/height，只在用得到时才要求对应字段是数字，
不用得到时（如 left/top/bottom、topLeft）不强制，避免逼纯文字配置编造假值。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 21:29:31 +08:00
joywayerandClaude Opus 5 6c92920df8 二七王：前端布局与动画常量 
照清单 §6 各表逐条录入，字段名与 LayoutSolver 的 node 一一对应、可原样喂入。
布局文件保持纯数据：无函数、无副作用；分行策略等写成数据标记而非函数。
建房选项配置自带 bit 与 value，roomtype 拼串遍历配置即可，不按下标硬拼。
动画参数含 D-8 判定动画的待补说明。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 21:26:16 +08:00
joywayerandClaude Opus 5 1976edf9bd 二七王：前端 SpriteIndex，精灵键名扁平索引 
布局配置按键名引用精灵，本模块把嵌套的精灵常量展平供查。
重复键与未知键一律抛错——静默覆盖会让界面指向别处的精灵且极难排查。
用例含真实常量的全量建索引校验。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 21:06:15 +08:00
joywayerandClaude Opus 5 4d05457590 二七王：拆分 HistoryMingPaiView，补充注释细节 
拆分理由：Layer1/Layer2 的写法让 History/MingPai 两个 group 容器各自
属于哪个图层只靠书写顺序隐含，无结构绑定。拆成 HistoryView(Layer 304)
与 MingPaiView(Layer 305) 两个独立 View 后，「一个 View 恰好一个 Layer」
成为不变式，精灵键名/ID/内容不变。

顺带补两处注释 Minor：PlayAreaView 的 PlayLeft/PlayRight 块首补资源键
说明；AccountView 的 4 个功能按钮改为逐条写资源键，不再靠顺序隐式对应。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 21:02:20 +08:00
joywayerandClaude Opus 5 69cb04ecfa 二七王：确立「一个 View 恰好一个图层」不变式 
原本允许 Layer1/Layer2 声明多图层，但「哪个 group 属于哪个图层」只能靠
注释隐含、无法机械判定。改为跨图层的界面拆成两个 View，各带自己的 Layer——
一个 View 将来对应一个 BaseComponent 组件，本就该分开。

SpriteIndex 加校验守住该不变式：View 缺 Layer、或写成 Layer1/Layer2 均报错。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 21:01:04 +08:00
joywayerandClaude Opus 5 488f36b545 二七王：前端精灵结构常量 
照清单 §5.1–§5.8 逐条录入，键名与 ID 原样照抄；省略写法（如「结构同 202」）
全部展开写全。每个精灵注明类型/用途/资源键/帧说明，后期照此在编辑器里创建。
按协调方中途下达的结构变更，Group 与其名下精灵合并为 group 容器
（groupName: { id: 群组常量, 精灵键: 精灵ID, ... }）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 20:53:35 +08:00
joywayerandClaude Opus 5 8b579896b2 二七王：精灵常量再优化为 View → group 容器 → 精灵 
group 与其名下精灵合并为 { id: 群组常量, 精灵键: id, ... }，
所属关系由结构表达而非注释；拿到 group 对象即可 showGroup 并遍历其精灵。

SpriteIndex 随之支持 groupIdOf：精灵与群组 ID 被结构绑定，
显隐走群组时可机械查出。校验增至 5 处显式失败（重复键、精灵值非数字、
View 下混入标量键、group 缺 id、查不到的键）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 20:51:18 +08:00
joywayerandClaude Opus 5 5ac445d08d 二七王：精灵常量改为以 UI View 为组织单位 
Layer/Group 扁平声明在 View 定义下，精灵只写 id、所属关系写在注释里；
一个 View 对应一个 UI 组件，拿到 View 即拿到它的全部精灵与图层群组。

SpriteIndex 的展平逻辑随之调整：保留键 Layer*/Group* 跳过，其余键即精灵；
新增「值非数字即报错」——两者结构上同级、只靠键名区分，写错前缀会静默变成假精灵。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 20:44:17 +08:00
joywayerandClaude Opus 5 6546f75965 二七王：前端图层/群组/图片/声音常量 
照清单 §0.3 与 §3 逐条录入，图片资源每条注明用途/帧数/帧义/尺寸——
后期即照这些注释在编辑器里建资源。声音因 T-20 未决只建骨架、不臆造条目。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 20:22:24 +08:00
joywayerandClaude Opus 5 8d6d272f76 二七王：LayoutSolver grid 补显式失败校验，attach 四角补精确坐标测试 
审查发现 _solveGrid 在 count > cols*rows 时静默截断多出的项，违反显式失败
红线；补校验直接抛错并报出 count 与容量。fillOrder 字段之前从未被读取、
形同虚设，改为显式拒绝除 'row' 外的值（不实现列优先，YAGNI）。
测试补 grid 超载/恰好满格/fillOrder 三态，以及 attach 四角(topLeft/
bottomLeft/bottomRight)的精确坐标核对（此前只有 topRight 有精确值）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 20:15:57 +08:00
joywayerandClaude Opus 5 2d0469e7f3 二七王：前端 LayoutSolver，五型布局求解器 
solve 是纯函数（attach 靠 ctx.rects 查目标矩形而非反查引擎），
fan 的 clamp 间距算法只此一处实现；line 带 items 时自行按累计宽度推进，
不走假设等宽的 distribute。未知 kind/缺参/target 缺失一律抛错，不兜底。
apply 是唯一触碰 SpriteManager 的三行封装。

测试里 attach 外侧右上角一条按 AlignmentUtils.alignCornerTopRight 的真实实现
（角对角重合，非贴外侧）修正了期望值，未在求解器里做偏移补偿迁就猜测值。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 20:09:26 +08:00
joywayerandClaude Opus 5 3a5da5b975 二七王：前端 CardMark，手牌标记推导与花色统计 
三种标记互斥、优先级 tractor > zheng > zhu，据主花色本地推导。
拖拉机识别与服务端 decompose_trump 同思路：分对子后扫极大连续段，
主牌一组、副牌按花色分组。反面用例覆盖不连续、单对、跨花色三种不成拖的情形。
countByFlower 供选主面板的张数与对数，协议明确服务端不下发。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 20:02:44 +08:00
joywayerandClaude Opus 5 39a920bed5 二七王：前端 CardOrder，手牌主牌序排序 
直接委托 shared/cards.js 的 order_cards（与服务端同一份文件），
前端只负责 concat 防改入参、把未选主表达为 mainflower=0。
单测拿服务端 class.arith 的输出做逐一对照，五种主花色全覆盖。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 20:01:51 +08:00
joywayerandClaude Opus 5 e9333303d5 二七王：前端 SeatMap，服务端座位与显示位互换 
清单 §0.1：下家 (seat+1)%3 显示在右上，与服务端 get_nextseat 同源。
3×3 全组合 + 互逆 + 非法键抛错都已覆盖。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 19:57:02 +08:00
joywayerandClaude Opus 5 65a73c5c2a 二七王：前端 CardCodec，cardId 转牌面帧号 
清单 §0.4 的唯一权威转换：服务端花色段序与美术帧顺序相反，
转换把花色段反过来数。用清单给的 10 条样例逐条锁死，
另加两副牌同帧、值域、单射三组断言。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 19:56:32 +08:00
joywayerandClaude Opus 5 3b9828c8ca 二七王：修正文档里服务端测试脚本数量 
实际是 17 个 test_*.js（624 checks），原文写的 20 把 _assert/_rpc/_shim 也数进去了。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 19:52:31 +08:00
joywayerandClaude Opus 5 656066b1a5 二七王：前端单测框架与 shared 同步守卫 
测试侧用 vm.runInThisContext 加载浏览器全局脚本，正式代码不为测试加任何导出。
test_shared_sync 断言前后端 shared 逐字节一致，已做反向验证（改一个空格即红）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 19:51:31 +08:00
joywayerandClaude Opus 5 147a28805e 二七王：sync_shared.cmd 补上 chcp 65001 
对齐 build_spine_data.cmd 既有范式，修复交互式控制台下中文提示的乱码问题；
计划原文漏抄了这一行。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 19:47:16 +08:00
joywayerandClaude Opus 5 d287ce5c8c 二七王：新增根目录 shared 同步脚本与前端只读副本 
同步是跨端动作（源在 server、目标在 client），脚本放仓库根目录。
只提供服务端→前端一个方向；前端副本只读，手改会被覆盖。
CLAUDE.md 常用命令一节同步收录。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 19:44:00 +08:00
joywayerandClaude Opus 5 9f32af7d72 二七王：抽出前后端共享算法 shared/cards.js 
把牌值编码与牌型分组的 8 个纯函数（id_to_flower/id_to_number/id_to_code/
order_cards/is_continuous/get_pairlist/get_tuolaji_list/trump_rank）移入
shared/，arith 改为挂引用——对外方法名与签名不变，既有调用点零改动。

前端排序与手牌标记将同步这一份，避免两处各写一份导致主牌序漂移。
现有 20 个测试脚本原样全绿，即本次纯搬运的验收依据。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 19:37:46 +08:00
joywayerandClaude Opus 5 e326481f2f 二七王：前端子项目 A 实施计划 
14 个任务，每个自带 TDD 循环与提交：shared 抽取与同步（1-2）、
单测框架与漂移守卫（3）、core 四个纯逻辑模块（4-7）、布局求解器（8）、
常量层三批（9/10/12）、精灵索引（11）、常量机械守卫（13）、接入骨架（14）。

顺带修订设计文档两处：shared 抽取函数数量 7→8（原文列了 8 个名字），
CardMark.markOf 签名与计划对齐（拖拉机判定需整手牌作上下文）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 18:55:26 +08:00
joywayerandClaude Opus 5 0f29c2e08c 二七王：shared 同步脚本改放仓库根目录 
同步是跨端动作（源在 server、目标在 client），不属于任何一端，
故 sync_shared.cmd 放根目录而非 client/scripts/。

同时写明单向流水线纪律：只改服务端 shared，改完跑脚本同步；
前端副本只读，本地改动会被覆盖，由字节一致守卫测试兜底。
验收补一条：CLAUDE.md「常用命令」需同步收录该脚本。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 18:42:52 +08:00
joywayerandClaude Opus 5 849de06194 二七王：前端子项目 A（地基与逻辑层）设计定案 
前端拆为 A→F 六个子项目，本文定案 A：目录结构、常量层全量、
core 纯逻辑、codes/ui 布局求解器、shared 抽取与同步、单测框架、接入骨架。

两处取舍已定：求解器归子游戏 codes/ui；排序算法走服务端 shared/ 同源
（抽 7 个牌值编码与牌型分组函数，arith 改挂引用，现有 20 个测试为安全网）。

资源与精灵不阻塞编码——常量文件先行、即建资源的规格书，编辑器后期照建。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 18:36:55 +08:00
joywayerandClaude Opus 5 f04bff4e9f 二七王：S-8 curmultiple 改为带符号 
问题：S-1 实现时取了绝对值，而判定的正负号恰恰是「谁赢」的区分——
3 大光 vs -3 升3级、2 小光 vs -2 升2级、1 过庄 vs -1 升1级，取绝对值后
三对完全撞在一起，D-8 的过程中判定动画无从分辨该播哪个。

改法：get_curmultiple 直接返回 get_upgrade 原值，与结算包 aset.upgrade
完全同口径（3/2/1 庄家大光/小光/过庄，-N 闲家升N级，0 叫分未定）。
顶部「抓分」角标只关心大小，取 Math.abs 即可；判定动画靠符号分辨，
前端一套映射通吃「过程中」与「结算前」两条路径。

协议 4 处 curmultiple 说明同步（shangzhuang / chupai1 / chupai2·3 /
PushCards）。

测试（hint 33 → 46 checks）：
- 钉住三对「绝对值相同、判定相反」的组合可区分，以及符号语义
  （>0 庄赢 / <0 闲赢 / ==0 叫分未定）。
- 新增一组【直接调 get_curmultiple 本身】覆盖负数分支，含爬坡 Q 分段。

补上一个测试盲点：第一次反向验证（把实现退回取绝对值）竟然全绿——因为
原有断言里算法层的 cm() 走的是 A.get_upgrade、绕过了 get_curmultiple，
而端到端那局恰好是大光(正数)，取不取绝对值都一样。补齐直接调用的用例后
再验，4 条断言立刻失败。

至此 §7.5 服务端待补 8 条全部完成，服务端侧无遗留；D-8 只差动画设计稿
与触发细节。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 12:42:29 +08:00
joywayerandClaude Opus 5 fd31272bd1 二七王：D-8 判定结果改为动画呈现，并记录 S-8 
小局结算面板【不做】大光/小光/过庄/升N级 的静态文字，改由动画在两个时机
呈现：对局过程中（判定档位跳变时）与结算前（最终判定）。精灵 1814
RESULT_JUDGE_TEXT 与资源 634 的静态文字方案作废，634 改为帧动画资源
ANI_JUDGE，播放参数进 AnimationConfigs。

动画遵守「数据优先、表现延后」：先写数据再播动画，动画回调只刷界面不写
核心数据；动画缺失或卡住时结算面板与数据仍正确。

新增 S-8（阻塞 D-8 的过程中动画）：S-1 实现 curmultiple 时取了绝对值，
而判定的正负号恰恰是「谁赢」的区分——取绝对值后
  3 大光 vs -3 升3级、2 小光 vs -2 升2级、1 过庄 vs -1 升1级
三对完全撞在一起，过程中动画无从判断该播哪个。建议改为带符号、与结算包
aset.upgrade 同口径，前端一套映射通吃两条路径；顶部抓分角标取 Math.abs
即可，不受影响。

当初取绝对值是因为 S-1 只服务顶部角标一个用途、只关心大小；现在多了动画
这个消费方，符号成了必需信息。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 12:12:58 +08:00
joywayerandClaude Opus 5 e51cde02b8 二七王：去掉开底提示文案，状态提示条收敛为 3 条 
闲家看到底牌由背面翻成正面本身就是开底最直白的表达，再加一行「底牌公示中」
是多余的。移除后提示条只剩 3 条：等待庄家选主 / 等待庄家埋牌 / 强甩失败。

「不做」清单相应增至五处：叫分等待、出牌等待、准备等待、掉线重连、开底提示，
各自记明理由（倒计时已指明、平台标识已有、画面本身已表达）。

同时移除随该文案而设的「底牌公示是文案不是术语」那段注记——文案没了，
注记也不再需要；术语侧「开底」的定义在 §0.0 未变。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 08:20:48 +08:00
joywayerandClaude Opus 5 32cbe2fe91 二七王：T-33 提示条文案定案，亮牌改为纯自动关闭 
T-33 定案，状态提示条全部 4 条：
  底牌公示中   全场   70 分开底那 3 秒
  等待庄家选主 闲家   shangzhuang → xuanzhu
  等待庄家埋牌 闲家   xuanzhu → maipai
  强甩失败     全场   收到 shuaicuo==1，自动淡出

明确不做四处并记下理由：叫分等待与出牌等待（倒计时就显示在当前操作者
位置旁，已指明在等谁；出牌一局约 84 次切换，弹条只会吵）、准备等待
（平台自带已准备/未准备标识）、掉线重连提示（平台 Layer 615 已覆盖）。

特别标注一处易绕回去的地方：「底牌公示中」是【界面文案】可以用，但
「底牌公示」作为【术语】已弃用（会与「亮牌＝公示牌力」混淆），规则术语
一律说「开底」。文案配合 8 张牌摊开的画面不会误读，故沿用。

T-34 补充：亮牌面板改为【仅自动时长关闭】，遮罩不注册点击。并列出三个
遮罩面板关闭方式的对照表——亮牌仅自动、冲关牌型点遮罩、明牌/出牌历史
点遮罩+按钮切换，三者不同，实现时最容易写混。

至此待确认 34 项只剩 T-20 音效（已明确后补）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 08:14:51 +08:00
joywayerandClaude Opus 5 6c78b37e89 二七王：T-34 亮牌展示时机定案，整理 T-33 等待提示条文案候选 
T-34 已定：亮牌在【埋牌后、出牌前】一次性弹出——收 maipai 包（其中带
liangpai）时展示，出牌开始前收起，与 design §8.2 的规则时点一致。
点遮罩关闭 + 自动关闭时长兜底（liangpaiAutoClose 进配置）；只有闲家会
收到并弹出；面板开着不阻塞出牌推送，收到出牌包直接收起即可。

T-33：按流程梳理出等待类文案候选 W1–W6 写进 §2.8，连同即时反馈类
（目前只有「强甩失败」）。同时标出三处需要拍板的：
- W4 出牌等待要不要做——一局约 84 次切换，每次弹条会很吵，且已有倒计时
  与已出牌区两重指示，倾向不做。
- W6 开底 3 秒显示什么——参考图上写的是「等待庄家选主」，但那张图叠画了
  开底与选主两个状态（§0.5），不能直接采信。
- 文案是否带昵称——带则提示条需随文案变宽。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 08:07:35 +08:00
joywayerandClaude Opus 5 796503153d 二七王：S-7 明牌条件按手册定案，服务端无需改动 
结论：按 design §9.3——任一玩家报无主后，三家都显示「明牌」按钮，
且整个出牌阶段随时可查、不限次数。判定依据是「场上有人报无主」而非
「自己报无主」，报无主那位和另外两位一样能看。

此前我把前端条件收紧成「自己是无主玩家」，比手册严格，反而与服务端
have_baofu() 的受理条件对不上。现改回：

- 前端清单 §1.7 D-6、§2.6 底栏按钮、§0.0 对照表、baozhu 字段说明统一为
  「可查牌 + 出牌阶段 + baozhu==1 → 三家都显示」。
- design §9.3 第 3 条补一句消歧：明确「为这三个人都出现」、判定依据是
  场上有人报无主、且不限次数随时可查。原文靠「同时」承接上一条的
  「为全体三人」，容易读漏。
- protocol 的术语表与 mingpai 受理条件说明同步加注。

服务端与协议本来就是手册口径，无代码改动。此前记的「有主牌玩家伪造请求
也能拿到明牌数据」这一泄露担忧不成立——按手册他本就有权查看，服务端受理
是正确行为。

验收清单增至 18 条，新增一条专门钉住「三家都显示，不是只给自己无主那家」。
至此 §7.5 服务端待补项 7 条全部处理完毕，服务端侧无遗留。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 08:03:08 +08:00
joywayerandClaude Opus 5 9ea6bfa14d 二七王：立「怎么读参考图」原则，清掉由 mock 数值引出的伪待确认项 
参考图是界面设计示意，只看版式/位置/样式，不看数值与状态组合。§0.5 新增
一张对照表写清哪些可信、哪些不可信：

  可信：位置、尺寸、层级、配色、字体、元素形态、牌面排布方式
  不可信：具体数值（一律填充假数据）；同时出现的互斥元素（如多个玩家位
          同时挂庄标——那是在标「庄标在每个位置分别摆哪儿」）；跨阶段并置
          的状态；底栏功能按钮的显隐

据此关闭两个本来就不成立的待确认项：
- T-31 大局结算「基础分」与「总得分」：图上两者数值相同且与右侧大字对不上，
  是填充数据所致。取 grade_jf_total 与 score，S-6 已实现。
- T-32 等待庄家选主.png 里底牌仍摊着：属叠画示意。实际先后仍按 design §4：
  开底 3 秒 → 摸底入手 → 选主。

其余三处已按同一原则处理过的表述（叫分角标 1子/2子/4子、埋牌双排 17/19）
统一改为指向 §0.5，口径一致。

顺带整理 §7.2：T-9 已定却仍留在「仍未决」表里，T-30~T-34 又不在表内。
现重整为「仍未决 3 项（T-20 音效 / T-33 等待文案 / T-34 亮牌展示时机）」+
「已定论 31 项」，并核对 T-1~T-34 连续无缺号。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 07:46:13 +08:00
joywayerandClaude Opus 5 76e82405e1 二七王：S-6 大局结算按 基础分/冲关分/傍王分 三项分解 
问题：大局结算面板要分项显示，而 account 只有「累积得分 + 每局得分数组」。
傍王分尤其拆不出来——N = 冲关奖数 + 傍王王数，两个来源【求和之后】才代入
grade_aw = X×(2Ni−Nj−Nk)，事后无法反推各自占比。

解法：在算钱时就拆。把 N 分成 N_冲关（只计庄家）与 N_傍王（勾选后庄闲都算），
分别代入同一公式各算一次。公式对 N 线性，故恒有
  grade_cg + grade_bw == grade_aw
这条恒等式正好当回归断言用。

服务端：
- class.paiju.js 抽出 award_pay(n) 复用同一公式，新增 grade_cg / grade_bw；
  desk.seatlist 追加三个累计位（基础/冲关/傍王）。
- class.desk.js seatlist 初始化为 5 元素；account 下发改为【对象数组】
  { score, grades, grade_jf_total, grade_cg_total, grade_bw_total }。
  原二元数组下标语义不清，且前端未开工，此时改代价最小（同 S-4 的判断）。

协议：aset.seatlist 增补 grade_cg / grade_bw；account 结构与恒等式
  grade_jf_total + grade_cg_total + grade_bw_total == score 写明；
  并记录这次结构变更的时间与理由。

测试（endgame 26 → 39 checks）：
- 核心不变量：两分量之和 == grade_aw；两分量各自零和。
- 未勾傍王局：grade_bw 恒 0、grade_cg == grade_aw。
- 【新增一整局开傍王的端到端】：不开傍王时 grade_bw 恒 0，只验到平凡情形，
  必须有傍王局才算真验证了拆分。该局逐项复核两个分量的公式、naward 口径，
  并钉住「王数不全相等时 grade_bw 必有非零」防止又退化成平凡。
- 大局累计恒等式：基础+冲关+傍王 == 累积总分。

反向验证：把 _awbw 置零 → 4 条断言失败；把冲关分量误算到闲家头上 →
2 条断言失败。均已还原、全量 17 文件全绿。

另修四处测试桩：_rpc.js / test_paiju / test_rpc / test_success 里手工构造的
o_desk.seatlist 仍是 2 元素，未跟上 class.desk.js 的结构变更（脚本缺陷，
非业务缺陷）。

顺带解决小局结算「冲关分」标签的不严谨：改取 grade_cg 而非 grade_aw，
开傍王时不再把傍王贡献算进来。

遗留 T-31：参考图「基础分」与「总得分」两行数值相同且与右侧大字对不上
（30/30 vs +135），mock 不自洽。当前按 基础分=grade_jf_total、总分=score
提供。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-26 00:34:46 +08:00