二七王：布局求解器补齐显式失败与运行时注入契约，配置补 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>

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

@@ -21,10 +21,16 @@ EQW_Layout.CALL_BTN_GRID = {
 //档位分数文字：贴对应档位按钮居中。CALL_BTN_1..14 是 14 个固定精灵，但本节点是共用模板，
 //target 由调用方按第几档注入（不预置单一 target）。宽高随数字位数变化，清单未给固定值，
 //资源 NUM_CALL_SCORE 单字位 30×40 仅供参考，不作为本节点的 w/h
-EQW_Layout.CALL_BTN_SCORE_TEXT = { kind: 'attach', hAlign: 'center', vAlign: 'middle', offsetY: 4 };
+EQW_Layout.CALL_BTN_SCORE_TEXT = {
+    kind: 'attach', targetKind: 'sprite', hAlign: 'center', vAlign: 'middle', offsetY: 4,
+    runtime: ['target', 'w', 'h']
+};
 
 //档位子数角标：贴对应档位按钮右上角，纯文字无底图，清单未给宽高（同上，调用方注入 target）
-EQW_Layout.CALL_BTN_MULTIPLE_BADGE = { kind: 'attach', corner: 'topRight', offsetX: -30, offsetY: 2 };
+EQW_Layout.CALL_BTN_MULTIPLE_BADGE = {
+    kind: 'attach', targetKind: 'sprite', corner: 'topRight', offsetX: -30, offsetY: 2,
+    runtime: ['target', 'w', 'h']
+};
 
 EQW_Layout.CALL_BTN_NONE = { kind: 'point', x: 553, y: 345, w: 184, h: 57 };
 
@@ -44,14 +50,23 @@ EQW_Layout.MAIN_SUIT_LINE = {
 };
 
 //花色图标：贴对应花色按钮左侧（资源 SUIT_ICON_L 46×46）。target 由调用方按花色序号注入
-EQW_Layout.MAIN_SUIT_ICON = { kind: 'attach', hAlign: 'left', vAlign: 'middle', offsetX: 14, w: 46, h: 46 };
+EQW_Layout.MAIN_SUIT_ICON = {
+    kind: 'attach', targetKind: 'sprite', hAlign: 'left', vAlign: 'middle', offsetX: 14, w: 46, h: 46,
+    runtime: ['target']
+};
 
 //张数大字：贴对应花色按钮居中，纯文字，清单未给宽高（调用方注入 target）
-EQW_Layout.MAIN_SUIT_COUNT_TEXT = { kind: 'attach', hAlign: 'center', vAlign: 'middle', offsetX: 14 };
+EQW_Layout.MAIN_SUIT_COUNT_TEXT = {
+    kind: 'attach', targetKind: 'sprite', hAlign: 'center', vAlign: 'middle', offsetX: 14,
+    runtime: ['target', 'w', 'h']
+};
 
 //对数角标底：贴对应花色按钮右上角（资源 BADGE_MULTIPLE 帧1 34×18）。
 //角标文字复用同一矩形，不单独配置（调用方注入 target）
-EQW_Layout.MAIN_SUIT_PAIR_BADGE = { kind: 'attach', corner: 'topRight', offsetX: -36, offsetY: 2, w: 34, h: 18 };
+EQW_Layout.MAIN_SUIT_PAIR_BADGE = {
+    kind: 'attach', targetKind: 'sprite', corner: 'topRight', offsetX: -36, offsetY: 2, w: 34, h: 18,
+    runtime: ['target']
+};
 
 //===== 埋牌 / 出牌操作条 =====
 

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

@@ -69,7 +69,7 @@ EQW_Layout.PLAY_AREA = {
 //已出牌 · 牌型标签：贴该区第一张牌。首槽是固定精灵（PLAY_SELF_1 / PLAY_LEFT_1 / PLAY_RIGHT_1），非动态目标。
 //资源 LABEL_CARDTYPE 76×24（清单 §3）
 EQW_Layout.PLAY_TYPE_LABEL = {
-    kind: 'attach', corner: 'bottomLeft', offsetX: 0, offsetY: -24, w: 76, h: 24,
+    kind: 'attach', targetKind: 'sprite', corner: 'bottomLeft', offsetX: 0, offsetY: -24, w: 76, h: 24,
     bySeat: {
         SELF:  { target: 'PLAY_SELF_1' },
         LEFT:  { target: 'PLAY_LEFT_1' },
@@ -82,7 +82,8 @@ EQW_Layout.PLAY_TYPE_LABEL = {
 //EQW_LayoutSolver.solve——这是有意的动态目标模式，不在配置里预置 target（清单未给尺寸；
 //两种资源分别是 MARK_BANKER_CORNER 28×28 / MARK_JOKER_BIG 34×34，按实际显示的是哪个徽标取值）
 EQW_Layout.PLAY_CARD_CORNER_MARK = {
-    kind: 'attach', corner: 'topRight', offsetX: -28, offsetY: 0
+    kind: 'attach', targetKind: 'sprite', corner: 'topRight', offsetX: -28, offsetY: 0,
+    runtime: ['target', 'w', 'h']
 };
 
 //冲关牌（叠加层）：精灵复制场景（§5.6a），spacingMin 放宽到 -88 以容纳 20+ 张的极端情况。

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

@@ -9,45 +9,70 @@ var EQW_Layout = EQW_Layout || {};
 //两层嵌套：类别竖排（ROOM_CATEGORY_COLUMN）+ 类别内选项槽横排（ROOM_OPTION_ROW）。
 //本节数值按参考图比例估，实际以平台建房界面尺寸为准（清单 §6.9b 原文，不是本文件误差）。
 
-//类别竖排。itemWidth 清单未给——类别行宽度等于平台内容区实际宽度，由调用方按实际面板尺寸处理
+//类别竖排。itemWidth 清单未给——类别行宽度等于平台内容区实际宽度，由调用方按实际面板尺寸注入。
+//anchor 必须是竖排语义的 top/bottom/center：写成水平语义的 'left' 会被框架 switch 的 default
+//当成居中（3 个类别时算出 y=[-56,-16,24]，前两行跑到画布外），求解器现已按方向校验并抛错
 EQW_Layout.ROOM_CATEGORY_COLUMN = {
     kind: 'line', direction: 'vertical', anchorX: 0, anchorY: 0,
-    itemHeight: 32, spacing: 8, anchor: 'left'
+    itemHeight: 32, spacing: 8, anchor: 'top',
+    runtime: ['itemWidth']
 };
 
 //类别标题：贴所在类别行。该行是 ROOM_CATEGORY_COLUMN 求解结果的第 N 项，不是固定精灵，
 //target 由调用方按类别序号注入。资源 ROOM_CAT_TITLE 60×24（清单 §3）
-EQW_Layout.ROOM_CATEGORY_TITLE = { kind: 'attach', hAlign: 'left', vAlign: 'middle', offsetX: 0, w: 60, h: 24 };
+EQW_Layout.ROOM_CATEGORY_TITLE = {
+    kind: 'attach', targetKind: 'layout', hAlign: 'left', vAlign: 'middle', offsetX: 0, w: 60, h: 24,
+    runtime: ['target']
+};
 
 //类别内选项槽横排。anchorY 清单未给（随所在类别行的 y 浮动，由调用方按该行位置注入）；
 //itemHeight 清单未给，沿用 ROOM_CATEGORY_COLUMN.itemHeight（同一行内选择框与文字纵向居中）
 EQW_Layout.ROOM_OPTION_ROW = {
     kind: 'line', direction: 'horizontal', anchorX: 70,
-    itemWidth: 150, spacing: 0, anchor: 'left'
+    itemWidth: 150, itemHeight: EQW_Layout.ROOM_CATEGORY_COLUMN.itemHeight, spacing: 0, anchor: 'left',
+    runtime: ['anchorY']
 };
 
 //选项组之间的额外间隔（同类别下两个选项组之间比组内选项多留的间距）
 EQW_Layout.ROOM_OPTION_GROUP_GAP = 40;
 
 //选择框：贴所在选项槽左侧（资源 ROOM_OPT_BOX 22×22）。target 由调用方按选项槽注入
-EQW_Layout.ROOM_OPTION_BOX = { kind: 'attach', hAlign: 'left', vAlign: 'middle', w: 22, h: 22 };
+//（槽是 ROOM_OPTION_ROW 求解结果的第 N 项，故 targetKind 是 layout 而非精灵键）
+EQW_Layout.ROOM_OPTION_BOX = {
+    kind: 'attach', targetKind: 'layout', hAlign: 'left', vAlign: 'middle', w: 22, h: 22,
+    runtime: ['target']
+};
 
-//选项文字：贴同槽选择框右侧，纯文字，清单未给宽高。
+//选项文字：贴同槽选择框右侧（target 是该槽的 ROOM_BOX_* 精灵，由调用方按选项配置的 box 键注入），
+//纯文字，清单未给宽高，由调用方按渲染出的文案尺寸注入。
 //选中态变橙见 EQW_Layout.TEXT_STYLE.ROOM_OPT（normal / selected 两态，由调用方按选中状态二选一）
-EQW_Layout.ROOM_OPTION_TEXT = { kind: 'attach', hAlign: 'right', vAlign: 'middle', offsetX: 8 };
+EQW_Layout.ROOM_OPTION_TEXT = {
+    kind: 'attach', targetKind: 'sprite', hAlign: 'right', vAlign: 'middle', offsetX: 8,
+    runtime: ['target', 'w', 'h']
+};
 
-//房卡附注：贴扣卡组最后一个选项（固定精灵 ROOM_BOX_CARD_2）右侧
+//房卡附注：贴扣卡组最后一个选项（固定精灵 ROOM_BOX_CARD_2）右侧。纯文字，宽高随文案运行时注入
 EQW_Layout.ROOM_CARD_COST_NOTE = {
-    kind: 'attach', target: 'ROOM_BOX_CARD_2', hAlign: 'right', vAlign: 'middle', offsetX: 20,
-    textStyle: EQW_Layout.TEXT_STYLE.ROOM_CARD_COST_NOTE
+    kind: 'attach', targetKind: 'sprite', target: 'ROOM_BOX_CARD_2',
+    hAlign: 'right', vAlign: 'middle', offsetX: 20,
+    textStyle: EQW_Layout.TEXT_STYLE.ROOM_CARD_COST_NOTE,
+    runtime: ['w', 'h']
 };
 
 //折行：选项数超过 maxPerRow 时改用 grid。二七王每组最多 2 项，不会触发（清单 §6.9b 原文）；
 //清单原文是 grid{cols:maxPerRow, spacingX:0, spacingY:8, fillOrder:'row'}，cols 直接取自 maxPerRow，
-//故与 spacingX/spacingY/fillOrder 一并记为已定的四个字段；itemWidth / itemHeight / anchorX / anchorY
-//清单未给（该分支未被实际使用）
+//故与 spacingX/spacingY/fillOrder 一并记为已定的四个字段。
+//rows 由实际选项数决定（ceil(选项数 / cols)），anchorX/anchorY 随所在类别行浮动 —— 三者都是运行时值，
+//在 runtime 里显式声明；缺 rows 时求解器会抛错，不再静默返回空数组（一个矩形都不产出）。
+//itemWidth / itemHeight 清单同样未给：折行摆的还是同一批选项槽，沿用 ROOM_OPTION_ROW 的槽尺寸，
+//不另编一套数值；anchor 同理沿用 ROOM_OPTION_ROW 的 'left'（折行前后左边缘对齐一致）
 EQW_Layout.ROOM_OPTION_MAX_PER_ROW = 4;
-EQW_Layout.ROOM_OPTION_OVERFLOW_GRID = { kind: 'grid', cols: 4, spacingX: 0, spacingY: 8, fillOrder: 'row' };
+EQW_Layout.ROOM_OPTION_OVERFLOW_GRID = {
+    kind: 'grid', cols: EQW_Layout.ROOM_OPTION_MAX_PER_ROW, spacingX: 0, spacingY: 8, fillOrder: 'row',
+    itemWidth: EQW_Layout.ROOM_OPTION_ROW.itemWidth, itemHeight: EQW_Layout.ROOM_OPTION_ROW.itemHeight,
+    anchor: 'left',
+    runtime: ['rows', 'anchorX', 'anchorY']
+};
 
 ///////////////////////////////////////////////////////////////
 ////////// EQW_RoomOptions: 建房规则选项配置（清单 §1.1）///////

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

@@ -9,7 +9,9 @@ EQW_Layout.RESULT_BOTTOM_PANEL = { kind: 'point', x: 430, y: 140, w: 420, h: 148
 
 //底牌说明文字：贴面板底部，纯文字，清单未给宽高
 EQW_Layout.RESULT_BOTTOM_TEXT = {
-    kind: 'attach', target: 'RESULT_BOTTOM_PANEL', hAlign: 'center', vAlign: 'bottom', offsetY: -14
+    kind: 'attach', targetKind: 'layout', target: 'RESULT_BOTTOM_PANEL',
+    hAlign: 'center', vAlign: 'bottom', offsetY: -14,
+    runtime: ['w', 'h']
 };
 
 //三家分数光晕
@@ -24,7 +26,8 @@ EQW_Layout.RESULT_GLOW = {
 
 //三家总分大字：贴对应光晕居中。target 直接指向光晕精灵键（固定，非动态）
 EQW_Layout.RESULT_SCORE_TEXT = {
-    kind: 'attach', hAlign: 'center', vAlign: 'middle', textStyle: EQW_Layout.TEXT_STYLE.SCORE_BIG,
+    kind: 'attach', targetKind: 'sprite', hAlign: 'center', vAlign: 'middle',
+    textStyle: EQW_Layout.TEXT_STYLE.SCORE_BIG, runtime: ['w', 'h'],
     bySeat: {
         LEFT:  { target: 'RESULT_GLOW_LEFT' },
         RIGHT: { target: 'RESULT_GLOW_RIGHT' },
@@ -34,7 +37,8 @@ EQW_Layout.RESULT_SCORE_TEXT = {
 
 //三家『牌局分』：贴对应光晕左下
 EQW_Layout.RESULT_JF_TEXT = {
-    kind: 'attach', hAlign: 'left', vAlign: 'bottom', offsetX: -15, offsetY: 24,
+    kind: 'attach', targetKind: 'sprite', hAlign: 'left', vAlign: 'bottom', offsetX: -15, offsetY: 24,
+    runtime: ['w', 'h'],
     bySeat: {
         LEFT:  { target: 'RESULT_GLOW_LEFT' },
         RIGHT: { target: 'RESULT_GLOW_RIGHT' },
@@ -44,7 +48,8 @@ EQW_Layout.RESULT_JF_TEXT = {
 
 //三家『冲关分』：贴对应光晕右下
 EQW_Layout.RESULT_AW_TEXT = {
-    kind: 'attach', hAlign: 'right', vAlign: 'bottom', offsetX: 15, offsetY: 24,
+    kind: 'attach', targetKind: 'sprite', hAlign: 'right', vAlign: 'bottom', offsetX: 15, offsetY: 24,
+    runtime: ['w', 'h'],
     bySeat: {
         LEFT:  { target: 'RESULT_GLOW_LEFT' },
         RIGHT: { target: 'RESULT_GLOW_RIGHT' },

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

@@ -12,19 +12,28 @@ EQW_Layout.TOP_INFO_BG = { kind: 'point', x: 486, y: 4, w: 276, h: 68 };
 
 //顶部 · 花色图标：贴信息条内部左下角（资源 SUIT_ICON_S 30×30，清单 §3）
 EQW_Layout.TOP_SUIT_ICON = {
-    kind: 'attach', target: 'TOP_INFO_BG',
+    kind: 'attach', targetKind: 'layout', target: 'TOP_INFO_BG',
     hAlign: 'left', vAlign: 'bottom', offsetX: 20, offsetY: -8, w: 30, h: 30
 };
 
+//顶部 · 叫分数值文字 / 抓分数值文字：【清单 §6.5 未给出位置】——那张表只列了两个角标底与角标
+//文字，而角标底又必须贴在这两段数值文字身上。此处显式占位：坐标与宽高全部标为运行时注入，
+//由调用方按信息条内的三列表格实际排布给出；设计稿补齐后把 x/y/w/h 回填成固定值即可。
+//显式占位是为了避免 C 阶段在渲染代码里就地硬编码一组坐标——那样这两处位置就再也无从统一修改
+EQW_Layout.TOP_CALL_TEXT = { kind: 'point', runtime: ['x', 'y', 'w', 'h'] };
+EQW_Layout.TOP_GRADE_TEXT = { kind: 'point', runtime: ['x', 'y', 'w', 'h'] };
+
 //顶部 · 叫分角标底：贴叫分数值文字右上角（资源 BADGE_MULTIPLE 帧1 34×18）。
 //角标数值文字复用同一矩形，不单独配置（清单未给独立位置，下同）
 EQW_Layout.TOP_CALL_BADGE_BG = {
-    kind: 'attach', target: 'TOP_CALL_TEXT', corner: 'topRight', offsetX: 4, offsetY: 6, w: 34, h: 18
+    kind: 'attach', targetKind: 'layout', target: 'TOP_CALL_TEXT',
+    corner: 'topRight', offsetX: 4, offsetY: 6, w: 34, h: 18
 };
 
 //顶部 · 抓分角标底：贴抓分数值文字右上角（资源 BADGE_MULTIPLE 帧2 34×18）
 EQW_Layout.TOP_GRADE_BADGE_BG = {
-    kind: 'attach', target: 'TOP_GRADE_TEXT', corner: 'topRight', offsetX: 4, offsetY: 6, w: 34, h: 18
+    kind: 'attach', targetKind: 'layout', target: 'TOP_GRADE_TEXT',
+    corner: 'topRight', offsetX: 4, offsetY: 6, w: 34, h: 18
 };
 
 //亮牌信息条
@@ -81,7 +90,7 @@ EQW_Layout.PLAYER_AVATAR_FRAME_REF = {
 //会合并包括 kind 在内的所有字段，这里利用该机制表达「底栏庄标是固定坐标、不贴附任何目标」，
 //与 LEFT/RIGHT 两个上家贴头像框（attach）是不同的定位方式，不是笔误
 EQW_Layout.P_BANKER_MARK = {
-    kind: 'attach', w: 40, h: 40,
+    kind: 'attach', targetKind: 'platform', w: 40, h: 40,
     bySeat: {
         LEFT:  { target: 'P_LEFT_AVATAR',  corner: 'topRight', offsetX: 7,   offsetY: 8 },
         RIGHT: { target: 'P_RIGHT_AVATAR', corner: 'topLeft',  offsetX: -40, offsetY: 8 },
@@ -91,7 +100,7 @@ EQW_Layout.P_BANKER_MARK = {
 
 //『主N』角标底：仅左右两家（自己主/对数已在手牌区可见，无此角标）。w/h 为清单 §6.6 实测值
 EQW_Layout.P_ZHU_BADGE = {
-    kind: 'attach', corner: 'bottomLeft', offsetX: 0, offsetY: 6, w: 40, h: 19,
+    kind: 'attach', targetKind: 'platform', corner: 'bottomLeft', offsetX: 0, offsetY: 6, w: 40, h: 19,
     bySeat: {
         LEFT:  { target: 'P_LEFT_AVATAR' },
         RIGHT: { target: 'P_RIGHT_AVATAR' }
@@ -101,7 +110,7 @@ EQW_Layout.P_ZHU_BADGE = {
 //『对N』角标底：贴主N角标右侧。w/h 清单未重复给出，沿用主N角标同尺寸
 //（同资源 BADGE_ZHU_PAIR 的另一帧，帧1黄底=主N、帧2白底=对N，尺寸一致）
 EQW_Layout.P_PAIR_BADGE = {
-    kind: 'attach', target: 'P_ZHU_BADGE', hAlign: 'right', vAlign: 'middle',
+    kind: 'attach', targetKind: 'layout', target: 'P_ZHU_BADGE', hAlign: 'right', vAlign: 'middle',
     offsetX: 44, offsetY: 0, w: 40, h: 19
 };
 
@@ -127,7 +136,7 @@ EQW_Layout.P_COUNTDOWN = {
 //提示气泡（踩/没分/有分）：朝向 arrowRight 是配置项，不按座位硬判（清单 §6.6）。
 //w/h 清单 §3 标『待定』，此处用示意尺寸占位，资源定稿后回填（不影响 kind/字段结构）
 EQW_Layout.TISHI_BUBBLE = {
-    kind: 'attach', w: 96, h: 44,
+    kind: 'attach', targetKind: 'platform', w: 96, h: 44,
     bySeat: {
         LEFT:  { target: 'P_LEFT_AVATAR',  hAlign: 'right', vAlign: 'middle', offsetX: 10,  arrowRight: false },
         RIGHT: { target: 'P_RIGHT_AVATAR', hAlign: 'left',  vAlign: 'middle', offsetX: -10, arrowRight: true },

client/js/01_SubGame/codes/ui/LayoutSolver.js

@@ -7,22 +7,36 @@
 //
 // solve(node, ctx) 是【纯函数】：不碰精灵、不查引擎，故可完整单测。
 //   node: 一份布局配置（五型之一，可含 bySeat）
-//   ctx : { seat, count, rects }
+//   ctx : { seat, count, rects, <运行时注入字段> }
 //         seat  —— 'SELF'|'LEFT'|'RIGHT'，仅 bySeat 需要
 //         count —— 运行时项数（清单 §6.1：count 由数据给出、不进配置）
 //         rects —— { 键名: {x,y,width,height} }，仅 attach 需要
 //   返回恒为数组，point / attach 长度为 1。
 //
+// 【运行时注入】配置里写不出固定值的字段（动态文字宽高、贴哪张牌、随数据变化的行数/锚点…）
+// 一律留空，由调用方在 ctx 里补上；可注入字段见 INJECT_KEYS，优先级恒为 ctx > bySeat > base。
+// 布局节点用 runtime: ['target','w',…] 显式声明自己有哪些字段延后到运行时——那是给人和
+// 机械守卫看的契约（区分「忘了写」与「故意留空」），求解器本身对所有 INJECT_KEYS 一视同仁。
+//
 // 参数名一律沿用框架 AlignmentUtils 的入参名（清单 §6.0），配置可原样喂入。
 // 精灵锚点恒在左上角，配置里的 anchorX/anchorY 是【对齐基准点】，不是精灵左上角。
 // 出错一律抛异常，不返回 {x:0,y:0} 之类的兜底值（工程总则 §7 显式失败）。
 var EQW_LayoutSolver = EQW_LayoutSolver || {
 
+    //可由 ctx 运行时注入的配置字段（与布局节点 runtime 声明里允许出现的键名同一份清单）
+    INJECT_KEYS: ['target', 'x', 'y', 'w', 'h', 'anchorX', 'anchorY', 'rows', 'itemWidth', 'itemHeight'],
+
+    //各方向合法的对齐基准：框架 AlignmentUtils 的 switch 对不认识的 anchor 一律落到
+    //default（居中），写错方向的 anchor（如竖排写 'left'）会被静默吞掉、界面偏到画外也不报错。
+    //故在此按方向白名单校验，把笔误挡在求解入口（工程总则 §7 显式失败）
+    ANCHORS_HORIZONTAL: ['left', 'right', 'center'],
+    ANCHORS_VERTICAL:   ['top', 'bottom', 'center'],
+
     //——— 对外：求解 ———
     solve: function (node, ctx) {
         if (!node) { throw new Error('[EQW_LayoutSolver] node 为空'); }
         ctx = ctx || {};
-        var n = this._mergeBySeat(node, ctx.seat);
+        var n = this._mergeCtx(this._mergeBySeat(node, ctx.seat), ctx);
 
         switch (n.kind) {
             case 'point':  return this._solvePoint(n);
@@ -35,14 +49,69 @@ var EQW_LayoutSolver = EQW_LayoutSolver || {
     },
 
     //——— 对外：求解并摆精灵（唯一触碰 SpriteManager 之处）———
+    //精灵个数与求解出的矩形数必须一一对应：数量不等时显式抛错，【不静默截断】——
+    //少摆的那几个精灵会停在上一手牌的旧坐标上，是最难反查的一类错位（工程总则 §7 显式失败）
     apply: function (node, spriteIds, ctx) {
         var rects = this.solve(node, ctx);
-        for (var i = 0; i < spriteIds.length && i < rects.length; i++) {
+        if (!spriteIds || spriteIds.length !== rects.length) {
+            throw new Error('[EQW_LayoutSolver] apply 精灵数与矩形数不一致: spriteIds=' +
+                (spriteIds ? spriteIds.length : 0) + ' rects=' + rects.length);
+        }
+        for (var i = 0; i < spriteIds.length; i++) {
             SpriteManager.setPosition(spriteIds[i], rects[i].x, rects[i].y);
         }
         return rects;
     },
 
+    //——— ctx 运行时注入：ctx 里给出的 INJECT_KEYS 字段覆盖配置同名字段 ———
+    _mergeCtx: function (node, ctx) {
+        var hit = false;
+        var k, i;
+        for (i = 0; i < this.INJECT_KEYS.length; i++) {
+            if (typeof ctx[this.INJECT_KEYS[i]] !== 'undefined') { hit = true; break; }
+        }
+        if (!hit) { return node; }
+
+        var merged = {};
+        for (k in node) {
+            if (node.hasOwnProperty(k)) { merged[k] = node[k]; }
+        }
+        for (i = 0; i < this.INJECT_KEYS.length; i++) {
+            k = this.INJECT_KEYS[i];
+            if (typeof ctx[k] !== 'undefined') { merged[k] = ctx[k]; }
+        }
+        return merged;
+    },
+
+    //——— 对齐基准点校验：line/fan/grid 都要 anchorX/anchorY ———
+    //框架 AlignmentUtils 内部是 options.anchorY || 0，缺失会被静默当成 0（整排贴到画布顶边），
+    //故在此显式要求；写不出固定值的（如随类别行浮动的 anchorY）用 runtime 声明 + ctx 注入
+    _requireAnchorPoint: function (n) {
+        if (typeof n.anchorX !== 'number' || typeof n.anchorY !== 'number') {
+            throw new Error('[EQW_LayoutSolver] ' + n.kind + ' 需要数字 anchorX/anchorY：配置未写，' +
+                '且 ctx.anchorX/ctx.anchorY 未给出（anchorX=' + n.anchorX + ' anchorY=' + n.anchorY + '）');
+        }
+    },
+
+    //——— 方向 × 对齐基准校验 ———
+    _checkAnchor: function (direction, anchor) {
+        var allowed;
+        if (direction === 'vertical') {
+            allowed = this.ANCHORS_VERTICAL;
+        } else if (direction === 'horizontal' || typeof direction === 'undefined') {
+            allowed = this.ANCHORS_HORIZONTAL;   //不写 direction 等同水平（框架默认）
+        } else {
+            throw new Error('[EQW_LayoutSolver] 未知 direction: ' + direction);
+        }
+        //不写 anchor 等同框架默认 center，两个方向都合法；写了就必须与方向匹配
+        if (typeof anchor === 'undefined') { return; }
+        for (var i = 0; i < allowed.length; i++) {
+            if (allowed[i] === anchor) { return; }
+        }
+        throw new Error('[EQW_LayoutSolver] direction=' + (direction || 'horizontal') +
+            ' 不接受 anchor=' + anchor + '，只能是 ' + allowed.join('/'));
+    },
+
     //——— bySeat 合并：bySeat[seat] 覆盖外层 base，未列出的字段继承（清单 §6.2）———
     _mergeBySeat: function (node, seat) {
         if (!node.bySeat) { return node; }
@@ -61,12 +130,20 @@ var EQW_LayoutSolver = EQW_LayoutSolver || {
         return merged;
     },
 
+    //point：定点。x/y 缺失即无法定位，显式抛错——不返回 {x:undefined} 让 NaN 流到界面上
+    //（x/y 写不出固定值的节点，用 runtime 声明并由 ctx.x/ctx.y 注入）
     _solvePoint: function (n) {
+        if (typeof n.x !== 'number' || typeof n.y !== 'number') {
+            throw new Error('[EQW_LayoutSolver] point 需要数字 x/y：配置未写，且 ctx.x/ctx.y 未给出（x=' +
+                n.x + ' y=' + n.y + '）');
+        }
         return [{ x: n.x, y: n.y, width: n.w, height: n.h }];
     },
 
     //line：等距排列。带 items 时逐项取宽（itemWidth 失效），此时不能走 distribute（它假设等宽）
     _solveLine: function (n, ctx) {
+        this._checkAnchor(n.direction, n.anchor);
+        this._requireAnchorPoint(n);
         if (n.items) { return this._solveLineItems(n); }
 
         var count = ctx.count;
@@ -87,7 +164,11 @@ var EQW_LayoutSolver = EQW_LayoutSolver || {
     },
 
     //line + items：逐项不等宽（底栏功能钮组、埋牌操作条等，清单 §6.1）
+    //只实现了水平方向（逐项取宽、沿 x 推进）；竖排逐项不等高暂无用例，显式拒绝而不是按水平算
     _solveLineItems: function (n) {
+        if (n.direction === 'vertical') {
+            throw new Error('[EQW_LayoutSolver] line + items 仅支持 direction=horizontal');
+        }
         var items = n.items;
         var spacing = n.spacing || 0;
         var i, total = 0;
@@ -112,6 +193,8 @@ var EQW_LayoutSolver = EQW_LayoutSolver || {
 
     //fan：张数可变、总宽受限、动态压缩间距（清单 §6.1，间距算法【唯一实现】）
     _solveFan: function (n, ctx) {
+        this._checkAnchor(n.direction, n.anchor);
+        this._requireAnchorPoint(n);
         var count = ctx.count;
         if (typeof count !== 'number') { throw new Error('[EQW_LayoutSolver] fan 需要 ctx.count'); }
         if (count <= 0) { return []; }
@@ -141,6 +224,15 @@ var EQW_LayoutSolver = EQW_LayoutSolver || {
         if (n.fillOrder && n.fillOrder !== 'row') {
             throw new Error('[EQW_LayoutSolver] grid 仅支持 fillOrder=row，暂不支持: ' + n.fillOrder);
         }
+        //cols/rows 缺一即容量为 NaN：超载守卫失效（count > NaN 恒为 false）、循环一次都不跑、
+        //静默返回空数组——摆不下与「一个都没摆」同样必须显式失败（工程总则 §7）。
+        //rows 允许由 ctx.rows 运行时注入（行数随实际项数而定的场景），此处校验的是合并后的有效值
+        if (typeof n.cols !== 'number' || typeof n.rows !== 'number') {
+            throw new Error('[EQW_LayoutSolver] grid 需要数字 cols/rows：配置未写，且 ctx.rows 未给出（cols=' +
+                n.cols + ' rows=' + n.rows + '）');
+        }
+        this._checkAnchor('horizontal', n.anchor);   //grid 逐行走水平分布，anchor 同水平语义
+        this._requireAnchorPoint(n);
 
         var capacity = n.cols * n.rows;
         var count = (typeof ctx.count === 'number') ? ctx.count : capacity;
@@ -173,17 +265,16 @@ var EQW_LayoutSolver = EQW_LayoutSolver || {
     //attach：贴在另一个精灵上。corner 为空 = 在目标【内部】对齐；有值 = 与目标对应角重合
     //target/w/h 都支持运行时注入：叫分档位贴自己的按钮、花色图标贴自己的按钮、牌角标贴"打出的那张牌"，
     //这类目标配置里写不出固定值；动态文字标签的真实宽高要等文案渲染出来才知道，配置里也留空。
-    //这些节点写成模板，由 ctx.target/ctx.w/ctx.h 在运行时补上（ctx.* 优先于 n.* 里的同名字段）
+    //这些节点写成模板并用 runtime 声明留空字段，由 ctx 在运行时补上（已在 solve 里合并进 n）
     _solveAttach: function (n, ctx) {
         if (!ctx.rects) { throw new Error('[EQW_LayoutSolver] attach 需要 ctx.rects'); }
-        var targetKey = ctx.target || n.target;
+        var targetKey = n.target;
         if (!targetKey) { throw new Error('[EQW_LayoutSolver] attach 配置未写 target，且 ctx.target 未给出'); }
         var target = ctx.rects[targetKey];
         if (!target) { throw new Error('[EQW_LayoutSolver] attach 的 target 未在 ctx.rects 中: ' + targetKey); }
 
-        //ctx.w/ctx.h 优先于配置里的 n.w/n.h；后续的校验、求解、返回值一律用合并后的值
-        var w = (typeof ctx.w === 'number') ? ctx.w : n.w;
-        var h = (typeof ctx.h === 'number') ? ctx.h : n.h;
+        var w = n.w;
+        var h = n.h;
 
         var sprite = { width: w, height: h };
         var offset = { x: n.offsetX || 0, y: n.offsetY || 0 };