ソースを参照

fix: 误退出

doge 3 ヶ月 前
親
コミット
609d91c21e
3 ファイル変更、278 行追加、11 行削除
  1. 211 0
      exploration_state_machine.md
  2. 8 1
      tasks/Exploration/base.py
  3. 59 10
      tasks/Exploration/solo.py

+ 211 - 0
exploration_state_machine.md

@@ -0,0 +1,211 @@
+# 探索阶段转换状态机
+
+本文档基于当前 `tasks/Exploration` 实现整理。现有代码不是独立状态机类,而是由 `Scene` 场景识别加 `run_solo`、`run_leader`、`run_member` 三个循环隐式驱动。
+
+## 代码入口
+
+- `tasks/Exploration/base.py`
+  - `Scene`
+  - `get_current_scene()`
+  - `pre_process()`
+  - `post_process()`
+  - `check_exit()`
+  - `quit_explore()`
+  - `fire()`
+- `tasks/Exploration/solo.py`
+  - `ScriptTask.run()`
+  - `run_solo()`
+  - `run_leader()`
+  - `run_member()`
+
+## 状态定义
+
+| 状态 | 含义 |
+| --- | --- |
+| `START` | 启动探索任务,先识别当前场景。 |
+| `PRE_PROCESS` | 当前场景无法识别且随机点击恢复失败时,执行前置处理:换御魂、开加成、进入探索页。 |
+| `WORLD` | 探索大地图/章节选择页。 |
+| `ENTRANCE` | 章节入口弹窗/章节挑战入口。 |
+| `TEAM` | 组队房间,主要由队长/队员模式使用。 |
+| `MAIN_INIT` | 已进入探索副本,但本轮探索还未初始化。 |
+| `MAIN_SEARCH` | 探索副本内找怪、捡小纸人、打 Boss。 |
+| `BATTLE` | 战斗准备或战斗中。 |
+| `QUIT_EXPLORE` | 退出当前章节,回到 `WORLD` 或 `ENTRANCE`。 |
+| `POST_PROCESS` | 任务结束收尾:返回庭院、关闭加成、设置下次运行。 |
+| `END` | 抛出 `TaskEnd`,结束任务。 |
+
+## 主状态机
+
+```mermaid
+stateDiagram-v2
+    [*] --> START
+
+    START --> PRE_PROCESS: Scene.UNKNOWN 且恢复失败
+    START --> DISPATCH: 已识别场景
+
+    PRE_PROCESS --> WORLD: ui_goto(page_exploration)
+
+    DISPATCH --> SOLO: user_status = ALONE
+    DISPATCH --> LEADER: user_status = LEADER
+    DISPATCH --> MEMBER: user_status = MEMBER
+
+    SOLO --> WORLD
+    LEADER --> WORLD
+    MEMBER --> WORLD
+
+    WORLD --> POST_PROCESS: check_exit() = true
+    WORLD --> ENTRANCE: open_expect_level()
+    WORLD --> WORLD: 捡宝箱/确认弹窗/等待世界稳定
+
+    ENTRANCE --> POST_PROCESS: check_exit() = true
+    ENTRANCE --> MAIN_INIT: 单人点击挑战
+    ENTRANCE --> TEAM: 队长创建队伍
+    ENTRANCE --> WORLD: 队员返回等待邀请
+
+    TEAM --> MAIN_INIT: 队长开火/进入章节
+    TEAM --> WORLD: 邀请失败/退出房间
+    TEAM --> TEAM: 队员等待
+
+    MAIN_INIT --> MAIN_SEARCH: explore_init = true
+
+    MAIN_SEARCH --> BATTLE: 找到小怪或 Boss 并 fire()
+    MAIN_SEARCH --> MAIN_SEARCH: 捡小纸人奖励
+    MAIN_SEARCH --> MAIN_SEARCH: 未找到目标,累计 search_fail_cnt
+    MAIN_SEARCH --> QUIT_EXPLORE: 搜索失败 >= 4 且到达地图末尾
+    MAIN_SEARCH --> QUIT_EXPLORE: 组队队友离开超时
+    MAIN_SEARCH --> MAIN_SEARCH: 搜索失败 >= 4 但未到末尾,右滑继续找怪
+
+    BATTLE --> MAIN_SEARCH: 战斗结束回副本
+    BATTLE --> BATTLE: check_take_over_battle()
+
+    QUIT_EXPLORE --> WORLD: 回到探索大地图
+    QUIT_EXPLORE --> ENTRANCE: 回到章节入口
+
+    POST_PROCESS --> END
+    END --> [*]
+```
+
+## 关键转换条件
+
+### `WORLD -> POST_PROCESS`
+
+`check_exit()` 返回 `true`:
+
+- `minions_cnt >= exploration_config.minions_cnt`
+- 当前运行时长达到 `exploration_config.limit_time`
+- 绘卷模式下突破票数量达到 `scrolls.scrolls_threshold`,当前探索结束并调度 `RealmRaid`、`MemoryScrolls`
+
+### `WORLD -> ENTRANCE`
+
+满足以下流程:
+
+- `wait_world_stable()` 判定探索大地图稳定
+- 若出现宝箱,先领取宝箱
+- `open_expect_level()` 找到配置章节并点击
+
+### `ENTRANCE -> MAIN_INIT`
+
+单人模式下点击章节挑战入口 `I_E_EXPLORATION_CLICK`,进入探索副本。
+
+### `ENTRANCE -> TEAM`
+
+队长模式下创建队伍并确认,进入组队房间。
+
+### `MAIN_INIT -> MAIN_SEARCH`
+
+首次进入副本后执行初始化:
+
+- 若 `auto_rotate = yes`,进入设置并补充候补式神
+- 点击自动轮换开关
+- 设置 `explore_init = true`
+
+### `MAIN_SEARCH -> BATTLE`
+
+找目标优先级:
+
+1. 若出现小纸人奖励 `I_BATTLE_REWARD`,先领取。
+2. 若出现 Boss 按钮 `I_BOSS_BATTLE_BUTTON`,点击开战。
+3. 查找普通怪按钮,受 `up_type` 配置过滤。
+
+`fire()` 成功后:
+
+- 调用 `run_general_battle()`
+- `minions_cnt += 1`
+
+### `MAIN_SEARCH -> QUIT_EXPLORE`
+
+连续找怪失败 `search_fail_cnt >= 4`,并且满足任一条件:
+
+- 当前章节为第 28 章且出现 `I_SWIPE_END`
+- `_match_end.stable()` 判定已经滑到地图末尾
+
+组队模式下,如果队友标识消失并超过 10 秒,也会进入退出流程。
+
+### `BATTLE -> MAIN_SEARCH`
+
+战斗阶段由 `check_take_over_battle()` 接管。战斗结束后,下一轮截图识别回到 `MAIN` 场景,业务上继续 `MAIN_SEARCH`。
+
+### `QUIT_EXPLORE -> WORLD/ENTRANCE`
+
+`quit_explore()` 持续处理返回、退出确认、战斗奖励等弹窗,直到识别到:
+
+- 探索大地图 `WORLD`
+- 章节入口 `ENTRANCE`
+
+### `UNKNOWN` 恢复
+
+启动阶段如果识别为 `UNKNOWN`:
+
+- 最多执行 2 次安全随机点击
+- 若仍为 `UNKNOWN`,执行 `pre_process()`
+
+运行循环中如果识别为 `UNKNOWN`,当前逻辑是继续截图重试。
+
+## 三种运行模式差异
+
+### 单人模式 `ALONE`
+
+```text
+WORLD -> ENTRANCE -> MAIN_INIT -> MAIN_SEARCH -> BATTLE
+```
+
+特点:
+
+- 自己选择章节
+- 自己开怪
+- 达到次数、时间或绘卷条件后退出
+
+### 队长模式 `LEADER`
+
+```text
+WORLD -> ENTRANCE -> TEAM -> MAIN_INIT -> MAIN_SEARCH -> BATTLE
+```
+
+特点:
+
+- 创建队伍
+- 邀请好友
+- 负责开怪
+- 副本内如果队友标识消失超过 10 秒,退出当前探索
+
+### 队员模式 `MEMBER`
+
+```text
+WORLD -> 等待邀请 -> MAIN_INIT -> MAIN_SEARCH/BATTLE
+```
+
+特点:
+
+- 在探索大地图等待邀请
+- 不主动选择章节开怪
+- 如果队友标识消失超过 10 秒,退出当前探索并回到大地图继续等待
+
+## 可重构方向
+
+当前代码把“画面识别状态”和“业务阶段状态”混在三个循环中。后续如果要显式化状态机,建议拆成两层:
+
+- 画面态:沿用 `Scene`,只负责识别当前 UI 处于哪里。
+- 业务态:新增 `ExplorationPhase`,表达 `MAIN_INIT`、`MAIN_SEARCH`、`QUIT_EXPLORE`、`POST_PROCESS` 等业务阶段。
+
+这样可以减少 `run_solo`、`run_leader`、`run_member` 中重复的副本内逻辑,并把模式差异集中在进入副本前和组队异常处理上。
+

