iter47-卡3：卡⑤(迭代47·Esc浮窗与营地顶栏批): Esc浮窗四态路由+CampHudBand顶栏栏+设置语境分支+断言批+审计补差+master取用+camp.md v2.3定稿吸收(半透明遮罩0.6场景根留底/Esc先关窗Q1甲换代)——终态六枚落满

game/presentation/camp_shop_presenter.gd

@@ -42,6 +42,7 @@ func open_camp() -> void:
 	meta.refresh_treasure_unlocks()   # 条件解锁刷新
 	start_overlay.visible = false
 	_open_modal.call(views.camp_scene)   # 模态栈单口（场景根开——选档层被栈遮挡挂起）
+	views.refresh_bus.refresh(camp_data())   # 进档动线尾显式刷新一闸（卡⑤ 契约 5 时机②——HUD 读数重读）
 	_refresh_presentations.call()
 
 

game/presentation/main.gd

@@ -528,6 +528,25 @@ func _on_camp_object_pressed(key: StringName) -> void:
 	MainOverlayFlow._on_camp_object_pressed(self, key)   # 场景点选路由（卡④ T3——薄委托，实现归覆盖层流程承接件）
 
 
+# Esc 输入入口（产品码首个键盘入口——卡⑤ T1 契约 9 接线定稿：事件驱动 _unhandled_input、
+# KEY_ESCAPE 键值判定配 physical_keycode、pressed 且非 echo、禁 Input 单例轮询、不挂 ui_cancel）
+func _unhandled_input(event: InputEvent) -> void:
+	if event is InputEventKey and event.pressed and not event.echo 			and (event.keycode == KEY_ESCAPE or event.physical_keycode == KEY_ESCAPE):
+		MainEscFlow.on_esc_input(self)
+
+
+func _on_esc_return() -> void:
+	MainEscFlow._on_return_to_menu(self)
+
+
+func _on_esc_settings() -> void:
+	MainEscFlow._on_settings(self)
+
+
+func _on_esc_quit() -> void:
+	MainEscFlow._on_quit(self)
+
+
 func _camp_data() -> Dictionary:
 	return MainOverlayFlow._camp_data(self)
 

game/presentation/main_esc_flow.gd

@@ -0,0 +1,56 @@
+## 组合根 Esc 流程承接件（产品码首个键盘输入入口——main._unhandled_input 同名薄委托落地）：
+## Esc 四态路由（契约 9 判据单点=ModalStack 登记册现开集合，禁手枚名单）＋三出口动线。
+## 静态承接件零成员态（仿 main_overlay_flow 形态——main 侧留同名薄委托，探针 main.X 路径零改动）。
+class_name MainEscFlow
+extends RefCounted
+
+
+## 营地语境判据（Q1 甲——场景根 visible；子界面开态抑制由契约 9① 现开集合承载，不并入本谓词）
+static func is_camp_context(root: Variant) -> bool:
+	return root.ui.modals.camp.scene != null and root.ui.modals.camp.scene.visible
+
+
+## Esc 优先序（camp.md v2.3 定稿 2026-11-01 用户裁——有功能窗开着→先关最上层窗，覆盖卡⑤ 契约 9①
+## 的 Q1 甲无反馈；设置开在浮窗之上仍无反馈=契约 3 保留）：
+## ①功能窗开着→close 最上层窗→①'设置开在浮窗之上→无反馈→②浮窗开→close（Q2 同键单义）→
+## ③营地语境→open→④非营地→无反馈
+static func on_esc_input(root: Variant) -> void:
+	var esc: Control = root.ui.modals.camp.esc_overlay
+	var window := _topmost_camp_window(root)
+	if window != null:
+		root.ui.modals.flow.close(window)   # ① 先关最上层功能窗（v2.3 定稿）
+		return
+	if root.ui.modals.settings_overlay.visible:
+		return   # ①' 设置开在浮窗之上 → 无反馈（浮窗不隔层关闭——契约 3）
+	if esc.visible:
+		root.ui.modals.flow.close(esc)   # ② 再按 Esc 关窗
+		return
+	if is_camp_context(root):
+		root.ui.modals.flow.open(esc)   # ③ 营地语境唤起
+	# ④ 非营地语境 → 无反馈
+
+
+# 五功能窗现开查询（camp.md v2.3 五窗互斥单开——模态栈深恒 1，至多一窗在开；生涯页入窗集）
+static func _topmost_camp_window(root: Variant) -> Control:
+	for w: Control in [root.ui.modals.camp.forge, root.ui.modals.camp.treasure, root.ui.modals.camp.tree,
+			root.ui.modals.camp.codex, root.ui.modals.career_overlay]:
+		if w != null and w.visible:
+			return w
+	return null
+
+
+
+## 返回主菜单动线（契约 4）：首步 close 浮窗（缺此步浮窗残留主菜单上方）→营地与选档层同收＋开始层恢复
+static func _on_return_to_menu(root: Variant) -> void:
+	root.ui.modals.flow.close(root.ui.modals.camp.esc_overlay)
+	root._camp_pres.on_camp_closed()   # 关层收闭单口（卡④ T3——营地层与选档层同收＋开始层恢复）
+
+
+## 设置出口（浮窗登记在设置层之下——open 只隐上方层，浮窗由树序遮挡非属性隐藏；关后重现=栈语义）
+static func _on_settings(root: Variant) -> void:
+	root.ui.modals.flow.open(root.ui.modals.settings_overlay)
+
+
+## 退出出口（_quit_game 原样复用——settings_store.save_settings+quit，零语义副作用）
+static func _on_quit(root: Variant) -> void:
+	root._quit_game()

