二七王：前端图层/群组/图片/声音常量

照清单 §0.3 与 §3 逐条录入，图片资源每条注明用途/帧数/帧义/尺寸——
后期即照这些注释在编辑器里建资源。声音因 T-20 未决只建骨架、不臆造条目。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

client/js/01_SubGame/codes/config/Groups.js

@@ -0,0 +1,37 @@
+///////////////////////////////////////////////////////////////
+////////// EQW_Groups: 群组 ID（清单 §0.3）////////////////////
+///////////////////////////////////////////////////////////////
+// 子游戏可用群组段：≥201（框架保留 0–200）。平台已占用 0–79，与下列不冲突。
+// 键名为已裁决的硬约定——下一任务的精灵常量按这些键名引用，不得改名。
+var EQW_Groups = EQW_Groups || {
+
+    TOP_INFO:      201,   // 顶部信息条（主 / 叫分 / 抓分）
+    P_LEFT_MARK:   202,   // 左上家附加标记（庄印章、主N对N、状态文字）
+    P_RIGHT_MARK:  203,   // 右上家附加标记（庄印章、主N对N、状态文字）
+    P_SELF_MARK:   204,   // 自己附加标记（庄印章、主N对N、状态文字）
+    FOOTER:        205,   // 底栏功能按钮组（明牌 / 已出牌 / 上一轮 / 底牌）
+    LIANGPAI_BAR:  206,   // 亮牌信息条
+
+    HAND:          210,   // 自己手牌
+    BOTTOM_CARDS:  211,   // 底牌区（发牌留桌 8 张）
+    PLAY_SELF:     212,   // 自己的已出牌区
+    PLAY_LEFT:     213,   // 左上家的已出牌区
+    PLAY_RIGHT:    214,   // 右上家的已出牌区
+    BURY_CARDS:    215,   // 埋牌底牌展示区（结算时 8 张）
+
+    CALL_PANEL:    220,   // 叫分面板
+    CHOOSE_MAIN:   221,   // 选主 / 投降面板
+    BURY_BAR:      222,   // 埋牌操作条
+    PLAY_BAR:      223,   // 出牌操作条
+    COUNTDOWN:     224,   // 倒计时（三位置）
+
+    OVERLAY:       230,   // 桌面浮层（气泡 / 飘字 / 报无主 / 甩错）
+
+    ASET_RESULT:   240,   // 小局结算
+    ACCOUNT:       241,   // 大局总结算
+    HISTORY:       242,   // 出牌历史
+    MINGPAI:       243,   // 明牌面板
+    CHONGGUAN:     244,   // 冲关牌型叠加层（清单 §5.6a，挂在图层 302，精灵复制）
+
+    CREATE_ROOM:   250    // 建房规则选项
+};

client/js/01_SubGame/codes/config/ImageResources.js

