# -*- coding: utf-8 -*- """截图连续识别失败熔断。 2026-11-16 实测: 游戏窗口被最小化/关掉后, AALC 每帧在 cv2.matchTemplate 上抛 「corr.rows <= img.rows + templ.rows - 1」断言, 只记 ERROR 继续跑, 第 2 局空转 4.5 小时。 2026-11-22 复查: 只在任务主线程里中止(retry_monitor 线程里抛只会打死那条线程); 要连续出错持续一段时间才算。 """ import sys import threading import types import unittest from pathlib import Path from unittest import mock REPO = Path(__file__).resolve().parents[1] sys.path.insert(0, str(REPO)) from lc_mcp import aalc_patches as ap # noqa: E402 class FakeImageUtils: """按顺序返回给定结果; None = 上游的识别失败分支。""" def __init__(self, results): self.results = list(results) self.calls = 0 def match_template(self, screenshot, template, threshold, *args, **kwargs): self.calls += 1 if self.results: return self.results.pop(0) return (1, 1), 0.9 class ImageErrorGuardTest(unittest.TestCase): def install(self, fake, clock=None, span=30, limit=3): self.lines = [] module = types.ModuleType('utils.image_utils') module.ImageUtils = fake with mock.patch.dict(sys.modules, {'utils': types.ModuleType('utils'), 'utils.image_utils': module}): self.assertIsNotNone(ap.install_image_error_guard( log=self.lines.append, clock=clock or (lambda: self.now[0]), span=span, limit=limit)) self.lines.clear() # 安装时那行 "patch: …" 不算 return fake def setUp(self): self.now = [0.0] def fail_frames(self, fake, times, step): for _ in range(times): self.now[0] += step fake.match_template(None, None, None) def test_ok_results_never_abort(self): fake = self.install(FakeImageUtils([((5, 5), 0.9)] * 10)) for _ in range(10): self.now[0] += 0.1 self.assertEqual(fake.match_template(None, None, None), ((5, 5), 0.9)) def test_short_burst_does_not_abort(self): # 68 次/秒的坏帧只持续 1 秒(重启游戏/切分辨率一闪而过): 原来 0.3 秒就停掉整个任务 fake = self.install(FakeImageUtils([None] * 68), limit=20) self.fail_frames(fake, 68, 1 / 68) self.assertEqual(self.lines, []) def test_a_success_resets_the_streak(self): fake = self.install(FakeImageUtils([None] * 5 + [((1, 1), 0.9)] + [None] * 5), span=30, limit=3) self.fail_frames(fake, 5, 5) # 25 秒的连续失败 self.now[0] += 1 fake.match_template(None, None, None) # 成功一次 self.fail_frames(fake, 5, 5) # 又 25 秒: 每段都不到 30 秒 self.assertEqual(self.lines, []) def test_sustained_failure_aborts_with_clear_message(self): fake = self.install(FakeImageUtils([None] * 100), span=30, limit=20) with mock.patch.object(ap.decisions, 'record') as record: with self.assertRaises(ap.TaskAbort) as caught: self.fail_frames(fake, 100, 1) self.assertEqual(fake.calls, 31) # 第 1 次起算, 持续满 30 秒那一次就停 self.assertIn('截图连续识别失败(31 次/30 秒)', str(caught.exception)) self.assertIn('[ERROR]', '\n'.join(self.lines)) record.assert_called_once_with('image_error', None, 'abort', count=31, seconds=30) def test_other_threads_never_abort_and_never_count(self): # retry_monitor 线程也调 match_template; 在那条线程里抛只会打死它, 任务照跑 fake = self.install(FakeImageUtils([None] * 200), span=1, limit=3) errors = [] def monitor(): try: self.fail_frames(fake, 50, 1) except BaseException as e: # noqa: B902 - 要看 TaskAbort 是否漏到这条线程 errors.append(e) worker = threading.Thread(target=monitor) worker.start() worker.join() self.assertEqual(errors, []) self.assertEqual(self.lines, []) with self.assertRaises(ap.TaskAbort), mock.patch.object(ap.decisions, 'record'): self.fail_frames(fake, 3, 1) # 主线程自己的计数从 0 开始: 第 3 次、持续 2 秒才停 def test_abort_is_not_a_normal_exception(self): # AALC 的 onetime_mir_process 会吞 Exception 再开一局, 熔断必须穿透 self.assertFalse(issubclass(ap.TaskAbort, Exception)) def test_restores_nothing_when_upstream_has_no_match_template(self): module = types.ModuleType('utils.image_utils') module.ImageUtils = object() with mock.patch.dict(sys.modules, {'utils': types.ModuleType('utils'), 'utils.image_utils': module}): self.assertIsNone(ap.install_image_error_guard(log=lambda *_: None))