solo.py 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559
  1. # This Python file uses the following encoding: utf-8
  2. # @author runhey
  3. # github https://github.com/runhey
  4. from time import sleep
  5. from copy import deepcopy
  6. from cached_property import cached_property
  7. from module.logger import logger
  8. from module.base.timer import Timer
  9. from tasks.Component.GeneralInvite.config_invite import InviteConfig, InviteNumber, FindMode
  10. from tasks.Exploration.base import BaseExploration, UpType, Scene
  11. from tasks.Exploration.config import ChooseRarity, AutoRotate, UserStatus
  12. class SoloExploration(BaseExploration):
  13. INVITE_FLAG_OFF = (157, 109, 83)
  14. INVITE_FLAG_ON = (227, 193, 153)
  15. INVITE_TIMEOUT = 20
  16. FRIEND_LEAVE_TIMEOUT = 3
  17. SEARCH_SWIPE_INTERVAL = 1.5
  18. MAX_SWIPE_COUNT = 2
  19. explore_init = False
  20. swipe_cnt: int = 0
  21. search_fail_timer: Timer = None
  22. @cached_property
  23. def _invite_config(self) -> InviteConfig:
  24. return InviteConfig(
  25. invite_number=InviteNumber.ONE,
  26. friend_1=self._config.invite_config.friend_1,
  27. friend_2='',
  28. find_mode=self._config.invite_config.find_mode,
  29. wait_time=self._config.invite_config.wait_time,
  30. default_invite=False
  31. )
  32. def _handle_treasure_box(self) -> bool:
  33. if self.appear(self.I_TREASURE_BOX_CLICK):
  34. logger.info('Treasure box appear, get it.')
  35. self.ui_click_until_disappear(self.I_TREASURE_BOX_CLICK)
  36. return True
  37. return False
  38. def _check_mate_leave(self, friend_leave_timer: Timer) -> bool:
  39. if self.appear(self.I_TEAM_EMOJI) or self.appear(self.I_TEAM_EMOJI_FIGHT):
  40. # 再次出现则重新计时,进入对局标志消失
  41. if friend_leave_timer.started():
  42. logger.warning('Team emoji appear again, clear friend_leave_timer')
  43. friend_leave_timer.clear()
  44. return False
  45. logger.warning('Team emoji not appear')
  46. if not friend_leave_timer.started():
  47. logger.warning('Mate leave, start timer')
  48. friend_leave_timer.start()
  49. return False
  50. if not friend_leave_timer.reached():
  51. return False
  52. logger.warning('Mate leave timer reached')
  53. logger.warning('Exit team')
  54. self.quit_explore()
  55. return True
  56. def _reset_search_state(self, reset_swipe_cnt: bool = False) -> None:
  57. if reset_swipe_cnt:
  58. if self.swipe_cnt > 0:
  59. logger.info(f"Exploration search reset (cleared count: {self.swipe_cnt})")
  60. self.swipe_cnt = 0
  61. self.search_fail_timer.clear()
  62. def _search_next_area(self) -> None:
  63. if not self.search_fail_timer.started():
  64. self.search_fail_timer.start()
  65. return
  66. if not self.search_fail_timer.reached():
  67. return
  68. # 若选择特定 UP(如经验怪),达到最大滑屏次数(默认2次,覆盖前3屏高密度区)超时仍无目标直接早退重开;
  69. # 若选择“全部”,则不限次数滑动直到最右边界,以保证清完全图小怪并击杀 BOSS。
  70. is_specific_up = self._config.exploration_config.up_type != UpType.ALL
  71. if is_specific_up and self.swipe_cnt >= self.MAX_SWIPE_COUNT:
  72. logger.info(f"Max search swipe count ({self.MAX_SWIPE_COUNT}) reached for specific UP target. Quitting exploration early.")
  73. self._reset_search_state(reset_swipe_cnt=True)
  74. self.quit_explore()
  75. return
  76. before_image = self.device.image
  77. self.swipe(self.S_SWIPE_BACKGROUND_RIGHT)
  78. sleep(0.3)
  79. self.screenshot()
  80. unchanged = self.is_swipe_unchanged(before_image, self.device.image)
  81. if unchanged:
  82. sleep(0.3)
  83. self.screenshot()
  84. unchanged = self.is_swipe_unchanged(before_image, self.device.image)
  85. if (self.get_current_scene() != Scene.MAIN
  86. or self.appear(self.I_UI_CONFIRM)
  87. or self.appear(self.I_UI_CONFIRM_SAMLL)):
  88. self.search_fail_timer.reset()
  89. return
  90. # 若未产生位移,原地做快速二次复核保底
  91. if unchanged:
  92. sleep(0.3)
  93. before_retry = self.device.image
  94. self.swipe(self.S_SWIPE_BACKGROUND_RIGHT)
  95. sleep(0.3)
  96. self.screenshot()
  97. if self.is_swipe_unchanged(before_retry, self.device.image):
  98. logger.info("Reached rightmost boundary (confirmed twice). Quitting exploration.")
  99. self._reset_search_state(reset_swipe_cnt=True)
  100. self.quit_explore()
  101. return
  102. self.device.click_record_remove(self.S_SWIPE_BACKGROUND_RIGHT.name)
  103. self.swipe_cnt += 1
  104. self.search_fail_timer.reset()
  105. def run_solo(self):
  106. logger.hr('solo')
  107. self.search_fail_timer = Timer(self.SEARCH_SWIPE_INTERVAL)
  108. while 1:
  109. self.screenshot()
  110. scene = self.get_current_scene()
  111. logger.info(f'[run_solo] Current scene: {scene.name}') # TODO 2026.06.22 之后删掉这个刷屏的
  112. #
  113. if scene == Scene.WORLD:
  114. self.explore_init = False
  115. self._reset_search_state(reset_swipe_cnt=True)
  116. self.device.click_record_remove(self.S_SWIPE_BACKGROUND_RIGHT.name)
  117. # 打开右边箭头
  118. if not self.wait_world_stable():
  119. continue
  120. if self.check_exit():
  121. break
  122. self.open_expect_level()
  123. continue
  124. #
  125. elif scene == Scene.ENTRANCE:
  126. self.explore_init = False
  127. self._reset_search_state(reset_swipe_cnt=True)
  128. self.device.click_record_remove(self.S_SWIPE_BACKGROUND_RIGHT.name)
  129. if self.check_exit():
  130. break
  131. self.ui_click(self.I_E_EXPLORATION_CLICK, stop=self.I_E_SETTINGS_BUTTON)
  132. continue
  133. #
  134. elif scene == Scene.MAIN:
  135. if not self.explore_init:
  136. if self._config.exploration_config.auto_rotate == AutoRotate.yes:
  137. self.enter_settings_and_do_operations()
  138. self.ui_click(self.I_E_AUTO_ROTATE_OFF, stop=self.I_E_AUTO_ROTATE_ON, timeout=5)
  139. self.explore_init = True
  140. self._reset_search_state(reset_swipe_cnt=True)
  141. continue
  142. if self._handle_treasure_box():
  143. self._reset_search_state()
  144. continue
  145. if (self.appear_then_click(self.I_UI_CONFIRM, interval=1)
  146. or self.appear_then_click(self.I_UI_CONFIRM_SAMLL, interval=1)):
  147. self._reset_search_state()
  148. continue
  149. # 小纸人
  150. if self.appear(self.I_BATTLE_REWARD):
  151. if self.ui_get_reward(self.I_BATTLE_REWARD):
  152. self._reset_search_state()
  153. continue
  154. # boss
  155. if self.appear(self.I_BOSS_BATTLE_BUTTON):
  156. self._reset_search_state()
  157. self.device.click_record_remove(self.S_SWIPE_BACKGROUND_RIGHT.name)
  158. if self.fire(self.I_BOSS_BATTLE_BUTTON):
  159. logger.info(f'Boss battle, minions cnt {self.minions_cnt}')
  160. continue
  161. # 小怪
  162. fight_button = self.search_up_fight()
  163. if fight_button is not None:
  164. self._reset_search_state()
  165. self.device.click_record_remove(self.S_SWIPE_BACKGROUND_RIGHT.name)
  166. if self.fire(fight_button):
  167. logger.info(f'Fight, minions cnt {self.minions_cnt}')
  168. continue
  169. # 向后拉,寻找怪
  170. self._search_next_area()
  171. continue
  172. #
  173. elif scene == Scene.BATTLE_PREPARE or scene == Scene.BATTLE_FIGHTING:
  174. self.check_take_over_battle(is_screenshot=False, config=self._config.general_battle_config)
  175. elif scene == Scene.UNKNOWN:
  176. continue
  177. def run_leader(self):
  178. logger.hr('leader')
  179. self.search_fail_timer = Timer(self.SEARCH_SWIPE_INTERVAL)
  180. friend_leave_timer = Timer(self.FRIEND_LEAVE_TIMEOUT)
  181. while 1:
  182. self.screenshot()
  183. scene = self.get_current_scene()
  184. # 探索大世界
  185. if scene == Scene.WORLD:
  186. self.explore_init = False
  187. self._reset_search_state(reset_swipe_cnt=True)
  188. self.device.click_record_remove(self.S_SWIPE_BACKGROUND_RIGHT.name)
  189. # 打开右边箭头
  190. if not self.wait_world_stable():
  191. continue
  192. if self.check_exit():
  193. self.wait_until_stable(self.I_UI_CANCEL, timer=Timer(0.6, 2))
  194. if self.appear(self.I_UI_CANCEL):
  195. self.ui_click_until_disappear(self.I_UI_CANCEL)
  196. break
  197. if self.appear(self.I_UI_CONFIRM):
  198. self.ui_click_until_disappear(self.I_UI_CONFIRM)
  199. # 可以加一下,清空第一次 explore_init
  200. continue
  201. self.open_expect_level()
  202. # explore_init = False
  203. continue
  204. # 邀请好友, 非常有可能是后面邀请好友,然后直接跳到组队了
  205. elif scene == Scene.ENTRANCE:
  206. self.explore_init = False
  207. self._reset_search_state(reset_swipe_cnt=True)
  208. self.device.click_record_remove(self.S_SWIPE_BACKGROUND_RIGHT.name)
  209. while 1:
  210. self.screenshot()
  211. if self.is_in_room():
  212. break
  213. if self.appear_then_click(self.I_ENSURE_PRIVATE_FALSE, interval=0.5):
  214. continue
  215. if self.appear_then_click(self.I_ENSURE_PRIVATE_FALSE_2, interval=0.5):
  216. continue
  217. # 创建在组队前,组队蒙层后概率会被误识别
  218. if self.appear_then_click(self.I_EXP_CREATE_ENSURE, interval=2):
  219. continue
  220. if self.appear_then_click(self.I_EXP_CREATE_TEAM, interval=1):
  221. continue
  222. #
  223. elif scene == Scene.TEAM:
  224. self.explore_init = False
  225. self._reset_search_state(reset_swipe_cnt=True)
  226. self.wait_until_stable(self.I_ADD_2, timer=Timer(0.8, 1))
  227. if self.appear(self.I_FIRE, threshold=0.8) and not self.appear(self.I_ADD_2):
  228. self.ui_click_until_disappear(self.I_FIRE, interval=1)
  229. continue
  230. if self.appear(self.I_ADD_2) and self.run_invite(config=self._invite_config, is_first=True):
  231. continue
  232. else:
  233. logger.warning('Invite failed, quit')
  234. while 1:
  235. self.screenshot()
  236. if self.appear(self.I_CHECK_EXPLORATION):
  237. break
  238. if self.appear_then_click(self.I_UI_CONFIRM, interval=0.5):
  239. continue
  240. if self.appear_then_click(self.I_UI_BACK_RED, interval=0.7):
  241. continue
  242. if self.appear_then_click(self.I_UI_BACK_YELLOW, interval=1):
  243. continue
  244. break
  245. ##
  246. elif scene == Scene.MAIN:
  247. if not self.explore_init:
  248. if self._config.exploration_config.auto_rotate == AutoRotate.yes:
  249. self.enter_settings_and_do_operations()
  250. self.ui_click(self.I_E_AUTO_ROTATE_OFF, stop=self.I_E_AUTO_ROTATE_ON)
  251. self.explore_init = True
  252. self._reset_search_state(reset_swipe_cnt=True)
  253. continue
  254. if self._handle_treasure_box():
  255. self._reset_search_state()
  256. continue
  257. if (self.appear_then_click(self.I_UI_CONFIRM, interval=1)
  258. or self.appear_then_click(self.I_UI_CONFIRM_SAMLL, interval=1)):
  259. self._reset_search_state()
  260. continue
  261. # 小纸人
  262. if self.appear(self.I_BATTLE_REWARD):
  263. if self.ui_get_reward(self.I_BATTLE_REWARD):
  264. self._reset_search_state()
  265. continue
  266. # 中途有人跑路
  267. if self._check_mate_leave(friend_leave_timer):
  268. self._reset_search_state()
  269. continue
  270. # boss
  271. if self.appear(self.I_BOSS_BATTLE_BUTTON):
  272. self._reset_search_state()
  273. self.device.click_record_remove(self.S_SWIPE_BACKGROUND_RIGHT.name)
  274. if self.fire(self.I_BOSS_BATTLE_BUTTON):
  275. logger.info(f'Boss battle, minions cnt {self.minions_cnt}')
  276. continue
  277. # 小怪
  278. fight_button = self.search_up_fight()
  279. if fight_button is not None:
  280. self._reset_search_state()
  281. self.device.click_record_remove(self.S_SWIPE_BACKGROUND_RIGHT.name)
  282. if self.fire(fight_button):
  283. logger.info(f'Fight, minions cnt {self.minions_cnt}')
  284. continue
  285. # 向后拉,寻找怪
  286. self._search_next_area()
  287. continue
  288. #
  289. elif scene == Scene.BATTLE_PREPARE or scene == Scene.BATTLE_FIGHTING:
  290. self.check_take_over_battle(is_screenshot=False, config=self._config.general_battle_config)
  291. elif scene == Scene.UNKNOWN:
  292. continue
  293. def run_member(self):
  294. logger.hr('member')
  295. wait_timer = Timer(50)
  296. friend_leave_timer = Timer(self.FRIEND_LEAVE_TIMEOUT)
  297. while 1:
  298. self.screenshot()
  299. scene = self.get_current_scene()
  300. logger.info(f'[run_member] Current scene: {scene.name}') # TODO 2026.06.12 之后删掉这个刷屏的
  301. #
  302. if scene == Scene.WORLD:
  303. # 打开右边箭头
  304. if not self.wait_world_stable():
  305. continue
  306. if self.check_exit():
  307. break
  308. if self.check_then_accept():
  309. # 接受邀请后清掉计时器
  310. wait_timer.clear()
  311. continue
  312. if wait_timer.started() and wait_timer.reached():
  313. logger.warning('Wait timer reached')
  314. break
  315. continue
  316. #
  317. elif scene == Scene.ENTRANCE:
  318. self.ui_click(self.I_UI_BACK_YELLOW,stop=self.I_CHECK_EXPLORATION)
  319. #
  320. elif scene == Scene.TEAM:
  321. continue
  322. #
  323. elif scene == Scene.MAIN:
  324. if not self.explore_init:
  325. if self._config.exploration_config.auto_rotate == AutoRotate.yes:
  326. self.enter_settings_and_do_operations()
  327. self.ui_click(self.I_E_AUTO_ROTATE_OFF, stop=self.I_E_AUTO_ROTATE_ON)
  328. self.explore_init = True
  329. continue
  330. if self._handle_treasure_box():
  331. continue
  332. # 小纸人
  333. if self.appear(self.I_BATTLE_REWARD):
  334. if self.ui_get_reward(self.I_BATTLE_REWARD):
  335. continue
  336. #
  337. if self._check_mate_leave(friend_leave_timer):
  338. wait_timer.reset()
  339. continue
  340. #
  341. elif scene == Scene.BATTLE_PREPARE or scene == Scene.BATTLE_FIGHTING:
  342. logger.info('[run_member] Handling scene: BATTLE')
  343. self.check_take_over_battle(is_screenshot=False, config=self._config.general_battle_config)
  344. elif scene == Scene.UNKNOWN:
  345. continue
  346. def invite_friend(self, name: str = None, find_mode: FindMode = FindMode.AUTO_FIND) -> bool:
  347. logger.info('Click add to invite friend')
  348. # 点击+号
  349. while 1:
  350. self.screenshot()
  351. if self.appear(self.I_LOAD_FRIEND):
  352. break
  353. if self.appear(self.I_INVITE_ENSURE):
  354. break
  355. if self.appear_then_click(self.I_ADD_2, interval=1):
  356. continue
  357. if self.appear_then_click(self.I_ADD_5_4, interval=1):
  358. continue
  359. # 避免中途队友进来邀请死循环
  360. if not self.appear(self.I_ADD_2) or not self.appear(self.I_ADD_5_4):
  361. # 可能刚好点到人,点一下空地方
  362. self.device.click(x=370, y=480, control_name='exploration_invite_friend_prevent')
  363. return True
  364. friend_class = []
  365. class_ocr = [self.O_F_LIST_1, self.O_F_LIST_2, self.O_F_LIST_3, self.O_F_LIST_4]
  366. class_index = 0
  367. list_1 = self.O_F_LIST_1.ocr(self.device.image)
  368. list_2 = self.O_F_LIST_2.ocr(self.device.image)
  369. list_3 = self.O_F_LIST_3.ocr(self.device.image)
  370. list_4 = self.O_F_LIST_4.ocr(self.device.image)
  371. list_1 = list_1.replace(' ', '').replace('、', '')
  372. list_2 = list_2.replace(' ', '').replace('、', '')
  373. list_3 = list_3.replace(' ', '').replace('、', '')
  374. if list_1 is not None and list_1 != '' and list_1 in self.friend_class:
  375. friend_class.append(list_1)
  376. if list_2 is not None and list_2 != '' and list_2 in self.friend_class:
  377. friend_class.append(list_2)
  378. if list_3 is not None and list_3 != '' and list_3 in self.friend_class:
  379. friend_class.append(list_3)
  380. if list_4 is not None and list_4 != '' and list_4 in self.friend_class:
  381. friend_class.append(list_4)
  382. for i in range(len(friend_class)):
  383. if friend_class[i] == '蔡友':
  384. friend_class[i] = '寮友'
  385. elif friend_class[i] == '路区':
  386. friend_class[i] = '跨区'
  387. elif friend_class[i] == '察友':
  388. friend_class[i] = '寮友'
  389. elif friend_class[i] == '区':
  390. friend_class[i] = '跨区'
  391. logger.info(f'Friend class: {friend_class}')
  392. # 76e2a874(#1509) 把 I_FLAG_2_ON 的 roi 改到了 tab 标签栏上方的空白区
  393. # (472,82,32,11) / (454,74,56,26),导致第 2 个 tab 的选中态永远匹配不上,
  394. # while index == 1 死循环点满 10 次触发 GameTooManyClickError。
  395. # 这里深拷贝一份并还原成 439be142(#1443) 的 roi,不改动原资源。
  396. # https://github.com/runhey/OnmyojiAutoScript/issues/1844
  397. flag_2_on = deepcopy(self.I_FLAG_2_ON)
  398. flag_2_on.roi_front = [471, 128, 54, 18]
  399. flag_2_on.roi_back = (471, 128, 54, 18)
  400. is_select: bool = False # 是否选中了好友
  401. if find_mode == FindMode.RECENT_FRIEND:
  402. logger.info('Find recent friend')
  403. # 获取’最近‘在friend_class中的index
  404. if '最近' not in friend_class:
  405. logger.warning('No recent friend')
  406. return False
  407. recent_index = friend_class.index('最近')
  408. while recent_index == 1:
  409. self.screenshot()
  410. if self.appear(flag_2_on):
  411. break
  412. if self.appear_then_click(self.I_FLAG_2_OFF, interval=1):
  413. continue
  414. logger.info(f'Now find friend in ”最近“')
  415. sleep(1)
  416. if not is_select:
  417. if self.detect_select(name):
  418. is_select = True
  419. sleep(1)
  420. if not is_select:
  421. if self.detect_select(name):
  422. is_select = True
  423. for index in range(len(friend_class)):
  424. # 如果不是自动寻找,就跳过
  425. if find_mode != FindMode.AUTO_FIND:
  426. continue
  427. # 如果已经选中了好友,就不需要再选中了
  428. if is_select:
  429. continue
  430. # 首先切换到不同的好友列表
  431. while index == 0:
  432. self.screenshot()
  433. if self.I_FLAG_1_ON.match_mean_color(self.device.image, self.INVITE_FLAG_ON, 10):
  434. break
  435. if self.click(self.I_FLAG_1_OFF, interval=1):
  436. continue
  437. while index == 1:
  438. self.screenshot()
  439. if flag_2_on.match_mean_color(self.device.image, self.INVITE_FLAG_ON, 10):
  440. break
  441. if self.click(self.I_FLAG_2_OFF, interval=1):
  442. continue
  443. while index == 2:
  444. self.screenshot()
  445. if self.I_FLAG_3_ON.match_mean_color(self.device.image, self.INVITE_FLAG_ON, 10):
  446. break
  447. if self.click(self.I_FLAG_3_OFF, interval=1):
  448. continue
  449. while index == 3:
  450. self.screenshot()
  451. if self.I_FLAG_4_ON.match_mean_color(self.device.image, self.INVITE_FLAG_ON, 10):
  452. break
  453. if self.click(self.I_FLAG_4_OFF, interval=1):
  454. continue
  455. # 选中好友, 在这里游戏获取在线的好友并不是很快,根据不同的设备会有不同的时间,而且没有什么元素提供我们来判断
  456. # 所以这里就直接等待一段时间
  457. logger.info(f'Now find friend in {friend_class[index]}')
  458. sleep(1)
  459. if not is_select:
  460. if self.detect_select(name):
  461. is_select = True
  462. sleep(1)
  463. if not is_select:
  464. if self.detect_select(name):
  465. is_select = True
  466. # 点击确定
  467. logger.info('Click invite ensure')
  468. if not self.appear(self.I_INVITE_ENSURE):
  469. logger.warning('No appear invite ensure while invite friend')
  470. while 1:
  471. self.screenshot()
  472. if not self.appear(self.I_INVITE_ENSURE):
  473. break
  474. if self.appear_then_click(self.I_INVITE_ENSURE):
  475. continue
  476. # 哪怕没有找到好友也有点击 确认 以退出好友列表
  477. if not is_select:
  478. logger.warning('No find friend')
  479. # 这个时候任务运行失败
  480. logger.info('Task failed')
  481. return False
  482. return True
  483. class ScriptTask(SoloExploration):
  484. def run(self):
  485. logger.hr('exploration')
  486. random_click_cnt = 0
  487. while 1:
  488. self.screenshot()
  489. scene = self.get_current_scene()
  490. if random_click_cnt >= 2:
  491. break
  492. if scene == Scene.UNKNOWN:
  493. logger.warning('Unknown scene, random click')
  494. if self.click(self.C_SAFE_RANDOM, interval=1.5):
  495. random_click_cnt += 1
  496. continue
  497. else:
  498. break
  499. if scene == Scene.UNKNOWN:
  500. self.pre_process()
  501. match self._config.exploration_config.user_status:
  502. case UserStatus.ALONE:
  503. self.run_solo()
  504. case UserStatus.LEADER:
  505. self.run_leader()
  506. case UserStatus.MEMBER:
  507. self.run_member()
  508. case _:
  509. self.run_solo()
  510. self.post_process()
  511. if __name__ == "__main__":
  512. from module.config.config import Config
  513. from module.device.device import Device
  514. config = Config('oas1')
  515. device = Device(config)
  516. t = ScriptTask(config, device)
  517. t.run()