| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768 |
- from __future__ import annotations
- """页面动作与 hook 动作的组合器。"""
- from dataclasses import dataclass
- from tasks.GameUi.common import ActionLike, RecognizerLike
- from tasks.GameUi.matcher import Matcher, ensure_matcher
- @dataclass(frozen=True)
- class ActionSequence:
- """顺序执行的一组动作。
- Attributes:
- actions: 按顺序执行的动作集合。
- success_index: 使用哪个动作的执行结果作为整个序列的成功判定。
- """
- actions: tuple[ActionLike, ...]
- success_index: int = 0
- @dataclass(frozen=True)
- class ConditionalAction:
- """带前置条件的动作包装器。
- Attributes:
- condition: 需要先命中的识别条件。
- action: 条件满足后执行的动作。
- """
- condition: Matcher
- action: ActionLike
- def sequence(*actions: ActionLike, success_index: int = 0) -> ActionSequence:
- """创建一个顺序动作序列。
- Args:
- *actions: 需要顺序执行的动作。
- success_index: 作为整体成功判定的动作索引。
- Returns:
- `ActionSequence` 实例。
- """
- return ActionSequence(tuple(actions), success_index=success_index)
- def conditional_action(condition: RecognizerLike | Matcher, action: ActionLike) -> ConditionalAction:
- """创建带条件的动作。
- Args:
- condition: 前置识别条件。
- action: 条件满足后执行的动作。
- Returns:
- `ConditionalAction` 实例。
- Raises:
- ValueError: 当条件为空时抛出。
- """
- matcher = ensure_matcher(condition)
- if matcher is None:
- raise ValueError("conditional_action requires a valid condition")
- return ConditionalAction(matcher, action)
|