diff --git a/README.md b/README.md index 985c24b..a59f537 100644 --- a/README.md +++ b/README.md @@ -211,6 +211,10 @@ MCP 初始化说明与工具描述均指导 AI 优先使用 AALC:常规日常 - **截图持续出错就结束任务**:游戏窗口被最小化或关掉后,AALC 每帧识图都出错、只记日志继续跑(11-16 空转了 4.5 小时)。 任务主线程里识图连续出错满 30 秒(至少 20 次、中间一次都没成功)就按未完成结束(退出码 4); 一闪而过的坏帧和 AALC 重试监控线程里的出错都不算。 +- **长时间没有进展就结束任务**:AALC 认不出画面时会在没有上限的循环里一直转,不报错,也不再打「开始执行 / 结束执行」 + (11-21 镜牢入口改版后大厅 ↔ 驱动来回点了 5 小时 20 分;11-17 全员阵亡后重开循环转了 5 小时 40 分)。 + 任务主线程 40 分钟没有新的一条就按未完成结束(退出码 4),配置照常写回。正常运行时最长约 20 分钟(一场 Boss 战)。 + `LCP_PROGRESS_STALL_MIN` 改分钟数,`0` 关闭。 - **返回按钮(上游 V1.6.2)**:上游在首次引导页(新赛季进镜牢的几十页引导)拿 `click_element` 的返回值当坐标再点, 它实际返回 `True`,会 `TypeError` 退出任务。补丁只在这几处把它改成"只找不点",由上游点一次; 上游改掉这种写法后安装时查不到,就不装。 @@ -275,6 +279,7 @@ powershell -ExecutionPolicy Bypass -File scripts\install_convert_task.ps1 -Every | `LCP_SHOP_NAMES` | 未设置 | 设为 `0` 时商店必买只用 AALC 图标模板;设为 JSON 文件路径时用它代替 `lc_mcp/data/shop_gifts.json` | | `LCP_THEME_PACK_SYSTEMS` | 未设置 | 设为 `0` 时卡包只按 AALC 原权重选;设为 JSON 文件路径时用它代替 `lc_mcp/data/theme_pack_systems.json` | | `LCP_THEME_PACK_THRESHOLD` | 1 | 卡包优选阈值:最高分低于它先刷新。设为 `0` 时用 `theme_pack_list.yaml` 里的值 | +| `LCP_PROGRESS_STALL_MIN` | 40 | 任务进程多少分钟没有「开始执行/结束执行」就结束任务;`0` 关闭 | | `LCP_KEY_HOLD` | 未设置 | 设为 `0` 时任务进程的按键完全走 AALC 原逻辑(前台 `pyautogui.press`、不按住) | | `LCP_KILL_KEY` | `end` | 任务子进程的急停键,如 `pause` / `scrolllock`;认不出的键名会报错而不是换成默认键 | | `LC_PY` | 当前解释器 | `levelup.py`/`auto_cycle.py` 调用 MCP 用的 Python | diff --git a/docs/BACKLOG.md b/docs/BACKLOG.md index 24b1f8b..bcac4e5 100644 --- a/docs/BACKLOG.md +++ b/docs/BACKLOG.md @@ -36,7 +36,7 @@ | `c9a884a` | 首次引导页(`first_prompt`)改成 `if back_button := auto.click_element(返回)` 再 `mouse_click(back_button[0], …)`;新增 `back2_assets.png` | **上游 bug**:`click_element` 点完返回 `True`,`True[0]` → `TypeError`,镜牢任务直接退出(`road_to_mir`、`Mirror.run`、`select_battle_team` 三处)。补丁 `install_back_button_result` 只在这种写法调用时改成只找不点,由上游点一次(ISSUES I-15) | | `bbe646d` | 领奖拆成 `claim_mission_rewards` / `claim_battle_pass_rewards` / `claim_mail_rewards`,删 `set_get_prize`;旧配置首次加载自动换算,通行证奖励默认关 | 本仓库不读写这几个键,`reward` 任务仍调 `to_get_reward`;三项全关时它什么都不做。实机确认要不要打开通行证奖励 | | `2d52dd7` | `Automation.get_template_position`、`ImageUtils.get_template_bbox`(按 `set_win_size/1440` 缩放模板坐标) | 不涉及补丁;`match_template` 没改,截图熔断照常挂 | -| `c0e4926` | 采光、镜牢入口模板图换新 | 不涉及补丁;10-13 那次镜牢入口误认成采光(0.836)连点 18 分钟,换图后值得留意 | +| `c0e4926` | 采光、镜牢入口模板图换新 | **11-21 空转 5 小时的原因**:游戏改版后旧的 `home/mirror_dungeons_assets.png` 最高只匹配 0.41,进不了镜牢(ISSUES I-18);升级后待实机确认 | | `3293a90` | 队伍设置时间统计重置 | 不涉及 | 单测 769 项通过(含新加的上游真实 `select_battle_team` 端到端:不装补丁 `TypeError`,装了点一次)。 diff --git a/docs/ISSUES.md b/docs/ISSUES.md index 6f67125..a58f2a2 100644 --- a/docs/ISSUES.md +++ b/docs/ISSUES.md @@ -6,7 +6,7 @@ 状态:`已修` = 代码改了且实机验证;`已修待验` = 代码改了没实机验证; `待修` = 有确定方案;`待数据` = 卡在缺数据/缺决策;`观察` = 暂不处理,先攒样本;`记录` = 不是缺陷。 -最近更新:2026-11-22 云端(AALC 升到 V1.6.2;复查 11-16~11-22 的提交,按 `feedback/runs/2026-11-15_2026-11-21` 的决策记录修 I-15~I-17)。 +最近更新:2026-11-22 云端(按原始日志查清两次 5 小时空转,加无进展兜底 I-18;AALC 升到 V1.6.2;复查 11-16~11-22 的提交,按 `feedback/runs/2026-11-15_2026-11-21` 的决策记录修 I-15~I-17)。 上一次:2026-11-15 14:10(本机实机:I-05 键盘 4/4 进入、I-06 软件点击兜底关掉弹窗、I-08 卡包按体系加分生效;6 连刷 6/6 完成,见 [`feedback/2026-11-15/README.md`](feedback/2026-11-15/README.md))。 上一次:2026-11-15 01:55 本机(6 连刷进行中)。 @@ -188,9 +188,25 @@ (服务器重试弹窗从此没人点),任务照跑,下一秒主线程才真正中止。另外"120 秒内 20 次"在 68 次/秒的出错速度下 0.3 秒就到, 重启游戏这类一闪而过的坏帧也会停掉整个任务。 - **修法**:只在任务主线程计数和中止;要求连续出错满 30 秒(至少 20 次,中间没有一次识别成功)。 -- **未解决**:这两次熔断前各有约 5.5~6 小时没有任何决策记录(11-17 00:30→06:25、11-21 13:53→19:21),熔断只是收尾, - 卡住的原因要看任务日志。归档说明里的过滤日志 `logs/*.log` 被 `.gitignore` 的 `*.log` 挡掉,没进仓库; - 现已对 `docs/feedback/runs/**/logs/*.log` 放行,请在本机重新 `git add` 这批日志。 +- 这两次熔断前各有 5 小时多没有进展,熔断只是收尾(游戏窗口最后没了);卡住的原因见 I-18。 + +### I-18 认不出画面时 AALC 空转几个小时、不报错 【已修待验】 + +按原始日志(`feedback/runs/2026-11-15_2026-11-21/logs-raw/`)查清,两次原因不同,共同点是上游循环没有上限、也不再打「开始执行 / 结束执行」: + +- **11-21 14:01 起 5 小时 20 分**:第 2 局从大厅进镜牢,驱动菜单里的镜牢入口 `home/mirror_dungeons_assets.png` 匹配 10195 次、 + 最高 0.41,于是大厅 ↔ 驱动来回点了 2500 多轮(`drive_assets` 0.98、`window_assets` 0.95 各 2500 多次)。这张图在 11-18 16:21 + 之前的每一轮都是 1.00,11-21 的三轮最高只有 0.42~0.49 → 游戏 11-18~11-21 之间改了界面。上游 V1.6.2 的 `c0e4926`(11-19) + 换的正是这张图,升级后应当认得出,**待实机确认能从大厅进镜牢**。 +- **11-17 00:45 起 5 小时 40 分**:全员阵亡(`battle/dead_all_confirm` 0.94)后进 `Mirror.re_start()`,它是 `while True` + (找放弃 / 设置,否则按 Esc),没有次数上限;之后每个模板的分数 5.5 小时完全不变,画面一帧没变(游戏卡住或不再渲染)。 +- 另:11-16 04:25 起 3 小时 30 分是窗口没了的识图出错风暴,截图熔断(I-17)现在 30 秒就停。 +- **修法**:`install_progress_watchdog`:任务主线程 40 分钟没有新的「开始执行 / 结束执行」就抛 `TaskAbort`,按未完成结束(退出码 4), + 记 `[ERROR]` 和 `progress/stall`(带最后一条里程碑)。`LCP_PROGRESS_STALL_MIN` 可调,`0` 关闭。 +- **依据**:用 20 份原始日志回放:17 轮正常运行最长空档约 20 分钟(一场 Boss 战),一次都不会误停;上面三次分别会在 + 05:05、01:25、14:41(最后一条之后 40 分钟)停下。 +- **验证方式**:正常跑团日志开头有 `patch: 40 分钟没有「开始执行/结束执行」就结束任务`,不应出现 `progress/stall`; + 真卡住时 `task_status` 的 `errors` 里有 `N 分钟没有新的「开始执行/结束执行」(最后一条: …)`。 --- ## 二、需求清单 diff --git a/lc_mcp/aalc_patches.py b/lc_mcp/aalc_patches.py index d475d3a..e1ee85b 100644 --- a/lc_mcp/aalc_patches.py +++ b/lc_mcp/aalc_patches.py @@ -2115,6 +2115,97 @@ def install_image_error_guard(log=print, clock=time.monotonic, log('[lc_mcp] patch: 截图识别连续出错 %d 秒(至少 %d 次)即结束任务' % (span, limit)) return original + +# ---------------------------------------------------------------- 长时间没有进展就结束 + +# AALC 的流程函数都套着 begin_and_finish_time_log, 进出各打一条「开始执行 X」「结束执行 X」(INFO)。 +# 认不出画面时它会在某个没有上限的循环里一直转, 不报错也不再打这两种日志 +# (feedback/runs/2026-11-15_2026-11-21/logs-raw): +# - 11-21 14:01 起 5 小时 20 分: 游戏界面改版后驱动菜单里的镜牢入口(home/mirror_dungeons_assets.png) +# 最高只匹配到 0.41, 大厅 ↔ 驱动来回点了 2500 多轮(上游 V1.6.2 换了这张图); +# - 11-17 00:45 起 5 小时 40 分: 全员阵亡后 Mirror.re_start() 的 while True, 画面 5.5 小时一帧没变; +# - 11-16 04:25 起 3 小时 30 分: 窗口没了后的识图出错风暴(现在截图熔断 30 秒就停)。 +# 正常运行里两条之间最长的是一场战斗, 20 个 run 里最长 1184 秒(约 20 分钟); 默认 40 分钟没有新的一条就结束任务。 +# 检查放在任务主线程每帧都会走的 match_template / take_screenshot 里, 抛 TaskAbort, finally 照常写回配置。 +PROGRESS_STALL_ENV = 'LCP_PROGRESS_STALL_MIN' # 分钟; 0 = 不装 +PROGRESS_STALL_MINUTES = 40 +PROGRESS_MARKERS = ('开始执行', '结束执行') + + +class _ProgressHandler(logging.Handler): + """AALC 日志里每出现一条「开始执行 / 结束执行」就记下时间。""" + + def __init__(self, state, clock): + super().__init__(logging.INFO) + self.state = state + self.clock = clock + + def emit(self, record): + try: + message = record.getMessage() + except Exception: + return + if message.startswith(PROGRESS_MARKERS): + self.state['last'], self.state['what'] = self.clock(), message.split(' 耗时', 1)[0] + + +def install_progress_watchdog(log=print, env=None, clock=time.monotonic): + """长时间没有「开始执行 / 结束执行」就结束任务。返回挂在 AALC logger 上的 handler, 未安装返回 None。""" + env = os.environ if env is None else env + setting = (env.get(PROGRESS_STALL_ENV) or '').strip() + try: + minutes = float(setting) if setting else PROGRESS_STALL_MINUTES + except ValueError: + log('[lc_mcp] %s=%r 不是数字, 按默认 %d 分钟' % (PROGRESS_STALL_ENV, setting, PROGRESS_STALL_MINUTES)) + minutes = PROGRESS_STALL_MINUTES + if minutes <= 0: + log('[lc_mcp] 无进展兜底已关闭(%s=%s)' % (PROGRESS_STALL_ENV, setting)) + return None + try: + from utils.image_utils import ImageUtils + from module.automation import auto + except Exception as e: + log('[lc_mcp] 无进展兜底跳过: 无法导入 %s' % e) + return None + real_match = getattr(ImageUtils, 'match_template', None) + real_shot = getattr(auto, 'take_screenshot', None) + if real_match is None or real_shot is None: + log('[lc_mcp] 无进展兜底跳过: 上游没有 ImageUtils.match_template / auto.take_screenshot') + return None + owner = threading.get_ident() + limit = minutes * 60 + state = {'last': clock(), 'what': '(任务开始后还没有)', 'fired': False} + + def check(): + if threading.get_ident() != owner: + return # 重试监控线程里抛只会打死那条线程 + idle = clock() - state['last'] + if idle < limit: + return + if not state['fired']: + state['fired'] = True + log('[ERROR] [lc_mcp] %d 分钟没有新的「开始执行/结束执行」(最后一条: %s), 判定卡死, 结束任务' + % (idle // 60, state['what'])) + decisions.record('progress', None, 'stall', minutes=int(idle // 60), last=state['what']) + raise TaskAbort('%d 分钟没有进展(最后一条: %s), AALC 可能在认不出的画面上空转' + % (idle // 60, state['what'])) + + def match_template(*args, **kwargs): + check() + return real_match(*args, **kwargs) + + def take_screenshot(*args, **kwargs): + check() + return real_shot(*args, **kwargs) + + handler = _ProgressHandler(state, clock) + logging.getLogger('AALC').addHandler(handler) + ImageUtils.match_template = staticmethod(match_template) + auto.take_screenshot = take_screenshot + log('[lc_mcp] patch: %g 分钟没有「开始执行/结束执行」就结束任务' % minutes) + return handler + + def install_gift_confirm_guard(log=print, clock=time.monotonic): """「获得E.G.O饰品」确认点了不关时换落点, 再不行就结束任务。返回原 click_element, 未安装返回 None。 diff --git a/lc_mcp/aalc_task.py b/lc_mcp/aalc_task.py index 0f6f6bc..c12c8b0 100644 --- a/lc_mcp/aalc_task.py +++ b/lc_mcp/aalc_task.py @@ -14,8 +14,8 @@ from .aalc_engine import bootstrap from .aalc_patches import (TaskAbort, WindowGuard, driver_click_tasks, headless_hdr_warning, install_back_button_result, install_default_battle_team, install_event_choices, install_exact_team_match, install_gift_confirm_guard, install_gift_preference, - install_image_error_guard, install_key_hold, install_rabbit_hole, - install_robust_set_foreground, install_shop_audit, install_shop_by_name, + install_image_error_guard, install_key_hold, install_progress_watchdog, + install_rabbit_hole, install_robust_set_foreground, install_shop_audit, install_shop_by_name, install_system_team_selection, install_team_screen_guard, install_theme_pack_audit, install_theme_pack_refresh_click, install_theme_pack_systems, install_typed_keyboard_road, load_rabbit_hole, mirror_progress, stop_driver_click) @@ -146,6 +146,7 @@ def _run(task, params): decisions.open() # TaskRunner 给的 .decisions.jsonl; 直接运行时不写 install_exact_team_match(auto, log) install_robust_set_foreground(screen, log=log) + install_progress_watchdog(log=log) # 40 分钟没有「开始执行/结束执行」就结束(11-17/11-21 各空转 5 小时多) if not cfg.simulator: install_key_hold(log=log) # 前台按键带扫描码、各模式按住再松开(ISSUES I-05) # 日常本(经验/纽本)不翻队伍列表: 队伍是自定义名字时按名字找必然失败, diff --git a/tests/test_progress_watchdog.py b/tests/test_progress_watchdog.py new file mode 100644 index 0000000..ff1a975 --- /dev/null +++ b/tests/test_progress_watchdog.py @@ -0,0 +1,146 @@ +# -*- coding: utf-8 -*- +"""长时间没有「开始执行 / 结束执行」就结束任务。 + +feedback/runs/2026-11-15_2026-11-21/logs-raw: 11-21 14:01 起镜牢入口认不出, 大厅 ↔ 驱动来回点 5 小时 20 分; +11-17 00:45 起全员阵亡后 re_start() 的 while True 转了 5 小时 40 分。两次都没有报错, 只是不再有这两种日志。 +""" +import logging +import sys +import threading +import types +import unittest +from pathlib import Path +from types import SimpleNamespace +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 + +AALC_LOG = logging.getLogger('AALC') + + +class FakeImageUtils: + calls = 0 + + @staticmethod + def match_template(screenshot, template, bbox, model='clam'): + FakeImageUtils.calls += 1 + return (1, 1), 0.3 + + +class FakeAuto: + def __init__(self): + self.shots = 0 + + def take_screenshot(self, gray=True): + self.shots += 1 + return object() + + +class ProgressWatchdogTest(unittest.TestCase): + + def setUp(self): + self.now = [0.0] + self.lines = [] + self.auto = FakeAuto() + self.utils = type('ImageUtils', (), {'match_template': FakeImageUtils.__dict__['match_template']}) + + def install(self, env=None): + image_module = types.ModuleType('utils.image_utils') + image_module.ImageUtils = self.utils + modules = {'utils': types.ModuleType('utils'), 'utils.image_utils': image_module, + 'module': types.ModuleType('module'), 'module.automation': SimpleNamespace(auto=self.auto)} + with mock.patch.dict(sys.modules, modules): + handler = ap.install_progress_watchdog(log=self.lines.append, env=env or {}, clock=lambda: self.now[0]) + if handler is not None: + self.addCleanup(AALC_LOG.removeHandler, handler) + return handler + + def frame(self, minutes): + """主线程过了 minutes 分钟后识一次图。""" + self.now[0] += minutes * 60 + return self.utils.match_template(None, None, None) + + def milestone(self, text): + with mock.patch.object(AALC_LOG, 'level', logging.DEBUG), mock.patch.object(AALC_LOG, 'propagate', False): + AALC_LOG.info(text) + + def test_quiet_for_less_than_the_limit_is_fine(self): + self.assertIsNotNone(self.install()) + self.assertEqual(self.frame(39), ((1, 1), 0.3)) + self.assertIn('patch: 40 分钟没有「开始执行/结束执行」就结束任务', '\n'.join(self.lines)) + + def test_each_milestone_restarts_the_clock(self): + self.install() + for _ in range(5): # 5 场 30 分钟的战斗, 每场之间都有新日志 + self.frame(30) + self.milestone('结束执行 一次战斗') + self.frame(39) + self.assertNotIn('[ERROR]', '\n'.join(self.lines)) + + def test_no_progress_ends_the_task(self): + self.install() + self.milestone('开始执行 体力换饼') + with mock.patch.object(ap.decisions, 'record') as record: + with self.assertRaises(ap.TaskAbort) as caught: + self.frame(41) + self.assertIn('41 分钟没有进展(最后一条: 开始执行 体力换饼)', str(caught.exception)) + self.assertIn('[ERROR] [lc_mcp] 41 分钟没有新的「开始执行/结束执行」', '\n'.join(self.lines)) + record.assert_called_once_with('progress', None, 'stall', minutes=41, last='开始执行 体力换饼') + + def test_screenshot_loops_are_covered_too(self): + # while auto.take_screenshot() is None: continue —— 这种循环不识图 + self.install() + self.now[0] += 41 * 60 + with self.assertRaises(ap.TaskAbort), mock.patch.object(ap.decisions, 'record'): + self.auto.take_screenshot() + + def test_other_milestone_like_text_does_not_count(self): + self.install() + self.frame(30) + self.milestone('目标图片:home/drive_assets.png, 相似度:0.98') + with self.assertRaises(ap.TaskAbort), mock.patch.object(ap.decisions, 'record'): + self.frame(11) + + def test_duration_suffix_is_trimmed_from_the_last_milestone(self): + self.install() + self.milestone('结束执行 一次镜牢 耗时:01:15:46') + with self.assertRaises(ap.TaskAbort) as caught, mock.patch.object(ap.decisions, 'record'): + self.frame(45) + self.assertIn('最后一条: 结束执行 一次镜牢)', str(caught.exception)) + + def test_other_threads_never_abort(self): + self.install() + self.now[0] += 60 * 60 + errors = [] + + def monitor(): + try: + self.utils.match_template(None, None, None) + except BaseException as e: # noqa: B902 - 要看 TaskAbort 是否漏到这条线程 + errors.append(e) + + worker = threading.Thread(target=monitor) + worker.start() + worker.join() + self.assertEqual(errors, []) + + def test_env_sets_or_disables_the_limit(self): + self.install(env={ap.PROGRESS_STALL_ENV: '90'}) + self.frame(80) + with self.assertRaises(ap.TaskAbort), mock.patch.object(ap.decisions, 'record'): + self.frame(11) + + def test_env_zero_does_not_install(self): + self.assertIsNone(self.install(env={ap.PROGRESS_STALL_ENV: '0'})) + self.assertEqual(self.frame(600), ((1, 1), 0.3)) + + def test_bad_env_falls_back_to_default(self): + self.install(env={ap.PROGRESS_STALL_ENV: 'abc'}) + self.assertIn('不是数字, 按默认 40 分钟', '\n'.join(self.lines)) + self.frame(39) + + +if __name__ == '__main__': + unittest.main()