@@ -0,0 +1,367 @@
+///////////////////////////////////////////////////////////////
+////////// EQW_Images: 图片资源 ID（清单 §3，帧排布见 §0.4）////
+///////////////////////////////////////////////////////////////
+// 子游戏图片资源段：≥501（框架保留 1–500）。平台占用 1–439，与下列不冲突。
+// 每条注释为后期在编辑器里建资源的规格书：用途 / 帧数 / 帧说明 / 尺寸。
+// 尺寸均为参考图实测估值，出图前须与最终设计稿核对（清单 §3 表头说明）。
+// 按钮类资源一律只出 1 帧普通态，按下缩放/透明反馈由框架统一处理。
+//
+// 以下键号在源清单中被显式判定「不需要」，本文件不占用，留空号以便追溯：
+//   539 BTN_READY         —— 准备标识用平台自带的（清单 §0.2）
+//   652 TXT_BAOZHU        —— 报无主不做全场提示（D-4），只让他家 主N/对N 角标出现
+//   655 PANEL_BOTTOM_3S   —— 底牌 3 秒展示复用庄家翻底牌 UI（D-2），仅可见范围不同
+var EQW_Images = EQW_Images || {
+
+    //===================== §3.1 牌面（3 套，见清单 §0.4）=====================
+
+    //用途：自己手牌与底牌区的牌面
+    //帧数：60（10列×6行，行优先）
+    //帧说明：帧1–13=黑桃A–K 帧14–26=红桃A–K 帧27–39=梅花A–K 帧40–52=方块A–K
+    //        帧53=小王 帧54=大王 帧55–60=牌背1–6（二七王用帧55）
+    //        二七王不引用帧 3,4,16,17,29,30,42,43（design §2 去掉 3 和 4），但资源照 60 帧通用排版出图
+    //尺寸：单帧 110×190，整图 1100×1140
+    CARD_FACE_L: 501,
+
+    //用途：三家已出牌区的牌面
+    //帧数：60（10列×6行，行优先）
+    //帧说明：帧排布与 CARD_FACE_L 完全一致——帧1–13=黑桃A–K 帧14–26=红桃A–K
+    //        帧27–39=梅花A–K 帧40–52=方块A–K 帧53=小王 帧54=大王 帧55–60=牌背1–6（二七王用帧55）
+    //尺寸：单帧 90×155，整图 900×930
+    CARD_FACE_M: 502,
+
+    //用途：结算埋牌底牌区的牌面
+    //帧数：60（10列×6行，行优先）
+    //帧说明：帧排布与 CARD_FACE_L 完全一致——帧1–13=黑桃A–K 帧14–26=红桃A–K
+    //        帧27–39=梅花A–K 帧40–52=方块A–K 帧53=小王 帧54=大王 帧55–60=牌背1–6（二七王用帧55）
+    //尺寸：单帧 50×70，整图 500×420
+    CARD_FACE_S: 503,
+
+    //===================== §3.2 花色图标 =====================
+
+    //用途：顶部信息条「主」列的花色小图标
+    //帧数：4
+    //帧说明：帧1=方块♦ 帧2=梅花♣ 帧3=红心♥ 帧4=黑桃♠（按服务端 flower 编号 1–4 排序，
+    //        与牌面资源的花色顺序黑桃→红桃→梅花→方块不同，两套互不换算）
+    //尺寸：30×30
+    SUIT_ICON_S: 511,
+
+    //用途：选主面板花色按钮上的花色图标
+    //帧数：4
+    //帧说明：帧1=方块♦ 帧2=梅花♣ 帧3=红心♥ 帧4=黑桃♠（按服务端 flower 编号 1–4 排序，同 SUIT_ICON_S）
+    //尺寸：46×46
+    SUIT_ICON_L: 512,
+
+    //===================== §3.3 按钮 =====================
+
+    //用途：叫分档位按钮底 + 右上角角标底（同一张图，不含文字）
+    //帧数：4
+    //帧说明：帧1=浅黄底+蓝角标（对应档位 70/65/60/55） 帧2=金黄底+绿角标（50/45/40）
+    //        帧3=橙底+深橙角标（35…5） 帧4=灰（已叫过/不可选）。颜色按档位位置固定，只因不可叫变灰
+    //尺寸：74×56
+    BTN_CALL_SCORE: 531,
+
+    //用途：「不叫」按钮
+    //帧数：1
+    //帧说明：蓝色渐变
+    //尺寸：184×57
+    BTN_NO_CALL: 532,
+
+    //用途：选主花色按钮底
+    //帧数：1
+    //帧说明：金黄底
+    //尺寸：128×55
+    BTN_SUIT_CHOOSE: 533,
+
+    //用途：「投降」按钮
+    //帧数：1
+    //帧说明：金黄底
+    //尺寸：128×55
+    BTN_SURRENDER: 534,
+
+    //用途：「提示」按钮
+    //帧数：1
+    //帧说明：蓝色渐变
+    //尺寸：180×63
+    BTN_TIP: 535,
+
+    //用途：「埋牌 (N/8)」按钮
+    //帧数：2
+    //帧说明：帧1=可提交（金黄） 帧2=置灰（未满 8 张）
+    //尺寸：180×63
+    BTN_BURY: 536,
+
+    //用途：「出牌」按钮
+    //帧数：2
+    //帧说明：帧1=可出 帧2=置灰
+    //尺寸：157×55
+    BTN_PLAY: 537,
+
+    //用途：底栏功能钮底（明牌/已出牌/上一轮/底牌共用）
+    //帧数：1
+    //帧说明：深色圆角
+    //尺寸：88×30
+    BTN_BOTTOM_FUNC: 538,
+
+    //用途：底栏「踩」/「有分」/「没分」按钮底（三者共用）
+    //帧数：1
+    //帧说明：深色圆角，同 BTN_BOTTOM_FUNC 风格但更窄
+    //尺寸：52×30
+    BTN_TISHI: 540,
+
+    //用途：结算「下一局」按钮
+    //帧数：1
+    //帧说明：金黄渐变
+    //尺寸：180×65
+    BTN_NEXT_ASET: 541,
+
+    //用途：结算「冲关牌型」按钮
+    //帧数：1
+    //帧说明：蓝色渐变
+    //尺寸：183×63
+    BTN_CG_CARDS: 542,
+
+    //用途：大局结算「再来一局」按钮
+    //帧数：1
+    //帧说明：黄色渐变
+    //尺寸：190×60
+    BTN_ACCOUNT_AGAIN: 543,
+
+    //用途：大局结算「分享好友」按钮
+    //帧数：1
+    //帧说明：蓝色渐变
+    //尺寸：190×60
+    BTN_ACCOUNT_SHARE: 544,
+
+    //用途：大局结算「复制战绩」按钮
+    //帧数：1
+    //帧说明：蓝色渐变
+    //尺寸：190×60
+    BTN_ACCOUNT_COPY: 545,
+
+    //用途：大局结算「退出房间」按钮
+    //帧数：1
+    //帧说明：红色渐变
+    //尺寸：190×60
+    BTN_ACCOUNT_EXIT: 546,
+
+    //用途：大局结算标题栏右上角关闭按钮
+    //帧数：1
+    //帧说明：（无）
+    //尺寸：36×36
+    BTN_ACC_CLOSE: 547,
+
+    //===================== §3.4 标记类 =====================
+
+    //用途：「庄」红色印章
+    //帧数：1
+    //帧说明：（无）
+    //尺寸：40×40
+    MARK_BANKER: 571,
+
+    //用途：牌角「庄」橙色斜标
+    //帧数：1
+    //帧说明：（无）
+    //尺寸：28×28
+    MARK_BANKER_CORNER: 572,
+
+    //用途：大王「大」圆标
+    //帧数：2
+    //帧说明：帧1=大王 帧2=小王
+    //尺寸：34×34
+    MARK_JOKER_BIG: 573,
+
+    //用途：「主N」/「对N」角标底
+    //帧数：2
+    //帧说明：帧1=黄底（主） 帧2=白底（对）
+    //尺寸：44×20
+    BADGE_ZHU_PAIR: 574,
+
+    //用途：子数/倍数角标底
+    //帧数：2
+    //帧说明：帧1=蓝底 帧2=橙底
+    //尺寸：34×18
+    BADGE_MULTIPLE: 575,
+
+    //用途：牌型标签
+    //帧数：1
+    //帧说明：只做「毙」一种（前端只展示这一个标签）。数据层仍保留 毙/垫/混合出牌 三种标识以备扩展，
+    //        但当前不出图、不显示
+    //尺寸：76×24
+    LABEL_CARDTYPE: 576,
+
+    //用途：手牌牌型标记
+    //帧数：3
+    //帧说明：帧1=「拖」（拖拉机） 帧2=橙色五角星（正2/正7） 帧3=蓝色五角星（除正2正7外的其他主牌）
+    //尺寸：26×26
+    MARK_CARD_GROUP: 577,
+
+    //用途：手牌选中标记
+    //帧数：1
+    //帧说明：待定（也可只用上浮表现，不出图）
+    //尺寸：待定
+    MARK_SELECTED: 578,
+
+    //用途：大局结算名次徽章（花瓣形）
+    //帧数：3
+    //帧说明：帧1=第1名（金） 帧2=第2名（橙） 帧3=第3名（蓝）
+    //尺寸：44×44
+    BADGE_RANK: 579,
+
+    //===================== §3.5 面板底图 =====================
+
+    //用途：顶部三列信息条底
+    //帧数：1
+    //帧说明：（无）
+    //尺寸：276×68
+    PANEL_TOP_INFO: 601,
+
+    //用途：叫分面板底
+    //帧数：1
+    //帧说明：（无）
+    //尺寸：575×170
+    PANEL_CALL_SCORE: 602,
+
+    //用途：「70分坐庄才可投降」提示条底
+    //帧数：1
+    //帧说明：（无）
+    //尺寸：345×33
+    BAR_HINT_TOP: 603,
+
+    //用途：「亮主」斜角标题条
+    //帧数：1
+    //帧说明：（无）
+    //尺寸：425×50
+    BAR_CHOOSE_MAIN: 604,
+
+    //用途：亮牌信息条底（半透圆角）
+    //帧数：1
+    //帧说明：（无）
+    //尺寸：210×35
+    BAR_LIANGPAI: 605,
+
+    //用途：结算底牌区面板底
+    //帧数：1
+    //帧说明：（无）
+    //尺寸：420×148
+    PANEL_BOTTOM_CARDS: 606,
+
+    //用途：结算分数光晕背景
+    //帧数：2
+    //帧说明：帧1=赢（橙） 帧2=输（蓝）
+    //尺寸：225×100
+    GLOW_RESULT: 607,
+
+    //用途：底栏深色条
+    //帧数：1
+    //帧说明：（无）
+    //尺寸：1280×72
+    BAR_FOOTER: 608,
+
+    //用途：半透黑遮罩（冲关牌型/出牌历史/明牌 共用）
+    //帧数：1
+    //帧说明：纯色可拉伸，出 1 张小图即可
+    //尺寸：1280×720
+    MASK_DIM: 609,
+
+    //用途：大局总结算面板底（圆角浅灰绿）
+    //帧数：1
+    //帧说明：（无）
+    //尺寸：1100×540
+    PANEL_ACCOUNT: 610,
+
+    //用途：大局结算标题栏（青绿底，含圆角上沿）
+    //帧数：1
+    //帧说明：（无）
+    //尺寸：1100×56
+    BAR_ACCOUNT_TITLE: 611,
+
+    //用途：大局结算底部规则栏（浅绿底，含圆角下沿）
+    //帧数：1
+    //帧说明：（无）
+    //尺寸：1100×62
+    BAR_ACCOUNT_RULE: 612,
+
+    //用途：玩家栏之间的分隔线
+    //帧数：1
+    //帧说明：（无）
+    //尺寸：1060×2
+    LINE_DIVIDER: 613,
+
+    //===================== §3.6 数字与符号 =====================
+
+    //用途：倒计时数字（带描边/渐变美术字）
+    //帧数：10
+    //帧说明：帧1–10 = 0–9
+    //尺寸：44×60
+    NUM_COUNTDOWN: 631,
+
+    //用途：结算得分数字（赢，橙，带描边/渐变美术字）
+    //帧数：12
+    //帧说明：帧1–10 = 0–9，帧11 = +，帧12 = -
+    //尺寸：46×62
+    NUM_RESULT_WIN: 632,
+
+    //用途：结算得分数字（输，蓝，带描边/渐变美术字）
+    //帧数：12
+    //帧说明：帧1–10 = 0–9，帧11 = +，帧12 = -
+    //尺寸：46×62
+    NUM_RESULT_LOSE: 633,
+
+    //用途：判定结果动画（大光/小光/过庄/升N级/投降）——帧动画资源，播放参数进 AnimationConfigs【待设计 D-8】
+    //帧数：待定
+    //帧说明：待定
+    //尺寸：待定
+    ANI_JUDGE: 634,
+
+    //用途：叫分档位的分数数字（深棕描边美术字，带描边/渐变，文字精灵做不出此效果）
+    //帧数：10
+    //帧说明：帧1–10 = 0–9
+    //尺寸：30×40
+    NUM_CALL_SCORE: 635,
+
+    //===================== §3.7 浮层与气泡 =====================
+
+    //用途：「踩」/「没分」/「有分」提示气泡
+    //帧数：6（3×2）
+    //帧说明：帧1=踩·箭头向左 帧2=没分·箭头向左 帧3=有分·箭头向左
+    //        帧4=踩·箭头向右 帧5=没分·箭头向右 帧6=有分·箭头向右
+    //        帧序内层是 tip（1踩/2没分/3有分）、外层是箭头朝向 → frame = (arrowRight ? 3 : 0) + tip
+    //        箭头向左 = 头像在气泡左侧、箭头向右 = 头像在气泡右侧
+    //尺寸：待定
+    BUBBLE_TISHI: 651,
+
+    //用途：通用状态提示条底（深色半透圆角，白字居中）——「等待庄家选主」/「强甩失败」等共用（清单 §2.8）
+    //帧数：1
+    //帧说明：可九宫拉伸，按文案长度变宽
+    //尺寸：363×50
+    BAR_TOAST: 653,
+
+    //用途：捡分飘字底（「20分」金色）
+    //帧数：1
+    //帧说明：（无）
+    //尺寸：待定
+    TXT_GRADE_FLOAT: 654,
+
+    //===================== §3.8 建房选项 =====================
+
+    //用途：建房选择框（单选钮 + 复选框合一）
+    //帧数：4（2×2）
+    //帧说明：帧1=单选·未选中（灰空心环） 帧2=单选·已选中（橙实心环）
+    //        帧3=复选·未选中（浅绿空方块） 帧4=复选·已选中
+    //        帧号 = (useCheckbox ? 3 : 1) + (selected ? 1 : 0)；「单选（可不选）」用复选帧 3/4
+    //尺寸：22×22
+    ROOM_OPT_BOX: 681,
+
+    //用途：建房类别标题（一张图多帧）
+    //帧数：3
+    //帧说明：帧1=牌局 帧2=模式 帧3=规则
+    //尺寸：60×24
+    ROOM_CAT_TITLE: 682,
+
+    //用途：选项行底
+    //帧数：1
+    //帧说明：参考图为无底透明，可选
+    //尺寸：待定
+    ROW_ROOM_OPT: 683
+
+};

