action.py 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768
  1. from __future__ import annotations
  2. """页面动作与 hook 动作的组合器。"""
  3. from dataclasses import dataclass
  4. from tasks.GameUi.common import ActionLike, RecognizerLike
  5. from tasks.GameUi.matcher import Matcher, ensure_matcher
  6. @dataclass(frozen=True)
  7. class ActionSequence:
  8. """顺序执行的一组动作。
  9. Attributes:
  10. actions: 按顺序执行的动作集合。
  11. success_index: 使用哪个动作的执行结果作为整个序列的成功判定。
  12. """
  13. actions: tuple[ActionLike, ...]
  14. success_index: int = 0
  15. @dataclass(frozen=True)
  16. class ConditionalAction:
  17. """带前置条件的动作包装器。
  18. Attributes:
  19. condition: 需要先命中的识别条件。
  20. action: 条件满足后执行的动作。
  21. """
  22. condition: Matcher
  23. action: ActionLike
  24. def sequence(*actions: ActionLike, success_index: int = 0) -> ActionSequence:
  25. """创建一个顺序动作序列。
  26. Args:
  27. *actions: 需要顺序执行的动作。
  28. success_index: 作为整体成功判定的动作索引。
  29. Returns:
  30. `ActionSequence` 实例。
  31. """
  32. return ActionSequence(tuple(actions), success_index=success_index)
  33. def conditional_action(condition: RecognizerLike | Matcher, action: ActionLike) -> ConditionalAction:
  34. """创建带条件的动作。
  35. Args:
  36. condition: 前置识别条件。
  37. action: 条件满足后执行的动作。
  38. Returns:
  39. `ConditionalAction` 实例。
  40. Raises:
  41. ValueError: 当条件为空时抛出。
  42. """
  43. matcher = ensure_matcher(condition)
  44. if matcher is None:
  45. raise ValueError("conditional_action requires a valid condition")
  46. return ConditionalAction(matcher, action)