feat(调试入口): 全局浮层角标——UI 最顶层、任何 UI 不遮挡（2026-10-16 用户令）

用户定稿：调试入口不做置顶钮式按需出现，要的是「UI 最顶层浮层、不被任何 UI 遮挡」。实现=三枚屏内角标（菜单右下/战斗 HUD 右下/地图顶栏）合并为一枚全局浮层角标： - LAYER_CONTRACT 末位新增 {"key": "debug_badge", "kind": "float"}——只落树序（最顶绘制序）、不注册 ModalStack：open() 遮挡记账只隐藏登记层，故任何模态/覆盖层开都不遮它（用户需求的机制根因）；_layer_node 补映射；main 直接子层、构建走 ui_assembler.build_debug_badge - 位置：右下角 16px 惯例位；地图屏底栏 85px 常驻→_sync_status_entry 按 map_on 抬 offset 至底栏上方 16px；战斗屏状态角标经 MarginContainer 让位（right 16/bottom 52）不再被压 - 屏内角标全退役：menu_screen/board_zone_view/level_map_screen 三处 debug_badge 删除， main 两处接线与 _sync_status_entry 四条可见性/置灰行清除（浮层常显不置灰——点它就是开浮窗） - 浮窗 desc 文案改「UI 最顶层「调试」浮层角标随时可开——任何界面不遮挡」 - 断言/探针换代：smoke V2f 查 main.debug_badge boot 可见；click_probe 遮挡判据移至设置面开中段（浮层角标此时仍应可见=直接验「不遮挡」）；tune_probe ①点击路径与⑨对局中角标全改 main.debug_badge（T2 防线断言不动——浮窗 non_locking×遮挡复活×has_open 组合回归）冒烟 1127/0 过；全量闸待跑。
2026-10-16 23:53:57 +08:00
1 parent cc575b2ce3
commit 6b1e447d27
@@ -48,6 +48,8 @@ const LAYER_CONTRACT: Array[Dictionary] = [
 	{"key": "inter_overlay", "kind": "state", "tags": []},
 	{"key": "confirm_dialog", "kind": "modal", "tags": []},
 	{"key": "debug_overlay", "kind": "modal", "tags": [ModalStack.TAG_NON_LOCKING]},
+	{"key": "debug_badge", "kind": "float"},   # 2026-10-16 用户令：调试入口全局浮层——末位=最顶绘制序；
+	# float 类不注册 ModalStack（open() 遮挡记账只隐藏登记层）→ 任何 UI 打开都不遮它
 ]

 var db
@@ -113,6 +115,7 @@ var settings_overlay: SettingsOverlay     # 设置覆盖层（迭代 8 卡④—
 var status_panel: StatusPanel           # 局内状态面板·只读（迭代 17 卡③——钥石余额+营地三柜台进度查看；登记设置层同档）
 var career_overlay: CareerOverlay         # 生涯页·只读全屏页（迭代 18 卡④——跨局汇总六类九项；登记营地同档〔设置层旁、确认弹窗之前〕）
 var debug_overlay: DebugOverlay        # 调试浮窗（迭代 14.5 调试整合批——种子/数值调整/批量模拟/两层调试入口收一）
+var debug_badge: Button                # 调试浮层入口角标（2026-10-16 用户令：UI 最顶层浮层——LAYER_CONTRACT 末位 float 类，任何 UI 不遮挡）

 var _modal_flow = null             # 模态编排纯逻辑类（modal_flow.gd——迭代 27 T4 P1-5/P2-7 抽取；依赖仅 ModalStack+查询 Callable）
 var _modals = null                 # 模态层级状态机（=_modal_flow.stack——探针 _list 登记序断言缝保留）
@@ -191,9 +194,9 @@ func _ready() -> void:
 	_refresh_resume_button()   # 迭代 8 卡②——启动读盘后按断点在档态点亮「继续上局」
 	_start_overlay.visible = true
 	_debug_entry = true   # 2026-10-16 用户令：DS_DEBUG 环境变量门控写死（原 OS.get_environment 读取已退役；发布前清）
-	_menu_screen.dbgbtn.visible = _debug_entry   # 角标可见性须门控落定后赋值（连接在 _build_ui 接线区）
+	debug_badge.visible = _debug_entry   # 浮层角标可见性须门控落定后赋值（构建/连接在 _build_ui）
 	# 2026-10-16 用户令修正：boot 菜单优先——不自动开浮窗（原「启动即开」把开始屏盖成调试面板，
-	# 用户实测否决）；调试入口=开始屏右下角「调试」角标+对局中两屏角标（见菜单屏接线段）
+	# 用户实测否决）；调试入口=UI 最顶层全局浮层角标（LAYER_CONTRACT 末位 float 类，任何 UI 不遮挡）


 # ==================== 视图接线（三屏壳 + 模态层装配；构建归屏壳/UiAssembler，本类只接线） ====================
@@ -237,7 +240,6 @@ func _build_ui() -> void:

 	board_zone.action_requested.connect(_on_board_action)
 	board_zone.status_badge.pressed.connect(_on_status_badge_pressed)   # 状态面板入口（迭代 17 卡③——战斗屏 HUD 角标）
