| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896 |
- from __future__ import annotations
- import random
- from module.base.decorator import run_once
- from tasks.Exploration.assets import ExplorationAssets
- from tasks.GlobalGame.assets import GlobalGameAssets
- """GameUi 导航运行时。"""
- import heapq
- import inspect
- import time
- from pathlib import Path
- from time import sleep
- from module.atom.click import RuleClick
- from module.atom.gif import RuleGif
- from module.atom.image import RuleImage
- from module.atom.list import RuleList
- from module.atom.ocr import RuleOcr
- from module.base.timer import Timer
- from module.exception import GamePageUnknownError, GameNotRunningError
- from module.logger import logger
- from tasks.ActivityShikigami.assets import ActivityShikigamiAssets
- from tasks.GameUi.action import ActionSequence, ConditionalAction
- from tasks.GameUi.assets import GameUiAssets
- from tasks.GameUi.common import infer_tasks_category_from_parts, infer_tasks_category_from_path
- from tasks.GameUi.matcher import collect_rule_images
- from tasks.GameUi.page_definition import Page, Transition, sort_pages_by_priority
- from tasks.GameUi.registry import PageRegistry
- from tasks.GameUi.session import NavigatorSession
- from tasks.SixRealms.assets import SixRealmsAssets
- from tasks.base_task import BaseTask
- class GameUi(BaseTask, GameUiAssets):
- """页面识别、导航与未知页恢复的统一入口。"""
- REPEATED_TRANSITION_FAILURE_THRESHOLD = 3
- # 全局未知页关闭动作,所有任务共享。
- DEFAULT_UNKNOWN_CLOSERS = [
- GlobalGameAssets.I_UI_BACK_RED,
- GlobalGameAssets.I_CHAT_CLOSE_BUTTON,
- ActivityShikigamiAssets.I_SKIP_BUTTON,
- GlobalGameAssets.I_UI_CONFIRM_SAMLL,
- GlobalGameAssets.I_UI_CONFIRM,
- ExplorationAssets.I_E_EXIT_CONFIRM,
- GameUiAssets.I_BACK_DAILY,
- GlobalGameAssets.I_UI_BACK_YELLOW,
- SixRealmsAssets.I_EXIT_SIXREALMS,
- GlobalGameAssets.I_UI_BACK_BLUE,
- GlobalGameAssets.I_UI_BACK_CIRCLE,
- ]
- def __init__(self, config, device):
- """初始化 GameUi 运行时。
- Args:
- config: 当前任务配置对象。
- device: 当前设备对象。
- """
- super().__init__(config, device)
- PageRegistry.load_all_pages()
- # 当前任务的导航 session,持有页面快照和运行期状态。
- self.navigator = NavigatorSession(task_category=self._infer_task_category())
- self.navigator.bootstrap(PageRegistry.all())
- def _infer_task_category(self) -> str:
- """根据当前任务模块路径推断任务分类。
- Returns:
- 当前任务所属分类名。
- """
- module_parts = self.__class__.__module__.split(".")
- if "tasks" in module_parts:
- return infer_tasks_category_from_parts(
- module_parts,
- module_parts.index("tasks"),
- component_use_child=True,
- )
- # 调度器通过固定模块名 `script_task` 动态加载任务时,__module__ 无法反映真实路径,
- # 因此这里回退到类定义文件路径推断任务分类。
- try:
- class_file = Path(inspect.getfile(self.__class__)).resolve()
- except (TypeError, OSError):
- return "global"
- return infer_tasks_category_from_path(class_file, component_use_child=True)
- def _default_detect_categories(self) -> set[str]:
- """获取普通当前页识别时允许扫描的分类集合。"""
- return {"global", self.navigator.task_category}
- def _navigation_detect_categories(self, destination: Page) -> set[str]:
- """获取导航时用于识别当前页的分类集合。
- Args:
- destination: 目标页面。
- Returns:
- 当前导航允许识别的页面分类集合。
- """
- return {"global", self.navigator.task_category, destination.category}
- def _navigation_graph_categories(self, destination: Page, current: Page | None) -> set[str]:
- """获取导航时允许参与建图的分类集合。
- Args:
- destination: 目标页面。
- current: 当前页面。
- Returns:
- 当前导航允许参与路径规划的页面分类集合。
- """
- categories = {"global", destination.category}
- if current is not None:
- categories.add(current.category)
- return categories
- def _invoke_callable(self, target):
- """调用用户自定义动作函数。
- Args:
- target: 自定义可调用对象。
- Returns:
- 调用结果。
- """
- try:
- signature = inspect.signature(target)
- except (TypeError, ValueError):
- return target(self)
- if len(signature.parameters) == 0:
- return target()
- return target(self)
- def match_page_once(self, page: Page) -> bool:
- """执行一次页面识别。
- Args:
- page: 待识别页面。
- Returns:
- 单次识别是否成功。
- """
- if page.recognizer is None:
- return False
- return bool(page.recognizer.evaluate(self))
- def confirm_page(self, page: Page, skip_first_screenshot: bool = True) -> bool:
- """使用两帧稳定判定确认页面。
- Args:
- page: 待确认页面。
- skip_first_screenshot: 是否复用当前截图。
- Returns:
- 两帧连续识别是否成功。
- """
- self.maybe_screenshot(skip_first_screenshot)
- if not self.match_page_once(page):
- return False
- self.screenshot()
- return self.match_page_once(page)
- def _detect_current_page(
- self,
- *,
- skip_first_screenshot: bool = True,
- categories: set[str] = None,
- ) -> Page | None:
- """在给定分类集合内识别当前页面。
- Args:
- skip_first_screenshot: 是否复用当前截图。
- categories: 允许参与识别的页面分类集合。
- Returns:
- 稳定识别到的当前页面;识别失败时返回 `None`。
- """
- pages = self.navigator.all_pages(categories)
- return GameUi._detect_pages(self, pages, skip_first_screenshot=skip_first_screenshot)
- def _detect_current_page_with_fallback(
- self,
- *,
- skip_first_screenshot: bool = True,
- categories: set[str] = None,
- context: str = "current_page",
- ) -> Page | None:
- """先按作用域识别当前页面,失败后再回退到 session 全量页面。
- Args:
- skip_first_screenshot: 是否复用当前截图。
- categories: 第一轮识别允许参与的页面分类集合。
- context: 当前识别调用场景,用于日志输出。
- Returns:
- 稳定识别到的当前页面;两轮识别都失败时返回 `None`。
- """
- page = self._detect_current_page(
- skip_first_screenshot=skip_first_screenshot,
- categories=categories,
- )
- if page is not None or not categories:
- return page
- sorted_categories = sorted(categories)
- page = GameUi._detect_pages(
- self,
- self.navigator.all_pages(),
- skip_first_screenshot=True,
- )
- if page is not None:
- logger.attr("UI", page.name)
- return page
- logger.warning(f"Page detect miss[{context}]: scoped={sorted_categories}")
- return None
- def _detect_pages(
- self,
- pages: list[Page],
- *,
- skip_first_screenshot: bool = True,
- ) -> Page | None:
- """在给定页面集合内识别当前页面。"""
- if not pages:
- return None
- self.maybe_screenshot(skip_first_screenshot)
- GameUi._prepare_page_rule_image_cache(self, pages)
- indexed_candidates = [(index, page) for index, page in enumerate(pages) if self.match_page_once(page)]
- if not indexed_candidates:
- return None
- self.screenshot()
- GameUi._prepare_page_rule_image_cache(self, [page for _, page in indexed_candidates])
- for page in sort_pages_by_priority(indexed_candidates):
- if self.match_page_once(page):
- self.navigator.current_page = page
- logger.attr("UI", page.name)
- return page
- return None
- def _prepare_page_rule_image_cache(self, pages: list[Page]) -> None:
- targets = []
- seen = set()
- for page in pages:
- if page.recognizer is None:
- continue
- for target in collect_rule_images(page.recognizer):
- cache_key = id(target)
- if cache_key in seen:
- continue
- seen.add(cache_key)
- targets.append(target)
- if targets and hasattr(self, "prepare_appear_cache"):
- self.prepare_appear_cache(targets)
- @staticmethod
- def _action_name(action) -> str:
- """将动作对象转换为便于日志输出的名称。
- Args:
- action: 目标动作对象。
- Returns:
- 动作名称字符串。
- """
- if isinstance(action, (RuleImage, RuleGif, RuleOcr, RuleList, RuleClick)):
- return action.name
- if isinstance(action, ConditionalAction):
- return f"ConditionalAction({GameUi._action_name(action.action)})"
- if isinstance(action, ActionSequence):
- return f"ActionSequence[{len(action.actions)}]"
- if callable(action):
- return str(getattr(action, "__name__", action.__class__.__name__))
- return repr(action)
- def _execute_action(self, action, *, interval: float | None = None, skip_first_screenshot: bool = True) -> bool:
- """统一执行动作对象。
- Args:
- action: 待执行动作。
- interval: 点击间隔。
- skip_first_screenshot: 是否复用当前截图。
- Returns:
- 动作是否成功执行。
- """
- self.maybe_screenshot(skip_first_screenshot)
- if isinstance(action, ConditionalAction):
- if not action.condition.evaluate(self):
- return False
- return self._execute_action(action.action, interval=interval, skip_first_screenshot=False)
- if isinstance(action, ActionSequence):
- if not action.actions:
- return False
- results = [
- self._execute_action(item, interval=interval, skip_first_screenshot=(index == 0 and skip_first_screenshot))
- for index, item in enumerate(action.actions)
- ]
- if action.success_index < len(results):
- return results[action.success_index]
- return any(results)
- if isinstance(action, (list, tuple)):
- return self._execute_action(
- ActionSequence(tuple(action)),
- interval=interval,
- skip_first_screenshot=skip_first_screenshot,
- )
- if callable(action) and not isinstance(action, (RuleImage, RuleGif, RuleOcr, RuleList, RuleClick)):
- result = self._invoke_callable(action)
- if isinstance(result, bool):
- return result
- if result is None:
- return False
- return self._execute_action(result, interval=interval, skip_first_screenshot=False)
- if isinstance(action, RuleList):
- return self.list_appear_click(action, interval=interval or 0.8)
- if isinstance(action, (RuleImage, RuleGif)):
- return self.appear_then_click(action, interval=interval)
- if isinstance(action, RuleOcr):
- return self.ocr_appear_click(action, interval=interval)
- if isinstance(action, RuleClick):
- if interval is not None:
- return self.click(action, interval=interval)
- x, y = action.coord()
- self.device.click(x=x, y=y, control_name=action.name)
- return True
- return False
- def _run_hooks(self, hooks: list, *, interval: float = 0.6) -> None:
- """按顺序执行 hook 列表。
- Args:
- hooks: 待执行的 hook 列表。
- interval: hook 点击间隔。
- """
- for index, hook in enumerate(hooks):
- self._execute_action(hook, interval=interval, skip_first_screenshot=(index == 0))
- def _mark_page_entered(self, page: Page) -> None:
- """记录最近一次已触发进入成功 hook 的页面。
- Args:
- page: 当前已进入的页面。
- """
- self.navigator.last_enter_success_page_key = page.key
- def _run_enter_success_hooks_if_needed(self, page: Page) -> None:
- """仅在页面变化时触发进入成功 hook。
- Args:
- page: 当前页面。
- """
- if self.navigator.last_enter_success_page_key == page.key:
- return
- self._run_hooks(page.on_enter_success)
- self._mark_page_entered(page)
- def _allowed_pages_for_navigation(self, destination: Page, current: Page | None) -> dict[str, Page]:
- """构建本轮导航允许访问的页面集合。
- Args:
- destination: 目标页面。
- current: 当前页面。
- Returns:
- 以页面 key 为索引的允许页面字典。
- """
- categories = self._navigation_graph_categories(destination, current)
- categories.add(self.navigator.task_category)
- pages = {page.key: page for page in self.navigator.all_pages(categories)}
- if current is not None:
- pages[current.key] = current
- pages[destination.key] = destination
- return pages
- def _build_path(self, current: Page, destination: Page) -> list[Transition]:
- """在允许页面集合内构建最小代价路径。
- Args:
- current: 当前页面。
- destination: 目标页面。
- Returns:
- 最优路径的边列表;无法构建路径时返回 `None`。
- """
- if current == destination:
- return []
- allowed_pages = self._allowed_pages_for_navigation(destination, current)
- if destination.key not in allowed_pages:
- return None
- queue: list[tuple[float, int, str]] = [(0.0, 0, current.key)]
- best_cost: dict[str, float] = {current.key: 0.0}
- previous: dict[str, tuple[str, Transition]] = {}
- sequence = 0
- while queue:
- cost, _, page_key = heapq.heappop(queue)
- if cost > best_cost.get(page_key, float("inf")):
- continue
- if page_key == destination.key:
- break
- page = allowed_pages[page_key]
- for transition in page.transitions:
- next_page = transition.destination
- if next_page.key not in allowed_pages:
- continue
- next_cost = cost + next_page.cost + transition.cost + self.navigator.penalty_of(transition)
- if next_cost >= best_cost.get(next_page.key, float("inf")):
- continue
- best_cost[next_page.key] = next_cost
- previous[next_page.key] = (page_key, transition)
- sequence += 1
- heapq.heappush(queue, (next_cost, sequence, next_page.key))
- if destination.key not in previous:
- return None
- path: list[Transition] = []
- node_key = destination.key
- while node_key != current.key:
- prev_key, transition = previous[node_key]
- path.append(transition)
- node_key = prev_key
- path.reverse()
- return path
- def _refresh_current_page(self, destination: Page, skip_first_screenshot: bool) -> Page | None:
- """优先确认缓存当前页,失败后再执行作用域识别与全量兜底。
- Args:
- destination: 当前导航目标页面。
- skip_first_screenshot: 是否复用当前截图。
- Returns:
- 当前稳定页面;无法识别时返回 `None`。
- """
- current = self.navigator.current_page
- if current is not None and self.confirm_page(current, skip_first_screenshot=skip_first_screenshot):
- return current
- return self._detect_current_page_with_fallback(
- skip_first_screenshot=skip_first_screenshot,
- categories=self._navigation_detect_categories(destination),
- context="goto_page",
- )
- def _wait_for_destination(self, destination: Page, timeout: float = 4.0) -> bool:
- """等待下一页面稳定出现。
- Args:
- destination: 目标页面。
- timeout: 等待超时时间。
- Returns:
- 是否在超时前稳定识别到目标页面。
- """
- timer = Timer(timeout).start()
- while not timer.reached():
- if self.confirm_page(destination, skip_first_screenshot=False):
- self.navigator.current_page = destination
- return True
- return False
- def _execute_transition(self, transition: Transition) -> bool:
- """执行一条导航边。
- Args:
- transition: 待执行的页面边。
- Returns:
- 是否成功到达边的终点页面。
- """
- source = transition.source
- destination = transition.destination
- logger.info(f"Page switch: {source} -> {destination}")
- action_timer = Timer(6.0).start()
- action_done = False
- while not action_timer.reached():
- if self._execute_action(transition.action, interval=0.8, skip_first_screenshot=False):
- action_done = True
- break
- # 町中入口图标可能因动画或皮肤变化无法通过模板识别。只有在
- # 重新确认当前页仍为 town,且目标动作具有固定图标区域时,
- # 才机械点击一次 roi_front 中心作为保底。
- if (
- not action_done
- and source.key == "page_town"
- and isinstance(transition.action, (RuleImage, RuleGif))
- and self.confirm_page(source, skip_first_screenshot=False)
- ):
- x, y, width, height = transition.action.roi_front
- click_x = x + width // 2
- click_y = y + height // 2
- logger.warning(
- "Town target was not recognized; use one fixed-position "
- f"fallback click: action={self._action_name(transition.action)}, "
- f"position=({click_x}, {click_y})"
- )
- self.device.click(
- x=click_x,
- y=click_y,
- control_name=(
- f"TOWN_FALLBACK_{self._action_name(transition.action)}"
- ),
- )
- action_done = True
- if not action_done:
- self._run_hooks(source.on_leave_failure)
- self._run_hooks(transition.on_leave_failure)
- self._run_hooks(destination.on_enter_failure)
- self._run_hooks(transition.on_enter_failure)
- penalty = self.navigator.add_penalty(transition)
- logger.warning(f"Transition failed before leaving {source}: {transition.key}, penalty={penalty:.1f}")
- self.navigator.current_page = self._detect_current_page_with_fallback(
- skip_first_screenshot=False,
- categories=self._navigation_detect_categories(destination),
- )
- return False
- if self._wait_for_destination(destination):
- self._run_hooks(source.on_leave_success)
- self._run_hooks(transition.on_leave_success)
- self._run_hooks(destination.on_enter_success)
- self._run_hooks(transition.on_enter_success)
- self._mark_page_entered(destination)
- logger.info(f"Page arrived {destination}")
- return True
- self._run_hooks(source.on_leave_failure)
- self._run_hooks(transition.on_leave_failure)
- self._run_hooks(destination.on_enter_failure)
- self._run_hooks(transition.on_enter_failure)
- penalty = self.navigator.add_penalty(transition)
- logger.warning(f"Transition cannot reach {destination}: {transition.key}, penalty={penalty:.1f}")
- self.navigator.current_page = self._detect_current_page_with_fallback(
- skip_first_screenshot=False,
- categories=self._navigation_detect_categories(destination),
- )
- return False
- def _collect_page_check_results(self, destination: Page) -> list[str]:
- """收集当前截图下所有命中的页面名称。
- Args:
- destination: 当前导航目标页面。
- Returns:
- 当前截图命中的页面名称列表。
- """
- pages = self.navigator.all_pages(self._navigation_detect_categories(destination))
- self.screenshot()
- return [page.name for page in pages if self.match_page_once(page)]
- def _record_unknown_close_event(self, message: str) -> None:
- """记录未知页关闭历史。
- Args:
- message: 本次关闭尝试的结果描述。
- """
- self.navigator.unknown_close_history.append(message)
- self.navigator.unknown_close_history = self.navigator.unknown_close_history[-10:]
- def _log_navigation_timeout(
- self,
- destination: Page,
- last_path_signature: tuple[str, str] | None = None,
- repeated_failure_transition_key: str | None = None,
- repeated_failure_count: int = 0,
- last_repeated_failure_close_result: str | None = None,
- ) -> None:
- """输出导航超时诊断日志。
- Args:
- destination: 当前导航目标页面。
- last_path_signature: 最近一次成功构建的路径签名。
- repeated_failure_transition_key: 最近一次连续失败的边 key。
- repeated_failure_count: 当前连续失败次数。
- last_repeated_failure_close_result: 最近一次“三连失败后主动关闭”的结果摘要。
- """
- current = self.navigator.current_page.name if self.navigator.current_page else "None"
- allowed_categories = sorted(self._navigation_graph_categories(destination, self.navigator.current_page))
- penalties = {
- key: value
- for key, value in sorted(self.navigator.edge_penalties.items(), key=lambda item: item[0])
- if value > 0
- }
- check_results = self._collect_page_check_results(destination)
- logger.warning("Unknown ui page or navigation stalled")
- logger.warning(f"Current page: {current}")
- logger.warning(f"Target page: {destination.name}")
- logger.warning(f"Allowed categories: {allowed_categories}")
- logger.warning(f"Current task category: {self.navigator.task_category}")
- logger.warning(f"Current page checks: {check_results}")
- logger.warning(f"Last path signature: {last_path_signature}")
- logger.warning(
- "Repeated transition failure: "
- f"key={repeated_failure_transition_key}, count={repeated_failure_count}"
- )
- logger.warning(f"Last repeated-failure close result: {last_repeated_failure_close_result}")
- logger.warning(f"Edge penalties: {penalties}")
- logger.warning(f"Unknown close history: {self.navigator.unknown_close_history}")
- raise GamePageUnknownError(f"Cannot goto page[{destination}]")
- def get_current_page(self, skip_first_screenshot: bool = True, fallback: bool = False) -> Page | None:
- """获取当前稳定页面。
- Args:
- skip_first_screenshot: 是否复用当前截图。
- fallback: 是否回退至识别全部注册页面
- Returns:
- 当前稳定识别到的页面;识别失败时返回 `None`。
- """
- if not fallback:
- return self._detect_current_page(
- skip_first_screenshot=skip_first_screenshot,
- categories=self._default_detect_categories()
- )
- return self._detect_current_page_with_fallback(
- skip_first_screenshot=skip_first_screenshot,
- categories=self._default_detect_categories(),
- context="get_current_page",
- )
- def pages_in_category(self, category: str) -> list[Page]:
- """读取当前 session 中指定分类下的所有页面副本。"""
- return self.navigator.all_pages({category})
- def detect_page_in(self, *targets: str | Page, include_global: bool = True) -> Page | None:
- """在指定分类或显式页面集合内识别当前页面。"""
- category_set = {target for target in targets if isinstance(target, str)}
- explicit_pages: list[Page] = []
- for target in targets:
- if not isinstance(target, Page):
- continue
- page = self.navigator.resolve_page(target)
- if page is None:
- continue
- explicit_pages.append(page)
- pages: list[Page] = []
- if category_set:
- if include_global:
- category_set.add("global")
- pages.extend(self.navigator.all_pages(category_set))
- elif not explicit_pages and include_global:
- pages.extend(self.navigator.all_pages({"global"}))
- if explicit_pages:
- existed = {page.key for page in pages}
- for page in explicit_pages:
- if page.key in existed:
- continue
- pages.append(page)
- existed.add(page.key)
- return GameUi._detect_pages(self, pages, skip_first_screenshot=True)
- def close_unknown_pages(self, skip_first_screenshot: bool = True) -> bool:
- """尝试关闭未知页面。
- Args:
- skip_first_screenshot: 是否复用当前截图。
- Returns:
- 是否成功触发某个关闭动作。
- """
- self.maybe_screenshot(skip_first_screenshot)
- # 客户端掉回登录态(掉线/被顶号)时页面上的标志全部不可信,点关闭动作
- # 没有意义,交回 Restart 处理(登录流程会关掉弹窗)
- if self.device.app_lost_login():
- raise GameNotRunningError('Client dropped back to login')
- logger.warning("Try switch to a supported page")
- for action in [*self.navigator.local_unknown_closers, *self.DEFAULT_UNKNOWN_CLOSERS]:
- action_name = self._action_name(action)
- # 若最后3次执行的都是该动作,则跳过该动作尝试其他动作
- if len(self.navigator.unknown_close_history) >= 3 and \
- self.navigator.unknown_close_history[-3:] == [action_name] * 3:
- continue
- if self._execute_action(action, interval=1.5, skip_first_screenshot=False):
- self._record_unknown_close_event(f"{action_name}")
- # 关掉未知界面后等待页面变化, 防止多次识别到未知界面
- time.sleep(random.randrange(8, 16, 1) / 10)
- return True
- self._record_unknown_close_event(f"None")
- @run_once
- def app_check():
- if not self.device.app_is_running():
- raise GameNotRunningError("Game not running")
- @run_once
- def minicap_check():
- if self.config.script.device.control_method == "uiautomator2":
- self.device.uninstall_minicap()
- @run_once
- def rotation_check():
- self.device.get_orientation()
- app_check()
- minicap_check()
- rotation_check()
- return False
- def _finalize_arrival(self, destination: Page, confirm_wait: float, start_time: float) -> bool:
- """统一处理到达目标页后的收尾动作。
- 到达判定已由调用方完成(跳转边到达等待的两帧确认,或当前页刷新返回的两帧确认结果),
- 本方法不再重复确认,只负责收尾:刷新当前页缓存、幂等触发进入成功钩子、按需等待、输出到达日志。
- Args:
- destination: 已确认到达的目标页面。
- confirm_wait: 到达后额外等待的确认时间。
- start_time: 本次导航开始时间戳,用于输出耗时。
- Returns:
- 固定返回 True,表示已到达目标页面。
- """
- self.navigator.current_page = destination
- self._run_enter_success_hooks_if_needed(destination)
- if confirm_wait > 0:
- Timer(confirm_wait, count=int(confirm_wait // 0.5)).start().wait()
- logger.attr(f'{time.time() - start_time:.1f}s', f"Page arrived {destination}")
- return True
- def goto_page(self, destination: Page, confirm_wait: float = 0, skip_first_screenshot: bool = True,
- timeout: int = 30, *, accepted_pages: tuple[Page, ...] = ()) -> bool | None:
- """导航到目标页面。
- Args:
- destination: 目标页面。
- confirm_wait: 到达目标页面后额外等待的确认时间。
- skip_first_screenshot: 是否复用当前截图。
- timeout: 无有效进展超时时间,单位秒。
- accepted_pages: 可直接继续任务的其他页面,识别到后无需转往目标页。
- Returns:
- 是否成功到达目标页面。
- Raises:
- GamePageUnknownError: 无法恢复到可导航状态或无法推进到目标页面时抛出。
- """
- destination = self.navigator.resolve_page(destination) or self.navigator.add_page(destination)
- logger.hr(f"UI goto {destination}")
- start_time = time.time()
- progress_timer = Timer(timeout).start()
- last_progress_signature: tuple[str, str] | None = None
- last_detected_page_key: str | None = None
- repeated_failure_transition_key: str | None = None
- repeated_failure_count = 0
- last_repeated_failure_close_result: str | None = None
- def reset_repeated_transition_failures() -> None:
- nonlocal repeated_failure_transition_key, repeated_failure_count
- repeated_failure_transition_key = None
- repeated_failure_count = 0
- while True:
- current = self._refresh_current_page(destination, skip_first_screenshot)
- skip_first_screenshot = False
- if current is None:
- if self.close_unknown_pages(skip_first_screenshot=False):
- progress_timer.reset()
- last_progress_signature = ("close_unknown", destination.key)
- last_detected_page_key = None
- reset_repeated_transition_failures()
- elif progress_timer.reached():
- self._log_navigation_timeout(
- destination,
- last_path_signature=last_progress_signature,
- repeated_failure_transition_key=repeated_failure_transition_key,
- repeated_failure_count=repeated_failure_count,
- last_repeated_failure_close_result=last_repeated_failure_close_result,
- )
- raise GamePageUnknownError(f"Cannot goto page[{destination}]")
- continue
- if current.key != last_detected_page_key:
- self._run_enter_success_hooks_if_needed(current)
- progress_timer.reset()
- last_detected_page_key = current.key
- reset_repeated_transition_failures()
- if current == destination or any(current.key == page.key for page in accepted_pages):
- # current 来自 _refresh_current_page,其返回已是两帧稳定确认的结果,无需再次 confirm。
- return self._finalize_arrival(current, confirm_wait, start_time)
- path = self._build_path(current, destination)
- if not path:
- if self.close_unknown_pages(skip_first_screenshot=False):
- progress_timer.reset()
- last_progress_signature = ("close_unknown", current.key)
- reset_repeated_transition_failures()
- continue
- if progress_timer.reached():
- self._log_navigation_timeout(
- destination,
- last_path_signature=last_progress_signature,
- repeated_failure_transition_key=repeated_failure_transition_key,
- repeated_failure_count=repeated_failure_count,
- last_repeated_failure_close_result=last_repeated_failure_close_result,
- )
- continue
- path_signature = (current.key, " -> ".join(transition.key for transition in path))
- # Failed edges can alternate the cheapest route without leaving this
- # page. Replanning alone must not extend the no-progress deadline.
- last_progress_signature = path_signature
- logger.info(f"Current page: {current}. Following path:")
- logger.info(" -> ".join([current.name, *[transition.destination.name for transition in path]]))
- advanced = True
- for transition in path:
- if not self._execute_transition(transition):
- advanced = False
- if repeated_failure_transition_key == transition.key:
- repeated_failure_count += 1
- else:
- repeated_failure_transition_key = transition.key
- repeated_failure_count = 1
- if repeated_failure_count % self.REPEATED_TRANSITION_FAILURE_THRESHOLD == 0:
- close_success = self.close_unknown_pages(skip_first_screenshot=False)
- logger.warning(f"Transition {transition.key} repeated failure close result: {close_success}")
- if close_success:
- progress_timer.reset()
- last_progress_signature = ("close_unknown_after_repeated_failure", transition.key)
- reset_repeated_transition_failures()
- break
- progress_timer.reset()
- last_detected_page_key = transition.destination.key
- last_repeated_failure_close_result = None
- reset_repeated_transition_failures()
- if advanced and self.navigator.current_page == destination:
- # _execute_transition 的到达等待已对目标页完成两帧确认,直接收尾返回,避免回环重复确认。
- return self._finalize_arrival(destination, confirm_wait, start_time)
- if progress_timer.reached():
- self._log_navigation_timeout(
- destination,
- last_path_signature=last_progress_signature,
- repeated_failure_transition_key=repeated_failure_transition_key,
- repeated_failure_count=repeated_failure_count,
- last_repeated_failure_close_result=last_repeated_failure_close_result,
- )
- raise GamePageUnknownError(f"Cannot goto page[{destination}]")
|