决战小关结束流程中奖励弹窗模板误检，无法正确返回入口总览页

[syokounya]

在提交您的问题反馈之前

• 我已经阅读了 用户文档 并尝试自己解决问题，同时在社群中进行了讨论
• 我无法找到任何 open issue 反馈了相同的问题

相关环境信息

No response

问题描述

决战小关通关后，confirm_stage_clear 的 settle 循环中 symbol_get_ship 模板在决战地图页上被误匹配，导致代码不断点击右下角关闭按钮但无法真正关闭弹窗。最终小关结束后游戏画面停留在决战地图页，没有回到决战入口总览页，_handle_enter_map 的 detect_entry_status() 在地图页上寻找入口状态模板，抛出 TimeoutError。

复现方法

运行决战 Ex-1（或任意章节）
打完小关终止节点，进入 STAGE_CLEAR 阶段
confirm_stage_clear 执行两次 confirm_operation 后进入 settle 循环
settle 循环持续检测到 symbol_get_ship，不断点击 (0.953, 0.954)
12 秒 settle 超时，流程进入 ENTER_MAP
_handle_enter_map 调用 detect_entry_status() 在地图页上匹配入口状态模板
10 秒后超时：检测决战入口状态超时 (10.0s): 未匹配到任何状态模板

Log输出