-	board_zone.debug_badge.pressed.connect(_on_debug_badge_pressed)   # 调试浮窗入口（迭代 18 卡⑦ P2 甲——战斗屏 HUD 角标）
 	info_panel.treasure_slot_clicked.connect(_treasure_ui.on_slot_clicked)   # 迭代 7 T4——两步交互第一步
 	board_zone.stop_pressed.connect(_on_stop_pressed)
 	board_zone.refresh_confirmed.connect(_on_refresh_confirmed)
@@ -270,7 +272,6 @@ func _build_ui() -> void:
 	node_overlay.continue_pressed.connect(_on_node_continue)
 	level_screen.route_chosen.connect(_on_route_chosen)
 	level_screen.status_badge.pressed.connect(_on_status_badge_pressed)   # 状态面板入口（迭代 17 卡③——地图屏顶栏角标）
-	level_screen.debug_badge.pressed.connect(_on_debug_badge_pressed)   # 调试浮窗入口（迭代 18 卡⑦ P2 甲——地图屏顶栏角标）
 	level_screen.abandon_requested.connect(_on_abandon_requested)   # 放弃入口（2026-09-21 用户拍板——台账 119）
 	_end_overlay.continue_pressed.connect(_on_battle_end_continue)
 	settings_overlay = SettingsOverlay.new(settings_store)   # 迭代 8 卡④——最小设置面（音量/全屏/减动效）
@@ -306,9 +307,11 @@ func _build_ui() -> void:
 	_menu_screen.lvbtn.pressed.connect(_start_adventure_from_menu)
 	_menu_screen.resumebtn.pressed.connect(_resume_from_menu)   # 迭代 8 卡②——续玩入口
 	_resume_btn = _menu_screen.resumebtn
-	# 调试角标入口（2026-10-16 用户令恢复开始屏右下角角标——iter18 卡⑦ P2 甲迁宿主两屏的理由
-	# ＝「启动即开」，已随菜单优先修正不成立；对局中两枚角标接线见两屏装配段）
-	_menu_screen.dbgbtn.pressed.connect(_on_debug_badge_pressed)
+	# 调试入口＝UI 最顶层全局浮层角标（2026-10-16 用户令：任何 UI 不遮挡——菜单/战斗/地图三枚
+	# 屏内角标形态退役，全局浮层全场景承载；连接归组合根，树序/登记面见 LAYER_CONTRACT 末位）
+	debug_badge = UiAssembler.build_debug_badge(self)
+	add_child(debug_badge)
+	debug_badge.pressed.connect(_on_debug_badge_pressed)
 	# 营地/商店投影（T4/D4 拆件批——迁 camp_shop_presenter.gd；本类只接线、探针缝保缝转发；
 	# 购买写调用唯一经 MetaProgression/LevelRunner core 单口——组合根 lambda 现值注入）
 	_camp_pres = CampShopPresenter.new(CampFlowContext.new(db, func() -> Variant: return meta, func() -> Variant: return save_manager, camp_overlay, shop_overlay,
@@ -417,6 +420,7 @@ func _layer_node(key: String) -> Node:
 		"inter_overlay": return _inter_overlay
 		"confirm_dialog": return confirm_dialog
 		"debug_overlay": return debug_overlay
+		"debug_badge": return debug_badge
 	return null


@@ -1147,10 +1151,13 @@ func _sync_status_entry() -> void:
 	level_screen.status_badge.disabled = _modal_flow.badge_greyed_map()
 	# 调试浮窗角标（迭代 18 卡⑦ P2 甲——迁宿主两屏，调试会话门控恒开；17卡③状态角标同形制同守卫）：
 	# 战斗屏=对局内（冒险或调试两层）且地图屏未激活；地图屏=随屏；开始菜单零角标（恒开=启动即开）
-	board_zone.debug_badge.visible = _debug_entry and not map_on and battle_live
-	level_screen.debug_badge.visible = _debug_entry and map_on
-	board_zone.debug_badge.disabled = board_zone.status_badge.disabled
-	level_screen.debug_badge.disabled = level_screen.status_badge.disabled
+	board_zone.status_badge.visible = run_scope.level_active and not map_on
+	level_screen.status_badge.visible = map_on
+	board_zone.status_badge.disabled = _modal_flow.badge_greyed_battle()   # 迭代 27 T4——互斥域谓词
+	level_screen.status_badge.disabled = _modal_flow.badge_greyed_map()
+	# 调试浮层角标（2026-10-16 用户令：全局浮层任何 UI 不遮挡——可见性不随场景变，只抬 offset
+	# 避让：地图屏底栏 85px 常驻，角标抬至底栏上方 16px；其余场景右下角 16px 贴底）
+	debug_badge.offset_bottom = -101.0 if map_on else -16.0


 # ---- 探针缝保缝（T4/D4 拆件——click/ui_probe 营地段直呼组合根面；实现归 camp_shop_presenter.gd）----