+ 8 - 1
tasks/Exploration/base.py

@@ -57,6 +57,14 @@ class BaseExploration(GameUi, GeneralBattle, GeneralRoom, GeneralInvite, Replace
     def _match_end(self):
     def _match_end(self):
         return RuleAnimate(self.I_SWIPE_END)
         return RuleAnimate(self.I_SWIPE_END)
 
 
+    def is_swipe_unchanged(self, before_image, after_image, threshold: float = 2.0) -> bool:
+        # 对比滑屏前后同一块区域,变化很小说明地图大概率没有移动,已经滑到尽头。
+        before = self.I_SWIPE_END.corp(before_image, self.I_SWIPE_END.roi_front)
+        after = self.I_SWIPE_END.corp(after_image, self.I_SWIPE_END.roi_front)
+        diff = np.mean(np.abs(before.astype(np.int16) - after.astype(np.int16)))
+        logger.info(f'Swipe end area diff: {diff:.2f}')
+        return diff <= threshold
+
     def get_current_scene(self, reuse_screenshot: bool = True) -> Scene:
     def get_current_scene(self, reuse_screenshot: bool = True) -> Scene:
         if not reuse_screenshot:
         if not reuse_screenshot:
             self.screenshot()
             self.screenshot()
@@ -464,4 +472,3 @@ if __name__ == "__main__":
         print(t.get_current_scene())
         print(t.get_current_scene())
     from PIL import Image
     from PIL import Image
     # Image.fromarray(t.device.image.astype(np.uint8)).show()
     # Image.fromarray(t.device.image.astype(np.uint8)).show()
-

+ 59 - 10
tasks/Exploration/solo.py

@@ -28,9 +28,23 @@ class SoloExploration(BaseExploration):
             default_invite=False
             default_invite=False
         )
         )
 
 