game/presentation/main_esc_flow.gd.uid

@@ -0,0 +1 @@
+uid://caa868un7dnt4

game/presentation/main_overlay_flow.gd

@@ -10,7 +10,11 @@ static func _open_settings(root: Variant) -> void:
 
 static func _on_settings_closed(root: Variant) -> void:
 	root.ui.modals.flow.close(root.ui.modals.settings_overlay)   # 模态栈单口
-	root.ui.screens.start_overlay.visible = true
+	# 语境分支（卡⑤ 契约 3——谓词=camp_esc_overlay.visible，谁开的设置谁收）：
+	# 营地浮窗路径关设置回浮窗不回主菜单（栈语义：浮窗登记在下、由树序遮挡非属性隐藏）；
+	# 菜单路径保留开始层恢复硬副作用。
+	if not root.ui.modals.camp.esc_overlay.visible:
+		root.ui.screens.start_overlay.visible = true
 
 
 # ---- 局内状态面板·只读（入口角标在两屏装配段；开合与数据喂入归组合根）----

game/presentation/main_ui_build.gd

@@ -110,6 +110,15 @@ static func _build_overlays(root: Variant) -> void:
 	var codex := CodexView.new()
 	root.add_child(codex)
 	root.ui.modals.camp.codex = codex
+	# Esc 浮窗（卡⑤——登记于设置层之前的模态；三钮意图经 MainEscFlow 路由）
+	var esc_overlay := CampEscOverlay.new()
+	esc_overlay.setup_buttons()
+	esc_overlay.bind_signals()
+	root.add_child(esc_overlay)
+	root.ui.modals.camp.esc_overlay = esc_overlay
+	# 营地顶栏 HUD 栏（卡⑤——钥石余额常驻；挂卡④场景根顶栏预留位＋入刷新单口目标册）
+	var hud_band := CampHudBand.new()
+	root.ui.modals.camp.scene.set_hud_band(hud_band)
 	# 屏壳/子界面插位由 LAYER_CONTRACT 槽统一落位——禁散落 move_child
 	root.ui.modals.legend_overlay.closed.connect(root.ui.modals.flow.close.bind(root.ui.modals.legend_overlay))
 	root.ui.modals.node_overlay.continue_pressed.connect(root._on_node_continue)
