ksaa 2025.6.8.0__py3-none-any.whl → 2025.6.28.0__py3-none-any.whl

kotonebot/kaa/main/kaa.py

@@ -1,21 +1,33 @@
 import io
 import os
+from typing import Any, Literal, cast
+import zipfile
 import logging
-import importlib.metadata
 import traceback
-import zipfile
+import importlib.metadata
 from datetime import datetime
+from typing_extensions import override
 
 import cv2
-from typing_extensions import override
 
-from .dmm_host import DmmHost
+from kotonebot.client.host.mumu12_host import MuMu12HostConfig
+
 from ...client import Device
 from kotonebot.ui import user
 from kotonebot import KotoneBot
+from ..util.paths import get_ahk_path
 from ..kaa_context import _set_instance
+from .dmm_host import DmmHost, DmmInstance
 from ..common import BaseConfig, upgrade_config
-from kotonebot.client.host import Mumu12Host, LeidianHost
+from kotonebot.config.base_config import UserConfig
+from kotonebot.client.host import (
+    Mumu12Host, LeidianHost, Mumu12Instance,
+    LeidianInstance, CustomInstance
+)
+from kotonebot.client.host.protocol import (
+    Instance, AdbHostConfig, WindowsHostConfig,
+    RemoteWindowsHostConfig
+)
 
 # 初始化日志
 log_formatter = logging.Formatter('[%(asctime)s][%(levelname)s][%(name)s] %(message)s')
@@ -103,24 +115,32 @@ class Kaa(KotoneBot):
         if self.backend_instance is None:
             raise ValueError('Backend instance is not set.')
         _set_instance(self.backend_instance)
+        from kotonebot import device
+        logger.info('Set target resolution to 720x1280.')
+        device.orientation = 'portrait'
+        device.target_resolution = (720, 1280)
 
-    @override
-    def _on_create_device(self) -> Device:
+    def __get_backend_instance(self, config: UserConfig) -> Instance:
+        """
+        根据配置获取或创建 Instance。
+
+        :param config: 用户配置对象
+        :return: 后端实例
+        """
         from kotonebot.client.host import create_custom
-        from kotonebot.config.manager import load_config
-        # HACK: 硬编码
-        config = load_config(self.config_path, type=self.config_type)
-        config = config.user_configs[0]
-        logger.info('Checking backend...')
+
+        logger.info(f'Querying for backend: {config.backend.type}')
+
         if config.backend.type == 'custom':
             exe = config.backend.emulator_path