+    def _handle_treasure_box(self, roi_back=None) -> bool:
+        original_roi_back = self.I_TREASURE_BOX_CLICK.roi_back
+        if roi_back is not None:
+            self.I_TREASURE_BOX_CLICK.roi_back = roi_back
+        try:
+            if self.appear(self.I_TREASURE_BOX_CLICK):
+                logger.info('Treasure box appear, get it.')
+                self.ui_click_until_disappear(self.I_TREASURE_BOX_CLICK)
+                return True
+            return False
+        finally:
+            self.I_TREASURE_BOX_CLICK.roi_back = original_roi_back
+
     def run_solo(self):
     def run_solo(self):
         logger.hr('solo')
         logger.hr('solo')
         search_fail_cnt = 0
         search_fail_cnt = 0
+        swipe_unchanged_cnt = 0
 
 
         while 1:
         while 1:
             self.screenshot()
             self.screenshot()
@@ -38,19 +52,21 @@ class SoloExploration(BaseExploration):
             logger.info(f'[run_solo] Current scene: {scene.name}')  # TODO 2026.06.22 之后删掉这个刷屏的
             logger.info(f'[run_solo] Current scene: {scene.name}')  # TODO 2026.06.22 之后删掉这个刷屏的
             #
             #
             if scene == Scene.WORLD:
             if scene == Scene.WORLD:
+                swipe_unchanged_cnt = 0
                 # 打开右边箭头
                 # 打开右边箭头
                 if not self.wait_world_stable():
                 if not self.wait_world_stable():
                     continue
                     continue
-                if self.appear(self.I_TREASURE_BOX_CLICK):
-                    # 宝箱
-                    logger.info('Treasure box appear, get it.')
-                    self.ui_click_until_disappear(self.I_TREASURE_BOX_CLICK)
+                # if self.appear(self.I_TREASURE_BOX_CLICK):
+                #     # 宝箱
+                #     logger.info('Treasure box appear, get it.')
+                #     self.ui_click_until_disappear(self.I_TREASURE_BOX_CLICK)
                 if self.check_exit():
                 if self.check_exit():
                     break
                     break
                 self.open_expect_level()
                 self.open_expect_level()
                 continue
                 continue
             #
             #
             elif scene == Scene.ENTRANCE:
             elif scene == Scene.ENTRANCE:
