ksaa 2025.8.23.1__py3-none-any.whl → 2025.9b2__py3-none-any.whl

{kotonebot/kaa → kaa}/application/core/idle_mode.py

@@ -16,7 +16,7 @@ with suppress(ImportError):
     import win32con # type: ignore
 
 from kotonebot.backend.context.context import vars
-from kotonebot.kaa.config.schema import IdleModeConfig
+from kaa.config.schema import IdleModeConfig
 
 logger = logging.getLogger(__name__)
 

{kotonebot/kaa → kaa}/application/core/misc_core.py

@@ -2,7 +2,7 @@ import os
 import sys
 
 from kotonebot.interop.win.shortcut import create_shortcut
-from kotonebot.kaa.errors import LauncherNotFoundError
+from kaa.errors import LauncherNotFoundError
 
 
 def create_desktop_shortcut(start_immediately: bool):

{kotonebot/kaa → kaa}/common.py

@@ -11,7 +11,7 @@ from pydantic import BaseModel, ConfigDict
 # TODO: from kotonebot import config (context) 会和 kotonebot.config 冲突
 from kotonebot import logging
 from kotonebot.backend.context import config
-from kotonebot.kaa.config.schema import BaseConfig
+from kaa.config.schema import BaseConfig
 
 logger = logging.getLogger(__name__)
 
@@ -19,4 +19,4 @@ def sprite_path(path: str) -> str:
     standalone = os.path.join('kotonebot/kaa/sprites', path)
     if os.path.exists(standalone):
         return standalone
-    return str(resources.files('kotonebot.kaa.sprites') / path)
+    return str(resources.files('kaa.sprites') / path)

{kotonebot/kaa → kaa}/config/const.py

@@ -156,7 +156,7 @@ class DailyMoneyShopItems(IntEnum):
         return [(cls.to_ui_text(item), item) for item in cls if cls._is_note(item)]
 
     def to_resource(self):
-        from kotonebot.kaa.tasks import R
+        from kaa.tasks import R
         match self:
             case DailyMoneyShopItems.Recommendations:
                 return R.Daily.TextShopRecommended

{kotonebot/kaa → kaa}/config/produce.py

@@ -6,7 +6,7 @@ import logging
 from typing import Literal
 from pydantic import BaseModel, ConfigDict, ValidationError, field_serializer, field_validator
 
-from kotonebot.kaa.errors import ProduceSolutionInvalidError, ProduceSolutionNotFoundError
+from kaa.errors import ProduceSolutionInvalidError, ProduceSolutionNotFoundError
 
 from .const import ProduceAction, RecommendCardDetectionMode
 

{kotonebot/kaa → kaa}/config/schema.py

@@ -2,7 +2,7 @@ from typing import TypeVar, Literal, Sequence
 from pydantic import BaseModel, ConfigDict
 
 from kotonebot import config
