ksaa 2025.6.23.0__py3-none-any.whl → 2025.7.3.0__py3-none-any.whl

kotonebot/kaa/main/kaa.py

@@ -1,5 +1,6 @@
 import io
 import os
+from typing import Any, Literal, cast
 import zipfile
 import logging
 import traceback
@@ -9,6 +10,8 @@ from typing_extensions import override
 
 import cv2
 
+from kotonebot.client.host.mumu12_host import MuMu12HostConfig
+
 from ...client import Device
 from kotonebot.ui import user
 from kotonebot import KotoneBot
@@ -112,6 +115,10 @@ 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)
 
     def __get_backend_instance(self, config: UserConfig) -> Instance:
         """
@@ -228,12 +235,32 @@ class Kaa(KotoneBot):
             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 in ['adb', 'adb_raw', 'uiautomator2']:
-                host_conf = AdbHostConfig(timeout=180)
+            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}'")
 

kotonebot/kaa/metadata.py

@@ -1,6 +1,48 @@
 WHATS_NEW = """
 # 更新日志
 ## kaa
+### v2025.7.3.0
+启动器：
+* [新增] 新启动器现在支持安装指定版本与指定补丁（#456019b）
+* [新增] 自动更新可禁用（#3f88c3a）
+* [新增] 启动器 C++ EXE 跳板程序（#b377b84）
+* [新增] 新启动器（#c4b93f4）
+
+其他：
+* [其他] Git 记录提取工具支持 bootstrap scope（#66ea531）
+
+### 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）