+                swipe_unchanged_cnt = 0
                 if self.check_exit():
                 if self.check_exit():
                     break
                     break
                 self.ui_click(self.I_E_EXPLORATION_CLICK, stop=self.I_E_SETTINGS_BUTTON)
                 self.ui_click(self.I_E_EXPLORATION_CLICK, stop=self.I_E_SETTINGS_BUTTON)
@@ -63,6 +79,8 @@ class SoloExploration(BaseExploration):
                     self.ui_click(self.I_E_AUTO_ROTATE_OFF, stop=self.I_E_AUTO_ROTATE_ON)
                     self.ui_click(self.I_E_AUTO_ROTATE_OFF, stop=self.I_E_AUTO_ROTATE_ON)
                     self.explore_init = True
                     self.explore_init = True
                     continue
                     continue
+                if self._handle_treasure_box(roi_back=(5, 520, 325, 70)):
+                    continue
                 # 小纸人
                 # 小纸人
                 if self.appear(self.I_BATTLE_REWARD):
                 if self.appear(self.I_BATTLE_REWARD):
                     if self.ui_get_reward(self.I_BATTLE_REWARD):
                     if self.ui_get_reward(self.I_BATTLE_REWARD):
@@ -70,23 +88,37 @@ class SoloExploration(BaseExploration):
                 # boss
                 # boss
                 if self.appear(self.I_BOSS_BATTLE_BUTTON):
                 if self.appear(self.I_BOSS_BATTLE_BUTTON):
                     if self.fire(self.I_BOSS_BATTLE_BUTTON):
                     if self.fire(self.I_BOSS_BATTLE_BUTTON):
+                        swipe_unchanged_cnt = 0
                         logger.info(f'Boss battle, minions cnt {self.minions_cnt}')
                         logger.info(f'Boss battle, minions cnt {self.minions_cnt}')
                     continue
                     continue
                 # 小怪
                 # 小怪
                 fight_button = self.search_up_fight()
                 fight_button = self.search_up_fight()
                 if fight_button is not None:
                 if fight_button is not None:
                     if self.fire(fight_button):
                     if self.fire(fight_button):
+                        swipe_unchanged_cnt = 0
                         logger.info(f'Fight, minions cnt {self.minions_cnt}')
                         logger.info(f'Fight, minions cnt {self.minions_cnt}')
                     continue
                     continue
                 # 向后拉,寻找怪
                 # 向后拉,寻找怪
                 if search_fail_cnt >= 4:
                 if search_fail_cnt >= 4:
                     search_fail_cnt = 0
                     search_fail_cnt = 0
-                    if (self._config.exploration_config.exploration_level == ExplorationLevel.EXPLORATION_28\
-                        and self.appear(self.I_SWIPE_END))\
-                            or self._match_end.stable(self.device.image, refresh_after_stable=True):
+                    # I_SWIPE_END 是第 28 章的末尾标识,其他章节不要用它判断退出。
+                    if (
+                            self._config.exploration_config.exploration_level == ExplorationLevel.EXPLORATION_28
+                            and self.appear(self.I_SWIPE_END)
+                    ):
                         self.quit_explore()
                         self.quit_explore()
                         continue
                         continue
+                    before_image = self.device.image.copy()
                     if self.swipe(self.S_SWIPE_BACKGROUND_RIGHT, interval=3):
                     if self.swipe(self.S_SWIPE_BACKGROUND_RIGHT, interval=3):
+                        self.screenshot()
+                        # 单次画面没变化可能是偶发,连续两次滑不动才认为到尽头。
+                        if self.is_swipe_unchanged(before_image, self.device.image):
+                            swipe_unchanged_cnt += 1
+                        else:
+                            swipe_unchanged_cnt = 0
+                        if swipe_unchanged_cnt >= 2:
+                            logger.info('Swipe unchanged twice, quit exploration')
+                            self.quit_explore()
                         continue
                         continue
                 else:
                 else:
                     search_fail_cnt += 1
                     search_fail_cnt += 1
