feat: 自动战斗支持切换后援

Author: kawayiYokami

assets/game_data/screen_info/_od_merged.yml

@@ -408,6 +408,20 @@
     template_match_threshold: 0.7
     color_range: null
     goto_list: []
+  - area_name: 按键-切换后援
+    id_mark: false
+    pc_rect:
+    - 1615
+    - 776
+    - 1726
+    - 877
+    text: ''
+    lcs_percent: 0.5
+    template_sub_dir: battle
+    template_id: btn_switch_backup_1
+    template_match_threshold: 0.7
+    color_range: null
+    goto_list: []
   - area_name: 连携技-1
     id_mark: false
     pc_rect:
@@ -675,6 +689,20 @@
     template_match_threshold: 0.7
     color_range: null
     goto_list: []
+  - area_name: 按键-切换后援标记
+    id_mark: false
+    pc_rect:
+    - 1658
+    - 891
+    - 1661
+    - 897
+    text: ''
+    lcs_percent: 0.5
+    template_sub_dir: ''
+    template_id: ''
+    template_match_threshold: 0.7
+    color_range: null
+    goto_list: []
 - screen_id: battle_menu
   screen_name: 战斗-菜单
   pc_alt: false
@@ -1297,20 +1325,41 @@
     - 770
     - 1110
     - 830
+    text: ''
+    lcs_percent: null
+    template_sub_dir: ''
+    template_id: ''
+    template_match_threshold: null
+    color_range: null
+    goto_list: []
   - area_name: 对话框内容
     id_mark: false
     pc_rect:
     - 418
     - 831
     - 1500
     - 980
+    text: ''
+    lcs_percent: null
+    template_sub_dir: ''
+    template_id: ''
+    template_match_threshold: null
+    color_range: null
+    goto_list: []
   - area_name: 右侧选项区域
     id_mark: false
     pc_rect:
     - 1438
     - 536
     - 1914
     - 830
+    text: ''
+    lcs_percent: null
+    template_sub_dir: ''
+    template_id: ''
+    template_match_threshold: null
+    color_range: null
+    goto_list: []
   - area_name: 中间选项区域
     id_mark: false
     pc_rect:
@@ -1402,6 +1451,13 @@
     - 213
     - 565
     - 285
+    text: ''
+    lcs_percent: null
+    template_sub_dir: ''
+    template_id: ''
+    template_match_threshold: null
+    color_range: null
+    goto_list: []
   - area_name: 按钮-短信-关闭
     id_mark: false
     pc_rect:

assets/game_data/screen_info/battle.yml

@@ -44,6 +44,20 @@ area_list:
   template_match_threshold: 0.7
   color_range: null
   goto_list: []
+- area_name: 按键-切换后援
+  id_mark: false
+  pc_rect:
+  - 1615
+  - 776
+  - 1726
+  - 877
+  text: ''
+  lcs_percent: 0.5
+  template_sub_dir: battle
+  template_id: btn_switch_backup_1
+  template_match_threshold: 0.7
+  color_range: null
+  goto_list: []
 - area_name: 连携技-1
   id_mark: false
   pc_rect:
@@ -311,3 +325,17 @@ area_list:
   template_match_threshold: 0.7
   color_range: null
   goto_list: []
+- area_name: 按键-切换后援标记
+  id_mark: false
+  pc_rect:
+  - 1658
+  - 891
+  - 1661
+  - 897
+  text: ''
+  lcs_percent: 0.5
+  template_sub_dir: ''
+  template_id: ''
+  template_match_threshold: 0.7
+  color_range: null
+  goto_list: []

assets/template/battle/btn_switch_backup_1/mask.png

@@ -12206,6 +12206,10 @@
       - "op_name": "等待秒数"
         "seconds": 0.1
       "states": "([按键-切换角色-下一个, 0, 0.1] | [按键-切换角色-上一个, 0, 0.1]) | [自定义-连携跳过, 0, 0.1]"
+    - "debug_name": "切换后援可用"
+      "operations":
+      - "op_name": "按键-切换后援"
+      "states": "[按键可用-切换后援, 0, 1] & ![按键-切换后援, 0, 2]"
   - "states": ""
     "sub_handlers":
     - "interrupt_states": "[前台-能量, 0, 0.1] & ![前台-莱卡恩]"

assets/template/battle/btn_switch_backup_1/raw.png

@@ -128,6 +128,17 @@ scenes:
         sub_handlers:
           - state_template: "轮换-合轴-全角色"
 
+  - triggers: ["按键可用-切换后援"]
+    priority: 70
+    interval: 0.1
+    handlers:
+      - states: "![自定义-终结技被强制释放, 0, 1]"
+        debug_name: "切换后援可用"
+        operations:
+          - op_name: "按键-切换后援"
+          - op_name: "等待秒数"
+            seconds: 0.1
+
   - triggers: []
     priority: 9
     interval: 0.02

assets/template/battle/btn_switch_backup_2/mask.png

@@ -0,0 +1,23 @@
+# 自动战斗补充说明
+
+## 队伍角色识别兜底
+
+自动战斗中的队伍角色识别，原本会在连续多次识别结果一致后，停止全量匹配，转为基于当前队伍信息的低成本识别。
+
+当游戏内出现同一队伍在战斗中循环切换的新模式时，旧的低成本识别可能会因为候选角色被固定，导致当前画面一个角色都识别不到。
+
+针对这个场景，当前实现增加了一个兜底策略：
+
+- 当普通攻击按钮可用，说明当前仍处于战斗画面。
+- 如果这一帧角色识别结果为“一个角色都识别不到”，则不立即常驻开启全量识别。
+- 仅将下一次角色识别强制切回“全量匹配所有角色”，并重置识别节流时间。
+
+这样可以在兼容新模式的同时，尽量减少常规战斗中的模板匹配压力。
+
+## 战斗按钮提示
+
+战斗画面中的部分按钮会通过模板匹配写入状态，供自动战斗状态判断与调试提示使用。
+
+- 普通攻击按钮用于快速判断当前是否仍处于战斗画面。
+- 切换后援按钮每 1 秒检测一次，识别命中时会写入状态 `按键可用-切换后援`。
+- 自动战斗可直接执行原子操作 `按键-切换后援`，默认键盘键位为 `R`。

assets/template/battle/btn_switch_backup_2/raw.png

@@ -2,8 +2,9 @@
 
 import threading
 import time
-from enum import StrEnum, IntEnum
-from typing import TYPE_CHECKING, Callable
+from collections.abc import Callable
+from enum import IntEnum, StrEnum
+from typing import TYPE_CHECKING
 
 from one_dragon.base.conditional_operation.atomic_op import AtomicOp
 from one_dragon.base.conditional_operation.operation_def import OperationDef
@@ -62,6 +63,8 @@ def __init__(self, ctx: AutoBattleContext, op_def: OperationDef):
             self._method = self.ctx.switch_next
         elif op_name == BattleStateEnum.BTN_SWITCH_PREV.value:
             self._method = self.ctx.switch_prev
+        elif op_name == BattleStateEnum.BTN_SWITCH_BACKUP.value:
+            self._method = self.ctx.switch_backup
         elif op_name == BattleStateEnum.BTN_SWITCH_NORMAL_ATTACK.value:
             self._method = self.ctx.normal_attack
         elif op_name == BattleStateEnum.BTN_SWITCH_SPECIAL_ATTACK.value:
@@ -93,7 +96,7 @@ def execute(self):
                 return
             self._status = BtnRunStatus.RUNNING
 
-        for i in range(self.repeat_times):
+        for _i in range(self.repeat_times):
             if self._status != BtnRunStatus.RUNNING:
                 break