22:55:18.881 | INFO     | ops/decisive/handlers.py:423 | [决战] 节点 J 战斗结束, 等待地图加载
22:55:18.882 | INFO     | ops/decisive/handlers.py:427 | [决战] 小关 2 终止节点 J 已到达
22:55:18.882 | DEBUG    | ops/decisive/controller.py:124 | [决战] 阶段: STAGE_CLEAR | 小关: 2 | 节点: J
22:55:18.882 | INFO     | ops/decisive/handlers.py:468 | [决战] 小关 2 通关!
22:55:22.658 | DEBUG    | emulator/controller/scrcpy.py:417 | [Emulator] click(0.502, 0.846) → pixel(964, 914)  res=1920x1080  ui/utils/navigation.py:292 in confirm_operation
22:55:22.719 | INFO     | ui/utils/navigation.py:293 | [UI] 确认操作: 点击 'confirm_4' (0.5021, 0.8463)
22:55:24.370 | DEBUG    | emulator/controller/scrcpy.py:417 | [Emulator] click(0.502, 0.846) → pixel(964, 914)  res=1920x1080  ui/utils/navigation.py:292 in confirm_operation
22:55:24.421 | INFO     | ui/utils/navigation.py:293 | [UI] 确认操作: 点击 'confirm_4' (0.5021, 0.8463)
22:55:32.421 | DEBUG    | emulator/controller/scrcpy.py:417 | [Emulator] click(0.501, 0.568) → pixel(961, 613)  res=1920x1080  ui/utils/navigation.py:292 in confirm_operation
22:55:32.486 | INFO     | ui/utils/navigation.py:293 | [UI] 确认操作: 点击 'confirm_1' (0.5005, 0.5676)
22:55:36.242 | INFO     | ui/decisive/map_controller.py:638 | [地图控制器] 结算阶段仍有奖励弹窗: 'symbol_get_ship'
22:55:36.245 | DEBUG    | emulator/controller/scrcpy.py:417 | [Emulator] click(0.953, 0.954) → pixel(1829, 1030)  res=1920x1080  ui/decisive/map_controller.py:639 in confirm_stage_clear
22:55:40.395 | INFO     | ui/decisive/map_controller.py:638 | [地图控制器] 结算阶段仍有奖励弹窗: 'symbol_get_ship'
22:55:40.399 | DEBUG    | emulator/controller/scrcpy.py:417 | [Emulator] click(0.953, 0.954) → pixel(1829, 1030)  res=1920x1080  ui/decisive/map_controller.py:639 in confirm_stage_clear
22:55:43.918 | WARNING  | ui/decisive/map_controller.py:650 | [地图控制器] 小关通关后未能确认已回到决战入口页
22:55:43.921 | DEBUG    | ops/decisive/controller.py:124 | [决战] 阶段: ENTER_MAP | 小关: 2 | 节点: A
22:55:54.643 | ERROR    | ops/decisive/controller.py:86 | [决战] 执行异常
Traceback (most recent call last):

  File "F:\app\conda\Lib\threading.py", line 1015, in _bootstrap
    self._bootstrap_inner()
    │    └ <function Thread._bootstrap_inner at 0x0000024B05E98220>
    └ <Thread(Thread-1 (_run_in_thread), started daemon 7324)>
  File "F:\app\conda\Lib\threading.py", line 1044, in _bootstrap_inner
    self.run()
    │    └ <function Thread.run at 0x0000024B05E7BF60>
    └ <Thread(Thread-1 (_run_in_thread), started daemon 7324)>
  File "F:\app\conda\Lib\threading.py", line 995, in run
    self._target(*self._args, **self._kwargs)
    │    │        │    │        │    └ {}
    │    │        │    │        └ <Thread(Thread-1 (_run_in_thread), started daemon 7324)>
    │    │        │    └ (<function _start_decisive.<locals>.executor at 0x0000024B3A208180>,)
    │    │        └ <Thread(Thread-1 (_run_in_thread), started daemon 7324)>
    │    └ <bound method TaskManager._run_in_thread of <autowsgr.server.task_manager.TaskManager object at 0x0000024B1A6D67B0>>
    └ <Thread(Thread-1 (_run_in_thread), started daemon 7324)>

  File "F:\AutoWSGR-GUI\python\site-packages\autowsgr\server\task_manager.py", line 160, in _run_in_thread
    results = executor(task)
              │        └ TaskInfo(task_id='task_37a622e4', task_type='decisive', status=<TaskStatus.RUNNING: 'running'>, created_at='2026-04-11T14:42:...
              └ <function _start_decisive.<locals>.executor at 0x0000024B3A208180>

  File "F:\AutoWSGR-GUI\python\site-packages\autowsgr\server\routes\task.py", line 308, in executor
    result = controller.run()
             │          └ <function DecisiveController.run at 0x0000024B3A1498A0>
             └ <autowsgr.ops.decisive.controller.DecisiveController object at 0x0000024B3A1292B0>

> File "F:\AutoWSGR-GUI\python\site-packages\autowsgr\ops\decisive\controller.py", line 84, in run
    return self._main_loop()
           │    └ <function DecisiveController._main_loop at 0x0000024B3A14A2A0>
           └ <autowsgr.ops.decisive.controller.DecisiveController object at 0x0000024B3A1292B0>

  File "F:\AutoWSGR-GUI\python\site-packages\autowsgr\ops\decisive\controller.py", line 153, in _main_loop
    handler()
    └ <bound method DecisivePhaseHandlers._handle_enter_map of <autowsgr.ops.decisive.controller.DecisiveController object at 0x000...

  File "F:\AutoWSGR-GUI\python\site-packages\autowsgr\ops\decisive\handlers.py", line 115, in _handle_enter_map
    entry_status = self._battle_page.detect_entry_status()
                   │    │            └ <function DecisiveBattlePage.detect_entry_status at 0x0000024B38D8DA80>
                   │    └ <autowsgr.ui.decisive.battle_page.DecisiveBattlePage object at 0x0000024B3A12A120>
                   └ <autowsgr.ops.decisive.controller.DecisiveController object at 0x0000024B3A1292B0>

  File "F:\AutoWSGR-GUI\python\site-packages\autowsgr\ui\decisive\battle_page.py", line 407, in detect_entry_status
    raise TimeoutError(f'检测决战入口状态超时 ({timeout}s): 未匹配到任何状态模板')
                                      └ 10.0

TimeoutError: 检测决战入口状态超时 (10.0s): 未匹配到任何状态模板
22:55:54.648 | WARNING  | server/routes/task.py:314 | [Task] 决战第 1 轮终止: error
22:55:54.649 | INFO     | server/task_manager.py:170 | [Task] 任务完成: task_37a622e4 (completed)

[github-actions]

Issue 概要

• issue：#413
• 版本 / 分支 / 环境：issue 未提供版本号与提交；日志路径显示来自 GUI 打包环境（AutoWSGR-GUI/python/site-packages/autowsgr，Windows）
• 任务 / 入口 / 相关设置：决战（Ex-1 示例），小关通关后的 STAGE_CLEAR -> ENTER_MAP 流程
• 关键提示 / 报错文案：检测决战入口状态超时 (10.0s): 未匹配到任何状态模板
• 用户现象：小关结算后停留在决战地图页，未回到决战入口总览页，随后进入 ENTER_MAP 时超时

附件概览

• 实际可读文件：issue 正文内联日志；1 条机器人评论（无技术结论）
• 缺失或未上传的证据：完整日志包、当时截图/录像、配置导出、版本号/commit、资源包版本

关键证据

点击此处展开

• issue 正文 / 评论：
  • 日志显示在结算阶段反复识别到 symbol_get_ship，并持续点击关闭位置，最终 settle 超时后进入 ENTER_MAP，随后 detect_entry_status() 超时。
• 运行时日志：
  • ui/decisive/map_controller.py:638：[地图控制器] 结算阶段仍有奖励弹窗: 'symbol_get_ship'
  • ops/decisive/controller.py 抛出：TimeoutError: 检测决战入口状态超时 (10.0s): 未匹配到任何状态模板
• 代码依据：
  • confirm_stage_clear() 在结算阶段直接用 symbol_get_ship/symbol_get_item 做全屏模板匹配并驱动点击：

    AutoWSGR/autowsgr/ui/decisive/map_controller.py

    Lines 588 to 642 in c72ed6a

    	ship_templates = [
    	Templates.Symbol.GET_SHIP,
    	Templates.Symbol.GET_ITEM,
    	]
    	entry_templates = Templates.Decisive.entry_status_templates()
    	collected: list[str] = []
    	for _ in range(10):
    	# 等待掉落弹窗出现
    	if ImageChecker.template_exists(
    	self._ctrl.screenshot(),
    	ship_templates,
    	confidence=0.8,
    	):
    	break
    	time.sleep(0.25)
    	while True:
    	screen = self._ctrl.screenshot()
    	detail = ImageChecker.find_any(
    	screen,
    	ship_templates,
    	confidence=0.8,
    	)
    	if detail is None:
    	time.sleep(1.0)
    	screen = self._ctrl.screenshot()
    	detail = ImageChecker.find_any(
    	screen,
    	ship_templates,
    	confidence=0.8,
    	)
    	if detail is None:
    	break
    	_log.info("[地图控制器] 检测到掉落: '{}'", detail.template_name)
    	collected.append(detail.template_name)
    	self._ctrl.click(0.953, 0.954)
    	time.sleep(0.5)
    	confirm_operation(self._ctrl, timeout=1.0)
    	# 掉落处理结束后，继续等待回到决战入口页，避免奖励弹窗残留导致后续状态识别超时
    	settle_deadline = time.monotonic() + 12.0
    	reward_ack_pos = (0.5, 0.5)
    	while time.monotonic() < settle_deadline:
    	screen = self._ctrl.screenshot()
    	if ImageChecker.find_any(screen, entry_templates, confidence=0.8) is not None:
    	_log.info('[地图控制器] 小关通关结算完成，已回到决战入口页')
    	break
    	reward_detail = ImageChecker.find_any(screen, ship_templates, confidence=0.8)
    	if reward_detail is not None:
    	_log.info("[地图控制器] 结算阶段仍有奖励弹窗: '{}'", reward_detail.template_name)
    	self._ctrl.click(*reward_ack_pos)
    	time.sleep(0.35)
    	confirm_operation(self._ctrl, timeout=0.8)
    	continue

  • symbol_get_ship/symbol_get_item 为通用战斗掉落符号模板：

    AutoWSGR/autowsgr/image_resources/ops.py

    Lines 110 to 115 in c72ed6a

    	class Symbol:
    	"""符号/标志模板。"""
    	GET_SHIP = LazyTemplate('combat/get_ship_540p.png', 'symbol_get_ship')
    	GET_ITEM = LazyTemplate('combat/get_item_540p.png', 'symbol_get_item')
    	CLICK_TO_CONTINUE = LazyTemplate('combat/result_540p.png', 'click_to_continue')

  • ENTER_MAP 阶段会调用 detect_entry_status()，该函数只在“入口总览页”模板中匹配，若仍在地图页会超时：

    AutoWSGR/autowsgr/ui/decisive/battle_page.py

    Lines 350 to 405 in c72ed6a

    	def detect_entry_status(
    	self,
    	*,
    	timeout: float = 10.0,
    	interval: float = 0.3,
    	confidence: float = 0.8,
    	) -> DecisiveEntryStatus:
    	"""检测当前决战总览页的入口状态。
    	通过图像模板匹配识别 4 种入口状态:
    	``CANT_FIGHT`` / ``CHALLENGING`` / ``REFRESHED`` / ``REFRESH``。
    	对应 legacy ``detect('enter_map')`` — 使用
    	``decisive_battle_image[3:7]`` 的 ``wait_images``。
    	Parameters
    	----------
    	timeout:
    	最大等待时间 (秒)。
    	interval:
    	截图检测间隔 (秒)。
    	confidence:
    	模板匹配置信度阈值。
    	Returns
    	-------
    	DecisiveEntryStatus
    	检测到的入口状态枚举值。
    	Raises
    	------
    	TimeoutError
    	超时仍未匹配到任何入口状态。
    	"""
    	from autowsgr.image_resources import Templates
    	templates = Templates.Decisive.entry_status_templates()
    	statuses = list(DecisiveEntryStatus)
    	deadline = time.monotonic() + timeout
    	while True:
    	screen = self._ctrl.screenshot()
    	detail = ImageChecker.find_any(
    	screen,
    	templates,
    	confidence=confidence,
    	)
    	if detail is not None:
    	idx = next(i for i, t in enumerate(templates) if t.name == detail.template_name)
    	status = statuses[idx]
    	_log.info('[决战] 决战入口状态: {}', status.value)
    	return status
    	if time.monotonic() >= deadline:
    	raise TimeoutError(f'检测决战入口状态超时 ({timeout}s): 未匹配到任何状态模板')
    	time.sleep(interval)

    、

    AutoWSGR/autowsgr/ops/decisive/handlers.py

    Lines 102 to 123 in c72ed6a

    	def _handle_enter_map(self) -> None:
    	"""检测入口状态 → 按需重置 → 点击进入地图 → 转到 WAITING_FOR_MAP。
    	通过 :meth:`DecisiveBattlePage.detect_entry_status` 识别当前章节的
    	入口状态，根据 :class:`~autowsgr.types.DecisiveEntryStatus` 分别处理:
    	- ``REFRESH``: 使用磁盘重置关卡后重新检测
    	- ``REFRESHED``: 有存档进度，直接进入地图 (后续会弹出使用上次舰队)
    	- ``CHALLENGING``: 挑战中，直接进入地图
    	- ``CANT_FIGHT``: 无法出击，抛出异常
    	"""
    	entry_status = self._battle_page.detect_entry_status()
    	if entry_status == DecisiveEntryStatus.REFRESH:
    	_log.info('[决战] 检测到「重置关卡」状态，执行章节重置')
    	self._battle_page.reset_chapter()
    	# 重置后重新检测入口状态
    	entry_status = self._battle_page.detect_entry_status()
    	if entry_status == DecisiveEntryStatus.CANT_FIGHT:
    	raise RuntimeError(
    	f'决战 Ex-{self._config.chapter}: 入口状态为「无法出击」，其他关卡正在进行中'

根因判断

• 直接结论：已证实是结算阶段奖励模板误检导致的状态机错位。confirm_stage_clear() 将 symbol_get_ship 作为“奖励弹窗存在”依据；当该模板在地图页被误匹配时，流程会持续执行“关闭奖励”分支，未能稳定回到入口总览页，之后 ENTER_MAP 在错误页面调用 detect_entry_status() 触发超时。
• 证据链：issue 日志中的重复 symbol_get_ship 命中 + 代码中以该模板直接驱动点击 + ENTER_MAP 对页面前置条件（入口总览页）的强依赖。
• 当前主线是否可能已修复：部分缓解但未完全闭环。当前主线已将结算阶段确认点击点改为中部位置（减少旧坐标副作用），但核心判定仍依赖同一组通用模板全屏匹配，缺少“误检熔断/多特征确认”，根因仍有复发可能。

修复方案

1. 代码 / 配置 / 资源层修复
   将“奖励弹窗存在”从单模板命中改为组合条件（如奖励标题/遮罩/关闭控件 + 掉落符号），并限制匹配区域；引入连续帧确认，避免单帧误检驱动点击。
2. 需要补充的测试、日志或截图
   增加回归用例：在“地图页含相似图案”样本上验证不会进入奖励关闭分支；在真实奖励弹窗样本上验证可正常关闭并回到入口页。
3. 如问题属于不支持场景，应如何限制入口或改进提示
   若 settle 超时仍未识别入口页，应在 STAGE_CLEAR 直接抛出“结算未完成”错误并附带截图，而不是继续进入 ENTER_MAP 造成二次超时误导。

给用户的建议

• 用户现在可以直接尝试的动作：升级到最新构建后复测；若仍复现，补充“复现时刻前后 30s 完整日志 + 两张截图（误检时画面、超时时画面）”。
• 是否建议升级 / 重下完整包 / 重置配置 / 更换环境：建议先升级；当前证据更偏向流程判定缺陷，不像配置损坏。
• 是否有临时绕过方案：若运行到小关结算时出现重复点击且不退回入口，可手动点回入口后再继续任务，避免直接触发 ENTER_MAP 超时。

给修复 AI 的建议（可复制）

点击此处展开

现象：
决战小关结算后，流程在地图页误判“仍有奖励弹窗”，反复执行确认点击，随后 ENTER_MAP 在错误页面调用 detect_entry_status() 超时。

关键证据：
- [地图控制器] 结算阶段仍有奖励弹窗: 'symbol_get_ship'
- TimeoutError: 检测决战入口状态超时 (10.0s): 未匹配到任何状态模板
- confirm_stage_clear() 以 ship_templates 全屏匹配作为奖励弹窗判定依据

可能相关线索（待验证）：
1) symbol_get_ship 在决战地图页存在高相似区域，confidence=0.8 误命中；
2) settle 分支缺少“多模板联合确认 + 连续帧确认 + 误检熔断”；
3) settle 失败后仍继续 ENTER_MAP，导致错误被延后暴露为入口状态超时。

