daoqi/erqiwang_youle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
137 Commits 1 Branch 0 Tags
8dba099717a8b62f119a896225284abd8b384578
Commit Graph
8 Commits
Author SHA1 Message Date
joywayerandClaude Opus 5 2b1dd0d947 二七王：修复出牌操作条/亮牌历史布局越界，补主牌统计条改名遗漏 
- I1：Layers.js 群组 206 改名遗漏一处注释（亮牌信息条 → 主牌统计条），全仓复查确认无第二处
- I2：出牌操作条补「提示」项后 anchor:center 导致已有两项挤偏，改用 anchor:left 并反推
  anchorX=446，令「出牌」按钮回到参考图实测 x≈556（求解器验证：446/556/748）
- I3：HIST_FAN/MING_FAN 的 maxWidth 反推算错（旧注释「488」有误，实际总宽恒等于
  maxWidth=500），导致 RIGHT 座位整排超出画布 5px；收窄为 490 使三座位求解结果落在
  0-1280 内，订正注释与清单 §6.9c 对应文字
- M3：同步修正计划文档里遗留的旧名「亮牌信息条/亮牌条」
- M6：test_constants.js 补 items[].key 的三命名空间解析守卫（此前完全无守卫）
- M5/M7：订正 ACC_ROW_TEXT_GRID 与扣底按钮宽度的估值依据说明
- M1/M2：清单 §6.9 子节重新排序为 6.9a→6.9b→6.9c 并统一标题层级，修正脚注星号误渲染

client/tests/run.js 与 server/games/erqiwang/test/run.js 均全绿，精灵总数(380)/
布局节点数(83) 两个钉死断言未变。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-27 09:06:01 +08:00
joywayerandClaude Opus 5 8f36b61620 二七王：补齐三处配置缺口（扣底按钮 / 出牌提示按钮槽位 / 三个 View 的布局节点） 
这三处都是「精灵或按钮已在清单里定案，但配置层缺东西」，不补的话 C/D/E 阶段
写渲染代码时会发现没有布局节点，极易就地硬编码坐标（违反零裸值红线）。

1) 底栏「扣底」按钮没有精灵（清单 §2.6 列了 5 个功能按钮，只登记了 4 个）
   - 新增 BTN_BURY_CARDS(1056) / BTN_BURY_CARDS_TEXT(1057)，群组 205 号段内空闲号，
     资源沿用 BTN_BOTTOM_FUNC，与其余四个按钮同构。
   - FOOTER_FUNC_BUTTONS 的 items 由 4 项扩到 5 项，扣底紧邻底牌（照 §2.6 表序）。
     扣底宽 78 是【估值】：清单未给，取同为两字按钮的「底牌」实测值，已在配置与清单里注明。
   - 扣底看【埋牌底牌】(burycards)、底牌看【底牌】(bottomcards)，两批不同的牌，
     JSDoc 里补了防写反的提示（对应验收清单第 13 条）。

2) 出牌阶段「提示」按钮有精灵、无布局槽位
   - PLAY_OPERATION_BAR.items 补上 PLAY_BTN_TIP，顺序照清单 §1.7 行文：倒计时 / 出牌 / 提示。
   - 宽 180 是【估值】：清单 §6.8 自身漏了该项；与埋牌条的提示按钮同资源 BTN_TIP
     （§3.3 实测 180×63），埋牌条 items 首项亦取 180，故沿用。
   - 顺带记下一处待裁定项：本条 itemHeight 为 55（对齐 BTN_PLAY 157×55），
     而 BTN_TIP 原生高 63，高度差待设计稿定。

3) AccountView / HistoryView / MingPaiView 一个布局节点都没有
   - AccountView（§6.9a 新增）：外壳 6 个节点 + 玩家栏「容器 ACC_ROW_CONTAINER +
     行节点 ACC_ROW（itemHeight 即行高，行数由 ctx.count 给出）+ 行内模板贴附到行矩形」
     + 面板外 4 按钮，共 14 个节点。行内节点求出的是相对容器的坐标，可直接喂
     SpriteCopyUtils.create（与 §5.6a 冲关牌同一用法）。
   - HistoryView / MingPaiView（§6.9c 新增）：遮罩 + 容器 + 每家一排牌(fan) + 座位标签，
     各 4 个节点。照 CHONGGUAN_FAN 同构、锚点沿用 §6.7 冲关牌的三家落点；
     差别只在张数上限——出牌历史摊平后可达 28 张以上，故 maxWidth 放宽到 500、
     spacingMin 收到 -96【估值】。MING_* 只有 LEFT/RIGHT 两个 bySeat 变体（明牌不看自己）。
   - 坐标来源：大局结算.png / 冲关牌型显示.png 目视实测，w/h 取资源尺寸；
     配置与清单里均已注明「目视实测估值，待设计稿复核」。
   - 运行时才确定的字段（动态文字宽高、随行浮动的 anchorY、数字精灵宽）一律
     runtime 显式声明。

钉死断言按实际重新数并更新：精灵总数 378 → 380，布局节点总数 61 → 83。
另把 ACC_TPL_SCORE_NUM 加进 NUM_STYLE 同源校验表（与 RESULT_SCORE_NUM 同一套资源）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-27 08:40:48 +08:00
joywayerandClaude Opus 5 0c58ae67db 二七王：倒计时与结算得分改用数字图精灵，收尾几处命名与文档订正 
- CD_LEFT/CD_RIGHT/CD_SELF（1150-1152）由文字精灵改为多帧图数字精灵：
  资源 NUM_COUNTDOWN，纯秒数无后缀；对应布局节点 P_COUNTDOWN 的 h 改取
  NUM_STYLE.COUNTDOWN.charHeight，w 留到运行时注入。
- 结算得分 RESULT_SCORE_LEFT/RIGHT/SELF（1805-1807）同理由文字精灵改为
  数字图精灵（NUM_RESULT_WIN/NUM_RESULT_LOSE），与大局结算已有的
  ACC_TPL_SCORE_NUM 保持一致；布局节点随之调整，移除不再使用的
  TEXT_STYLE.SCORE_BIG。
- NUM_CALL_SCORE 第16帧由"待美术与规则确认"改为明确的"无后缀"（叫分档位
  面板只显示纯数字，"N子"角标是独立文字精灵）；NUM_MAIN_SUIT_COUNT /
  NUM_RESULT_WIN / NUM_RESULT_LOSE 第16帧仍待确认，不改。
- Layout_Action.js 的 CALL_BTN_SCORE_TEXT、Layout_Result.js 的
  RESULT_SCORE_TEXT 改名为 CALL_BTN_SCORE_NUM / RESULT_SCORE_NUM：
  两者驱动的都是数字图精灵，_TEXT 后缀误导；同步测试引用。
- docs/client/development-guide/02：订正"SpriteManager 第1154行"这一失效
  行号引用（回退后该行号落在 setTextWithWidth 体内），改为不写死行号。
- docs_dev 清单同步：§2.4/§5.4/§5.6/§6.6/§6.9 倒计时与结算得分的精灵类型
  描述、§6.6/§6.9 对应布局参数。
- test_constants.js 的 NUM_STYLE 同源守卫表新增 COUNTDOWN、RESULT_WIN、
  RESULT_LOSE 三对（连同改名后的 CALL_BTN_SCORE_NUM），共 6 条新断言。

精灵总数、布局节点总数均未变（378 / 61），只改类型与命名，不增删。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-27 00:54:42 +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 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 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 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 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