merge(同步 master): 并迭代 35 结项批（ec6eeba3）——按新收口顺序先并后跑闸

design/gdd/systems/冒险循环/关卡节点图生成.md

@@ -1,7 +1,7 @@
 # 关卡节点图生成
 
 > 一句话：一关的节点图从哪来——生成器按参数长出一张合法图
-> 状态：现行为 v1.2
+> 状态：现行为 v1.3
 
 ## 设计目的
 
@@ -47,7 +47,9 @@
 | 层高＝沿路步数 | 入口到终点的最长路径步数；第一关 ≥6，逐关递增且增幅变大 |
 | 出口归属锁定 | 多终点时由大岔口把图分成互不连达的分支区域，各区域只通向自己的终点；每个终点前一层节点的去路集合恰含一个终点——选路＝提前承诺打谁 |
 | 战斗节点保底 | 奖励/恢复/商店占位后战斗节点量不被挤没（保底数进调参表） |
-| 多终点深度互异 | 多终点（多 Boss 节点）必须落在互异的深度带；同一深度带出现两个终点即判产出无效——共带会让「走哪条路打谁」落空 |
+| 多终点深度互异 | 多终点（多 Boss 节点）必须落在互异的节点深度；同一节点深度出现两个终点即判产出无效——共深会让「走哪条路打谁」落空 |
+
+节点深度的算法：自入口沿路走到该节点的最长路径步数；多入口时取距任一入口的最长路径。不用最短路径——合流节点或多入口图上取最短，会让某些出边指向深度不增甚至更浅的节点，破坏「连线只朝前进方向」的无环判据。
 
 结构铁律：连线只朝前进方向（无环）；入口、终点都可多个（个数＝参数档），每条路径恰好从一个入口出发、恰好到达一个终点。
 
@@ -76,13 +78,14 @@
 
 配比是生成旋钮：战斗/奖励/恢复/商店各占多少由参数档定，生成器掷出分布落在图上成为节点类型；配比只管非终点节点，终点恒为 Boss、不进配比。节点类型在可见范围内对玩家公开（可见性规则归关卡节点地图）——看得见的类型才谈得上提前规划。
 
-摆放约束（三条）：
+摆放约束（四条）：
 
 | 约束 | 内容 |
 |---|---|
 | 商店位 | 每个终点前一位恰一家商店——每名玩家一局必经恰一家店 |
 | 岔路取舍·下一跳 | 一个岔口分出的各条去路，下一节点类型互不相同——下一跳必在可见范围，是决策的可见锚（实现侧已兑现：候选集强制豁免类型可见性） |
 | 岔路取舍·支路构成 | 一个岔口分出的各条支路，整条支路的节点类型构成互不相同——每条支路至少有一个别的支路没有的类型（例：一路有恢复节点、一路有奖励节点） |
+| 支路互异上限＝出口数 3 | 商店与 Boss 每条支路必有，可供支路互斥的类型只剩战斗/奖励/恢复三类——一条链上的岔口最多切出 3 条互异支路，故出口个数取值域为 1–3（见生成参数旋钮表） |
 
 内容归各 owner：战斗节点打谁＝敌人系统按深度带配池；奖励/恢复/商店的兑付语义＝关卡节点地图与各 owner 文档。
 

design/gdd/systems/冒险循环/关卡节点地图.md

@@ -1,7 +1,7 @@
 # 关卡节点地图
 
 > 一句话：单关内的节点图选路与推进
-> 状态：现行为 v2.2
+> 状态：现行为 v2.3
 
 ## 设计目的
 
@@ -54,7 +54,7 @@
 
 | 节点类型 | 机制承诺 |
 |---|---|
-| 战斗 | 携带节点编号；行进至此开战（兑付见下节）；胜利后回到选路 |
+| 战斗 | 携带节点深度；行进至此开战（兑付见下节）；胜利后回到选路 |
 | Boss | 恒为图终点；行进至此开 Boss 战；胜利即关卡收束点 |
 | 奖励 | 行进至此触发节点奖励（兑付见下节）；反馈呈现后回到选路 |
 | 恢复 | 行进至此向冒险结构发治疗封顶回报；反馈呈现后回到选路 |
