feat(m3-iter5-T5): 关卡节点图生成特性批·台阶一全落地——15张骨架(3关×5,模板0=现行图回滚档;L1单链排列变体/L2L3网状图变体,战斗id恒∈遭遇表行集,商店必经位承袭)+node_map扩签(标签不参与派生只进日志,黄金向量零动)+首次冒险固定脚本(存档布尔位唯一新增域,老档迁移=true,收束点置位幂等)+池内全模板加载校验(validate抽出与跨表校验模板感知)+MC分层出数(RUNSUM level_templates逐节点模板名,抽查五模板全被抽中);冒烟558→576(新增17断言:池参数/零scope强制/抽签确定性/N=1等价/首冒分支/收束置位幂等);生成器tools/t5_build_templates.py含生成前自校验

game/core/adventure_runner.gd

@@ -62,7 +62,8 @@ var _runner: LevelRunner                  # 当前关卡行进器（每关新建
 var _pending_next_level := false          # 大奖励已兑付、等 continue_to_next_level 确认
 var _last_level_payload := {}             # 最近一次关卡结束载荷（失败结算的败退节点明细来源——数值验证取数面）
 var _override := [0, 0]                   # TunePanel 百分比通道 [atk_pct, hp_pct]（每关新 runner 都要应用）
-var _base_override := {"atk": 0, "max_hp": 0, "armor_class": 0}   # 永久强化 flat 注入（元进度实现批——冒险开始参数面 params.hero_override 存入，共享给 LevelRunner；全零 = 白板）
+var _base_override := {"atk": 0, "max_hp": 0, "armor_class": 0}
+var _first_script := false                # 首次脚本模式（关卡节点图生成 v0.4——true = 全关零抽签取池内模板 0；测量夹具恒 false）   # 永久强化 flat 注入（元进度实现批——冒险开始参数面 params.hero_override 存入，共享给 LevelRunner；全零 = 白板）
 
 
 func _init(db_ref, rng_ref) -> void:
@@ -91,6 +92,7 @@ func start_adventure(seed_val: int, params: Dictionary = {}) -> bool:
 	level_index = 1
 	_pending_next_level = false
 	_base_override = _normalize_override(params.get("hero_override", {}))
+	_first_script = bool(params.get("first_script", false))   # 缺省 = 非首次（抽签路径；真实侧由呈现层读存档布尔位传入）
 	ledger["hero_hp"] = int(db.hero.max_hp) + int(_base_override["max_hp"])   # 生命账本置满（表值+永久强化 flat——加算区刚归零）
 	state = "running"
 	return _start_current_level()
@@ -164,7 +166,8 @@ func _start_current_level() -> bool:
 	# 该回调重取 runner 实例），后 present_entry_choice()（入口候选呈现；顺序反了选路口会被呈现层
 	# 的 runner 空防御静默丢弃）。呈现零 RNG 消耗、pick 走同一 _enter_node——测量面逐位零漂移。
 	var ok: bool = _runner.start_level_external(level_index, ledger, bonus, purchased,
-		Callable(self, "apply_rest"), _base_override, true)
+		Callable(self, "apply_rest"), _base_override, true,
+		0 if _first_script else -1)   # 首次脚本 = 每关固定模板 0 零抽签（v0.4 拍板点①）；否则逐关抽签
 	if ok:
 		level_started.emit(level_index, String(_runner.level_row.get("display_name", "")))
 		_runner.present_entry_choice()

game/core/config_db.gd

@@ -169,15 +169,24 @@ func _cross_validate(loaded: Dictionary) -> void:
 			en_keys["%d_%d" % [int(row.level_index), int(row.node_depth)]] = true
 		for lrow in lv.rows:
 			var li: int = int(lrow.level_index)
