battle_wait.py 41 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930
  1. """
  2. ╔══════════════════════════════════════════════════════════════════════════════════╗
  3. ║ battle_wait.py 调用链地图 ║
  4. ╚══════════════════════════════════════════════════════════════════════════════════╝
  5. 装饰器双层栈(任务级)
  6. ───────────────────────────────────────────────────────────────────
  7. @battle_wait_options(excludes=[...]) ← 覆盖 options
  8. @battle_wait_strategy(success='activity') ← 覆盖 plan
  9. ↓
  10. script_task.battle_wait()
  11. ↓
  12. ┌─────────────────────────────────────────────────────────┐
  13. │ battle_wait_options.__call__.inner │
  14. │ options → pub.options │
  15. │ finally: 还原 class options │
  16. └───────────────────────────┬─────────────────────────────┘
  17. ↓
  18. ┌─────────────────────────────────────────────────────────┐
  19. │ battle_wait_strategy.__call__.inner │
  20. │ current_plan = deepcopy(类 plan).override(kwargs) │
  21. │ runtime.reset_per_battle() ← 每场新状态 │
  22. │ runtime.update_options() ← 按事件切片到各 pri │
  23. └───────────────────────────┬─────────────────────────────┘
  24. ↓
  25. ┌─────────────────────────────────────────────────────────┐
  26. │ battle_wait_with_strategy(plan) │
  27. │ │
  28. │ setup hook ──────────────────────── run 一次 │
  29. │ hook_enabled = sequence events − {completion} │
  30. │ │
  31. │ ┌─── while True ─────────────────────────────────┐ │
  32. │ │ screenshot() │ │
  33. │ │ for handler in sequence顺序: │ │
  34. │ │ if event not in hook_enabled: skip │ │
  35. │ │ result = handler() ──┐ │ │
  36. │ │ ↓ │ │ │
  37. │ │ DONE ────────────────┤ 结束循环 │ │
  38. │ │ CONTINUE ──→ 下一个 handler │ │
  39. │ │ │ │
  40. │ │ success/failure 结算后: │ │
  41. │ │ per_battle['success'] = BattleResult.X │ │
  42. │ │ enable=('completion',) ← completion 开门 │ │
  43. │ └───────────────────────────────────────────────────┘ │
  44. │ │
  45. │ return per_battle['success'] == BattleResult.SUCCESS │
  46. └─────────────────────────────────────────────────────────┘
  47. ┌──────────────────── Hook 调用 ────────────────────────────┐
  48. │ BattleWait.__new__ 遍历 MRO, _bw_* → runtime 包装 │
  49. │ handler() │
  50. │ → runtime.__call__(owner) │
  51. │ → func(owner, pub=pub_ctx, pri=pri_ctx[hook_name]) │
  52. └───────────────────────────────────────────────────────────────┘
  53. ┌──────────────────── 数据流 ─────────────────────────────────┐
  54. │ │
  55. │ battle_wait_options.options (类槽, 装饰器/with 写入) │
  56. │ ↓ pub.options = 上面整个 │
  57. │ ↓ pri[hook].options = 按事件名切片 │
  58. │ │
  59. │ pub (全局) pri (每个 hook 各一份) │
  60. │ ├─ cross ├─ cross │
  61. │ ├─ per_task ├─ per_task │
  62. │ ├─ per_battle ├─ per_battle │
  63. │ │ ├─ success │ │
  64. │ │ └─ hook_enabled │ │
  65. │ └─ options └─ options(本事件切片) │
  66. │ │
  67. │ 生命周期: │
  68. │ reset_per_task runtime 首次遇到新 task_owner │
  69. │ reset_per_battle 每次 battle_wait_strategy.__call__ │
  70. └─────────────────────────────────────────────────────────────┘
  71. """
  72. import random
  73. import time
  74. import copy
  75. from copy import deepcopy
  76. from functools import wraps, update_wrapper
  77. from dataclasses import dataclass, field
  78. from typing import TypeVar, ParamSpec, Callable
  79. from enum import Enum, auto
  80. from cached_property import cached_property
  81. from module.logger import logger
  82. from module.base.timer import Timer
  83. from module.atom.click import RuleClickExclude
  84. from tasks.base_task import BaseTask
  85. from tasks.Component.GeneralBattle.assets import GeneralBattleAssets
  86. P = ParamSpec('P')
  87. T = TypeVar('T')
  88. class HookSignal(Enum):
  89. CONTINUE = auto() # 无事发生
  90. BUSY = auto() # 处理了,继续
  91. DONE = auto() # 流程结束
  92. class BattleResult(Enum):
  93. SUCCESS = auto()
  94. FAILURE = auto()
  95. # ─── 默认值常量 ───────────────────────────────────
  96. # 战斗 hook 事件列表 & 默认调用顺序
  97. _HOOKS_DEFAULT: tuple[str, ...] = (
  98. 'setup', 'completion', 'interrupt', 'success', 'failure', 'idle',
  99. )
  100. _SEQUENCE_DEFAULT: str = 'completion > interrupt > success > failure >'
  101. # hook options 默认值(装饰器 @battle_wait_options / with 上下文写入类槽)
  102. _DEFAULT_OPTIONS: dict[str, dict] = {
  103. 'success': {
  104. 'reward_exclude_click_1': [
  105. 'C_END_MESSAGE_RIGHT_TOP', 'C_END_BUFF_AREA_1',
  106. 'C_END_BUFF_AREA_2', 'C_END_SOUL_RECORD', 'C_END_SOUL_DETAILS',
  107. ],
  108. 'reward_exclude_click_2': [
  109. 'C_END_MESSAGE_RIGHT_TOP', 'C_END_BUFF_AREA_1',
  110. 'C_END_BUFF_AREA_2', 'C_END_SOUL_RECORD', 'C_END_SOUL_DETAILS',
  111. 'C_END_1_1', 'C_END_1_2', 'C_END_1_3', 'C_END_1_4',
  112. 'C_END_1_5', 'C_END_1_6',
  113. ],
  114. },
  115. }
  116. # 跨任务/跨战斗状态的初始
  117. @dataclass
  118. class PerTaskState:
  119. """跨任务状态, 单个任务全程共享, reset_per_task 时重建"""
  120. count: int = 0
  121. @dataclass
  122. class PerBattleState:
  123. """跨战斗状态, 每场战斗独立, reset_per_battle 时重建"""
  124. success: BattleResult = BattleResult.FAILURE
  125. hook_enabled: set = field(default_factory=lambda: set(_HOOKS_DEFAULT) - {'completion'})
  126. # ────────────────────────────────────────────
  127. class BattleWaitPlan:
  128. """
  129. 就是一个超级大的状态机,这里拆成了很多hook
  130. """
  131. HOOKS_DEFAULT = _HOOKS_DEFAULT
  132. SEQUENCE_DEFAULT = _SEQUENCE_DEFAULT
  133. def __init__(self, *arg, **kwargs):
  134. extra_sequence: str = ''
  135. #
  136. for event_strategy in arg:
  137. if not isinstance(event_strategy, str):
  138. raise TypeError(
  139. 'Battle wait hook must be a string in '
  140. '"event_strategy" format; '
  141. f'got {event_strategy!r}'
  142. )
  143. if not event_strategy:
  144. raise ValueError(
  145. 'Battle wait hook cannot be empty; '
  146. 'expected "event_strategy" format'
  147. )
  148. event, separator, strategy = event_strategy.partition('_')
  149. if not separator or not event or not strategy:
  150. raise ValueError(
  151. 'Invalid battle wait hook '
  152. f'{event_strategy!r}; expected "event_strategy" format'
  153. )
  154. setattr(self, event, strategy)
  155. if event not in self.HOOKS_DEFAULT:
  156. extra_sequence += f'{event} > '
  157. #
  158. for event, strategy in kwargs.items():
  159. if not event or not isinstance(event, str) or not isinstance(strategy, str):
  160. raise TypeError(f'{event} or {strategy} is not a string')
  161. if getattr(self, event, None) is not None:
  162. raise ValueError(
  163. f'Battle wait event {event!r} was configured more than once'
  164. )
  165. setattr(self, event, strategy)
  166. if event not in self.HOOKS_DEFAULT:
  167. extra_sequence += f'{event} > '
  168. # 补齐默认的
  169. for event in self.HOOKS_DEFAULT:
  170. if getattr(self, event, None) is None:
  171. setattr(self, event, 'default')
  172. #
  173. self.sequence = kwargs.get('sequence', None)
  174. if self.sequence is None:
  175. self.sequence = f'{BattleWaitPlan.SEQUENCE_DEFAULT} {extra_sequence} idle'
  176. if not isinstance(self.sequence, str):
  177. raise TypeError(
  178. 'Battle wait sequence must be a string containing event names '
  179. "separated by '>'; "
  180. f'got {self.sequence!r}'
  181. )
  182. self.sequence: str = self.sequence.replace(' ', '').replace('\n', '').replace('\r', '').replace('setup', '')
  183. for event_name in self.sequence.split('>'):
  184. event_name = event_name.strip()
  185. if event_name == "sequence":
  186. continue
  187. if getattr(self, event_name, None) is None:
  188. raise ValueError(
  189. f'Unknown battle wait event {event_name!r} in '
  190. f'sequence {self.sequence!r}'
  191. )
  192. for event in self.HOOKS_DEFAULT:
  193. if event != 'setup' and event not in self.sequence:
  194. raise ValueError(
  195. f'Battle wait sequence is missing required event {event!r}; '
  196. f'got {self.sequence!r}'
  197. )
  198. def __str__(self):
  199. lines = [f"{self.__class__.__name__}:", f" sequence: {self.sequence}", " hooks:"]
  200. for event_name in self.HOOKS_DEFAULT:
  201. strategy_name = getattr(self, event_name, None)
  202. if callable(strategy_name):
  203. if hasattr(strategy_name, '__name__'):
  204. func_name = strategy_name.__name__
  205. else:
  206. func_name = repr(strategy_name)
  207. val_str = f"<function {func_name}>"
  208. else:
  209. val_str = repr(strategy_name)
  210. lines.append(f" {event_name}: {val_str}")
  211. return "\n".join(lines)
  212. def __repr__(self):
  213. return self.__str__()
  214. @property
  215. def function_setup_name(self) -> str:
  216. if getattr(self, 'setup', None) is None:
  217. self.setup = 'default'
  218. return f'_bw_setup_{self.setup}'
  219. def sequence_function_names(self) -> list[str]:
  220. """
  221. 注意,这里是没有setup的
  222. """
  223. function_names = []
  224. for event_name in self.sequence.split('>'):
  225. event_name = event_name.strip()
  226. if not event_name:
  227. continue
  228. if not hasattr(self, event_name):
  229. raise ValueError(f'Unknown battle wait event: {event_name}')
  230. strategy_name = getattr(self, event_name)
  231. if not isinstance(strategy_name, str) or not strategy_name:
  232. raise ValueError(
  233. f'Invalid strategy for battle wait event {event_name}: '
  234. f'{strategy_name!r}'
  235. )
  236. function_names.append(f'_bw_{event_name}_{strategy_name}')
  237. return function_names
  238. def override(self, *arg, **kwargs):
  239. if kwargs:
  240. raise TypeError(
  241. 'sequence is not supported' if 'sequence' in kwargs else f'Unexpected keyword arguments: {tuple(kwargs)}')
  242. if not arg:
  243. return self
  244. events = [event for event in self.sequence.split('>') if event]
  245. if 'idle' not in events:
  246. raise ValueError(f'Sequence {self.sequence!r} must contain "idle"')
  247. idle_index = events.index('idle')
  248. for event_strategy in arg:
  249. if not isinstance(event_strategy, str):
  250. raise TypeError(f'event_strategy must be a string, got {event_strategy!r}')
  251. event, separator, strategy = event_strategy.partition('_')
  252. if not separator or not event or not strategy:
  253. raise ValueError(f'Invalid event_strategy: {event_strategy!r}')
  254. if event == 'sequence':
  255. raise ValueError('sequence cannot be overridden')
  256. is_new = not hasattr(self, event)
  257. setattr(self, event, strategy)
  258. if is_new:
  259. events.insert(idle_index, event)
  260. idle_index += 1
  261. self.sequence = '>'.join(events)
  262. return self
  263. class battle_wait_strategy:
  264. battle_wait_plan: BattleWaitPlan = None
  265. def __init__(self, *arg, **kwargs):
  266. self._scope = 'decorator'
  267. self._battle_wait_plan = BattleWaitPlan(*arg, **kwargs)
  268. def __enter__(self):
  269. self._scope = 'temporary'
  270. self._previous_plan = battle_wait_strategy.battle_wait_plan
  271. battle_wait_strategy.battle_wait_plan = self._battle_wait_plan
  272. return self
  273. def __exit__(self, *exc):
  274. battle_wait_strategy.battle_wait_plan = self._previous_plan
  275. return False
  276. def __str__(self):
  277. plan = getattr(self, '_battle_wait_plan', None)
  278. scope = getattr(self, '_scope', 'decorator')
  279. active_plan = battle_wait_strategy.battle_wait_plan
  280. return (
  281. f'{type(self).__name__}('
  282. f'scope={scope}, '
  283. f'plan=\n{plan}, '
  284. f'active_plan=\n{active_plan}'
  285. f')'
  286. )
  287. def __repr__(self):
  288. return self.__str__()
  289. def _recreate_cm(self):
  290. return self
  291. def __call__(self, func: Callable[P, T]) -> Callable[P, T]:
  292. # 跨任务重置配置和策略,但是不重置状态
  293. battle_wait_strategy.battle_wait_plan = self._battle_wait_plan
  294. @wraps(func)
  295. def inner(owner, *args: P.args, **kwargs: P.kwargs) -> T:
  296. # 兼容性处理
  297. #-----------------------------------------------------------------------
  298. if kwargs:
  299. override_kwargs = {}
  300. override_args = list()
  301. for key, value in kwargs.items():
  302. if key == 'random_click_swipt_enable' and value:
  303. override_kwargs['randomclick'] = 'default'
  304. override_args.append('randomclick_default')
  305. current_plan = copy.deepcopy(battle_wait_strategy.battle_wait_plan)
  306. current_plan = current_plan.override(*override_args)
  307. else:
  308. current_plan = battle_wait_strategy.battle_wait_plan
  309. # -----------------------------------------------------------------------
  310. # kwargs.setdefault(
  311. # 'battle_wait_plan',
  312. # self.battle_wait_plan,
  313. # )
  314. options = battle_wait_options.options or None
  315. runtime.reset_per_battle()
  316. runtime.update_options(options)
  317. return func(owner, battle_wait_plan=current_plan, options=options) \
  318. if options else func(owner, battle_wait_plan=current_plan)
  319. return inner
  320. class battle_wait_options:
  321. """
  322. 用法(输入为按 hook 名的 kwargs, 每个值必须是 dict[str, dict]):
  323. 1) 装饰器 = 永久覆盖(任务级):
  324. @battle_wait_options(success={'excludes': [...]}) # 参数
  325. @battle_wait_strategy(success='activity') # 策略, 只管 hook 与顺序
  326. def battle_wait(self, *args, **kwargs):
  327. return self.battle_wait_with_strategy(*args, **kwargs)
  328. 2) with = 临时覆盖(本次调用, 退出还原):
  329. with battle_wait_options(failure={'excludes': [...]}):
  330. task.battle_wait()
  331. """
  332. _DEFAULT_OPTIONS = _DEFAULT_OPTIONS
  333. options: dict[str, dict] = deepcopy(_DEFAULT_OPTIONS)
  334. def __init__(self, *arg, **kwargs):
  335. self._scope = 'decorator'
  336. self._overrides = dict(kwargs)
  337. def __enter__(self):
  338. self._scope = 'temporary'
  339. self._prev = type(self).options
  340. merged = deepcopy(self._prev) or {}
  341. merged.update(self._overrides)
  342. type(self).options = merged
  343. return self
  344. def __exit__(self, *exc):
  345. type(self).options = self._prev
  346. return False
  347. def __str__(self):
  348. scope = getattr(self, '_scope', 'decorator')
  349. return (
  350. f'{type(self).__name__}('
  351. f'scope={scope}, '
  352. f'overrides={self._overrides}, '
  353. f'options={battle_wait_options.options or {}}'
  354. f')'
  355. )
  356. def __repr__(self):
  357. return self.__str__()
  358. def __call__(self, func: Callable[P, T]) -> Callable[P, T]:
  359. # 装饰器 = 永久覆盖(任务级); 调用结束后还原,避免跨任务污染
  360. self._options_saved = type(self).options
  361. @wraps(func)
  362. def inner(owner, *args: P.args, **kwargs: P.kwargs) -> T:
  363. type(self).options = deepcopy(self._overrides)
  364. try:
  365. return func(owner, *args, **kwargs)
  366. finally:
  367. type(self).options = self._options_saved
  368. return inner
  369. @dataclass
  370. class PublicContext:
  371. cross: dict = field(default_factory=dict)
  372. per_task: PerTaskState = field(default_factory=PerTaskState)
  373. per_battle: PerBattleState = field(default_factory=PerBattleState)
  374. options: dict = field(default_factory=dict) # 所有hook的options
  375. @dataclass
  376. class PrivateContext:
  377. cross: dict = field(default_factory=dict)
  378. per_task: dict = field(default_factory=dict)
  379. per_battle: dict = field(default_factory=dict)
  380. options: dict = field(default_factory=dict) # 单个hook的options
  381. class runtime:
  382. task_owner = None
  383. pri_ctx: dict[str, PrivateContext] = {}
  384. pub_ctx: PublicContext = None
  385. def __init__(self, func: Callable):
  386. self.func = func
  387. self.hook_name = func.__name__
  388. update_wrapper(self, func)
  389. def __get__(self, obj, objtype=None):
  390. if obj is None:
  391. return self
  392. runtime._ensure_pub()
  393. runtime._ensure_pri(self.hook_name)
  394. @wraps(self.func)
  395. def bound(*args, **kwargs):
  396. return self(obj, *args, **kwargs)
  397. return bound
  398. def __call__(self, owner, *args, **kwargs):
  399. # 新任务重置一下
  400. if runtime.task_owner is None or owner is not runtime.task_owner:
  401. runtime.task_owner = owner
  402. runtime.reset_per_task()
  403. runtime._ensure_pub()
  404. runtime._ensure_pri(self.hook_name)
  405. return self.func(owner, pub=runtime.pub_ctx, pri=runtime.pri_ctx[self.hook_name])
  406. def __str__(self):
  407. pub = runtime.pub_ctx or PublicContext()
  408. pri = runtime.pri_ctx.get(self.hook_name) or PrivateContext()
  409. def _keys(d):
  410. if isinstance(d, dict):
  411. return ','.join(d.keys()) or '-'
  412. if isinstance(d, (PerTaskState, PerBattleState)):
  413. return ','.join(d.__dataclass_fields__) or '-'
  414. return str(d)
  415. return (
  416. f'runtime({self.hook_name}) '
  417. f'pub[c:{_keys(pub.cross)},t:{_keys(pub.per_task)},b:{_keys(pub.per_battle)},o:{_keys(pub.options)}] '
  418. f'pri[c:{_keys(pri.cross)},t:{_keys(pri.per_task)},b:{_keys(pri.per_battle)},o:{_keys(pri.options)}]'
  419. )
  420. def __repr__(self):
  421. return self.__str__()
  422. @classmethod
  423. def reset_per_task(cls):
  424. cls._ensure_pub()
  425. cls.pub_ctx.per_task = PerTaskState()
  426. for ctx in cls.pri_ctx.values():
  427. ctx.per_task = {}
  428. @classmethod
  429. def reset_per_battle(cls):
  430. cls._ensure_pub()
  431. cls.pub_ctx.per_battle = PerBattleState()
  432. for ctx in cls.pri_ctx.values():
  433. ctx.per_battle = {}
  434. @classmethod
  435. def _ensure_pub(cls):
  436. if cls.pub_ctx is None:
  437. cls.pub_ctx = PublicContext()
  438. @classmethod
  439. def _ensure_pri(cls, name):
  440. if name not in cls.pri_ctx:
  441. cls.pri_ctx[name] = PrivateContext()
  442. @classmethod
  443. def hook2event(cls, func_name: str) -> str:
  444. # '_bw_success_soul' -> 'success'(strategy 名里带下划线也能正确切出事件名)
  445. return func_name[len('_bw_'):].rsplit('_', 1)[0]
  446. @classmethod
  447. def update_options(cls, options: dict[str, dict]):
  448. cls._ensure_pub()
  449. if not isinstance(options, dict):
  450. cls.pub_ctx.options = {}
  451. for ctx in cls.pri_ctx.values():
  452. ctx.options = {}
  453. return
  454. cls.pub_ctx.options = options
  455. for hook_name, ctx in cls.pri_ctx.items():
  456. ctx.options = options.get(cls.hook2event(hook_name)) or {}
  457. @classmethod
  458. def hook_enabled(cls) -> set:
  459. _hook_enabled = cls.pub_ctx.per_battle.hook_enabled
  460. if not _hook_enabled:
  461. raise
  462. return _hook_enabled
  463. @classmethod
  464. def hook_enabled_update(cls, enable: tuple[str, ...], disable: tuple[str, ...]) -> HookSignal:
  465. """
  466. hook_enabled 的更新只能在 BattleWait 上。不可以在 battle_wait_options 或者 battle_wait_strategy 上
  467. """
  468. cls.pub_ctx.per_battle.hook_enabled.update(enable)
  469. cls.pub_ctx.per_battle.hook_enabled.difference_update(disable)
  470. return HookSignal.CONTINUE
  471. class BattleWait(BaseTask, GeneralBattleAssets):
  472. def __new__(cls, *args, **kwargs):
  473. for klass in reversed(cls.__mro__):
  474. # 找遍整个继承链,从父到子
  475. if klass is object:
  476. continue
  477. if klass.__dict__.get('_runtime_auto_decorated'):
  478. continue
  479. klass._runtime_auto_decorated = True
  480. for name, attr in list(vars(klass).items()):
  481. if name.startswith('_bw_') and callable(attr) and not isinstance(attr, runtime):
  482. setattr(klass, name, runtime(attr))
  483. return super().__new__(cls)
  484. # ------------------------------------------------------------------------------------------------------------------
  485. @cached_property
  486. def exclude_button_stage_1(self):
  487. return ['C_END_MESSAGE_RIGHT_TOP', 'C_END_BUFF_AREA_1', 'C_END_BUFF_AREA_2',
  488. 'C_END_SOUL_RECORD', 'C_END_SOUL_DETAILS',
  489. ]
  490. @cached_property
  491. def exclude_button_stage_2(self):
  492. return ['C_END_MESSAGE_RIGHT_TOP', 'C_END_BUFF_AREA_1', 'C_END_BUFF_AREA_2', 'C_END_SOUL_RECORD', 'C_END_SOUL_DETAILS',
  493. 'C_END_1_1', 'C_END_1_2', 'C_END_1_3', 'C_END_1_4', 'C_END_1_5', 'C_END_1_6',
  494. ]
  495. def reward_exclude_click(self, areas: list[str] = None, name: str = 'success_exclude_click') -> RuleClickExclude:
  496. inputs = []
  497. for area in areas:
  498. click = getattr(self, area, None)
  499. if click is None:
  500. raise ValueError(f'Unknown success exclusion click: {area!r}')
  501. inputs.append(click)
  502. return RuleClickExclude(inputs, name=name)
  503. def reward_exclude_click_1(self, areas: list[str] = None) -> RuleClickExclude:
  504. return self.reward_exclude_click(areas, name='reward_exclude_click_1')
  505. def reward_exclude_click_2(self, areas: list[str] = None) -> RuleClickExclude:
  506. return self.reward_exclude_click(areas, name='reward_exclude_click_2')
  507. # build in
  508. # ------------------------------------------------------------------------------------------------------------------
  509. def _bw_setup_default(self, pub: PublicContext, pri: PrivateContext) -> HookSignal:
  510. """
  511. options: dict = {
  512. ‘excludes’
  513. }
  514. """
  515. self.C_REWARD_1.name = 'C_REWARD'
  516. self.C_REWARD_2.name = 'C_REWARD'
  517. self.C_REWARD_3.name = 'C_REWARD'
  518. self.device.stuck_record_add('BATTLE_STATUS_S')
  519. self.device.click_record_clear()
  520. logger.info('Start battle process')
  521. pri_options = pri.options if isinstance(pri.options, dict) else {}
  522. success_options = pri_options.get('success') or {}
  523. if not isinstance(success_options, dict):
  524. raise TypeError("battle wait option 'success' must be a dict")
  525. excludes = success_options.get('excludes')
  526. exclude_stage_1 = excludes if excludes is not None else self.exclude_button_stage_1
  527. exclude_stage_2 = excludes if excludes is not None else self.exclude_button_stage_2
  528. self._reward_exclude_click_1 = self.reward_exclude_click_1(exclude_stage_1)
  529. self._reward_exclude_click_2 = self.reward_exclude_click_2(exclude_stage_2)
  530. # print(self._reward_exclude_click_1)
  531. # print(self._reward_exclude_click_2)
  532. return HookSignal.DONE
  533. def _bw_completion_default(self, pub: PublicContext, pri: PrivateContext) -> HookSignal:
  534. logger.info('Battle completion process')
  535. pub.per_task.count += 1
  536. return HookSignal.DONE
  537. def _bw_interrupt_default(self, pub: PublicContext, pri: PrivateContext) -> HookSignal:
  538. # 比如 御魂溢出
  539. return HookSignal.CONTINUE
  540. def _bw_success_default(self, pub: PublicContext, pri: PrivateContext) -> HookSignal:
  541. if self.appear_then_click(self.I_WIN, interval=0.8):
  542. self.click(self._reward_exclude_click_1)
  543. return HookSignal.CONTINUE
  544. appear_ghost, appear_reward, appear_gold, appear_skin = (
  545. self.appear(self.I_GREED_GHOST),
  546. self.appear(self.I_REWARD),
  547. self.appear(self.I_REWARD_GOLD),
  548. self.appear(self.I_REWARD_GOLD_SNAKE_SKIN)
  549. )
  550. if not any([appear_ghost, appear_reward, appear_gold, appear_skin]):
  551. return HookSignal.CONTINUE
  552. logger.info('Win battle')
  553. timer = Timer(20).start()
  554. while 1:
  555. self.screenshot()
  556. # 不小心点到了具体的奖励,他会弹出这个物品的详细描述 里面必定包含有“获取途径”
  557. if self.appear(self.I_END_FIX_1) or self.appear(self.I_END_FIX_2):
  558. self.click(self.C_REWARD_2, interval=1.5)
  559. _appear_ghost, _appear_reward, _appear_gold, _appear_skin = (
  560. self.appear(self.I_GREED_GHOST, threshold=0.6),
  561. self.appear(self.I_REWARD),
  562. self.appear(self.I_REWARD_GOLD),
  563. self.appear(self.I_REWARD_GOLD_SNAKE_SKIN)
  564. )
  565. # logger.info(f'_appear_ghost: {_appear_ghost} _appear_reward: {_appear_reward} _appear_gold: {_appear_gold} _appear_skin: {_appear_skin}')
  566. if any([_appear_ghost, _appear_reward, _appear_gold, _appear_skin]):
  567. if random.random() < 0.02:
  568. # 有一定的概率专门点击具体的奖励物品
  569. x, y = self._reward_exclude_click_2.coord_in_excluded(None)
  570. self.device.click(x=x, y=y, control_name='reward_item')
  571. continue
  572. self.click(self._reward_exclude_click_2, interval=1.5)
  573. else:
  574. logger.info('Get all reward')
  575. pub.success = True
  576. pub.completion = True
  577. return HookSignal.CONTINUE
  578. if timer.reached_and_reset():
  579. logger.warning('battle')
  580. break
  581. return HookSignal.CONTINUE
  582. def _bw_failure_default(self, pub: PublicContext, pri: PrivateContext) -> HookSignal:
  583. if self.appear(self.I_FALSE, threshold=0.8):
  584. logger.warning('False battle')
  585. self.ui_click_until_disappear(self.I_FALSE)
  586. pub.per_battle.success = BattleResult.FAILURE
  587. return runtime.hook_enabled_update(
  588. enable=('completion', ),
  589. disable=tuple(['success', 'failure']),
  590. )
  591. return HookSignal.CONTINUE
  592. def _bw_idle_default(self, pub: PublicContext, pri: PrivateContext) -> HookSignal:
  593. return HookSignal.CONTINUE
  594. def _bw_randomclick_default(self, pub: PublicContext, pri: PrivateContext) -> HookSignal:
  595. return HookSignal.CONTINUE
  596. done = pri.per_battle.get('_bw_randomclick_state', False)
  597. if done:
  598. return HookSignal.CONTINUE
  599. if not self.is_in_battle(is_screenshot=False):
  600. return HookSignal.CONTINUE
  601. if random.random() < 0.005 : # 低概率
  602. rand_type = random.randint(0, 2)
  603. match rand_type:
  604. case 0:
  605. self.click(self.C_RANDOM_CLICK, interval=20)
  606. case 1:
  607. self.swipe(self.S_BATTLE_RANDOM_LEFT, interval=20)
  608. case 2:
  609. self.swipe(self.S_BATTLE_RANDOM_RIGHT, interval=20)
  610. pri.per_battle['_bw_randomclick_state'] = True
  611. # 重新设置为长战斗
  612. # self.device.stuck_record_add('BATTLE_STATUS_S')
  613. else:
  614. time.sleep(0.4) # 这样的好像不对
  615. return HookSignal.CONTINUE
  616. # custom
  617. # ------------------------------------------------------------------------------------------------------------------
  618. def _bw_success_soul(self, pub: PublicContext, pri: PrivateContext) -> HookSignal:
  619. options: dict[str, dict] = pub.options if isinstance(pub.options, dict) else {}
  620. success_options = options.get('success') or {}
  621. if not isinstance(success_options, dict):
  622. raise TypeError("battle wait option 'success' must be a dict")
  623. action_click = self.reward_exclude_click(success_options.get('excludes'))
  624. if self.appear_then_click(self.I_WIN, interval=0.8):
  625. return HookSignal.CONTINUE
  626. appear_ghost, appear_reward, appear_gold, appear_skin = (
  627. self.appear(self.I_GREED_GHOST),
  628. self.appear(self.I_REWARD),
  629. self.appear(self.I_REWARD_GOLD),
  630. self.appear(self.I_REWARD_GOLD_SNAKE_SKIN)
  631. )
  632. if not any([appear_ghost, appear_reward, appear_gold, appear_skin]):
  633. return HookSignal.CONTINUE
  634. logger.info('Win battle')
  635. timer = Timer(20).start()
  636. while 1:
  637. self.screenshot()
  638. _appear_ghost, _appear_reward, _appear_gold, _appear_skin = (
  639. self.appear(self.I_GREED_GHOST, threshold=0.6),
  640. self.appear(self.I_REWARD),
  641. self.appear(self.I_REWARD_GOLD),
  642. self.appear(self.I_REWARD_GOLD_SNAKE_SKIN)
  643. )
  644. # logger.info(f'_appear_ghost: {_appear_ghost} _appear_reward: {_appear_reward} _appear_gold: {_appear_gold} _appear_skin: {_appear_skin}')
  645. if any([_appear_ghost, _appear_reward, _appear_gold, _appear_skin]):
  646. self.click(action_click, interval=1.5)
  647. else:
  648. logger.info('Get all reward')
  649. pub.success = True
  650. pub.completion = True
  651. return HookSignal.CONTINUE
  652. if timer.reached_and_reset():
  653. logger.warning('battle ')
  654. break
  655. return HookSignal.CONTINUE
  656. @cached_property
  657. def exclude_click_activity(self, areas: list[str] = None) -> RuleClickExclude:
  658. inputs = []
  659. for area in ['C_END_MESSAGE_RIGHT_TOP', 'C_END_ACTIVITY_REWARD']:
  660. click = getattr(self, area, None)
  661. if click is None:
  662. raise ValueError(f'Unknown success exclusion click: {area!r}')
  663. inputs.append(click)
  664. return RuleClickExclude(inputs, name='exclude_click_activity', strategy='rejection', distribution='uniform')
  665. def _bw_success_activity(self, pub: PublicContext, pri: PrivateContext) -> HookSignal:
  666. """
  667. 战斗结算是有 “获得奖励” 的适用
  668. """
  669. if not self.appear(self.I_UI_REWARD):
  670. return HookSignal.CONTINUE
  671. self.screenshot()
  672. if not self.appear(self.I_UI_REWARD):
  673. return HookSignal.CONTINUE
  674. logger.info('Win battle')
  675. timer = Timer(20).start()
  676. while 1:
  677. self.screenshot()
  678. # 不小心点到了具体的奖励,他会弹出这个物品的详细描述 里面必定包含有“获取途径”
  679. if self.appear(self.I_END_FIX_1) or self.appear(self.I_END_FIX_2) or self.appear(self.I_END_FIX_3):
  680. self.screenshot()
  681. if self.appear(self.I_END_FIX_1) or self.appear(self.I_END_FIX_2) or self.appear(self.I_END_FIX_3):
  682. self.click(self.C_REWARD_2, interval=2.5)
  683. continue
  684. if self.appear(self.I_UI_REWARD):
  685. if random.random() < 0.02:
  686. # 有一定的概率专门点击具体的奖励物品
  687. x, y = self.exclude_click_activity.coord_in_excluded(['C_END_ACTIVITY_REWARD'])
  688. self.device.click(x=x, y=y, control_name='reward_item')
  689. continue
  690. self.click(self.exclude_click_activity, interval=2.5)
  691. elif not self.appear(self.I_END_FIX_2):
  692. self.screenshot()
  693. if any([self.appear(self.I_UI_REWARD), self.appear(self.I_END_FIX_1), self.appear(self.I_END_FIX_2), self.appear(self.I_END_FIX_3)]):
  694. continue
  695. logger.info('Get all reward')
  696. pub.per_battle.success = BattleResult.SUCCESS
  697. return runtime.hook_enabled_update(
  698. enable=('completion', ),
  699. disable=tuple(['success', 'failure']),
  700. )
  701. if timer.reached_and_reset():
  702. logger.warning('battle ')
  703. break
  704. return HookSignal.CONTINUE
  705. # ------------------------------------------------------------------------------------------------------------------
  706. def battle_wait_with_strategy(self, *args, **kwargs) -> bool:
  707. """
  708. 理解 event + strategy 概念: 把战斗过程抽象为一系列触发事件以及对应的实现函数,也称hook。
  709. event + strategy 拼成了一个hook, 一个 event 在一次战斗过程中只能挂载一个 strategy
  710. 默认定义的 hook 有 BattleWaitPlan.HOOKS_DEFAULT = ('setup', 'completion', 'interrupt', 'success', 'failure', 'idle')
  711. 这些 hook 跑在一个 while 里面,默认的调用顺序 BattleWaitPlan.SEQUENCE_DEFAULT = 'completion > interrupt > success > failure > idle'
  712. setup 没有跑在 while里面 而是在 while之前, 比如一个战斗过程可以表示为:
  713. setup_default()
  714. while 1:
  715. completion_default()
  716. interrupt_default()
  717. success_default()
  718. failure_default()
  719. idle_default()
  720. 围绕hook从两个维度来构建一个战斗系统, options 表示每一个hook的配置选项, public 和 private 表示每一个hook的共享和私有状态。分别有两个生命周期
  721. | 自定义 /生命周期 | 跨任务 | 任务共享 | 单次战斗 |
  722. | ------------- | ----- | --------------------- | ------------ |
  723. | strategy | 不做 | @battle_wait_strategy | with 上下文 |
  724. | options | 不做 | @battle_wait_options | with 上下文 |
  725. | public | cross | per_task | per_battle |
  726. | private | cross | per_task | per_battle |
  727. ----------------------------------------------------------------------------------------------------------------
  728. 三种自定义策略方法:
  729. 1. 使用装饰器battle_wait_strategy, 将会覆盖掉类变量
  730. @battle_wait_strategy( 'reserve_default', 'idle_default', failure='default')
  731. def battle_wait(self, *args, **kwargs):
  732. return self.battle_wait_with_strategy(*args, **kwargs)
  733. 2. 使用 with 上下文 (!在1基础上), 将会临时覆盖掉原先的类变量,退出后恢复
  734. with battle_wait_strategy('reserve_default'):
  735. test_battle_wait.battle_wait()
  736. 3. 调用时动态传参 (!在1基础上), 不覆盖,就临时更新策略
  737. obj.battle_wait(random_click_swipt_enable=1) # 详细参数看 battle_wait_strategy.__call__()
  738. 自定义hook就是字符串拼起来: battle_wait_strategy的入参可以有 ‘event_strategy’ 或者 'event=strategy'
  739. 可以添加任意 event 以及其对应的 strategy。比如 ‘yyy_default’ 'abcd_edf'
  740. 但是必须要实现对应的hook 上面的比如 _bw_yyy_default() 以及 _bw_abcd_edf()
  741. hook 可以自定义顺序,比如 battle_wait_strategy(sequence='completion > interrupt > success > failure > idle')
  742. 如果没有指定sequence, 新增的event会按照传参时候从左到右排序,左边高优先级,新增的会插入到 failure 和 idle 之间
  743. ----------------------------------------------------------------------------------------------------------------
  744. 如果希望每一个hook带上参数:
  745. 1. 在 battle_wait_strategy 定义了一组默认的 options
  746. 2. 可以在装饰器定义 @battle_wait_strategy(options = options),这里将会覆盖掉原先的 battle_wait_strategy.options
  747. 3. 上下文带上 with battle_wait_strategy(...).with_options(options),同样也是临时覆盖掉 battle_wait_strategy.options
  748. 4.
  749. options: dict[str: dict] = {
  750. "setup": {...}
  751. ...
  752. }
  753. ----------------------------------------------------------------------------------------------------------------
  754. 跨战斗,考虑把状态挂到方法上,而不是挂到类对象上。】
  755. 我突然感觉 一个类里面装了 策略和参数,这样不好,考虑拆分成两个装饰器
  756. """
  757. battle_wait_plan = kwargs.get('battle_wait_plan')
  758. if battle_wait_plan is None:
  759. battle_wait_plan = BattleWaitPlan()
  760. print(battle_wait_plan)
  761. # print(battle_wait_plan.sequence_function_names())
  762. options = runtime.pub_ctx.options
  763. logger.info('options: {}'.format(options))
  764. setup_func = getattr(self, battle_wait_plan.function_setup_name, self._bw_setup_default)
  765. setup_func()
  766. handlers = [getattr(self, func_name, None) for func_name in battle_wait_plan.sequence_function_names()]
  767. _hook_enabled = tuple(runtime.hook2event(h.__name__) for h in handlers if h)
  768. _hook_disabled = ('completion', )
  769. runtime.hook_enabled_update(enable=_hook_enabled, disable=_hook_disabled)
  770. print(f'first runtime.hook_enabled(): {runtime.hook_enabled()}')
  771. while True:
  772. self.screenshot()
  773. hook_enabled = runtime.hook_enabled()
  774. for handler in handlers:
  775. if runtime.hook2event(handler.__name__) not in hook_enabled:
  776. continue
  777. result = handler()
  778. if handler.__name__.startswith('_bw_completion') and result == HookSignal.DONE:
  779. return runtime.pub_ctx.per_battle.success == BattleResult.SUCCESS
  780. if result == HookSignal.CONTINUE:
  781. continue
  782. if __name__ == '__main__':
  783. from module.config.config import Config
  784. from module.device.device import Device
  785. from tasks.Component.GeneralBattle.general_battle import GeneralBattle
  786. c = Config('oas1')
  787. d = Device(c)
  788. class TestBattleWait(GeneralBattle, BattleWait):
  789. def _bw_settlement(self):
  790. pass
  791. @battle_wait_strategy( 'reserve_default', 'idle_default', failure='default')
  792. def battle_wait(self, *args, **kwargs):
  793. return self.battle_wait_with_strategy(*args, **kwargs)
  794. test_battle_wait = TestBattleWait(c,d)
  795. test_battle_wait.battle_wait(random_click_swipt_enable=1)
  796. with battle_wait_strategy(sequence='completion > interrupt > success > failure > idle').with_options(options={"setup": {"11": "11"}}):
  797. test_battle_wait.battle_wait()