@@ -62,7 +62,7 @@
 
 商店房的编排规则：**每个终点前一位恰一家店**——哈迪斯式的"决战前最后一个补给点"：买到的属性还有整段战斗可消费，错过的成长也没有第二家店可补。终点前一位同时是**必经位**：每名玩家一局恰好必经一家店，成长保底是图结构事实而非玩家自觉。这条位置约束不由加载校验承载，由冒烟断言把关（摆放规则语义见[关卡节点图生成](关卡节点图生成.md)配比节）。
 
-每个节点在图上有**节点深度**（本文含义：从入口沿路走过来的步数），用来当战斗的定位地址——遭遇坐标＝关卡序号＋节点深度，敌人表按**深度带**（深度区间）配池，寻址语义见[敌人系统](../战斗循环/敌人系统.md)。"最深处是关底"的直感由深度承载：终点恒在各路径最深处。单链（每步只有一条连线）是合法退化形态，节点深度等于它前面走过的战斗场数；三关参数档都含岔口，第一关不再是单链。图的来源见[关卡节点图生成](关卡节点图生成.md)。
+每个节点在图上有**节点深度**（本文含义：自入口沿路走到该节点的最长路径步数；多入口时取距任一入口的最长路径），用来当战斗的定位地址——遭遇坐标＝关卡序号＋节点深度，敌人表按**深度带**（深度区间）配池，寻址语义见[敌人系统](../战斗循环/敌人系统.md)。不用最短路径：合流节点或多入口图上取最短，会让某些出边指向深度不增甚至更浅的节点，破坏「连线只朝前进方向」的无环判据。"最深处是关底"的直感由深度承载：终点恒在各路径最深处。单链（每步只有一条连线）是合法退化形态，节点深度等于它前面走过的战斗场数；三关参数档都含岔口，第一关不再是单链。图的来源见[关卡节点图生成](关卡节点图生成.md)。
 
 呈现侧口径（2026-09-17 用户拍板）：节点图的画面表达走**方块地牢观感**——节点画成地牢房间的方块、连线画成通道——但逻辑拓扑就是本文的节点图，不产生任何额外选路或探索语义。关卡画面本体即节点链进度的呈现载体（选路覆盖层的常驻形态，节点态直接读图：已过暗金 / 当前金 / 候选下一跳通道亮金 / Boss 紫赤描边（紫赤＋深墨环，视觉定稿见 [level-map](../../ux/level-map.md)）），不另设进度条组件；视觉规格归 [HUD 框架](../表现与支撑/HUD框架.md)。
 
@@ -155,7 +155,7 @@ Boss 兑付（胜利或英雄死亡）触发关卡收束点，此后不再有选
 
 1. 从冒险结构接收开始关卡（关卡序号、当前生命、生效上限），加载本关节点图并呈现选路停点（关卡画面），玩家在图上选出第一跳，行进自所选节点开始（入口节点不自动进入）。
 2. 每节点兑付完成并确认后返回关卡画面，玩家再选路前进；岔路选一条、单链点继续；零自动推进。
-3. 战斗 / Boss 节点：组装关卡序号 + 节点编号，移交战斗结算开战；战斗结束向冒险结构上报战斗结果。
+3. 战斗 / Boss 节点：组装关卡序号 + 节点深度，移交战斗结算开战；战斗结束向冒险结构上报战斗结果。
 4. 奖励节点：触发节点奖励兑付 = 提升三选一（与通关三选一共享令牌库）；恢复节点：向冒险结构发治疗封顶回报；商店节点：打开商店覆盖层，购买即时生效，离开后兑付确认。
 5. Boss 战胜利或任意战斗倒下 = 关卡收束点：先调战斗结算的关卡收束清库，再宣布关卡结束。
 6. 单链是合法退化形态；三关参数档都含岔口，第一关即有选择（图的来源见[关卡节点图生成](关卡节点图生成.md)）。