@@ -99,6 +131,7 @@ class SoloExploration(BaseExploration):
     def run_leader(self):
     def run_leader(self):
         logger.hr('leader')
         logger.hr('leader')
         search_fail_cnt = 0
         search_fail_cnt = 0
+        swipe_unchanged_cnt = 0
         friend_leave_timer = Timer(10)
         friend_leave_timer = Timer(10)
 
 
         while 1:
         while 1:
@@ -107,6 +140,7 @@ class SoloExploration(BaseExploration):
             logger.info(f'[run_leader] Current scene: {scene.name}')  # TODO 2026.06.22 之后删掉这个刷屏的
             logger.info(f'[run_leader] Current scene: {scene.name}')  # TODO 2026.06.22 之后删掉这个刷屏的
             # 探索大世界
             # 探索大世界
             if scene == Scene.WORLD:
             if scene == Scene.WORLD:
+                swipe_unchanged_cnt = 0
                 # 打开右边箭头
                 # 打开右边箭头
                 if not self.wait_world_stable():
                 if not self.wait_world_stable():
                     continue
                     continue
@@ -141,6 +175,7 @@ class SoloExploration(BaseExploration):
 
 
             # 邀请好友, 非常有可能是后面邀请好友,然后直接跳到组队了
             # 邀请好友, 非常有可能是后面邀请好友,然后直接跳到组队了
             elif scene == Scene.ENTRANCE:
             elif scene == Scene.ENTRANCE:
+                swipe_unchanged_cnt = 0
                 while 1:
                 while 1:
                     self.screenshot()
                     self.screenshot()
                     if self.is_in_room():
                     if self.is_in_room():
@@ -204,23 +239,37 @@ class SoloExploration(BaseExploration):
                 # boss
                 # boss
                 if self.appear(self.I_BOSS_BATTLE_BUTTON):
                 if self.appear(self.I_BOSS_BATTLE_BUTTON):
                     if self.fire(self.I_BOSS_BATTLE_BUTTON):
                     if self.fire(self.I_BOSS_BATTLE_BUTTON):
+                        swipe_unchanged_cnt = 0
                         logger.info(f'Boss battle, minions cnt {self.minions_cnt}')
                         logger.info(f'Boss battle, minions cnt {self.minions_cnt}')
                     continue
                     continue
                 # 小怪
                 # 小怪
                 fight_button = self.search_up_fight()
                 fight_button = self.search_up_fight()
                 if fight_button is not None:
                 if fight_button is not None:
                     if self.fire(fight_button):
                     if self.fire(fight_button):
+                        swipe_unchanged_cnt = 0
                         logger.info(f'Fight, minions cnt {self.minions_cnt}')
                         logger.info(f'Fight, minions cnt {self.minions_cnt}')
                     continue
                     continue
                 # 向后拉,寻找怪
                 # 向后拉,寻找怪
                 if search_fail_cnt >= 4:
                 if search_fail_cnt >= 4:
                     search_fail_cnt = 0
                     search_fail_cnt = 0
-                    if (self._config.exploration_config.exploration_level == ExplorationLevel.EXPLORATION_28\
-                        and self.appear(self.I_SWIPE_END))\
-                            or self._match_end.stable(self.device.image, refresh_after_stable=True):
+                    # I_SWIPE_END 是第 28 章的末尾标识,其他章节不要用它判断退出。
+                    if (
+                            self._config.exploration_config.exploration_level == ExplorationLevel.EXPLORATION_28
+                            and self.appear(self.I_SWIPE_END)
+                    ):
                         self.quit_explore()
                         self.quit_explore()
                         continue
                         continue
+                    before_image = self.device.image.copy()
                     if self.swipe(self.S_SWIPE_BACKGROUND_RIGHT, interval=4.5):
                     if self.swipe(self.S_SWIPE_BACKGROUND_RIGHT, interval=4.5):
+                        self.screenshot()
+                        # 单次画面没变化可能是偶发,连续两次滑不动才认为到尽头。
+                        if self.is_swipe_unchanged(before_image, self.device.image):
+                            swipe_unchanged_cnt += 1
+                        else:
+                            swipe_unchanged_cnt = 0
+                        if swipe_unchanged_cnt >= 2:
+                            logger.info('Swipe unchanged twice, quit exploration')
+                            self.quit_explore()
                         continue
                         continue
                 else:
                 else:
                     search_fail_cnt += 1
                     search_fail_cnt += 1