@@ -178,7 +187,8 @@ static func _build_menu_wiring(root: Variant) -> void:
 	# 营地刷新单口（各写口尾→现开界面＋场景根 HUD 一闸完成——卡④ T3；卡⑤ HUD band 随卡⑤挂册）
 	var camp_bus := CampRefreshBus.new()
 	camp_bus.bind_targets([root.ui.modals.camp.forge, root.ui.modals.camp.treasure,
-		root.ui.modals.camp.tree, root.ui.modals.camp.codex] as Array[Control])
+		root.ui.modals.camp.tree, root.ui.modals.camp.codex,
+		root.ui.screens.camp_screen.camp_scene.hud_band] as Array[Control])
 	root._camp_pres = CampShopPresenter.new(CampFlowContext.new(root.db,
 		{"camp_scene": root.ui.modals.camp.scene, "forge_view": root.ui.modals.camp.forge,
 			"treasure_view": root.ui.modals.camp.treasure, "tree_view": root.ui.modals.camp.tree,
@@ -226,6 +236,10 @@ static func _build_debug_and_resolvers(root: Variant) -> void:
 	root.ui.modals.confirm_dialog.confirmed.connect(root._on_confirm_accepted)
 	root.ui.modals.confirm_dialog.secondary_confirmed.connect(root._on_confirm_secondary)   # 三钮次确认（卡④ 大门「开始新冒险」出口）
 	root.ui.modals.confirm_dialog.cancelled.connect(root._on_confirm_declined)
+	# Esc 浮窗三出口接线（卡⑤——意图信号经薄委托归 MainEscFlow 动线；输入入口=main._unhandled_input）
+	root.ui.modals.camp.esc_overlay.return_requested.connect(root._on_esc_return)
+	root.ui.modals.camp.esc_overlay.settings_requested.connect(root._on_esc_settings)
+	root.ui.modals.camp.esc_overlay.quit_requested.connect(root._on_esc_quit)
 
 	# 调试浮窗（主菜单三散件收一：随机种子/数值调整/批量模拟/两层调试入口；
 	# 全局可开浮窗：调试会话恒开=启动即开〔_ready〕+两屏角标再开+当局数据只读区块；

game/presentation/ui_camp_modals.gd

@@ -9,3 +9,4 @@ var forge: ForgeView          # 锻造工坊子界面
 var treasure: TreasureView    # 秘宝匣子界面
 var tree: TreeView            # 天赋树子界面
 var codex: CodexView          # 奖励格图鉴子界面（占位挂起态）
+var esc_overlay: CampEscOverlay   # Esc 浮窗（卡⑤——终态六枚落满）

game/presentation/ui_registry.gd

@@ -27,6 +27,7 @@ const LAYER_CONTRACT: Array[Dictionary] = [
 	{"key": "treasure_view", "kind": "modal", "tags": []},
 	{"key": "tree_view", "kind": "modal", "tags": []},
 	{"key": "codex_view", "kind": "modal", "tags": []},
+	{"key": "camp_esc_overlay", "kind": "modal", "tags": []},   # Esc 浮窗（卡⑤——登记于营地层与设置层之间，契约 3 栈语义正解）
 	{"key": "settings_overlay", "kind": "modal", "tags": []},
 	{"key": "status_panel", "kind": "modal", "tags": []},
 	{"key": "career_overlay", "kind": "modal", "tags": []},
@@ -67,6 +68,7 @@ func node(key: String) -> Node:
 		"treasure_view": return modals.camp.treasure
 		"tree_view": return modals.camp.tree
 		"codex_view": return modals.camp.codex
+		"camp_esc_overlay": return modals.camp.esc_overlay
 		"settings_overlay": return modals.settings_overlay
 		"status_panel": return modals.status_panel
 		"career_overlay": return modals.career_overlay

game/presentation/views/camp_esc_overlay.gd

@@ -0,0 +1,32 @@
+## Esc 浮窗视图（营地语境 Esc 唤起）：返回主菜单/设置/退出游戏三钮（裁决 9——三项且仅三项）。
+## 壳=UiKit.modal_shell（居中模态壳，ui_kit 工厂单点）；退出钮=UiKit.danger_button；零新素材零新色值。
+## Q2 再按 Esc 关窗=组合根 Esc 路由直呼 flow.close（本视图无自关通路）；三钮 pressed 外发意图不内含动线。
+## 零动效（契约 6——直开直关，子树零 AnimationPlayer、源码零动效令牌）。
+class_name CampEscOverlay
+extends Control
+
+signal return_requested     ## 返回主菜单意图（动线归 MainEscFlow._on_return_to_menu——首步 close 浮窗）
+signal settings_requested   ## 设置意图（开设置层——浮窗登记在其下，栈语义关后重现）
+signal quit_requested       ## 退出游戏意图（_quit_game 原样复用）
+
+var _return_btn: Button
+var _settings_btn: Button
+var _quit_btn: Button
+
+
+func setup_buttons() -> void:
+	var box: VBoxContainer = UiKit.modal_shell(self, Color(UiKit.DIM, 0.55), Vector2(360, 0), 12,
+		UiKit.panel_skinned(Vector4(14, 12, 14, 12))).box
+	_return_btn = UiKit.button("返回主菜单")
+	box.add_child(_return_btn)
+	_settings_btn = UiKit.button("设置")
+	box.add_child(_settings_btn)
+	_quit_btn = UiKit.danger_button("退出游戏")
+	box.add_child(_quit_btn)
+	visible = false   # 登记模态初始隐（开合走栈——模态纪律）
+
+
+func bind_signals() -> void:
+	_return_btn.pressed.connect(func() -> void: return_requested.emit())
+	_settings_btn.pressed.connect(func() -> void: settings_requested.emit())
+	_quit_btn.pressed.connect(func() -> void: quit_requested.emit())

game/presentation/views/camp_esc_overlay.gd.uid

@@ -0,0 +1 @@
+uid://col25elh1utw5

game/presentation/views/camp_hud_band.gd

@@ -0,0 +1,27 @@
+## 营地顶栏小 HUD 栏（裁决 10——钥石余额常驻，最小集形态）：承载 UiKit.keystone_badge（工厂单点）。
+## 读数只经 camp_data() 投影单口（禁第二账本、禁视图自算）；刷新挂卡④ CampRefreshBus 单口
+## （bus 目标册成员——显式触发才变，禁 _ready 自刷/自持第二入口，契约 5）；载体=PRESET_TOP_WIDE 48px 浮层。
+class_name CampHudBand
+extends Control
+
+var _badge: PanelContainer
+
+
+func _init() -> void:
+	set_anchors_preset(Control.PRESET_TOP_WIDE)
+	custom_minimum_size = Vector2(0, 48)   # 高 48px 浮层覆盖、不挤压画面（camp.md §顶栏）
+	mouse_filter = Control.MOUSE_FILTER_IGNORE   # HUD 栏不挡场景命中区（浮层覆盖语义）
+	_badge = UiKit.keystone_badge("钥石 0")
+	_badge.set_anchors_preset(Control.PRESET_CENTER_RIGHT)
+	_badge.position = Vector2(-160, 8)   # 顶栏右位次（UiKit 现行件域内——代拍板 3）
+	add_child(_badge)
+
+
+## 余额写入（格式串=既有消费面同款「钥石 %d」——badge 工厂约定单点，禁第二格式串）
+func set_balance(v: int) -> void:
+	_badge.value_label.text = "钥石 %d" % v
+
+
+## 刷新单口落点（CampRefreshBus 目标册成员——显式触发才变，契约 5 刷新时机①②③同一闸）
+func refresh_camp(camp_data: Dictionary) -> void:
+	set_balance(int(camp_data.get("balance", 0)))

game/presentation/views/camp_hud_band.gd.uid

@@ -0,0 +1 @@
+uid://by6ugjfdicgud

game/presentation/views/camp_scene_view.gd

@@ -46,6 +46,7 @@ var _press_key := &""                        # 当前按住命中键
 var _float_tween: Tween                      # 悬停浮动补间（逐级整像素吸附，禁 _process 逐帧移 UI）
 var _desat_mat: ShaderMaterial               # 禁用态共享材质（strength 恒 1，材质挂/摘承载开关）
 var _hud_slot: Control                       # 顶栏预留位（卡⑤ set_hud_band 填值）
+var hud_band: Control                        # 顶栏 HUD 栏句柄（卡⑤ CampHudBand——装配后 bus 目标册取用面）
 
 
 func _init() -> void:
@@ -94,6 +95,7 @@ func set_feedback_state(key: StringName, state: FeedbackState) -> void:
 func set_hud_band(band: Control) -> void:
 	if _hud_slot != null:
 		_hud_slot.add_child(band)
+		hud_band = band
 
 
 func _gui_input(event: InputEvent) -> void:

game/presentation/views/camp_sub_view_base.gd

@@ -12,12 +12,8 @@ var _balance_label: Label   # 钥石徽数值行（探针直读面——ui_probe
 
 ## 壳构建（子类 _init 调用一次）：content 由子类先建好传入（列容器/滚动容器皆可）
 func _build_shell(title: String, icon_path: String, content: Control) -> void:
-	# 实底暖亮档（半透 dim 会透出底下场景图——CampOverlay 同案；遮蔽语义由组合根输入锁兜底）
-	var dim := UiKit._modal_dim(self, UiKit.BG_BRIGHT)
-	var bd := UiKit.backdrop_tile()
-	if bd != null:
-		dim.add_child(bd)
-	dim.add_child(UiKit.vignette_rect())
+	# 半透明压暗遮罩 0.6（camp.md v2.3 定稿——场景根留底可见，窗口之下垫遮罩；交互聚焦由遮罩 STOP 兜底）
+	var dim := UiKit._modal_dim(self, Color(UiKit.DIM, 0.6))
 	var margin := MarginContainer.new()
 	margin.set_anchors_preset(Control.PRESET_FULL_RECT)
 	margin.add_theme_constant_override("margin_left", 16)

game/presentation/views/career_overlay.gd

@@ -18,6 +18,7 @@ var _keystone_badge: UiKit.KeystoneBadge   # 钥石余额（badge 工厂件—
 func _init() -> void:
 	# 全屏页壳（T6/T7 对齐批先例——暖亮底+石纹弱质感+暗角+56px 通栏顶条+内容列）
 	var page: Dictionary[Variant, Variant] = UiKit.page_shell(self, true)
+	page.base.color = Color(UiKit.DIM, 0.6)   # 功能窗口化（camp.md v2.3 定稿——场景根留底+半透明压暗遮罩 0.6；观感随样张目检校准）
 	var top: HBoxContainer = page.top_row
 	top.add_child(UiKit.label("生 涯",UiKit.FS_TITLE, true, UiKit.WARM))
 	var top_sp := Control.new()