-from kotonebot.kaa.config.produce import ProduceSolution, ProduceSolutionManager
+from kaa.config.produce import ProduceSolution, ProduceSolutionManager
 from .const import (
     ConfigEnum,
     Priority,
@@ -75,6 +75,8 @@ class ProduceConfig(ConfigBaseModel):
     """选中的培育方案ID"""
     produce_count: int = 1
     """培育的次数。"""
+    produce_timeout_cd: int = 60
+    """推荐卡检测用时上限；若超时，则随机选择卡片打出。单位为秒，最少为20sec，DMM用户可以设置为30sec"""
 
 class MissionRewardConfig(ConfigBaseModel):
     enabled: bool = False
@@ -179,6 +181,13 @@ class MiscConfig(ConfigBaseModel):
 
     启用后，局域网内的其他设备可以通过本机 IP 地址访问 Web 界面。
     """
+    update_channel: Literal['release', 'beta'] = 'release'
+    """
+    更新通道。
+
+    * release: 只使用稳定版。
+    * beta: 包含预发布版本（如 alpha/beta/rc）。
+    """
 
 class IdleModeConfig(ConfigBaseModel):
     enabled: bool = False

{kotonebot/kaa → kaa}/db/sqlite.py

@@ -2,7 +2,7 @@ import os
 import sqlite3
 from typing import Any, cast
 
-from kotonebot.kaa import resources as res
+from kaa import resources as res
 
 _db: sqlite3.Connection | None = None
 _db_path = cast(str, res.__path__)[0] + '/game.db'

{kotonebot/kaa → kaa}/errors.py

@@ -50,3 +50,10 @@ class LauncherNotFoundError(KaaUserFriendlyError):
             '未找到启动器「kaa.exe」，请确认是否正确放置在根目录。',
             'https://kdocs.cn/l/cetCY8mGKHLj?linkname=jpzb09rLTS'
         )
+
+class ElevationRequiredError(KaaUserFriendlyError):
+    def __init__(self):
+        super().__init__(
+            '请以管理员身份运行 kaa。',
+            'https://www.kdocs.cn/l/cetCY8mGKHLj?linkname=qOqulS4KeX'
+        )

{kotonebot/kaa → kaa}/game_ui/dialog.py

@@ -1,6 +1,6 @@
 import logging
 
-from kotonebot.kaa.tasks import R
+from kaa.tasks import R
 from kotonebot import device, image
 
 logger = logging.getLogger(__name__)

{kotonebot/kaa → kaa}/game_ui/idols_overview.py

@@ -5,13 +5,13 @@ import cv2
 import numpy as np
 from cv2.typing import MatLike
 
-from kotonebot.kaa.tasks import R
-from kotonebot.kaa.util import paths
+from kaa.tasks import R
+from kaa.util import paths
 from kotonebot.primitives import RectTuple, Rect
-from kotonebot.kaa.game_ui import Scrollable
+from kaa.game_ui import Scrollable
 from kotonebot import device, action
 from kotonebot.util import cv2_imread
-from kotonebot.kaa.image_db import ImageDatabase, HistDescriptor, FileDataSource, DatabaseQueryResult
+from kaa.image_db import ImageDatabase, HistDescriptor, FileDataSource, DatabaseQueryResult
 from kotonebot.backend.preprocessor import HsvColorsRemover
 
 logger = logging.getLogger(__name__)

{kotonebot/kaa → kaa}/game_ui/schedule.py

@@ -6,8 +6,8 @@ from cv2.typing import MatLike
 from kotonebot.primitives import Rect
 from kotonebot import ocr, device, image, action
 from kotonebot.backend.core import HintBox
-from kotonebot.kaa.config import ProduceAction
-from kotonebot.kaa.tasks import R
+from kaa.config import ProduceAction
+from kaa.tasks import R
 
 logger = logging.getLogger(__name__)
 

{kotonebot/kaa → kaa}/game_ui/scrollable.py

@@ -189,9 +189,10 @@ class Scrollable:
         if self.scrollbar_rect is None:
             logger.warning('Unable to find scrollbar. (1)')
             return False
-        logger.debug('Scrollbar rect found.')
 
         x, y, w, h = self.scrollbar_rect.xywh
+        logger.debug(f'Scrollbar rect found. x/y/w/h: {x}/{y}/{w}/{h}')
+
         scroll_img = img[y:y+h, x:x+w]
         # 灰度、二值化
         gray = cv2.cvtColor(scroll_img, cv2.COLOR_BGR2GRAY)
@@ -201,10 +202,10 @@ class Scrollable:
         # 计算滚动位置
         positions = np.where(binary == 0)[0]
         if len(positions) > 0:
-            self.track_position = (int(x), int(y))
+            self.track_position = (int(x + w / 2), int(y))
             self.track_height = int(h)
             self.thumb_height = int(positions[-1] - positions[0])
-            self.thumb_position = (int(x), int(y + positions[0]))
+            self.thumb_position = (int(x + w / 2), int(y + positions[0]))
             self.position = float(positions[-1] / h)
             self.page_count = int(h / self.thumb_height)
             logger.debug(f'Scrollbar height: {self.thumb_height}, position: {self.position}')

{kotonebot/kaa → kaa}/image_db/db.py

@@ -167,7 +167,7 @@ class ImageDatabase:
     
 
 if __name__ == '__main__':
-    from kotonebot.kaa.image_db.db import Db
+    from kaa.image_db.db import Db
     logging.basicConfig(level=logging.DEBUG, format='[%(asctime)s] [%(levelname)s] [%(name)s] [%(funcName)s] [%(lineno)d] %(message)s')
     imgs_path = r'E:\GithubRepos\KotonesAutoAssistant.worktrees\dev\kotonebot\tasks\resources\idol_cards'
     needle_path = r'D:\05.png'

{kotonebot/kaa → kaa}/main/gr.py

@@ -14,25 +14,25 @@ from typing import List, Dict, Tuple, Literal, Generator, Callable, Any, get_arg
 import cv2
 import gradio as gr
 
-from kotonebot.kaa.errors import ProduceSolutionNotFoundError
-from kotonebot.kaa.main import Kaa
-from kotonebot.kaa.db import IdolCard
+from kaa.errors import ProduceSolutionNotFoundError
+from kaa.main import Kaa
+from kaa.db import IdolCard
 from kotonebot.backend.context.context import vars
 from kotonebot.errors import ContextNotInitializedError
 from kotonebot.client.host import Mumu12Host, LeidianHost
 from kotonebot.config.manager import load_config, save_config
 from kotonebot.config.base_config import UserConfig, BackendConfig
 from kotonebot.backend.context import task_registry, ContextStackVars
-from kotonebot.kaa.config import (
+from kaa.config import (
     BaseConfig, APShopItems, CapsuleToysConfig, ClubRewardConfig, PurchaseConfig, ActivityFundsConfig,
     PresentsConfig, AssignmentConfig, ContestConfig, ProduceConfig,
     MissionRewardConfig, DailyMoneyShopItems, ProduceAction,
     RecommendCardDetectionMode, TraceConfig, StartGameConfig, EndGameConfig, UpgradeSupportCardConfig, MiscConfig,
     IdleModeConfig,
 )
-from kotonebot.kaa.config.produce import ProduceSolution, ProduceSolutionManager, ProduceData
-from kotonebot.kaa.application.adapter.misc_adapter import create_desktop_shortcut
-from kotonebot.kaa.application.core.idle_mode import IdleModeManager
+from kaa.config.produce import ProduceSolution, ProduceSolutionManager, ProduceData
+from kaa.application.adapter.misc_adapter import create_desktop_shortcut
+from kaa.application.core.idle_mode import IdleModeManager
 
 logger = logging.getLogger(__name__)
 GradioInput = gr.Textbox | gr.Number | gr.Checkbox | gr.Dropdown | gr.Radio | gr.Slider | gr.Tabs | gr.Tab
@@ -58,7 +58,7 @@ ConfigKey = Literal[
     'select_which_contestant', 'when_no_set',
     
     # produce
-    'produce_enabled', 'selected_solution_id', 'produce_count',
+    'produce_enabled', 'selected_solution_id', 'produce_count', 'produce_timeout_cd',
     'mission_reward_enabled',
     
     # club reward
@@ -91,7 +91,7 @@ ConfigKey = Literal[
     'trace_recommend_card_detection',
     
     # misc
-    'check_update', 'auto_install_update', 'expose_to_lan',
+    'check_update', 'auto_install_update', 'expose_to_lan', 'update_channel',
 
     # idle
     'idle_enabled', 'idle_seconds', 'idle_minimize_on_pause',
@@ -233,10 +233,22 @@ class KotoneBotUI:
         self.is_single_task_stopping: bool = False  # 新增：标记单个任务是否正在停止
         self._kaa = kaa
         self._load_config()
-        # 新增 IdleModeManager
+        # IdleModeManager 空闲检测
+        def safe_get_is_running():
+            try:
+                return (self.is_running or self.single_task_running) and not self.is_stopping and not self.is_single_task_stopping and not vars.flow.is_paused
+            except ContextNotInitializedError:
+                return False
+
+        def safe_get_is_paused():
+            try:
+                return vars.flow.is_paused
+            except ContextNotInitializedError:
+                return False
+
         self.idle_mgr = IdleModeManager(
-            get_is_running=lambda: (self.is_running or self.single_task_running) and not self.is_stopping and not self.is_single_task_stopping and not vars.flow.is_paused,
-            get_is_paused=lambda: vars.flow.is_paused,
+            get_is_running=safe_get_is_running,
+            get_is_paused=safe_get_is_paused,
             get_config=lambda: self.current_config.options.idle,
         )
         self._setup_kaa()
@@ -518,6 +530,13 @@ class KotoneBotUI:
 
             # 快速设置控制区域
             gr.Markdown("### 快速设置")
+
+            with gr.Row():
+                select_all_btn = gr.Button("全选", scale=1)
+                unselect_all_btn = gr.Button("清空", scale=1)
+                select_produce_only_btn = gr.Button("只选培育", scale=1)
+                unselect_produce_only_btn = gr.Button("只不选培育", scale=1)
+
             with gr.Row(elem_classes=["quick-controls-row"]):
                 purchase_quick = gr.Checkbox(
                     label="商店",
@@ -612,6 +631,8 @@ class KotoneBotUI:
                 label="任务状态"
             )
 
+            # MARK: 状态 - 监听函数
+
             def on_run_click(evt: gr.EventData) -> Tuple[gr.Button, List[List[str]]]:
                 result = self.toggle_run()
                 # 如果正在停止，禁用按钮
@@ -623,43 +644,66 @@ class KotoneBotUI:
                 return self.toggle_pause()
 
             # 快速设置控制的事件处理函数
-            def save_quick_setting(field_name: str, value: bool, display_name: str):
+            def save_quick_setting(success_msg: str, failed_msg: str):
                 """保存快速设置并立即应用"""
                 try:
-                    # 更新配置
-                    if field_name == 'purchase':
-                        self.current_config.options.purchase.enabled = value
-                    elif field_name == 'assignment':
-                        self.current_config.options.assignment.enabled = value
-                    elif field_name == 'contest':
-                        self.current_config.options.contest.enabled = value
-                    elif field_name == 'produce':
-                        self.current_config.options.produce.enabled = value
-                    elif field_name == 'mission_reward':
-                        self.current_config.options.mission_reward.enabled = value
-                    elif field_name == 'club_reward':
-                        self.current_config.options.club_reward.enabled = value
-                    elif field_name == 'activity_funds':
-                        self.current_config.options.activity_funds.enabled = value
-                    elif field_name == 'presents':
-                        self.current_config.options.presents.enabled = value
-                    elif field_name == 'capsule_toys':
-                        self.current_config.options.capsule_toys.enabled = value
-                    elif field_name == 'upgrade_support_card':
-                        self.current_config.options.upgrade_support_card.enabled = value
-                    elif field_name == 'start_game':
-                        self.current_config.options.start_game.enabled = value
-
                     # 保存配置
                     save_config(self.config, "config.json")
 
                     # 尝试热重载配置
                     if self.reload_config():
-                        gr.Success(f"✓ {display_name} 已{'启用' if value else '禁用'}")
+                        gr.Success(success_msg)
                     else:
-                        gr.Warning(f"⚠ {display_name} 已保存，但重新加载失败")
+                        gr.Warning(failed_msg)
                 except Exception as e:
                     gr.Error(f"✗ 保存失败：{str(e)}")
+            
+            def update_and_save_quick_setting(field_name: str, value: bool, display_name: str):
+                """更新字段，并保存快速设置并立即应用"""
+
+                # 更新配置
+                if field_name == 'purchase':
+                    self.current_config.options.purchase.enabled = value
+                elif field_name == 'assignment':
+                    self.current_config.options.assignment.enabled = value
+                elif field_name == 'contest':
+                    self.current_config.options.contest.enabled = value
+                elif field_name == 'produce':
+                    self.current_config.options.produce.enabled = value
+                elif field_name == 'mission_reward':
+                    self.current_config.options.mission_reward.enabled = value
+                elif field_name == 'club_reward':
+                    self.current_config.options.club_reward.enabled = value
+                elif field_name == 'activity_funds':
+                    self.current_config.options.activity_funds.enabled = value
+                elif field_name == 'presents':
+                    self.current_config.options.presents.enabled = value
+                elif field_name == 'capsule_toys':
+                    self.current_config.options.capsule_toys.enabled = value
+                elif field_name == 'upgrade_support_card':
+                    self.current_config.options.upgrade_support_card.enabled = value
+                
+                # 保存并重载配置
+                save_quick_setting(
+                    f"✓ {display_name} 已{'启用' if value else '禁用'}",
+                    f"⚠ {display_name} 已保存，但重新加载失败"
+                )
+
+            def batch_select(default: bool, produce_only: bool, success_msg: str) -> None:
+                self.current_config.options.purchase.enabled             = default
+                self.current_config.options.assignment.enabled           = default
+                self.current_config.options.contest.enabled              = default
+                self.current_config.options.produce.enabled              = produce_only
+                self.current_config.options.mission_reward.enabled       = default
+                self.current_config.options.club_reward.enabled          = default
+                self.current_config.options.activity_funds.enabled       = default
+                self.current_config.options.presents.enabled             = default
+                self.current_config.options.capsule_toys.enabled         = default
+                self.current_config.options.upgrade_support_card.enabled = default
+
+                save_quick_setting(success_msg, f"⚠ 数据已保存，但重新加载失败")
+
+            # MARK: 状态 - UI回调函数
 
             run_btn.click(
                 fn=on_run_click,
@@ -671,45 +715,67 @@ class KotoneBotUI:
                 outputs=[pause_btn]
             )
 
+            select_all_btn.click(
+                fn=lambda: batch_select(True, True, f"✓ 全选成功"),
+                outputs=[]
+            )
+
+            unselect_all_btn.click(
+                fn=lambda: batch_select(False, False, f"✓ 清空成功"),
+                outputs=[]
+            )
+
+            select_produce_only_btn.click(
+                fn=lambda: batch_select(False, True, f"✓ 只选培育成功"),
+                outputs=[]
+            )
+
+            unselect_produce_only_btn.click(
+                fn=lambda: batch_select(True, False, f"✓ 只不选培育成功"),
+                outputs=[]
+            )
+
             # 绑定快速设置控制的事件
-            purchase_quick.change(
-                fn=lambda x: save_quick_setting('purchase', x, '商店'),
+
+            # 以下回调函数均由.change修改为.input，这样回调函数就只会在用户操作时触发，避免全选功能导致反复触发
+            purchase_quick.input(
+                fn=lambda x: update_and_save_quick_setting('purchase', x, '商店'),
                 inputs=[purchase_quick]
             )
-            assignment_quick.change(
-                fn=lambda x: save_quick_setting('assignment', x, '工作'),
+            assignment_quick.input(
+                fn=lambda x: update_and_save_quick_setting('assignment', x, '工作'),
                 inputs=[assignment_quick]
             )
-            contest_quick.change(
-                fn=lambda x: save_quick_setting('contest', x, '竞赛'),
+            contest_quick.input(
+                fn=lambda x: update_and_save_quick_setting('contest', x, '竞赛'),
                 inputs=[contest_quick]
             )
-            produce_quick.change(
-                fn=lambda x: save_quick_setting('produce', x, '培育'),
+            produce_quick.input(
+                fn=lambda x: update_and_save_quick_setting('produce', x, '培育'),
                 inputs=[produce_quick]
             )
-            mission_reward_quick.change(
-                fn=lambda x: save_quick_setting('mission_reward', x, '任务奖励'),
+            mission_reward_quick.input(
+                fn=lambda x: update_and_save_quick_setting('mission_reward', x, '任务奖励'),
                 inputs=[mission_reward_quick]
             )
-            club_reward_quick.change(
-                fn=lambda x: save_quick_setting('club_reward', x, '社团奖励'),
+            club_reward_quick.input(
+                fn=lambda x: update_and_save_quick_setting('club_reward', x, '社团奖励'),
                 inputs=[club_reward_quick]
             )
-            activity_funds_quick.change(
-                fn=lambda x: save_quick_setting('activity_funds', x, '活动费'),
+            activity_funds_quick.input(
+                fn=lambda x: update_and_save_quick_setting('activity_funds', x, '活动费'),
                 inputs=[activity_funds_quick]
             )
-            presents_quick.change(
-                fn=lambda x: save_quick_setting('presents', x, '礼物'),
+            presents_quick.input(
+                fn=lambda x: update_and_save_quick_setting('presents', x, '礼物'),
                 inputs=[presents_quick]
             )
-            capsule_toys_quick.change(
-                fn=lambda x: save_quick_setting('capsule_toys', x, '扭蛋'),
+            capsule_toys_quick.input(
+                fn=lambda x: update_and_save_quick_setting('capsule_toys', x, '扭蛋'),
                 inputs=[capsule_toys_quick]
             )
-            upgrade_support_card_quick.change(
-                fn=lambda x: save_quick_setting('upgrade_support_card', x, '支援卡升级'),
+            upgrade_support_card_quick.input(
+                fn=lambda x: update_and_save_quick_setting('upgrade_support_card', x, '支援卡升级'),
                 inputs=[upgrade_support_card_quick]
             )
 
@@ -1351,6 +1417,14 @@ class KotoneBotUI:
                     info=ProduceConfig.model_fields['produce_count'].description
                 )
 
+                produce_timeout_cd = gr.Number(
+                    minimum=20,
+                    value=self.current_config.options.produce.produce_timeout_cd,
+                    label="推荐卡检测用时上限",
+                    interactive=True,
+                    info=ProduceConfig.model_fields['produce_timeout_cd'].description
+                )
+
             # 绑定启用状态变化事件
             def on_produce_enabled_change(enabled):
                 return gr.Group(visible=enabled)
@@ -1368,11 +1442,13 @@ class KotoneBotUI:
             config.produce.enabled = data['produce_enabled']
             config.produce.selected_solution_id = data.get('selected_solution_id')
             config.produce.produce_count = data.get('produce_count', 1)
+            config.produce.produce_timeout_cd = data.get('produce_timeout_cd', 60)
 
         return set_config, {
             'produce_enabled': produce_enabled,
             'selected_solution_id': solution_dropdown,
-            'produce_count': produce_count
+            'produce_count': produce_count,
+            'produce_timeout_cd': produce_timeout_cd
         }
 
 
@@ -1504,7 +1580,7 @@ class KotoneBotUI:
                             (RecommendCardDetectionMode.STRICT.display_name, RecommendCardDetectionMode.STRICT.value)
                         ],
                         label="推荐卡检测模式",
-                        info="推荐卡检测模式。严格模式下，识别速度会降低，但识别准确率会提高。",
+                        info="推荐卡检测模式。严格模式下，识别速度会降低，但识别准确率会提高。推荐Kotone使用严格模式，其他角色使用正常模式。",
                         visible=False
                     )
                     use_ap_drink = gr.Checkbox(
@@ -1633,7 +1709,7 @@ class KotoneBotUI:
                         ],
                         value=current_solution.data.recommend_card_detection_mode.value,
                         label="推荐卡检测模式",
-                        info="推荐卡检测模式。严格模式下，识别速度会降低，但识别准确率会提高。"
+                        info="推荐卡检测模式。严格模式下，识别速度会降低，但识别准确率会提高。推荐Kotone使用严格模式，其他角色使用正常模式。"
                     )
                     use_ap_drink = gr.Checkbox(
                         label="AP 不足时自动使用 AP 饮料",
@@ -2244,6 +2320,16 @@ class KotoneBotUI:
                 info=MiscConfig.model_fields['expose_to_lan'].description,
                 interactive=True
             )
+            update_channel = gr.Dropdown(
+                choices=[
+                    ("正式版", "release"),
+                    ("测试版", "beta")
+                ],
+                value=self.current_config.options.misc.update_channel,
+                label="更新渠道",
+                info=MiscConfig.model_fields['update_channel'].description,
+                interactive=True
+            )
             with gr.Row():
                 gr.Button("创建桌面快捷方式").click(
                     fn=self._create_shortcut_button_click(False),
@@ -2258,11 +2344,13 @@ class KotoneBotUI:
             config.misc.check_update = data['check_update']
             config.misc.auto_install_update = data['auto_install_update']
             config.misc.expose_to_lan = data['expose_to_lan']
+            config.misc.update_channel = data['update_channel']
         
         return set_config, {
             'check_update': check_update,
             'auto_install_update': auto_install_update,
-            'expose_to_lan': expose_to_lan
+            'expose_to_lan': expose_to_lan,
+            'update_channel': update_channel
         }
 
     def _create_shortcut_button_click(self, start_immediately: bool) -> Callable[[], None]:
@@ -2369,9 +2457,12 @@ class KotoneBotUI:
             # 社团奖励设置
             club_reward_settings = self._create_club_reward_settings()
 
-            # 升级支援卡设置
+            # 扭蛋设置
             capsule_toys_settings = self._create_capsule_toys_settings()
 
+            # 升级支援卡设置
+            upgrade_support_card_settings = self._create_upgrade_support_card_settings()
+
             # 启动游戏设置
             start_game_settings = self._create_start_game_settings()
 
@@ -2402,6 +2493,7 @@ class KotoneBotUI:
                 mission_reward_settings,
                 club_reward_settings,
                 capsule_toys_settings,
+                upgrade_support_card_settings,
                 start_game_settings,
                 end_game_settings,
                 misc_settings,
@@ -2454,7 +2546,7 @@ class KotoneBotUI:
 
             # 更新日志
             with gr.Accordion("更新日志", open=False):
-                from kotonebot.kaa.metadata import WHATS_NEW
+                from kaa.metadata import WHATS_NEW
                 gr.Markdown(WHATS_NEW)
 
             # 载入信息按钮

{kotonebot/kaa → kaa}/main/kaa.py

@@ -13,7 +13,7 @@ import cv2
 
 from kotonebot.client.host.mumu12_host import MuMu12HostConfig
 
-from ...client import Device
+from kotonebot.client.device import Device
 from kotonebot.ui import user
 from kotonebot import KotoneBot
 from ..util.paths import get_ahk_path
@@ -57,7 +57,7 @@ class Kaa(KotoneBot):
     def __init__(self, config_path: str):
         # 升级配置
         upgrade_msg = upgrade_config()
-        super().__init__(module='kotonebot.kaa.tasks', config_path=config_path, config_type=BaseConfig)
+        super().__init__(module='kaa.tasks', config_path=config_path, config_type=BaseConfig)
         self.upgrade_msg = upgrade_msg
         self.version = importlib.metadata.version('ksaa')
         logger.info('Version: %s', self.version)

{kotonebot/kaa → kaa}/metadata.py

@@ -1,6 +1,61 @@
 WHATS_NEW = """
 # 更新日志
 ## kaa
+### v2025.09b2
+发布日期：2025-09-14
+
+脚本：
+* [新增] 新增培育不合格的判断，在不合格之后可以继续培育（#b9b7752）
+* [修复] 修复培育中推荐卡检测不到并且第一张卡无法打出时，培育卡住的问题（#34b2a43）
+* [修复] 修复滚动条概率滑动失败的问题（#2d949a6）
+
+界面：
+* [新增] 友好化管理员权限提示（#54b667a）
+* [新增] 更详细的'推荐卡检测模式'说明（#22f72eb）
+* [新增] 支持自定义推荐卡检测的超时CD（#847e9c1）
+
+框架：
+* [重构] 将 kotonebot 改为包引入而不是源码引入（#b5e3001）
+* [修复] 修复swipe_scale()内逻辑错误，导致无法正常安排工作的问题（#c189672）
+
+其他：
+* [文档] 开发文档新增构建启动器部分教程（#4a687cf）
+* [其他] 新增swipe的日志输出（#e72818a）
+
+### v2025.09b1
+发布日期：2025-09-06
+
+> **注意**
+>
+> 自此版本开始，版本号格式从 `v{YYYY}.{MM}.{DD}.{Minor}` 改为 `v{YYYY}.{MM}` 与 `v{YYYY}.{MM}b{BetaVersion}` 。
+> 前者为正式版，每一到两个月发布一次，后者为测试版，一到两周发布一次。对于只更新了游戏数据的正式版，使用 `post` 后缀。
+>
+> 【例】
+> - v2025.08 为 2025 年 9 月发布的正式版
+> - v2025.09b3 为 2025 年 9 月发布的第 3 个测试版
+> - v2025.08.post1 为 2025 年 8 月发布的正式版，但只更新了游戏数据
+
+脚本：
+* [修复] 修复培育中打牌时无法处理日期变更弹窗的问题（#de27888）
+* [修复] 修复了produce模块中循环引用，导致produce子模块失效的问题（#e08ec22）
+* [修复] 再次修复进入商店时，错误进入交换所的问题（#a425ae9）
+* [修复] 修复了上一次培育为NIA培育时，错误地进入Hajime培育的问题（#f8686b8）
+* [修复] 修复了自动使用AP饮料时有几率卡在点击「使う」按钮上的问题（#dd5dbdf）
+* [修复] 修复了'休息'时按钮点击过快，导致第二次点击丢失的问题（#070f052）
+* [修复] 修复了进入商店时，错误进入交换所的问题（#bfabf3e）
+* [新增] 新增了处理'培育时，日期变更'的功能（#e15f4e3）
+
+界面：
+* [修复] 在详细设置中添加了缺失的‘升级支援卡设置’（#89793c7）
+* [新增] 在'状态'页新增了全选、全不选、只选培育、只不选培育这四个新按键（#93f03b3）
+* [新增] UI 内支持检索测试版本的 kaa（#5a66777）
+
+框架：
+* [修复] 修复启用空闲模式后，反复报错 ContextNotInitializedError 的问题（#0a8293e）
+
+其他：
+* [文档] 新增开发指南（#4b7dea5）
+
 ### v2025.8.23.0
 脚本：
 * [新增] 新增闲置挂机功能（#54e2101）