Merge branch 'master' into iter43

game/presentation/views/battle_stage_view.gd

@@ -75,7 +75,7 @@ func _build_world_stage() -> void:
 
 
 ## Control 文本半区域（round_label / stage_center / log_view 原样保留——C1 永久 Control）
-func _build_text_half(db_ref) -> void:
+func _build_text_half(db_ref) -> void:  # type-hint: ignore（db 鸭子型注入——单测以最小 stub 构造）
 	var vb := VBoxContainer.new()
 	vb.add_theme_constant_override("separation", 4)
 	vb.set_anchors_preset(Control.PRESET_FULL_RECT)
@@ -124,7 +124,7 @@ func _build_center_row(vb: VBoxContainer) -> void:
 
 
 ## 壳层伴随件层域（最顶——世界站桩之上的 Control 触达面）＋主角站桩注册（世界）+ 状态行伴随件（壳层）
-func _build_companion_layer(db_ref) -> void:
+func _build_companion_layer(db_ref) -> void:  # type-hint: ignore（db 鸭子型注入——单测以最小 stub 构造）
 	_companion_layer = Control.new()
 	_companion_layer.set_anchors_preset(Control.PRESET_FULL_RECT)
 	_companion_layer.mouse_filter = Control.MOUSE_FILTER_IGNORE

game/presentation/views/board_cell_unit.gd

@@ -198,7 +198,8 @@ func _draw_glyph_layer(rect: Rect2) -> void:
 		draw_texture_rect(st.tex_mutation, rect, false)
 	# ③ 数字/徽章（数字 ≥ 格高 50% 墨族对格底 ≥4.5:1；徽章右下角金，遮蔽态 = "?"）
 	if glyph != "":
-		_draw_digit_plate()
+		if plate:
+			_draw_digit_plate()
 		if st.tex_glyph != null:
 			draw_texture_rect(st.tex_glyph, rect, false)
 		else:

game/presentation/views/level_map_screen.gd

@@ -478,9 +478,9 @@ func _room_color(node: Dictionary, ctx: Dictionary) -> Color:
 ## 选路停点（候选非空）非候选通道降透明——金岔路从结构网分离（干线共线重叠缺陷的
 ## 视觉主因：不同源通道共用同一垂直干线，金边与石色边焊接成「整列可走」假象）
 func _draw_passage_layer(canvas: Control, ctx: Dictionary) -> void:
-	var nodes: Array = ctx["nodes"]
-	var pos: Dictionary = ctx["pos"]
-	var cand_ids: Array = ctx["cand_ids"]
+	var nodes: Array = ctx["nodes"]         # type-hint: ignore（ctx 束 Variant 出值——布局缓存数组未参数化）
+	var pos: Dictionary = ctx["pos"]        # type-hint: ignore（同上——节点 id → 坐标）
+	var cand_ids: Array = ctx["cand_ids"]   # type-hint: ignore（同上——候选 id 集）
 	var dim_passages: bool = not cand_ids.is_empty()
 	for node in nodes:
 		var from: Vector2 = pos[node]
@@ -496,7 +496,7 @@ func _draw_passage_layer(canvas: Control, ctx: Dictionary) -> void:
 
 ## 房间方块域：底色随行进态＋Boss/候选描边＋图标/字形＋编号＋类型文字标签
 func _draw_room(canvas: Control, node: Dictionary, ctx: Dictionary) -> void:
-	var pos: Dictionary = ctx["pos"]
+	var pos: Dictionary = ctx["pos"]   # type-hint: ignore（ctx 束 Variant 出值——节点 id → 坐标）
 	var p: Vector2 = pos[node]
 	var t := String(node.get("type", ""))
 	var nid := _id_of(node)

game/presentation/views/standee_body.gd

@@ -141,7 +141,7 @@ func _set_hp(hp: int) -> void:
 	if st._hp_tween != null and st._hp_tween.is_valid():
 		st._hp_tween.kill()
 	st._hp_tween = create_tween()
-	st._hp_tween.tween_property(self, "st.hp_value", target, UiKit.motion(0.15))
+	st._hp_tween.tween_property(st, "hp_value", target, UiKit.motion(0.15))
 
 
 # 主角/敌方共用——状态效果唯一展示面（壳层伴随件转发；空态 = 图标行隐藏不占位）
@@ -212,17 +212,17 @@ func set_pending(ptype: String, pid: String) -> void:
 # 三档运动签名互异，灰度/剪影层可辨）。摇定时一次性短动画，随后静帧保持。
 func _play_intent_motion() -> void:
 	var tw := create_tween()
-	tw.tween_property(self, "st._intent_scale", 1.6, UiKit.motion(0.10))
-	tw.tween_property(self, "st._intent_scale", 1.0, UiKit.motion(0.16))
-	tw.parallel().tween_property(self, "st._glyph_rot", 4.0, UiKit.motion(0.10))
-	tw.tween_property(self, "st._glyph_rot", 0.0, UiKit.motion(0.14))
+	tw.tween_property(st, "_intent_scale", 1.6, UiKit.motion(0.10))
+	tw.tween_property(st, "_intent_scale", 1.0, UiKit.motion(0.16))
+	tw.parallel().tween_property(st, "_glyph_rot", 4.0, UiKit.motion(0.10))
+	tw.tween_property(st, "_glyph_rot", 0.0, UiKit.motion(0.14))
 	if _intent_charge:
-		tw.tween_property(self, "st._intent_scale", 1.22, UiKit.motion(0.28)).set_trans(Tween.TRANS_SINE)   # ③蓄力缓推
+		tw.tween_property(st, "_intent_scale", 1.22, UiKit.motion(0.28)).set_trans(Tween.TRANS_SINE)   # ③蓄力缓推
 		tw.tween_interval(UiKit.motion(0.40))                                                            #   定格微顿
-		tw.tween_property(self, "st._intent_scale", 1.0, UiKit.motion(0.18))
+		tw.tween_property(st, "_intent_scale", 1.0, UiKit.motion(0.18))
 	else:
-		tw.tween_property(self, "st._intent_scale", 1.26, UiKit.motion(0.11))   # ②二次弹跳（高举）
-		tw.tween_property(self, "st._intent_scale", 1.0, UiKit.motion(0.13))
+		tw.tween_property(st, "_intent_scale", 1.26, UiKit.motion(0.11))   # ②二次弹跳（高举）
+		tw.tween_property(st, "_intent_scale", 1.0, UiKit.motion(0.13))
 
 
 # 资产挂点：tex 落位后字形隐退、纹理立绘顶位——零代码换装契约；tex=null 回退字形。

game/presentation/views/ui_kit.gd

@@ -475,7 +475,7 @@ const PANEL_DEFAULT := true   # modal_shell 面板哨兵（非 StyleBox 实例
 # 面板哨兵解析（六参收拢五参——三态：null=无面板〔原 with_panel=false〕/PANEL_DEFAULT=默认样式盒面板
 # 〔原 with_panel=true+panel_sb=null〕/StyleBox 实例=自定义样式盒面板〔原双参形态〕；
 # 判别用 is StyleBox——StyleBox 与布尔哨兵直接 != 属异类操作数违例）
-static func _resolve_shell_panel(panel_sb) -> PanelContainer:
+static func _resolve_shell_panel(panel_sb) -> PanelContainer:  # type-hint: ignore（三态哨兵 bool/null/StyleBox 异构形参）
 	if panel_sb == null:
 		return null
 	var panel := PanelContainer.new()