置信度

• 中
• 还缺什么证据：问题发生版本/commit、完整日志包、复现现场截图（用于最终确认是模板误检还是页面切换时序异常）

---

点击此处展开分析过程

● skill(generic-issue-log-analysis)

● Get repo remote and HEAD commit (shell)
│ git --no-pager remote get-url origin && git --no-pager rev-parse HEAD
└ 3 lines...

● Get issue details (MCP: github-mcp-server) · method: "get_comments", owner: "OpenWSGR", repo: "Au…
└ [{"id":4229651811,"body":"🤖 AI 正在分析该 Issue... \n\n感谢您的反馈！AI
正在自动分析该问题，预...

● Get issue details (MCP: github-mcp-server) · method: "get_labels", owner: "OpenWSGR", repo: "Auto…
└ {"labels":[],"totalCount":0}

● Get issue details (MCP: github-mcp-server) · method: "get", owner: "OpenWSGR", repo: "AutoWSGR", …
└ {"number":413,"title":"决战小关结束流程中奖励弹窗模板误检，无法正确返回入口总览页","body":"###
在提交您的问题反馈之前...

我先把代码里的关键路径对齐一下（confirm_stage_clear、symbol_get_ship、detect_entry_status），再写结论到 copilot_answer.md。

● Search (grep)
│ "def confirm_stage_clear|symbol_get_ship|detect_entry_status|_handle_enter_map" in **/*.py
└ 9 lines found

● Search (glob)
│ "**/locale"
└ No matches found

● Read map_controller.py
│ autowsgr/ui/decisive/map_controller.py
└ L560:700 (141 lines read)

● Read battle_page.py
│ autowsgr/ui/decisive/battle_page.py
└ L320:450 (106 lines read)

● Read handlers.py
│ autowsgr/ops/decisive/handlers.py
└ L90:170 (81 lines read)

● Read ops.py
│ autowsgr/image_resources/ops.py
└ L90:140 (51 lines read)

● Search (grep)
│ "def entry_status_templates|entry_status_templates(" in **/*.py (autowsgr)
└ 3 lines found

● Search (grep)
│ "class DecisiveEntryStatus|CANT_FIGHT|CHALLENGING|REFRESHED|REFRESH" in **/*.py (autowsgr)
└ 28 lines found

● Read ops.py
│ autowsgr/image_resources/ops.py
└ L140:200 (61 lines read)

● Check history of settle loop lines (shell)
│ git --no-pager blame -L 627,643 -- autowsgr/ui/decisive/map_controller.py
└ 18 lines...

● Show history for map_controller (shell)
│ git --no-pager log --oneline -- autowsgr/ui/decisive/map_controller.py | head -n 20
└ 2 lines...

● Check working tree status (shell)
│ git --no-pager status --short
└ 1 line...

● Edit
└ Create copilot_answer.md

● Read copilot_answer.md
└ 75 lines read

● Show changed files (shell)
│ git --no-pager status --short
└ 2 lines...

已完成分析，结论已写入 copilot_answer.md。

核心判断是：confirm_stage_clear() 里用 symbol_get_ship/symbol_get_item 做奖励弹窗判定时发生误检，导致流程在地图页反复走“关闭奖励”分支，最终在错误页面进入 ENTER_MAP 并触发 detect_entry_status() 超时。文档中也补充了证据链、当前主线影响评估、修复方案和用户侧临时建议。

Changes +76 -0
Requests 1 Premium (2m 2s)
Tokens ↑ 424.1k • ↓ 7.6k • 397.8k (cached) • 4.7k (reasoning)

🔗 GitHub Action 运行记录