-            self.backend_instance = create_custom(
+            instance = create_custom(
                 adb_ip=config.backend.adb_ip,
                 adb_port=config.backend.adb_port,
                 adb_name=config.backend.adb_emulator_name,
                 exe_path=exe,
                 emulator_args=config.backend.emulator_args
             )
+            # 对于 custom 类型，需要额外验证模拟器路径
             if config.backend.check_emulator:
                 if exe is None:
                     user.error('「检查并启动模拟器」已开启但未配置「模拟器 exe 文件路径」。')
@@ -128,42 +148,121 @@ class Kaa(KotoneBot):
                 if not os.path.exists(exe):
                     user.error('「模拟器 exe 文件路径」对应的文件不存在！请检查路径是否正确。')
                     raise FileNotFoundError(f'Emulator executable not found: {exe}')
-                if not self.backend_instance.running():
-                    logger.info('Starting custom backend...')
-                    self.backend_instance.start()
-                    logger.info('Waiting for custom backend to be available...')
-                    self.backend_instance.wait_available()
-                else:
-                    logger.info('Custom backend "%s" already running.', self.backend_instance)
+            return instance
+
         elif config.backend.type == 'mumu12':
             if config.backend.instance_id is None:
                 raise ValueError('MuMu12 instance ID is not set.')
-            self.backend_instance = Mumu12Host.query(id=config.backend.instance_id)
-            if self.backend_instance is None:
+            instance = Mumu12Host.query(id=config.backend.instance_id)
+            if instance is None:
                 raise ValueError(f'MuMu12 instance not found: {config.backend.instance_id}')
-            if not self.backend_instance.running():
-                logger.info('Starting MuMu12 backend...')
-                self.backend_instance.start()
-                logger.info('Waiting for MuMu12 backend to be available...')
-                self.backend_instance.wait_available()
-            else:
-                logger.info('MuMu12 backend "%s" already running.', self.backend_instance)
+            return instance
+
         elif config.backend.type == 'leidian':
             if config.backend.instance_id is None:
                 raise ValueError('Leidian instance ID is not set.')
-            self.backend_instance = LeidianHost.query(id=config.backend.instance_id)
-            if self.backend_instance is None:
+            instance = LeidianHost.query(id=config.backend.instance_id)
+            if instance is None:
                 raise ValueError(f'Leidian instance not found: {config.backend.instance_id}')
-            if not self.backend_instance.running():
-                logger.info('Starting Leidian backend...')
-                self.backend_instance.start()
-                logger.info('Waiting for Leidian backend to be available...')
-                self.backend_instance.wait_available()
-            else:
-                logger.info('Leidian backend "%s" already running.', self.backend_instance)
+            return instance
+
         elif config.backend.type == 'dmm':
-            self.backend_instance = DmmHost.instance
+            return DmmHost.instance
+
         else:
             raise ValueError(f'Unsupported backend type: {config.backend.type}')
-        assert self.backend_instance is not None, 'Backend instance is not set.'
-        return self.backend_instance.create_device(config.backend.screenshot_impl)
+
+    def __ensure_instance_running(self, instance: Instance, config: UserConfig):
+        """
+        确保 Instance 正在运行。
+
+        :param instance: 后端实例
+        :param config: 用户配置对象
+        """
+        # DMM 实例不需要启动，直接返回
+        if isinstance(instance, DmmInstance):
+            logger.info('DMM backend does not require startup.')
+            return
+
+        # 对所有需要启动的后端（custom, mumu, leidian）使用统一逻辑
+        if config.backend.check_emulator and not instance.running():
+            logger.info(f'Starting backend "{instance}"...')
+            instance.start()
+            logger.info(f'Waiting for backend "{instance}" to be available...')
+            instance.wait_available()
+        else:
+            logger.info(f'Backend "{instance}" already running or check is disabled.')
+
+    @override
+    def _on_create_device(self) -> Device:
+        """
+        创建设备。
+        """
+        from kotonebot.config.manager import load_config
+
+        # 步骤1：加载配置
+        config = load_config(self.config_path, type=self.config_type)
+        user_config = config.user_configs[0]  # HACK: 硬编码
+
+        # 步骤2：获取实例
+        self.backend_instance = self.__get_backend_instance(user_config)
+        if self.backend_instance is None:
+            raise RuntimeError(f"Failed to find instance for backend '{user_config.backend.type}'")
+
+        # 步骤3：确保实例运行
+        self.__ensure_instance_running(self.backend_instance, user_config)
+
+        # 步骤4：准备 HostConfig 并创建 Device
+        impl_name = user_config.backend.screenshot_impl
+
+        if isinstance(self.backend_instance, DmmInstance):
+            if impl_name == 'windows':
+                ahk_path = get_ahk_path()
+                host_conf = WindowsHostConfig(
+                    window_title='gakumas',
+                    ahk_exe_path=ahk_path
+                )
+            elif impl_name == 'remote_windows':
+                ahk_path = get_ahk_path()
+                host_conf = RemoteWindowsHostConfig(
+                    windows_host_config=WindowsHostConfig(
+                        window_title='gakumas',
+                        ahk_exe_path=ahk_path
+                    ),
+                    host=user_config.backend.adb_ip,
+                    port=user_config.backend.adb_port
+                )
+            else:
+                raise ValueError(f"Impl of '{impl_name}' is not supported on DMM.")
+            return self.backend_instance.create_device(impl_name, host_conf)
+        # 统一处理所有基于 ADB 的后端
+        elif isinstance(self.backend_instance, (CustomInstance, Mumu12Instance, LeidianInstance)):
+            if impl_name == 'nemu_ipc' and isinstance(self.backend_instance, Mumu12Instance):
+                impl_name = cast(Literal['nemu_ipc'], impl_name)
+                options = cast(BaseConfig, user_config.options)
+
+                # 根据 mumu_background_mode 决定是否传递后台保活参数
+                if user_config.backend.mumu_background_mode:
+                    host_conf = MuMu12HostConfig(
+                        display_id=None,
+                        target_package_name=options.start_game.game_package_name,
+                        app_index=0,
+                        timeout=180
+                    )
+                else:
+                    host_conf = MuMu12HostConfig(
+                        timeout=180
+                    )
+                return self.backend_instance.create_device(impl_name, host_conf)
+            elif impl_name in ['adb', 'adb_raw', 'uiautomator2']:
+                impl_name = cast(Literal['adb', 'adb_raw', 'uiautomator2'], impl_name)
+                host_conf = AdbHostConfig(timeout=180)
+                return self.backend_instance.create_device(
+                    cast(Any, impl_name), # :(
+                    host_conf
+                )
+            else:
+                raise ValueError(f"{user_config.backend.type} backend does not support implementation '{impl_name}'")
+
+        else:
+            raise TypeError(f"Unknown instance type: {type(self.backend_instance)}")

kotonebot/kaa/metadata.py

@@ -1,6 +1,53 @@
 WHATS_NEW = """
 # 更新日志
 ## kaa
+### v2025.6.28.0
+脚本：
+* [修复] 修正 debug_entry 脚本路径处理逻辑（#b53a055）
+* [修复] 修复清理日志功能失效的问题（#ad5c7b7）
+* [修复] 修复 debug_entry 执行的脚本没有正确输出日志的问题（#3ceae4c）
+
+界面：
+* [新增] 优化日志导出功能（#9574d20）
+* [新增] 为 UI 增加部分配置有效性验证（#08a7e71）
+* [新增] 加入调试模式警告提示（#a01c37d）
+* [新增] 画面 Tab 刷新机制由自动改为手动（#2469fc0）
+* [新增] MuMu12 保活模式可选开启（#71170e5）
+
+框架：
+* [修复] 修复 Device 中缩放与截图 Hook 的处理顺序不正确问题
+* [修复] 修复 NemuIpc 在多显示器下的坐标系问题（#87da282）
+* [修复] 修复当目标分辨率与实际分辨率旋转不同时截图会强制拉伸的问题（#e62e65d）
+* [修复] 缩放处理支持自动识别旋转（#677932a）
+* [修复] 修复 NemuIpc 截图无法响应屏幕旋转导致的分辨率变化（#105a894）
+* [新增] NemuIpcImpl 获取显示器 ID 支持自动重试（#0c94acf）
+* [新增] 支持 MuMu12 后台保活模式（#e232826）
+* [新增] 引入 Nemu 截图与控制方式（#f0b9181）
+* [新增] 移除 WindowsImpl 中的分辨率缩放（#415a8df）
+* [新增] 支持等比例分辨率缩放（#bb7f603）
+* [重构] 组装 Device 改用 recipe 方案（#f01e022）
+* [重构] 将传递的 MuMu 路径从 shell 目录改为 MuMu 根目录（#784b8ed）
+
+其他：
+* [其他] HsvRangeTool 支持从剪贴板粘贴图片（#1397587）
+* [其他] VSCode 新增不初始化 context 的启动配置（#0718678）
+* [其他] 调整部分日志输出格式（#bcd8cf2）
+
+### v2025.6.23.0
+脚本：
+* [新增] 优化了培育开始的逻辑，修复若干 bug（#86313ec）
+
+框架：
+* [修复] 修复由于分离 AndroidDevice 方法导致的 typing 问题（#4d76e1a）
+* [重构] 将 Commandable 分离为 WindowsCommandable 与 AndroidCommandable（#16a267d）
+* [重构] 将启动 remote_server 的逻辑移动到 kaa cli 中（#b8b5ba8）
+* [重构] 提取三个 adb-based 截图方法的工厂函数的共同部分（#bd57dc4）
+* [重构] 将创建设备的逻辑从 init_context 中移除（#f2599e6）
+* [重构] 重构 Device 与 Impl 的创建方式（#2fc9ad5）
+
+其他：
+* [其他] 更新上游 submodules（#810c341）
+
 ### v2025.6.8.0
 脚本：
 * [新增] 新增支持自动禁用与恢复 Gakumasu Localify 汉化插件（#264dac2）