-			for node in lrow.nodes:
-				var t: String = String(node.get("type", ""))
-				if t != "battle" and t != "boss":
-					continue
-				var key := "%d_%d" % [li, int(node.get("node_depth", -1))]
-				if not bg_keys.has(key):
-					push_diag("error", "level_node_dangling", "level %d %s 节点 (%s) 在 board_gen 无精确行" % [li, t, key])
-				if not en_keys.has(key):
-					push_diag("error", "level_node_dangling", "level %d %s 节点 (%s) 在 enemy 无精确行" % [li, t, key])
+			# 模板池感知（关卡节点图生成 v0.4——池内全模板跨表校验，不只 row.nodes）
+			var node_lists: Array = []
+			var tpls: Array = lrow.get("templates", [])
+			if tpls.is_empty():
+				node_lists.append(lrow.get("nodes", []))
+			else:
+				for tpl in tpls:
+					node_lists.append(tpl.get("nodes", []))
+			for nodes_arr in node_lists:
+				for node in nodes_arr:
+					var t: String = String(node.get("type", ""))
+					if t != "battle" and t != "boss":
+						continue
+					var key := "%d_%d" % [li, int(node.get("node_depth", -1))]
+					if not bg_keys.has(key):
+						push_diag("error", "level_node_dangling", "level %d %s 节点 (%s) 在 board_gen 无精确行" % [li, t, key])
+					if not en_keys.has(key):
+						push_diag("error", "level_node_dangling", "level %d %s 节点 (%s) 在 enemy 无精确行" % [li, t, key])
 	# ⑤ 技能池引用完整性（敌人技能池批——敌人表池 × 技能表；独立入口 validate_skill_pool_links 供冒烟直验）
 	var skt = loaded.get("skill")
 	if skt != null and en != null:

game/core/level_runner.gd

@@ -110,7 +110,7 @@ func restore_hero_base() -> void:
 
 # ---- 关卡生命周期 ----
 
-func start_level(level_index: int, seed_val: int, base_override_in: Dictionary = {}) -> bool:
+func start_level(level_index: int, seed_val: int, base_override_in: Dictionary = {}, template_pick: int = -1) -> bool:
 	# 单关测试模式（旧路径——既有语义一字不改）：私有账本、内置恢复数学、自调 new_adventure（漂移①
 	# 单关=冒险的历史简化在测试模式保留；正式种子域归 AdventureRunner.start_adventure）
 	# base_override_in = 永久强化 flat 注入尾参（换算率标定批 2026-09-23——缺省 {} 全零白板，
