fix: 游戏闪退/最小化时截图失败处理

- executor: 新增 _screenshot 统一入口, 异常/None 返回 None
- executor: 所有 post_screencap 调用改为 _screenshot + None 检查
- executor: _wait_until_frames 截图失败设 _abort_reason 中止本轮
- avatar: locate_oper 和槽位 OCR 截图加 None 检查
- worker: 连续截图失败退避, 前3次快重试, 之后5s一次

Author: Windsland52

aao/core/avatar.py

@@ -120,6 +120,9 @@ def locate_oper(
     3. 无缓存/匹配失败 → 逐个点击槽位 → OCR 干员名 → 截取头像存盘
     """
     image = ctrl.post_screencap().wait().get()
+    if image is None:
+        logger.error("截图失败, 游戏可能已退出或最小化")
+        return None
     slots = detect_slots(context, image)
     if not slots:
         logger.error("未检测到干员槽位")
@@ -165,6 +168,9 @@ def locate_oper(
 
         # 截图详情页
         detail_img = ctrl.post_screencap().wait().get()
+        if detail_img is None:
+            logger.warning("截图失败, 跳过该槽位")
+            continue
 
         # OCR 干员名
         name = _ocr_oper_name(context, detail_img)

aao/measure/worker.py

@@ -40,6 +40,7 @@ def __init__(
         self.interval_s = interval_s
         self._running = False
         self._reset_requested = False
+        self._consecutive_errors = 0
         self._latest: dict = {}
         self._lock = threading.Lock()
 
@@ -58,9 +59,19 @@ def run(self) -> None:
             try:
                 img = self.controller.post_screencap().wait().get()
                 self.time_source.update(img)
+                self._consecutive_errors = 0
             except Exception:
-                logger.exception("采集/更新失败，跳过")
-                time.sleep(self.interval_s)
+                self._consecutive_errors += 1
+                if self._consecutive_errors <= 3:
+                    logger.warning("截图失败 %d 次", self._consecutive_errors)
+                elif self._consecutive_errors == 4:
+                    logger.error(
+                        "截图连续失败 %d 次, 游戏可能已退出或最小化, 降低重试频率",
+                        self._consecutive_errors,
+                    )
+                # 退避: 前 3 次快重试, 之后 5s 一次
+                backoff = self.interval_s if self._consecutive_errors <= 3 else 5.0
+                time.sleep(backoff)
                 continue
 
             state = {

custom/action/executor.py

@@ -356,9 +356,20 @@ def _perform_action(
         elif action.action_type == ActionType.RETREAT:
             self._retreat(ctrl, action)
 
+    def _screenshot(self, ctrl: Controller) -> np.ndarray | None:
+        """统一截图入口, 异常或空返回 None。"""
+        try:
+            img = ctrl.post_screencap().wait().get()
+        except Exception:
+            logger.exception("截图失败, 游戏可能已退出或最小化")
+            return None
+        return img
+
     def _read_frames(self, ctrl: Controller, ts: TimeSource) -> int | None:
-        """截图 → TimeSource → 累计帧。"""
-        img = ctrl.post_screencap().wait().get()
+        """截图 → TimeSource → 累计帧。截图异常返回 None。"""
+        img = self._screenshot(ctrl)
+        if img is None:
+            return None
         lf = ts.update(img)
         if lf is None:
             return None
@@ -383,7 +394,10 @@ def _wait_until_frames(
         while time.time() < deadline:
             if context_tasker_stopping():
                 return
-            img = ctrl.post_screencap().wait().get()
+            img = self._screenshot(ctrl)
+            if img is None:
+                self._abort_reason = "screenshot failed"
+                return
             now = time.time()
             lf = ts.update(img)
             if lf is not None:
@@ -435,7 +449,9 @@ def _pause_at_battle_start(
             if context_tasker_stopping():
                 return False
             time.sleep(0.2)
-            img = ctrl.post_screencap().wait().get()
+            img = self._screenshot(ctrl)
+            if img is None:
+                continue
             reco = context.run_recognition("Farm@BattleOn", img)
             if reco and reco.hit:
                 logger.debug("开局暂停: 战斗已加载")
@@ -451,7 +467,9 @@ def _pause_at_battle_start(
             self._tap_afa(afa_hotkey.VK_F, "F 开局暂停")
             self._paused = True
             time.sleep(0.03)
-            img = ctrl.post_screencap().wait().get()
+            img = self._screenshot(ctrl)
+            if img is None:
+                continue
             reco = context.run_recognition("BattlePaused", img)
             if reco and reco.hit:
                 logger.debug("开局暂停成功 (Play.png 命中), attempt=%d", i + 1)
@@ -481,7 +499,9 @@ def _pause(
         if context_tasker_stopping():
             return False
         for attempt in range(2):
-            img = ctrl.post_screencap().wait().get()
+            img = self._screenshot(ctrl)
+            if img is None:
+                return False
             reco = context.run_recognition("BattlePaused", img)
             if reco and reco.hit:
                 self._paused = True
@@ -491,7 +511,9 @@ def _pause(
             self._paused = True
             logger.debug("暂停(F), 等待 %dms, attempt=%d", config.PAUSE_WAIT_MS, attempt + 1)
             time.sleep(config.PAUSE_WAIT_MS / 1000)
-            img = ctrl.post_screencap().wait().get()
+            img = self._screenshot(ctrl)
+            if img is None:
+                return False
             reco = context.run_recognition("BattlePaused", img)
             if reco and reco.hit:
                 logger.debug("暂停确认成功(模板命中), attempt=%d", attempt + 1)
@@ -588,7 +610,9 @@ def _step_to_frames(
         for _ in range(max_steps):
             if context_tasker_stopping():
                 return
-            img = ctrl.post_screencap().wait().get()
+            img = self._screenshot(ctrl)
+            if img is None:
+                return
             lf = ts.update(img)
             if lf is None:
                 break