@@ -177,7 +177,7 @@ Boss 兑付（胜利或英雄死亡）触发关卡收束点，此后不再有选
 
 - 图合法：行集通过加载校验——每条路径恰好从一个入口出发、恰好到达一个终点，终点恒为 Boss（可多个）、连线无环、任意入口出发的任意路径都到达某一个终点；违规配置加载期致命（规则语义见[关卡节点图生成](关卡节点图生成.md)产出规格）。
 - 行进自主：从入口到 Boss 的每一次前进都由玩家选路发起（含关卡开始后的第一跳——关卡开始停在图上，入口节点不自动进入）；不存在任何自动推进路径；倒下时行进终止。
-- 兑付移交：每场开战调用携带（关卡序号 + 节点编号），与节点图上该节点位置一致；每场战斗结束恰一次战斗结果上报。
+- 兑付移交：每场开战调用携带（关卡序号 + 节点深度），与节点图上该节点位置一致；每场战斗结束恰一次战斗结果上报。
 - 兑付后确认：战斗节点的继续确认挂战斗总结结算（settlement-summary.md），奖励/恢复挂兑付反馈覆盖层；到达与兑付之间无确认步。
 - 恢复兑付：治疗封顶回报载荷 = 该关恢复比例（读关卡配置行）；满血回复 0 是合法状态（执行语义归冒险结构）。
 - 奖励兑付：奖励节点兑付恰触发一次；池空直通空态合法，现行 = 提升三选一（与通关三选一共享令牌库）取一件按件类兑付（spec：node-reward.md v2.x；兑付路由归[冒险结构](冒险结构.md)提升池节）。

design/gdd/systems/冒险循环/冒险结构.md

@@ -261,7 +261,7 @@ GP（显示名「GP」）是冒险内的一次性属性提升货币：战斗胜
 
 | 参数 | 域 | 现行值 | 说明 |
 |---|---|---|---|
-| 关卡行集（关数与图的参数档） | 关卡表逐关行 | 三关现行（图由生成器按参数档产出，见[关卡节点图生成](关卡节点图生成.md)；旧模板池随实现批清数据） | 加关 = 内容批（参数档 + 敌我数值 + 新元素同批）；确定性 = 固定种子＋固定参数档（首局教学与存档复现的固定图由此承载，无兜底模板） |
+| 关卡行集（关数与图的参数档） | 关卡表逐关行 | 三关现行（图由生成器按参数档产出，见[关卡节点图生成](关卡节点图生成.md)） | 加关 = 内容批（参数档 + 敌我数值 + 新元素同批）；确定性 = 固定种子＋固定参数档（首局教学与存档复现的固定图由此承载，无兜底模板） |
 | 恢复比例 | int [0,100]，逐关行 | 见 level.tres rest_heal_pct（provisional） | 恢复点回复生效上限的百分比；随上限加成同步放大；100 = 恢复点变全满泉，0 = 死节点 |
 | 上限提升 | int [0,999]，冒险表逐件列 | adventure_table bonus_attack_flat / bonus_max_hp_flat / bonus_armor_flat（provisional） | 三选一属性件各自兑付值；值锚与上调约束归难度曲线与Boss |
 | 三选一件值（其余） | int [0,999]，冒险表 kind×tier 列族 | adventure_table curio_value_*（GP 袋 / AP 件 / 恢复 / 刷新，provisional） | 令牌件值读表；道具件授予件数随秘宝件出池退役 |
@@ -290,7 +290,7 @@ GP（显示名「GP」）是冒险内的一次性属性提升货币：战斗胜
 - 同调位约束：道具终态持有恒 ≤ 同调位（谓词表实时求值）；超位时停点渠道触发替换交互（丢旧收新 / 放弃新件两路），战斗内渠道沉没不入；奖励节点渠道同受约束。（现行零道具件投放——约束保留作契约，见「秘宝件受同调位约束」节注。）
 - 钥石逐杀：Boss 击杀后钥石累计增量 = boss_keystone 行值（首杀/复杀两档）；大奖励面钥石入账零残留。
 - 收束次序：通关宣布到达时库存已被关卡节点地图先行清空；重复的关卡结束宣布被拒绝，状态与摘要零变化。
