autowsgr 2.0.4.dev1__tar.gz → 2.1.0__tar.gz

{autowsgr-2.0.4.dev1/autowsgr.egg-info → autowsgr-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autowsgr
-Version: 2.0.4.dev1
+Version: 2.1.0
 Summary: Auto Warship Girls Framework.
 License: MIT
 Project-URL: Homepage, https://github.com/OpenWSGR/AutoWSGR
@@ -21,11 +21,14 @@ Requires-Dist: opencv-python
 Requires-Dist: loguru
 Requires-Dist: keyboard
 Requires-Dist: easyocr>=1.7.1
-Requires-Dist: airtest-openwsgr>=1.3.9
+Requires-Dist: adbutils<3.0,>=2.0
+Requires-Dist: av>=12.0
 Requires-Dist: pydantic<3.0,>=2.0
 Requires-Dist: fastapi>=0.100.0
 Requires-Dist: uvicorn[standard]>=0.23.0
 Requires-Dist: websockets>=11.0
+Provides-Extra: airtest
+Requires-Dist: airtest-openwsgr>=1.3.9; extra == "airtest"
 Dynamic: license-file
 
 <div align=center>

{autowsgr-2.0.4.dev1 → autowsgr-2.1.0}/autowsgr/__init__.py

@@ -1,3 +1,3 @@
 """AutoWSGR — 战舰少女R 自动化框架 (v2)"""
 
-__version__ = '2.0.4.dev1'
+__version__ = '2.1.0'

{autowsgr-2.0.4.dev1 → autowsgr-2.1.0}/autowsgr/combat/handlers.py

@@ -220,6 +220,7 @@ class PhaseHandlersMixin:
         # 执行迂回
         if want_detour:
             clicked = click_image(self._device, TemplateKey.BYPASS, 2.5)
+            time.sleep(1.5)
             if clicked:
                 _log.info('[Combat] 执行迂回')
             else:

{autowsgr-2.0.4.dev1 → autowsgr-2.1.0}/autowsgr/combat/node_tracker.py

@@ -21,7 +21,7 @@ from typing import Any
 
 import cv2
 import numpy as np
-
+from autowsgr.infra import save_image
 from autowsgr.infra.logger import get_logger
 from autowsgr.vision import (
     MatchStrategy,
@@ -59,9 +59,9 @@ class NodePosition:
     name:
         节点标识符（如 ``"A"``、``"B"``）。
     x:
-        节点 x 坐标（相对值 0.0–1.0）。
+        节点 x 坐标（相对值 0.0-1.0）。
     y:
-        节点 y 坐标（相对值 0.0–1.0）。
+        节点 y 坐标（相对值 0.0-1.0）。
     next_nodes:
         从该节点可以到达的下一个节点名列表。
         仅在新格式 YAML 中提供；旧格式为空列表。
@@ -332,7 +332,7 @@ class NodeTracker:
         center = self._find_yellow_cluster(screen)
         if center is None:
             return None
-
+        save_image(screen, 'debug_node_tracker_cluster.png')
         if self._recheck_pixel(center, screen):
             self._ship_position = center
             _log.debug(

{autowsgr-2.0.4.dev1 → autowsgr-2.1.0}/autowsgr/combat/recognition.py

@@ -26,7 +26,7 @@ if TYPE_CHECKING:
 
 
 # ═══════════════════════════════════════════════════════════════════════════════
-# 常量 — 扫描区域 (960×540 绝对像素, L/T/R/B)
+# 常量 — 扫描区域 (960x540 绝对像素, L/T/R/B)
 # ═══════════════════════════════════════════════════════════════════════════════
 
 # 移植自 autowsgr_legacy/constants/positions.py TYPE_SCAN_AREA
@@ -38,7 +38,7 @@ _SCAN_AREA_EXERCISE: list[tuple[int, int, int, int]] = [
     (690, 312, 722, 328),
     (793, 312, 825, 328),
 ]
-"""演习界面的 6 个舰类图标扫描区域 (960×540)。"""
+"""演习界面的 6 个舰类图标扫描区域 (960x540)。"""
 
 _SCAN_AREA_FIGHT: list[tuple[int, int, int, int]] = [
     (39, 156, 71, 172),
@@ -48,7 +48,7 @@ _SCAN_AREA_FIGHT: list[tuple[int, int, int, int]] = [
     (39, 334, 71, 350),
     (322, 334, 354, 350),
 ]
-"""索敌成功界面的 6 个舰类图标扫描区域 (960×540, 2 列×3 行)。"""
+"""索敌成功界面的 6 个舰类图标扫描区域 (960x540, 2 列x3 行)。"""
 
 _SCAN_AREAS: dict[str, list[tuple[int, int, int, int]]] = {
     'exercise': _SCAN_AREA_EXERCISE,
@@ -87,7 +87,7 @@ RESULT_BLOOD_BAR_PROBE: dict[int, tuple[float, float]] = {
     4: (60 / 960, 442 / 540),
     5: (60 / 960, 517 / 540),
 }
-"""战斗结算页 6 个舰船血条探测点 (0-indexed)。归一化坐标：原始绝对坐标 (60, y) 基于 960×540。"""
+"""战斗结算页 6 个舰船血条探测点 (0-indexed)。归一化坐标：原始绝对坐标 (60, y) 基于 960x540。"""
 
 
 # ═══════════════════════════════════════════════════════════════════════════════
@@ -105,7 +105,7 @@ def recognize_enemy_ships(
 
     复用旧代码稳定的 C++ DLL 方案:
 
-    1. 将截图缩放到 960×540 并转灰度
+    1. 将截图缩放到 960x540 并转灰度
     2. 按 ``TYPE_SCAN_AREA`` 裁切 6 张舰类图标缩略图
     3. 送入 ``ApiDll.recognize_enemy()`` 获得类型字符串
     4. 统计各类型数量
@@ -113,7 +113,7 @@ def recognize_enemy_ships(
     Parameters
     ----------
     screen:
-        当前截图 (H×W×3, RGB/BGR)。
+        当前截图 (HxWx3, RGB/BGR)。
     mode:
         识别模式: ``"fight"`` (索敌成功, 默认) 或 ``"exercise"`` (演习)。
     dll:
@@ -132,7 +132,7 @@ def recognize_enemy_ships(
     if areas is None:
         raise ValueError(f'不支持的模式: {mode!r}，可选: {list(_SCAN_AREAS)}')
 
-    # 转换为 960×540 灰度
+    # 转换为 960x540 灰度
     img = Image.fromarray(screen).convert('L')
     img = img.resize((960, 540))
     img_arr = np.array(img)
@@ -177,7 +177,7 @@ def recognize_enemy_formation(
     Parameters
     ----------
     screen:
-        当前截图 (H×W×3)。
+        当前截图 (HxWx3)。
     ocr:
         OCR 引擎实例。
 

{autowsgr-2.0.4.dev1 → autowsgr-2.1.0}/autowsgr/context/expedition.py

@@ -23,9 +23,9 @@ class Expedition:
     """
 
     chapter: int = 0
-    """远征章节 (1–9)。"""
+    """远征章节 (1-9)。"""
     node: int = 0
-    """远征节点 (1–4)。"""
+    """远征节点 (1-4)。"""
     fleet: Fleet | None = None
     """执行远征的舰队；``None`` 表示该槽位空闲。"""
     start_time: float | None = None

{autowsgr-2.0.4.dev1 → autowsgr-2.1.0}/autowsgr/context/fleet.py

@@ -16,12 +16,12 @@ if TYPE_CHECKING:
 class Fleet:
     """一支舰队（最多 6 艘舰船）。
 
-    游戏共 4 支舰队 (fleet_id 1–4)。
+    游戏共 4 支舰队 (fleet_id 1-4)。
     第 3 舰队需通关 1-3，第 4 舰队需通关 2-3 后解锁。
     """
 
     fleet_id: int = 1
-    """舰队编号 (1–4)。"""
+    """舰队编号 (1-4)。"""
     ships: list[Ship] = field(default_factory=list)
     """舰队成员（索引 0 为旗舰）。"""
 

{autowsgr-2.0.4.dev1 → autowsgr-2.1.0}/autowsgr/context/game_context.py

@@ -66,7 +66,7 @@ class GameContext:
     resources: Resources = field(default_factory=Resources)
     """当前资源。"""
     fleets: list[Fleet] = field(default_factory=_default_fleets)
-    """四支舰队 (fleet_id 1–4)。"""
+    """四支舰队 (fleet_id 1-4)。"""
     expeditions: ExpeditionQueue = field(default_factory=ExpeditionQueue)
     """远征队列。"""
     build_queue: BuildQueue = field(default_factory=BuildQueue)
@@ -89,7 +89,7 @@ class GameContext:
     # ── 便捷访问 ──
 
     def fleet(self, fleet_id: int) -> Fleet:
-        """按编号 (1–4) 获取舰队。"""
+        """按编号 (1-4) 获取舰队。"""
         if not 1 <= fleet_id <= len(self.fleets):
-            raise ValueError(f'fleet_id 应在 1–{len(self.fleets)} 范围内，收到 {fleet_id}')
+            raise ValueError(f'fleet_id 应在 1-{len(self.fleets)} 范围内，收到 {fleet_id}')
         return self.fleets[fleet_id - 1]

{autowsgr-2.0.4.dev1 → autowsgr-2.1.0}/autowsgr/context/ship.py

@@ -42,7 +42,7 @@ class Ship:
 
     @property
     def health_ratio(self) -> float:
-        """当前耐久比例 (0.0–1.0)；*max_health* 未知时返回 1.0。"""
+        """当前耐久比例 (0.0-1.0)；*max_health* 未知时返回 1.0。"""
         if self.max_health <= 0:
             return 1.0
         return self.health / self.max_health

{autowsgr-2.0.4.dev1/autowsgr_legacy/data/plans → autowsgr-2.1.0/autowsgr/data/plan}/normal_fight/2-1/346/215/236/350/203/226/346/254/241.yaml

@@ -11,7 +11,7 @@ repair_mode: 1 #维修策略：1为中破就修，2为大破就修
 node_defaults:
   # 索敌成功阶段
   enemy_rules:
-    - [SAP != 1, retreat]
+    - [AP != 1, retreat]
   # 阵型选择阶段
   SL_when_spot_enemy_fails: True # 索敌失败时是否SL
   formation: 4 # 正常情况阵型选择，1-5

{autowsgr-2.0.4.dev1 → autowsgr-2.1.0}/autowsgr/data/plan/normal_fight/7-4/345/215/203/344/274/252.yaml

@@ -25,9 +25,9 @@ node_defaults:
 node_args:
   M:
     enemy_rules:
-      - [SAP < 1, retreat]
+      - [AP < 1, retreat]
     formation: 4 # 阵型选择，1-5
     night: True
   I:
     enemy_rules:
-      - [SAP < 1, retreat]
+      - [AP < 1, retreat]

{autowsgr-2.0.4.dev1 → autowsgr-2.1.0}/autowsgr/data/plan/normal_fight/7-4/350/203/226/346/254/241.yaml

@@ -28,10 +28,10 @@ node_args:
       - [DD + CL >= 3, retreat]
   M:
     enemy_rules:
-      - [SAP < 1, retreat]
+      - [AP < 1, retreat]
 
     formation: 4 # 阵型选择，1-5
     night: True
   I:
     enemy_rules:
-      - [SAP < 1, retreat]
+      - [AP < 1, retreat]

{autowsgr-2.0.4.dev1 → autowsgr-2.1.0}/autowsgr/data/plan/normal_fight/8-2BJ.yaml

@@ -20,7 +20,7 @@ node_args:
     proceed: True
   J:
     enemy_rules:
-      - ["SAP<1", "retreat"] # 不存在补给舰时撤退
+      - ["AP<1", "retreat"] # 不存在补给舰时撤退
     SL_when_spot_enemy_fails: True
     formation: 4
     night: False

{autowsgr-2.0.4.dev1 → autowsgr-2.1.0}/autowsgr/data/plan/normal_fight/9-1BF/347/202/270/351/261/274/345/270/246/346/215/236/350/203/226/346/254/241.yaml

@@ -21,7 +21,7 @@ node_args:
     proceed_stop: [2, 2, 2, 2, 2, 2]
   F:
     enemy_rules:
-      - [SAP != 1, retreat]
+      - [AP != 1, retreat]
     formation: 5
     night: True
     proceed: False

{autowsgr-2.0.4.dev1/autowsgr_legacy/data/plans → autowsgr-2.1.0/autowsgr/data/plan}/normal_fight/9-2ADGHM.yaml

@@ -12,7 +12,7 @@ repair_mode: 1   #1中破修，2大破修
 # NodeLevel
 node_defaults:
   enemy_rules:
-    - [SAP != 1, detour]
+    - [AP != 1, detour]
   formation: 2 # 正常情况阵型选择, 1-5
   # 夜战选择阶段
   night: False # 是否夜战
@@ -24,5 +24,5 @@ node_defaults:
 node_args:
   M:
     enemy_rules:
-    - [SAP != 1, detour]
+    - [AP != 1, detour]
     proceed: False # 结束后是否继续

{autowsgr-2.0.4.dev1 → autowsgr-2.1.0}/autowsgr/data/plan/normal_fight/9-2/350/203/226/346/254/24185/345/267/245/347/250/213.yaml

@@ -10,7 +10,7 @@ repair_mode: 2   #1中破修，2大破修
 # NodeLevel
 node_defaults:
   enemy_rules:
-    - [SAP != 1, detour]
+    - [AP != 1, detour]
   formation: 4 # 正常情况阵型选择, 1-5
   night: False # 是否夜战
   SL_when_detour_fails: True # 是否迂回失败后退出
@@ -20,8 +20,8 @@ node_defaults:
 node_args:
   M:
     enemy_rules:
-    - [SAP != 1, retreat]
+    - [AP != 1, retreat]
     proceed: False # 结束后是否继续
   E:
     enemy_rules:
-    - [SAP != 1, retreat]
+    - [AP != 1, retreat]

{autowsgr-2.0.4.dev1/autowsgr_legacy/data/plans → autowsgr-2.1.0/autowsgr/data/plan}/normal_fight/9-2/350/203/226/346/254/24185/346/227/240/351/227/250/347/245/236.yaml

@@ -10,7 +10,7 @@ repair_mode: 2   #1中破修，2大破修
 # NodeLevel
 node_defaults:
   enemy_rules:
-    - [SAP != 1, detour]
+    - [AP != 1, detour]
   formation: 4 # 正常情况阵型选择, 1-5
   night: False # 是否夜战
   SL_when_detour_fails: True # 是否迂回失败后退出
@@ -20,8 +20,8 @@ node_defaults:
 node_args:
   H:
     enemy_rules:
-    - [SAP != 1, retreat]
+    - [AP != 1, retreat]
     proceed: False # 结束后是否继续
   E:
     enemy_rules:
-    - [SAP != 1, retreat]
+    - [AP != 1, retreat]

{autowsgr-2.0.4.dev1 → autowsgr-2.1.0}/autowsgr/emulator/__init__.py

@@ -4,7 +4,7 @@
 
 1. **设备控制** (`AndroidController` / `ADBController`)：
    截图、点击、滑动、按键、应用管理等纯设备操作。
-   所有触控坐标使用相对值 (0.0–1.0)。
+   所有触控坐标使用相对值 (0.0-1.0)。
 
 2. **进程管理** (`EmulatorProcessManager` / `create_emulator_manager`)：
    在宿主操作系统上启动、停止、检测模拟器进程。
@@ -14,6 +14,7 @@ from .controller import (
     ADBController,
     AndroidController,
     DeviceInfo,
+    ScrcpyController,
 )
 from .detector import (
     EmulatorCandidate,
@@ -31,19 +32,17 @@ from .os_control import (
 
 
 __all__ = [
-    # controller
-    'AndroidController',
     'ADBController',
+    'AndroidController',
     'DeviceInfo',
-    # detector
     'EmulatorCandidate',
-    'detect_emulators',
-    'prompt_user_select',
-    'resolve_serial',
-    # os_control
     'EmulatorProcessManager',
-    'WindowsEmulatorManager',
-    'MacEmulatorManager',
     'LinuxEmulatorManager',
+    'MacEmulatorManager',
+    'ScrcpyController',
+    'WindowsEmulatorManager',
     'create_emulator_manager',
+    'detect_emulators',
+    'prompt_user_select',
+    'resolve_serial',
 ]

autowsgr-2.1.0/autowsgr/emulator/controller/__init__.py

@@ -0,0 +1,33 @@
+"""Android 设备控制器 — 模拟器层核心。
+
+提供纯粹的设备操作能力（截图、点击、滑动、按键、应用管理），
+**不做**任何图像识别、页面判定或游戏逻辑。
+
+所有触控坐标使用 **相对值** (0.0-1.0)：
+
+- 左上角 = (0.0, 0.0)
+- 右下角趋近 (1.0, 1.0)
+- 内部自动根据实际分辨率转换为像素坐标
+
+使用方式::
+
+    from autowsgr.emulator.controller import ADBController
+
+    ctrl = ADBController(serial="emulator-5554")
+    info = ctrl.connect()
+    screen = ctrl.screenshot()
+    ctrl.click(0.5, 0.5)
+    ctrl.disconnect()
+"""
+
+from .adb import ADBController
+from .protocol import AndroidController, DeviceInfo
+from .scrcpy import ScrcpyController
+
+
+__all__ = [
+    'ADBController',
+    'AndroidController',
+    'DeviceInfo',
+    'ScrcpyController',
+]

autowsgr-2.0.4.dev1/autowsgr/emulator/controller.py → autowsgr-2.1.0/autowsgr/emulator/controller/adb.py

@@ -1,13 +1,4 @@
-"""Android 设备控制器 — 模拟器层核心。
-
-提供纯粹的设备操作能力（截图、点击、滑动、按键、应用管理），
-**不做**任何图像识别、页面判定或游戏逻辑。
-
-所有触控坐标使用 **相对值** (0.0–1.0)：
-
-- 左上角 = (0.0, 0.0)
-- 右下角趋近 (1.0, 1.0)
-- 内部自动根据实际分辨率转换为像素坐标
+"""ADB 设备控制器 — 基于 Airtest / ADB 的具体实现。
 
 使用方式::
 
@@ -25,8 +16,6 @@ from __future__ import annotations
 import subprocess
 import sys
 import time
-from abc import ABC, abstractmethod
-from dataclasses import dataclass
 from typing import TYPE_CHECKING
 
 import cv2
@@ -37,7 +26,8 @@ from airtest.core.error import AdbError, DeviceConnectionError
 from autowsgr.infra import EmulatorConfig, EmulatorConnectionError
 from autowsgr.infra.logger import caller_info, get_logger
 
-from .detector import _find_adb, detect_emulators, prompt_user_select, resolve_serial
+from ..detector import _find_adb, detect_emulators, prompt_user_select, resolve_serial
+from .protocol import AndroidController, DeviceInfo
 
 
 if TYPE_CHECKING:
@@ -106,172 +96,6 @@ def _kill_adb_process(adb_path: str | None = None) -> None:
         _log.debug('[Emulator] adb start-server 失败（连接时会自动启动）: {}', exc)
 
 
-@dataclass(frozen=True, slots=True)
-class DeviceInfo:
-    """已连接设备的基本信息。
-
-    Attributes
-    ----------
-    serial:
-        ADB serial 地址。
-    resolution:
-        设备屏幕分辨率 ``(width, height)``。
-    """
-
-    serial: str
-    resolution: tuple[int, int]
-
-
-class AndroidController(ABC):
-    """Android 设备控制器抽象基类。
-
-    仅负责设备操作，不做任何图像识别。
-    子类实现具体连接方式（ADB / Minitouch 等）。
-    """
-
-    # ── 连接管理 ──
-
-    @abstractmethod
-    def connect(self) -> DeviceInfo:
-        """连接设备，返回设备信息。
-
-        Raises
-        ------
-        EmulatorConnectionError
-            连接失败时抛出。
-        """
-        ...
-
-    @abstractmethod
-    def disconnect(self) -> None:
-        """断开设备连接。"""
-        ...
-
-    @property
-    @abstractmethod
-    def resolution(self) -> tuple[int, int]:
-        """设备屏幕分辨率 ``(width, height)``。"""
-        ...
-
-    # ── 截图 ──
-
-    @abstractmethod
-    def screenshot(self) -> np.ndarray:
-        """截取当前屏幕，返回 RGB uint8 数组 ``(H, W, 3)``。
-
-        Raises
-        ------
-        EmulatorConnectionError
-            截图超时或设备无响应。
-        """
-        ...
-
-    # ── 触控 ──
-
-    @abstractmethod
-    def click(self, x: float, y: float) -> None:
-        """点击屏幕。
-
-        Parameters
-        ----------
-        x, y:
-            相对坐标 (0.0–1.0)。
-        """
-        ...
-
-    @abstractmethod
-    def swipe(
-        self,
-        x1: float,
-        y1: float,
-        x2: float,
-        y2: float,
-        duration: float = 0.5,
-    ) -> None:
-        """滑动。
-
-        Parameters
-        ----------
-        x1, y1:
-            起始相对坐标。
-        x2, y2:
-            终止相对坐标。
-        duration:
-            滑动持续时间（秒）。
-        """
-        ...
-
-    @abstractmethod
-    def long_tap(self, x: float, y: float, duration: float = 1.0) -> None:
-        """长按。
-
-        Parameters
-        ----------
-        x, y:
-            相对坐标。
-        duration:
-            按住时间（秒）。
-        """
-        ...
-
-    # ── 按键 ──
-
-    @abstractmethod
-    def key_event(self, key_code: int) -> None:
-        """发送 Android KeyEvent。
-
-        Parameters
-        ----------
-        key_code:
-            Android KeyEvent 键值（如 3 = HOME, 4 = BACK）。
-        """
-        ...
-
-    @abstractmethod
-    def text(self, content: str) -> None:
-        """输入文本。
-
-        Parameters
-        ----------
-        content:
-            要输入的文本。
-        """
-        ...
-
-    # ── 应用管理 ──
-
-    @abstractmethod
-    def start_app(self, package: str) -> None:
-        """启动 Android 应用。
-
-        Parameters
-        ----------
-        package:
-            应用包名。
-        """
-        ...
-
-    @abstractmethod
-    def stop_app(self, package: str) -> None:
-        """停止 Android 应用。"""
-        ...
-
-    @abstractmethod
-    def is_app_running(self, package: str) -> bool:
-        """检查应用是否在前台运行。"""
-        ...
-
-    # ── Shell ──
-
-    @abstractmethod
-    def shell(self, cmd: str) -> str:
-        """执行 ADB shell 命令并返回 stdout。"""
-        ...
-
-
-# ── ADB 实现 ──
-
-
 class ADBController(AndroidController):
     """基于 Airtest / ADB 的 Android 设备控制器。
 
@@ -321,12 +145,7 @@ class ADBController(AndroidController):
                 resolved = prompt_user_select(candidates)
         self._serial = resolved or None
 
-        # 使用 javacap 截图（minicap 在 Android 12+ x86_64 模拟器上不可用）
-        uri = (
-            f'Android:///{resolved}?cap_method=javacap'
-            if resolved
-            else 'Android:///?cap_method=javacap'
-        )
+        uri = f'Android:///{resolved}' if resolved else 'Android:///'
 
         self._connect_with_retry(uri)
         assert self._device is not None  # _try_connect 成功后保证非 None
@@ -369,6 +188,9 @@ class ADBController(AndroidController):
         except Exception as exc:
             _log.warning('[Emulator] 分辨率校验截图失败，使用 display_info 值: {}', exc)
 
+        # ── 禁止 ADBCAP 降级：性能过低（~3 fps），无法满足自动化需求 ──
+        self._reject_adbcap()
+
         _log.info('[Emulator] 已连接设备: {} ({}x{})', self._serial or 'auto', *self._resolution)
         return DeviceInfo(
             serial=self._serial or 'auto',
@@ -377,6 +199,23 @@ class ADBController(AndroidController):
 
     # ── 内部连接辅助 ──
 
+    def _reject_adbcap(self) -> None:
+        """检测截图方式，若降级到 ADBCAP 则直接报错终止。"""
+        proxy = getattr(self._device, '_screen_proxy', None)
+        if proxy is None:
+            return
+        method = getattr(proxy, 'method_name', '')
+        if method == 'ADBCAP':
+            raise EmulatorConnectionError(
+                'MINICAP 和 JAVACAP 均不可用，已被降级到 ADBCAP (~3 fps)。\n'
+                'AutoWSGR 要求高性能截图，拒绝以 ADBCAP 模式运行。\n'
+                '排查方法：\n'
+                '  1) 尝试使用 Android 9/11 版本的模拟器（minicap 兼容性更好）\n'
+                '  2) 换用 MuMu 等其他模拟器（javacap 兼容性可能更好）\n'
+                '  3) pip install --upgrade airtest 更新 Airtest'
+            )
+        _log.info('[Emulator] 截图方式: {}', method)
+
     def _try_connect(self, uri: str, *, kill_first: bool = False) -> None:
         """尝试建立设备连接（单次，不重试）。
 
@@ -594,7 +433,7 @@ class ADBController(AndroidController):
     def is_app_running(self, package: str) -> bool:
         try:
             dev = self._require_device()
-            ps_output = dev.shell('ps')
+            ps_output = dev.shell('ps -A')
         except (AdbError, DeviceConnectionError, EmulatorConnectionError) as exc:
             _log.debug(
                 "[Emulator] is_app_running('{}') → False (设备异常: {})  {}",