daoqi/erqiwang_youle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
127 Commits 1 Branch 0 Tags
a4b12a1ebb1bb18b11048806207ec95e61a53a9f
Commit Graph
15 Commits
Author SHA1 Message Date
joywayerandClaude Opus 5 a4b12a1ebb 二七王：Sprites_Cards.js 补 4 个 View 的布局说明注释 
为 HandView / BottomCardsView / BuryCardsView / PlayAreaView 各补一块 JSDoc：
分区标题标出 Layer 与 Group，正文含 ASCII 版式图（手牌单排/双排两种形态、
底牌背面与翻正面、埋牌底牌在结算面板内的位置、三家已出牌区的镜像关系与
牌型标签/牌角标贴附方式）、元素说明、资源说明、精灵 ID 分配与 @see 出处。

纯注释改动，数据部分一字未动（精灵总数仍 378、布局节点仍 61）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-27 01:39:49 +08:00
joywayerandClaude Opus 5 19f93bb96f 二七王：Sprites_Table.js 补 4 个 View 的布局说明注释 
按参考图与 UI 清单，为 TopInfoView / PlayerMarkView / LiangPaiView / FooterView
各补一块 JSDoc：分区标题标出 Layer 与 Group，正文含 ASCII 版式图（标注各区域
对应的精灵常量与实测坐标）、元素说明、资源说明、精灵 ID 分配与 @see 出处。

纯注释改动，数据部分一字未动（精灵总数仍 378、布局节点仍 61）。
顺带如实记下两处文档缺口：群组 206 的命名（亮牌条 vs 主牌统计条）与
底栏「扣底」按钮尚无精灵。

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