-- 覆盖义务：冒烟断言——行集内每个战斗与关底节点（关、深）在敌人与棋盘生成的数值表中有精确行；序列关数 = 行集关数。
+- 覆盖义务：冒烟断言——行集内每个战斗与关底节点（关、深）都必须在敌人与棋盘生成的数值表里命中：敌侧按深度带命中（落带不早于请求深度，禁以顶带 clamp 消解），板侧按解析命中；生成图深度域 L1 0–6／L2 0–9／L3 0–13（参数档 `layers` 实测，provisional）；序列关数 = 行集关数。
 - 生效前提未兑现（第二关行缺行）：以单关冒险运行（合法态），越界关断言显式跳过而非失败。
 - 放弃：战斗中的放弃请求被拒绝；非战斗期放弃按失败同型结算，已获大奖励不追回；放弃入口仅在选路停点呈现且只在冒险模式开放。
 - 种子域：冒险内零随机流自开，一切随机派生自主种子（含 GP 掉落掷定的 gp_drop 封闭流）；同种子同操作序列两局逐位可复现。

design/gdd/ux/level-map.md

@@ -2,12 +2,13 @@
 
 > **Status**: 定稿版——三项设计提案已拍板完成（2026-09-27：底栏状态展示 / 图上点击选路·候选按钮退役 / 放弃二次确认）；**形态已升格独立屏（2026-09-28 用户裁决：独立存在为最终形态）**；**视觉终稿已冻结（2026-09-28 关卡画面样张 v1 机检 11/11 全绿，闸形 A——冻结值见 Layout/组件清单与样张机检报告，迭代 4）**
 > **Author**: user + ZCode（关卡画面 UX 批）
-> **Last Updated**: 2026-10-15（简明技术中文用语规范批：词面修正 6 处）
+> **Last Updated**: 2026-10-25（迭代 35 生成图换代：呈现面随动登记）
 > **Platform Target**: PC (Steam)——Keyboard/Mouse 主，全部操作纯鼠标可完成（同 [battle.md](battle.md)）
 > **Template**: UX Spec
 > **覆盖范围**: 独立屏形态（关卡停点全景）· 入口停点 · 岔路停点 · 单链停点 · 放弃冒险入口
 > **不覆盖**: 节点覆盖层（NodeOverlay——奖励/恢复兑付反馈，spec：[node-reward.md](node-reward.md)）、商店覆盖层（spec：[shop.md](shop.md)）、关卡结算屏（[level-clear.md](level-clear.md)）、战斗屏（[battle.md](battle.md)）
 > **机制权威**: [关卡节点地图](../systems/冒险循环/关卡节点地图.md)（选路、兑付、停点语义）；图的来源 = [关卡节点图生成](../systems/冒险循环/关卡节点图生成.md)（参数化长图——只换图的来源与形态，不换本屏的呈现语义；多终点时各终点均带 Boss 标记，标记语义不变、数量随图；图形态随参数变化，布局自适应，形态不进呈现代码）；**系统契约**: [HUD框架](../systems/表现与支撑/HUD框架.md)（订阅纪律、模态层级、可访问性基线）
+> **生成图随动登记（2026-10-25）**：入口停点候选数＝入口个数（1 或多，多入口并列呈现，首跳即选从哪个入口进场）；节点数字＝图内句柄 id（非节点深度、非数组序）；生成图深度域 L3 上探至 0–13，超出画布冻结公式约 10 层的屏预算——等比缩放与滚动视口两案均未设计，归呈现批（见待办清单「超预算图策略升级路径」条），本 spec 冻结值暂不变。
 
 ---
 
@@ -65,7 +66,7 @@
 | 区 | 位置与尺寸 | 内容 |
 |---|---|---|
 | **顶栏语境** | 居中横排，图区上方，高约 32px | 左：关卡名（`level_row.display_name`，如「第二层 · 幽暗地域」）；右：GP 常驻徽章（GP 图标+数字，直角细线数据框——GP 值域超点阵适用档，走 pattern 5 的 When-NOT-to-Use 路线）；HP 归底部状态栏（2026-09-27 拍板完成） |
