matcher.py 4.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180
  1. from __future__ import annotations
  2. """页面识别条件组合器。"""
  3. from dataclasses import dataclass
  4. from typing import Iterable, Union
  5. from module.atom.gif import RuleGif
  6. from module.atom.image import RuleImage
  7. from module.atom.ocr import RuleOcr
  8. from tasks.GameUi.common import RecognizerLike, invoke_task_callable
  9. class Matcher:
  10. """页面识别条件的抽象基类。"""
  11. def evaluate(self, task) -> bool:
  12. """执行一次识别判断。
  13. Args:
  14. task: 当前运行时任务对象。
  15. Returns:
  16. 识别是否成功。
  17. """
  18. raise NotImplementedError
  19. @dataclass(frozen=True)
  20. class AtomMatcher(Matcher):
  21. """最小识别单元。
  22. Attributes:
  23. target: 单个识别目标,可以是 Rule 元对象或自定义函数。
  24. """
  25. target: RecognizerLike
  26. def evaluate(self, task) -> bool:
  27. """执行单个识别目标的判断。"""
  28. target = self.target
  29. if callable(target) and not isinstance(target, (RuleImage, RuleGif, RuleOcr)):
  30. return bool(invoke_task_callable(target, task))
  31. if isinstance(target, RuleOcr):
  32. return bool(task.ocr_appear(target))
  33. if isinstance(target, (RuleImage, RuleGif)):
  34. return bool(task.appear(target))
  35. return False
  36. @dataclass(frozen=True)
  37. class AnyMatcher(Matcher):
  38. """任一子条件命中即成功。"""
  39. children: tuple[Matcher, ...]
  40. def evaluate(self, task) -> bool:
  41. """按“或”语义执行识别。"""
  42. return any(child.evaluate(task) for child in self.children)
  43. @dataclass(frozen=True)
  44. class AllMatcher(Matcher):
  45. """所有子条件都命中才成功。"""
  46. children: tuple[Matcher, ...]
  47. def evaluate(self, task) -> bool:
  48. """按“且”语义执行识别。"""
  49. return all(child.evaluate(task) for child in self.children)
  50. @dataclass(frozen=True)
  51. class NotMatcher(Matcher):
  52. """对子条件结果取反。"""
  53. child: Matcher
  54. def evaluate(self, task) -> bool:
  55. """执行取反识别。"""
  56. return not self.child.evaluate(task)
  57. def ensure_matcher(target: Union[Matcher | RecognizerLike | Iterable[RecognizerLike] | None]) -> Matcher | None:
  58. """将任意识别输入规范化为 `Matcher`。
  59. Args:
  60. target: 原始识别定义,可以是 `Matcher`、Rule 元对象、可调用对象或可迭代集合。
  61. Returns:
  62. 规范化后的 `Matcher`;传入 `None` 时返回 `None`。
  63. """
  64. if target is None:
  65. return None
  66. if isinstance(target, Matcher):
  67. return target
  68. if isinstance(target, (list, tuple, set)):
  69. return AnyMatcher(tuple(ensure_matcher(item) for item in target if item is not None))
  70. return AtomMatcher(target)
  71. def any_of(*targets: RecognizerLike | Matcher) -> Matcher:
  72. """创建“任一命中即可”的组合识别条件。
  73. Args:
  74. *targets: 需要参与组合的识别条件。
  75. Returns:
  76. `AnyMatcher` 实例。
  77. """
  78. return AnyMatcher(tuple(ensure_matcher(target) for target in targets if target is not None))
  79. def all_of(*targets: RecognizerLike | Matcher) -> Matcher:
  80. """创建“全部命中才成功”的组合识别条件。
  81. Args:
  82. *targets: 需要参与组合的识别条件。
  83. Returns:
  84. `AllMatcher` 实例。
  85. """
  86. return AllMatcher(tuple(ensure_matcher(target) for target in targets if target is not None))
  87. def not_(target: RecognizerLike | Matcher) -> Matcher:
  88. """创建取反识别条件。
  89. Args:
  90. target: 需要取反的识别条件。
  91. Returns:
  92. `NotMatcher` 实例。
  93. """
  94. return NotMatcher(ensure_matcher(target))
  95. def collect_rule_images(target: Union[Matcher | RecognizerLike | Iterable[RecognizerLike] | None]) -> tuple[RuleImage, ...]:
  96. """提取 matcher 树中可批量预取的 `RuleImage` 原子节点。"""
  97. images: list[RuleImage] = []
  98. seen = set()
  99. def visit(node):
  100. if node is None:
  101. return
  102. if isinstance(node, RuleImage):
  103. cache_key = id(node)
  104. if cache_key in seen:
  105. return
  106. seen.add(cache_key)
  107. images.append(node)
  108. return
  109. if isinstance(node, AtomMatcher):
  110. visit(node.target)
  111. return
  112. if isinstance(node, (AnyMatcher, AllMatcher)):
  113. for child in node.children:
  114. visit(child)
  115. return
  116. if isinstance(node, NotMatcher):
  117. visit(node.child)
  118. return
  119. if isinstance(node, Matcher):
  120. return
  121. if isinstance(node, (list, tuple, set)):
  122. for item in node:
  123. visit(item)
  124. visit(target)
  125. return tuple(images)