194 lines
10 KiB
GDScript
194 lines
10 KiB
GDScript
# VERTICAL SLICE - NOT FOR PRODUCTION
|
||
# 整屏截图探针（迭代 9 卡⑰a 2026-09-30——呈现层测试分级 B 档基建：视口截图程序化产出；
|
||
# 迭代 19 卡① T1 2026-10-08 扩屏四屏→七屏——新纳 设置面/生涯页/暂停层，正主=tools/render_gate.sh）。
|
||
# 必须**窗口化**运行（真渲染设备——headless 无渲染面，get_image 得到空纹理）：
|
||
# Godot_console.exe --path . res://smoke/shot_probe.tscn -- <输出目录>
|
||
# 流程 = 真实按钮信号路径驱动（ui_click_probe 同款；存档/设置/元进度三面换注隔离档——禁碰真实档，
|
||
# 坑册「断点写盘随 save_manager 引用走」教训同款覆盖）：菜单（启动态）→ 设置面（settingsbtn
|
||
# 真实信号路径）→ 生涯页（careerbtn 同款）→ 营地（campbtn）→ 关卡画面（lvbtn→停点出图）→
|
||
# 战斗（level_screen.press_candidate(0) 真实选路提交）→ 暂停层（地图屏暂停角标真实信号路径）。
|
||
# 每屏双帧 + frame_post_draw 同步后抓 get_viewport().get_texture()，PNG 落输出目录；
|
||
# 最小自检 = 七件存在且非零字节（像素方差断言归 tools/shot_checker.py——B 档骨架分工）。
|
||
# 商店房注记（迭代 19 卡① T1 考证结论，代拍板白名单授权）：真实路径必经 L1 打穿→L2 商店节点
|
||
# 选路（ui_click_probe 实证商店层在 L2 Boss 前必经位）——探针现行驱动只进首战节点，低代价确定性
|
||
# 到达不成立；合成投喂（ui_struct_probe 同款）破坏本探针真实路径口径 → 不纳屏，注记留 B 批。
|
||
extends Node
|
||
|
||
const ProbeUiUtil := preload("res://smoke/probe_ui_util.gd") # T6 收口：树寻址/隔离样板单点
|
||
|
||
var main: Node
|
||
var out_dir := ""
|
||
var _problems: Array = []
|
||
var _meta := {} # 控件实测几何（全局 rect——shot_checker 文字框/明度带取样坐标源，禁硬编码像素）
|
||
|
||
|
||
func _ready() -> void:
|
||
# 运行前提=窗口化真渲染面：headless 下 frame_post_draw 永不触发+视口纹理恒空——无此守卫时 headless 调用方必挂死（2026-10-02 挂死灾害批护栏）
|
||
if DisplayServer.get_name() == "headless":
|
||
print("[shot_probe] FAIL — 本探针必须窗口化运行（headless 无渲染面，截图必空）；headless 自动闸禁跑本探针（正主=tools/probe_gate.sh）")
|
||
get_tree().quit(1)
|
||
return
|
||
var args := OS.get_cmdline_user_args()
|
||
out_dir = args[0] if args.size() >= 1 and args[0] != "" else "user://qa-screens"
|
||
DirAccess.make_dir_recursive_absolute(out_dir)
|
||
await get_tree().process_frame
|
||
main = load("res://presentation/main.tscn").instantiate()
|
||
add_child(main)
|
||
await get_tree().process_frame
|
||
# ── 存档/元进度/设置三面隔离（ui_click_probe 同款——真档零污染；历史语义 = contains 寻址） ──
|
||
ProbeUiUtil.isolate_save(main, "smoke_shot_probe", false, true, false)
|
||
# 隔离档即时应用（迭代 19 卡① T1——main 装配已按真实设置恢复过窗口态〔本机实测：真实档
|
||
# fullscreen=true 时窗口进全屏，视口纹理 2304x1440≠1280 基准档，checker 尺寸/取样全盘失真〕；
|
||
# apply 隔离档出厂默认=窗口化 1280x800，恢复本探针设计前提。探针侧环境修正，零运行时改动）
|
||
main.settings_store.apply()
|
||
await get_tree().process_frame
|
||
# ① 菜单（启动态）——meta 锚经 S1 裁后换代（2026-10-08 用户裁：副标题锚改认现行文案；
|
||
# 帮助文腿整个退役——载体玩法速览牌 2026-10-06 用户令退役，checker 对应断言段同撤）
|
||
_meta["menu_sub"] = ProbeUiUtil.label_rect(main._start_overlay, "扫雷的因")
|
||
_meta["menu_title"] = ProbeUiUtil.label_rect(main._start_overlay, "Dungeon Sweeper")
|
||
await _snap("menu")
|
||
# ①b 设置面（迭代 19 卡① T1 扩屏——settingsbtn 真实信号路径，开合同款真实钮）
|
||
var setbtn: Button = ProbeUiUtil.find_button(main._start_overlay, "设置", "prefix")
|
||
if setbtn == null:
|
||
_problems.append("设置入口缺失（开始层 settingsbtn）")
|
||
else:
|
||
setbtn.pressed.emit()
|
||
for i in 3:
|
||
await get_tree().process_frame
|
||
if not main.settings_overlay.visible:
|
||
_problems.append("设置面未打开（settingsbtn 路径）")
|
||
else:
|
||
_meta["settings_title"] = ProbeUiUtil.label_rect(main.settings_overlay, "设置")
|
||
await _snap("settings")
|
||
var set_close: Button = ProbeUiUtil.find_button(main.settings_overlay, "返回", "prefix")
|
||
if set_close == null:
|
||
_problems.append("设置面返回钮缺失")
|
||
else:
|
||
set_close.pressed.emit()
|
||
await get_tree().process_frame
|
||
# ①c 生涯页（迭代 19 卡① T1 扩屏——careerbtn 真实信号路径，ui_struct_probe 同款入口链）
|
||
var careerbtn: Button = ProbeUiUtil.find_button(main._start_overlay, "生涯", "prefix")
|
||
if careerbtn == null:
|
||
_problems.append("生涯入口缺失（开始层 careerbtn）")
|
||
else:
|
||
careerbtn.pressed.emit()
|
||
for i in 3:
|
||
await get_tree().process_frame
|
||
if not main.career_overlay.visible or main._start_overlay.visible:
|
||
_problems.append("生涯页未打开或开始层未隐藏（careerbtn 路径）")
|
||
else:
|
||
_meta["career_title"] = ProbeUiUtil.label_rect(main.career_overlay, "生 涯")
|
||
await _snap("career")
|
||
var career_close: Button = ProbeUiUtil.find_button(main.career_overlay, "返回", "prefix")
|
||
if career_close == null:
|
||
_problems.append("生涯页返回钮缺失")
|
||
else:
|
||
career_close.pressed.emit()
|
||
for i in 3:
|
||
await get_tree().process_frame
|
||
if main.career_overlay.visible or not main._start_overlay.visible:
|
||
_problems.append("生涯页关闭后页未隐藏或开始层未恢复")
|
||
# ② 营地
|
||
var campbtn: Button = ProbeUiUtil.find_button(main._start_overlay, "营地", "contains")
|
||
if campbtn == null:
|
||
_problems.append("营地入口缺失（开始层 campbtn）")
|
||
else:
|
||
campbtn.pressed.emit()
|
||
await get_tree().process_frame
|
||
await _snap("camp")
|
||
var close_btn: Button = ProbeUiUtil.find_button(main.camp_overlay, "关闭营地", "contains")
|
||
if close_btn != null:
|
||
close_btn.pressed.emit()
|
||
await get_tree().process_frame
|
||
# ③ 关卡画面（开始冒险→停点出图——冒险开始即出图，停点前移批语义）
|
||
var lvbtn: Button = ProbeUiUtil.find_button(main._start_overlay, "开始冒险", "contains")
|
||
if lvbtn == null:
|
||
_problems.append("开始冒险按钮缺失（开始层 lvbtn）")
|
||
else:
|
||
lvbtn.pressed.emit()
|
||
for i in 4:
|
||
await get_tree().process_frame
|
||
await _snap("level")
|
||
# GP 常驻徽章断言（迭代 9 卡⑪核验——读数=runner.gp 现值，刷新=写路径回执后重查〔open_choices〕）
|
||
var gp_label: Label = ProbeUiUtil.find_label(main.level_screen, "◈ ")
|
||
if gp_label == null or not gp_label.is_visible_in_tree():
|
||
_problems.append("GP 徽章不可见（关卡画面顶栏）")
|
||
elif main.level_screen.get("_runner") != null:
|
||
var expect := "◈ %d" % int(main.level_screen.get("_runner").gp)
|
||
if gp_label.text != expect:
|
||
_problems.append("GP 徽章读数不符: %s != %s" % [gp_label.text, expect])
|
||
# ④ 战斗（节点一——真实选路提交路径 press_candidate，ui_click_probe :199 同款）
|
||
if main.level_screen != null and main.level_screen.visible:
|
||
main.level_screen.press_candidate(0)
|
||
for i in 10:
|
||
await get_tree().process_frame
|
||
await _snap("battle")
|
||
# 战斗屏文字框/明度带锚点（全局 rect——checker 取样坐标源；明细带锚 S1 裁后改认现行文案）
|
||
_meta["battle_log_hint"] = ProbeUiUtil.label_rect(main.stage, "上轮摘要")
|
||
_meta["hero_panel"] = _node_rect(ProbeUiUtil.find_by_script(main, "hero_info_panel_view"))
|
||
_meta["stage_view"] = _node_rect(main.stage)
|
||
_meta["board_zone"] = _node_rect(main.board_zone)
|
||
# draw calls 真机测量（迭代 9 卡⑦——基线 270→目标 <200；窗口化渲染帧读数，
|
||
# 取值时机=战斗截图同帧后一帧——呈现终态满负荷）
|
||
await get_tree().process_frame
|
||
var dc := int(Performance.get_monitor(Performance.RENDER_TOTAL_DRAW_CALLS_IN_FRAME))
|
||
_meta["battle_draw_calls"] = dc
|
||
print("[shot_probe] battle draw_calls=%d（基线 270/目标 <200）" % dc)
|
||
# ⑤ 暂停层（迭代 19 卡① T1 扩屏——战斗屏暂停角标真实信号路径；层在战斗屏之上开合）
|
||
var pb: Button = main.board_zone.pause_badge
|
||
if pb == null or not pb.visible or pb.disabled:
|
||
_problems.append("暂停入口角标缺失/置灰（战斗屏 board_zone）")
|
||
else:
|
||
pb.pressed.emit()
|
||
for i in 3:
|
||
await get_tree().process_frame
|
||
if not main.pause_overlay.visible:
|
||
_problems.append("暂停层未打开（角标路径）")
|
||
else:
|
||
_meta["pause_title"] = ProbeUiUtil.label_rect(main.pause_overlay, "暂停")
|
||
await _snap("pause")
|
||
var pause_close: Button = ProbeUiUtil.find_button(main.pause_overlay, "继续", "prefix")
|
||
if pause_close == null:
|
||
_problems.append("暂停层继续钮缺失")
|
||
else:
|
||
pause_close.pressed.emit()
|
||
await get_tree().process_frame
|
||
if main.pause_overlay.visible:
|
||
_problems.append("暂停层关闭后未隐藏（继续钮路径）")
|
||
else:
|
||
_problems.append("关卡画面未出现（lvbtn 路径）")
|
||
# ── 几何元数据落盘（shot_checker 取样坐标源） ──
|
||
var mf := FileAccess.open(out_dir.path_join("shot_meta.json"), FileAccess.WRITE)
|
||
if mf != null:
|
||
mf.store_string(JSON.stringify(_meta))
|
||
mf.close()
|
||
# ── 最小自检：七件存在且非零字节（迭代 19 卡① T1 扩屏后口径） ──
|
||
for s in ["menu", "settings", "career", "camp", "level", "battle", "pause"]:
|
||
var p := out_dir.path_join("shot_%s.png" % s)
|
||
if not FileAccess.file_exists(p):
|
||
_problems.append("截图缺失: %s" % p)
|
||
else:
|
||
var fa := FileAccess.open(p, FileAccess.READ)
|
||
if fa == null or fa.get_length() < 1000:
|
||
_problems.append("截图疑似空文件: %s" % p)
|
||
print("[shot_probe] 完成 out=%s 问题=%d %s" % [out_dir, _problems.size(), str(_problems)])
|
||
get_tree().quit(1 if _problems.size() > 0 else 0)
|
||
|
||
|
||
func _snap(key: String) -> void:
|
||
await RenderingServer.frame_post_draw
|
||
await RenderingServer.frame_post_draw
|
||
var img: Image = get_viewport().get_texture().get_image()
|
||
if img == null:
|
||
_problems.append("视口纹理为空: %s" % key)
|
||
return
|
||
img.save_png(out_dir.path_join("shot_%s.png" % key))
|
||
print("[shot_probe] saved %s (%dx%d)" % [key, img.get_width(), img.get_height()])
|
||
|
||
|
||
func _node_rect(n: Node) -> Dictionary:
|
||
if n == null or not (n is CanvasItem):
|
||
return {}
|
||
return {"x": n.global_position.x, "y": n.global_position.y,
|
||
"w": n.size.x, "h": n.size.y}
|