-| **节点图区** | 居中 | 整幅节点图自绘：节点方块 + 通道折线 + 节点态着色 + Boss 紫赤描边。画布随图自适应（**冻结公式**：宽 = 70+层深×122+44.5、高 = 52+槽位×58+25+24，下限 620×256——routebug 83c11a1 根修件）；通道折线**冻结 2/3/4px**（未点亮石灰 STONE/候选亮金 GOLD_LIT/悬停加粗）；节点方块 52×36 内**节点图标 20px 烘焙 1:1**（♻ kenney 五键：战=弓/赏=桂冠/疗=篝火/王=王冠/商=钱袋，WARM 单色、当前金底转深墨——双色墨制）+ 编号 10px 右上角 |
+| **节点图区** | 居中 | 整幅节点图自绘：节点方块 + 通道折线 + 节点态着色 + Boss 紫赤描边。画布随图自适应（**冻结公式**：宽 = 70+层深×122+44.5、高 = 52+槽位×58+25+24，下限 620×256——routebug 83c11a1 根修件）；通道折线**冻结 2/3/4px**（未点亮石灰 STONE/候选亮金 GOLD_LIT/悬停加粗）；节点方块 52×36 内**节点图标 20px 烘焙 1:1**（♻ kenney 五键：战=弓/赏=桂冠/疗=篝火/王=王冠/商=钱袋，WARM 单色、当前金底转深墨——双色墨制）+ 编号（图内句柄 id）10px 右上角 |
 | **底部状态栏** | 图区下方横排，高约 48px | 左-中：状态数据框组（直角细线，pattern 5 族）——生命（当前/上限 + 迷你血条）、属性（攻击 / 护甲 AC，有效值 + 加成角标）、本关加成（攻+X · 上限+Y · AC+Z，零加成隐藏）；右端：放弃冒险按钮（危险红族文字，与状态数据框保持间距——破坏性确认异位，pattern 7） |
 
 ### Component Inventory
@@ -74,7 +75,7 @@
 |---|---|---|---|---|
 | 关卡名标签 | 文本 | `level_row.display_name`（关卡表行读数） | 只读 | 新建（现行标题位升级） |
 | GP 常驻徽章 | 直角细线数据框 | GP 图标 + 数字（`runner.gp`，冒险钱包读数；刷新经 `wallet_changed` 信号投影〔gain/buy/clear 三事件〕或写路径回执后重查） | 只读 | 新建（GP 去向拍板落地面） |
-| 节点图画布 | 自绘 Control | 节点图标（五键 20px 烘焙，双色墨制）+ 编号、通道折线、节点态着色、Boss 紫赤描边+深墨环（BOSS_PURPLE——2026-09-26 封印紫批语义：紫赤本色） | 悬停预承诺 / 点击提交选路（唯一通道） | ✅ level_map_screen.gd `_draw_graph`（视觉终稿已落码——迭代 4 T2/T3） |
+| 节点图画布 | 自绘 Control | 节点图标（五键 20px 烘焙，双色墨制）+ 编号（图内句柄 id）、通道折线、节点态着色、Boss 紫赤描边+深墨环（BOSS_PURPLE——2026-09-26 封印紫批语义：紫赤本色） | 悬停预承诺 / 点击提交选路（唯一通道） | ✅ level_map_screen.gd `_draw_graph`（视觉终稿已落码——迭代 4 T2/T3） |
 | 状态数据框组 | 直角细线数据框 ×3 | 生命（当前/上限 + 迷你血条）、属性（攻击 / 护甲 AC 有效值 + 加成角标）、本关加成（加算区增量列表，零加成隐藏） | 只读 | 新建（2026-09-27 拍板：底栏状态展示） |
 | 放弃冒险按钮 | 按钮（危险红族） | 「放弃冒险（同失败结算——已获大奖励保留）」；二次确认态已拍板（见布局决策 3） | 点击（首击转确认态、二击提交） | ✅ level_map_screen.gd（可见性归组合根，仅冒险模式开） |
 | 标题行 | 文本 | 停点语境提示（见布局决策 1 三停点标题） | 只读 | ✅ level_map_screen.gd `_title`（措辞已按布局决策 1 改稿） |
@@ -83,7 +84,7 @@
 
 | 停点 | 候选数 | 标题 |
 |---|---|---|
-| 入口停点 | 1（入口节点） | 「出发——选择首个节点」 |
+| 入口停点 | 入口个数（1 或多） | 「出发——选择首个节点」 |
 | 单链停点 | 1 | 「继续前进」 |
 | 岔路停点 | ≥2 | 「选择下一节点」 |