client/js/01_SubGame/codes/config/Layers.js

@@ -0,0 +1,23 @@
+///////////////////////////////////////////////////////////////
+////////// EQW_Layers: 图层 ID（清单 §0.3）////////////////////
+///////////////////////////////////////////////////////////////
+// 子游戏可用图层段：101–200 / 301–400 / 501–600 / 701+（client 02 §1）
+// 平台已占用 27/28/50/202/409/410/416/418/420/608/609/612/613/614/615/616/619/620，
+// 均落在框架保留段，与下列不冲突。
+var EQW_Layers = EQW_Layers || {
+
+    TABLE_STATIC:       101,   // 牌桌常驻：顶部信息条、玩家位附加标记、亮牌信息条、底栏（局数 + 功能钮）
+    HAND:               102,   // 自己手牌区（单排 / 埋牌双排）
+    TABLE_CARDS:        103,   // 桌面牌：底牌区、三家已出牌区、埋牌底牌展示区
+    ACTION:             104,   // 阶段操作区：叫分面板、选主/投降面板、埋牌/出牌操作条、倒计时
+    OVERLAY:            105,   // 桌面浮层：提示气泡、报无主、甩错、捡分飘字、70 分底牌亮 3 秒
+
+    POPUP_ASET_RESULT:  302,   // 小局结算（清单 §5.6a：冲关牌型叠加层群组 244 也挂在本图层）
+    POPUP_ACCOUNT:      303,   // 大局总结算 / 解散结算
+    POPUP_HISTORY:      304,   // 出牌历史面板
+    POPUP_MINGPAI:      305,   // 明牌面板
+    //306 POPUP_DISBAND 解散投票面板——清单 T-2「是否由平台提供」未决，暂不占号，定案后再补
+
+    //建房规则选项区挂在平台创建房间界面 Layer 27 CreateRoom_Layer 上，不新开图层（清单 T-3）
+    PLATFORM_CREATE_ROOM: 27
+};

client/js/01_SubGame/codes/config/SoundResources.js

@@ -0,0 +1,16 @@
+///////////////////////////////////////////////////////////////
+////////// EQW_Sounds: 声音资源 ID（清单 §4）//////////////////
+///////////////////////////////////////////////////////////////
+// 子游戏声音资源段：≥101（框架保留 1–100）。平台现占用 1–5。
+//
+// 【T-20 未决】整套音效尚未定案——清单 §4 整节标注「整节待确认 T-20」：
+//   design 与协议均未定义任何音效；清单里的候选表（发牌/叫分/不叫/上庄/选主/投降/
+//   埋牌/出牌/甩牌/甩错/毙牌/赢下一轮/报无主/踩没分有分/扣底/结算赢/结算输/
+//   倒计时/按钮点击）明确标注「未经确认，不得直接作为出音依据」。
+//   待确认项：是否需要男/女声区分、是否需要方言语音包、SND_TISHI 是否用真人语音、
+//   倒计时提示音从第几秒开始。
+// 定案前【不臆造条目】。届时在此按 SoundResources.template.js 的格式补充，
+// 每条注明：用途 / 时长 / 是否循环。
+var EQW_Sounds = EQW_Sounds || {
+    //待 T-20 定案后补充
+};