@@ -124,7 +124,6 @@ func start_level(level_index: int, seed_val: int, base_override_in: Dictionary =
 	if row.is_empty():
 		push_error("[关卡节点地图] level_index %d 在 LevelTable 无行" % level_index)
 		return false
-	level_row = row
 	node_index = -1
 	level_result = ""
 	_awaiting_choice = false
@@ -143,6 +142,7 @@ func start_level(level_index: int, seed_val: int, base_override_in: Dictionary =
 			break
 	hero_hp = effective_max_hp()
 	rng.new_adventure(seed_val)            # 关卡起点 = 冒险起点（切片口径；跨关接续归 冒险结构）
+	level_row = _resolve_template_row(row, template_pick)   # 池解析在播种后（node_map 抽签须已播种——EC7）
 	_running = true
 	var entry := _entry_node()
 	if entry.is_empty():
@@ -166,7 +166,7 @@ func start_level(level_index: int, seed_val: int, base_override_in: Dictionary =
 # _enter_node(entry)——与旧自动进入逐位等价（测量面零漂移红线）。
 func start_level_external(level_index: int, ledger: Dictionary, bonus_ref: Dictionary,
 		purchased_ref: Dictionary, rest_handler: Callable, base_override_ref: Dictionary = {},
-		defer_entry: bool = false) -> bool:
+		defer_entry: bool = false, template_pick: int = -1) -> bool:
 	var row := _find_level_row(level_index)
 	if row.is_empty():
 		push_error("[关卡节点地图] level_index %d 在 LevelTable 无行" % level_index)
@@ -177,7 +177,7 @@ func start_level_external(level_index: int, ledger: Dictionary, bonus_ref: Dicti
 	base_override = base_override_ref
 	_shop_purchased = purchased_ref
 	_rest_handler = rest_handler
-	level_row = row
+	level_row = _resolve_template_row(row, template_pick)
 	node_index = -1
 	level_result = ""
 	_awaiting_choice = false
@@ -218,6 +218,30 @@ func _find_level_row(level_index: int) -> Dictionary:
 	return {}
 
 
+# ---- 模板池解析（关卡节点图生成 v0.4——M-3 迭代 5 T5）----
+# row.templates 非空 = 池形态：template_pick >= 0 = 强制取该模板（首次脚本模式/冒烟固定图，零 RNG 消费）；
+# -1 = 抽签（node_map 用途标签恰一 scope，均匀取模）。空池 = 旧单图形态原样返回（向后兼容零迁移）。
+# 解析产物 = row 副本换 nodes（下游 nodes()/校验/呈现全透明）；active_template_name 供 MC 分层出数。
+var active_template_name := ""
+
+func _resolve_template_row(row: Dictionary, template_pick: int) -> Dictionary:
+	var templates: Array = row.get("templates", [])
+	active_template_name = ""
+	if templates.is_empty():
+		return row
+	var idx := 0
+	if template_pick >= 0:
+		idx = clampi(template_pick, 0, templates.size() - 1)
+	else:
+		var stream: RandomNumberGenerator = rng.open_stream("node_map")
+		idx = stream.randi_range(0, templates.size() - 1)
+	var tpl: Dictionary = templates[idx]
+	active_template_name = String(tpl.get("display_name", ""))
+	var out := row.duplicate(true)
+	out["nodes"] = tpl.get("nodes", [])
+	return out
+
+
 func nodes() -> Array:
 	return level_row.get("nodes", [])
 

game/core/meta_progression.gd

@@ -116,6 +116,8 @@ func refresh_workshop_unlocks() -> Array:
 # 明细 {big_reward, boss_drops: [{level, first, amount}], total, new_unlocks}；
 # 入账与标记经 save.apply_adventure_summary（boss_drops 副本随摘要入 recent_summaries）。
 func settle_adventure(summary: Dictionary) -> Dictionary:
+	# 首次冒险布尔位置位（关卡节点图生成 v0.4——完成/失败/放弃三结局同经本收束挂点，写入只在收束）
+	save.mark_first_adventure_done()
 	var drops: Array = []
 	for li in range(1, int(summary.get("levels_cleared", 0)) + 1):
 		var first: bool = not save.boss_first_kill_marked(li)

game/core/rng_service.gd

@@ -14,7 +14,7 @@
 extends Node
 
 # 用途标签封闭词表（并流前七流名全保留；新增用途走扩签通道 = 改代码 + 评审——清单封闭语义由「流」改「标签」）
-const PURPOSE_TAGS := ["board_gen", "reward_roll", "encounter", "armor_roll", "behavior_roll", "variant_place", "gp_drop"]
+const PURPOSE_TAGS := ["board_gen", "reward_roll", "encounter", "armor_roll", "behavior_roll", "variant_place", "gp_drop", "node_map"]   # node_map = 关卡节点图生成 v0.4 扩签（M-3 迭代 5 T5——标签不参与派生只进事件日志，派生/黄金向量零改动）
 
 # 分段表达式书写（数据配置 R3 实现级规约——禁 ≥2^63 完整字面量）
 const GOLDEN_RATIO := (0x9E3779B9 << 32) | 0x7F4A7C15      # 0x9E3779B97F4A7C15

game/core/save_manager.gd

@@ -54,10 +54,23 @@ func _default_data() -> Dictionary:
 			"level_clear_counts": {"1": 0, "2": 0, "3": 0},
 			"boss_first_kill": {},
 			"recent_summaries": [],
+			"first_adventure_done": false,
 		},
 	}
 
 
+# ---- 首次冒险布尔位（关卡节点图生成 v0.4——唯一新增存档字段，M-3 迭代 5 T5）----
+# false = 首次脚本模式（全关零抽签取池内模板 0=现行固定图）；置位只在冒险收束挂点（MetaProgression.settle_adventure）。
+# 老档迁移：缺字段 = 该档已有游玩史 → true（不重放教学脚本）。
+
+func is_first_adventure_done() -> bool:
+	return bool(_data["meta"].get("first_adventure_done", true))
+
+
+func mark_first_adventure_done() -> void:
+	_data["meta"]["first_adventure_done"] = true
+
+
 # ---- 读盘（启动时调用）----
 # 返回 true = 已就绪可用（含新档/损坏兜底/迁移成功）；false = 高版本拒读（默认数据运行、禁写盘）。
 # 损坏兜底：原文件改名 <path>.corrupt.bak（已存在则覆盖）+ push_warning + 默认数据继续——不静默丢档。
@@ -91,6 +104,9 @@ func load_from_disk() -> bool:
 		parsed = stepped
 		v = int(parsed.get("version", v + 1))
 	_data = _normalize(parsed)
+	# 老档迁移（关卡节点图生成 v0.4 布尔位——缺字段 = 已有游玩史，不重放教学脚本）
+	if not _data["meta"].has("first_adventure_done"):
+		_data["meta"]["first_adventure_done"] = true
 	return true