ksaa 2025.8.17.0__py3-none-any.whl → 2025.9b1__py3-none-any.whl

kotonebot/kaa/application/core/idle_mode.py

@@ -0,0 +1,172 @@
+import sys
+import time
+import logging
+import threading
+from contextlib import suppress
+from typing import Callable, Optional
+
+with suppress(ImportError):
+    keyboard = None
+    win32api = None
+    win32gui = None
+    win32con = None
+    import keyboard # type: ignore
+    import win32api # type: ignore
+    import win32gui # type: ignore
+    import win32con # type: ignore
+
+from kotonebot.backend.context.context import vars
+from kotonebot.kaa.config.schema import IdleModeConfig
+
+logger = logging.getLogger(__name__)
+
+def _get_system_idle_seconds_windows() -> int:
+    if win32api is None:
+        return 0
+    try:
+        last_input_tick = win32api.GetLastInputInfo()
+        tick_count = win32api.GetTickCount()
+        elapsed_ms = tick_count - last_input_tick
+        return max(0, int(elapsed_ms / 1000))
+    except Exception:
+        logger.exception('win32api.GetLastInputInfo failed')
+        return 0
+
+
+def get_system_idle_seconds() -> int:
+    if sys.platform.startswith('win'):
+        try:
+            return _get_system_idle_seconds_windows()
+        except Exception:
+            logger.exception('GetLastInputInfo failed')
+            return 0
+    return 0
+
+
+class IdleModeManager:
+    def __init__(
+        self,
+        *,
+        get_is_running: Callable[[], bool],
+        get_is_paused: Callable[[], bool],
+        get_config: Callable[[], IdleModeConfig],
+    ) -> None:
+        self._get_is_running = get_is_running
+        self._get_is_paused = get_is_paused
+        self._get_config = get_config
+        self._stop_event = threading.Event()
+        self._thread: Optional[threading.Thread] = None
+        self._keyboard_hook = None
+        self._last_key_ts: float = 0.0
+
+    def start(self) -> None:
+        if self._thread and self._thread.is_alive():
+            return
+        self._stop_event.clear()
+        self._thread = threading.Thread(target=self._loop, name='IdleModeThread', daemon=True)
+        self._thread.start()
+        self._install_keyboard_hook()
+        logger.info('IdleModeManager started')
+
+    def stop(self) -> None:
+        self._remove_keyboard_hook()
+        if self._thread and self._thread.is_alive():
+            self._stop_event.set()
+            self._thread.join(timeout=2.0)
+        logger.info('IdleModeManager stopped')
+
+    def notify_on_start(self) -> None:
+        # 运行态切换时可根据需要做重置
+        self._last_key_ts = 0.0
+
+    def notify_on_stop(self) -> None:
+        self._last_key_ts = 0.0
+
+    def _loop(self) -> None:
+        while not self._stop_event.is_set():
+            conf = self._get_config()
+            if not conf.enabled:
+                time.sleep(0.8)
+                continue
+            try:
+                if self._get_is_paused():
+                    idle_sec = get_system_idle_seconds()
+                    if idle_sec >= max(0, int(conf.idle_seconds)):
+                        logger.info('System idle for %ss while paused. Requesting resume...', idle_sec)
+                        try:
+                            vars.flow.request_resume()
+                        except Exception:
+                            logger.exception('request_resume failed')
+                time.sleep(0.8)
+            except Exception:
+                logger.exception('IdleMode loop error')
+                time.sleep(1.0)
+
+    def _install_keyboard_hook(self) -> None:
+        if keyboard is None:
+            logger.warning('keyboard module not available; key-to-pause disabled')
+            return
+        if self._keyboard_hook is not None:
+            return
+
+        def _on_key_event(_: object) -> None:
+            conf = self._get_config()
+            if not conf.enabled:
+                return
+            now = time.time()
+            if (now - self._last_key_ts) < 0.3:
+                return
+            self._last_key_ts = now
+            try:
+                if self._get_is_running() and not self._get_is_paused():
+                    logger.info('Any key pressed -> pause requested')
+                    vars.flow.request_pause()
+                    if conf.minimize_on_pause:
+                        self._minimize_game_window()
+            except Exception:
+                logger.exception('key handler failed')
+
+        try:
+            self._keyboard_hook = keyboard.on_press(_on_key_event, suppress=False)
+        except Exception:
+            logger.warning('Failed to install keyboard hook; degraded behavior')
+            self._keyboard_hook = None
+
+    def _remove_keyboard_hook(self) -> None:
+        if keyboard is None:
+            return
+        if self._keyboard_hook is None:
+            return
+        try:
+            keyboard.unhook(self._keyboard_hook)
+        except Exception:
+            logger.exception('Failed to remove keyboard hook')
+        finally:
+            self._keyboard_hook = None
+
+    def _minimize_game_window(self) -> None:
+        # Send the window to background (bottom of Z-order) via pywin32
+        if not sys.platform.startswith('win'):
+            return
+        if win32gui is None or win32con is None:
+            logger.warning('pywin32 (win32gui/win32con) not available; skip backgrounding')
+            return
+        try:
+            hwnd = win32gui.FindWindow(None, 'gakumas')  # type: ignore
+            if hwnd:
+                flags = (
+                    win32con.SWP_NOMOVE
+                    | win32con.SWP_NOSIZE
+                    | win32con.SWP_NOACTIVATE
+                    | win32con.SWP_NOOWNERZORDER
+                )
+                win32gui.SetWindowPos(hwnd, win32con.HWND_BOTTOM, 0, 0, 0, 0, flags)
+                try:
+                    win32gui.ShowWindow(hwnd, win32con.SW_SHOWNOACTIVATE)
+                except Exception:
+                    pass
+                logger.info('Sent game window to background (HWND=%s)', hwnd)
+            else:
+                logger.warning('Game window not found; cannot send to background')
+        except Exception:
+            logger.warning('Failed to send game window to background', exc_info=True) 

kotonebot/kaa/config/__init__.py

@@ -14,6 +14,7 @@ from .schema import (
     StartGameConfig,
     EndGameConfig,
     MiscConfig,
+    IdleModeConfig,
     conf,
 )
 from .const import (
@@ -46,6 +47,7 @@ __all__ = [
     "StartGameConfig",
     "EndGameConfig",
     "MiscConfig",
+    "IdleModeConfig",
     "conf",
     # const 导出
     "ConfigEnum",

kotonebot/kaa/config/schema.py

@@ -180,6 +180,14 @@ class MiscConfig(ConfigBaseModel):
     启用后，局域网内的其他设备可以通过本机 IP 地址访问 Web 界面。
     """
 
+class IdleModeConfig(ConfigBaseModel):
+    enabled: bool = False
+    """是否启用闲置挂机（任意键暂停、闲置自动恢复）"""
+    idle_seconds: int = 30
+    """暂停状态下，超过该闲置秒数将自动恢复"""
+    minimize_on_pause: bool = True
+    """按键触发暂停时最小化游戏窗口"""
+
 class BaseConfig(ConfigBaseModel):
     purchase: PurchaseConfig = PurchaseConfig()
     """商店购买配置"""
@@ -223,6 +231,9 @@ class BaseConfig(ConfigBaseModel):
     misc: MiscConfig = MiscConfig()
     """杂项配置"""
 
+    idle: IdleModeConfig = IdleModeConfig()
+    """闲置挂机配置"""
+
 
 def conf() -> BaseConfig:
     """获取当前配置数据"""

kotonebot/kaa/main/gr.py

@@ -28,9 +28,11 @@ from kotonebot.kaa.config import (
     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
 
 logger = logging.getLogger(__name__)
 GradioInput = gr.Textbox | gr.Number | gr.Checkbox | gr.Dropdown | gr.Radio | gr.Slider | gr.Tabs | gr.Tab
@@ -91,6 +93,9 @@ ConfigKey = Literal[
     # misc
     'check_update', 'auto_install_update', 'expose_to_lan',
 
+    # idle
+    'idle_enabled', 'idle_seconds', 'idle_minimize_on_pause',
+
     '_selected_backend_index'
     
 ]
@@ -228,6 +233,24 @@ class KotoneBotUI:
         self.is_single_task_stopping: bool = False  # 新增：标记单个任务是否正在停止
         self._kaa = kaa
         self._load_config()
+        # 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=safe_get_is_running,
+            get_is_paused=safe_get_is_paused,
+            get_config=lambda: self.current_config.options.idle,
+        )
         self._setup_kaa()
 
     def _setup_kaa(self) -> None:
@@ -322,6 +345,8 @@ class KotoneBotUI:
     def start_run(self) -> Tuple[str, List[List[str]]]:
         self.is_running = True
         self.run_status = self._kaa.start_all()
+        # 通知 Idle 管理器进入运行态
+        self.idle_mgr.notify_on_start()
         return "停止", self.update_task_status()
 
     def stop_run(self) -> Tuple[str, List[List[str]]]:
@@ -336,6 +361,8 @@ class KotoneBotUI:
         if self._kaa:
             self.run_status.interrupt()
             gr.Info("正在停止任务...")
+        # 通知 Idle 管理器停止态
+        self.idle_mgr.notify_on_stop()
 
         return "停止中...", self.update_task_status()
 
@@ -369,6 +396,8 @@ class KotoneBotUI:
         if hasattr(self, 'run_status') and self._kaa:
             self.run_status.interrupt()
             gr.Info("正在停止任务...")
+        # 通知 Idle 管理器停止态
+        self.idle_mgr.notify_on_stop()
         return "停止中...", "正在停止任务..."
 
     def toggle_pause(self) -> str:
@@ -501,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="商店",
@@ -595,6 +631,8 @@ class KotoneBotUI:
                 label="任务状态"
             )
 
+            # MARK: 状态 - 监听函数
+
             def on_run_click(evt: gr.EventData) -> Tuple[gr.Button, List[List[str]]]:
                 result = self.toggle_run()
                 # 如果正在停止，禁用按钮
@@ -606,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,
@@ -654,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]
             )
 
@@ -1553,7 +1636,7 @@ class KotoneBotUI:
 
                     with gr.Group(visible=not current_solution.data.auto_set_memory) as memory_sets_group:
                         memory_sets = gr.Dropdown(
-                            choices=[str(i) for i in range(1, 11)],  # 假设最多10个编成位
+                            choices=[str(i) for i in range(1, 21)],  # 最多20个编成位
                             value=str(current_solution.data.memory_set) if current_solution.data.memory_set else None,
                             label="回忆编成编号",
                             multiselect=False,
@@ -1569,7 +1652,7 @@ class KotoneBotUI:
 
                     with gr.Group(visible=not current_solution.data.auto_set_support_card) as support_card_sets_group:
                         support_card_sets = gr.Dropdown(
-                            choices=[str(i) for i in range(1, 11)],  # 假设最多10个编成位
+                            choices=[str(i) for i in range(1, 21)],  # 最多20个编成位
                             value=str(current_solution.data.support_card_set) if current_solution.data.support_card_set else None,
                             label="支援卡编成编号",
                             multiselect=False,
@@ -2253,6 +2336,42 @@ class KotoneBotUI:
             create_desktop_shortcut(start_immediately)
             gr.Success("快捷方式创建成功")
         return _inner
+    
+    def _create_idle_settings(self) -> ConfigBuilderReturnValue:
+        with gr.Column():
+            gr.Markdown("### 闲置挂机")
+            idle_enabled = gr.Checkbox(
+                label="启用闲置挂机（任意键暂停、闲置自动恢复）",
+                value=self.current_config.options.idle.enabled,
+                info=IdleModeConfig.model_fields['enabled'].description,
+                interactive=True
+            )
+            idle_seconds = gr.Slider(
+                label="自动恢复触发时间（秒）",
+                minimum=30,
+                maximum=3600,
+                step=10,
+                value=self.current_config.options.idle.idle_seconds,
+                info=IdleModeConfig.model_fields['idle_seconds'].description,
+                interactive=True
+            )
+            idle_minimize_on_pause = gr.Checkbox(
+                label="暂停时最小化游戏窗口",
+                value=self.current_config.options.idle.minimize_on_pause,
+                info=IdleModeConfig.model_fields['minimize_on_pause'].description,
+                interactive=True
+            )
+        
+        def set_config(config: BaseConfig, data: dict[ConfigKey, Any]) -> None:
+            config.idle.enabled = data['idle_enabled']
+            config.idle.idle_seconds = int(data['idle_seconds'])
+            config.idle.minimize_on_pause = data['idle_minimize_on_pause']
+        
+        return set_config, {
+            'idle_enabled': idle_enabled,
+            'idle_seconds': idle_seconds,
+            'idle_minimize_on_pause': idle_minimize_on_pause,
+        }
 
     def _create_debug_settings(self) -> ConfigBuilderReturnValue:
         """调试设置：仅在调试时使用"""
@@ -2316,9 +2435,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()
 
@@ -2328,6 +2450,9 @@ class KotoneBotUI:
             # 杂项设置
             misc_settings = self._create_misc_settings()
 
+            # 闲置挂机设置
+            idle_settings = self._create_idle_settings()
+
             # 调试设置（放在最后）
             debug_settings = self._create_debug_settings()
 
@@ -2346,9 +2471,11 @@ class KotoneBotUI:
                 mission_reward_settings,
                 club_reward_settings,
                 capsule_toys_settings,
+                upgrade_support_card_settings,
                 start_game_settings,
                 end_game_settings,
                 misc_settings,
+                idle_settings,
                 debug_settings
             ] # list of (set_func, { 'key': component, ... })
             all_components = [list(ret[1].values()) for ret in all_return_values] # [[c1, c2], [c3], ...]
@@ -2426,7 +2553,7 @@ class KotoneBotUI:
                 try:
                     # 构建命令，使用清华镜像源
                     cmd = [
-                        sys.executable, "-m", "pip", "index", "versions", "ksaa", "--json",
+                        sys.executable, "-m", "pip", "index", "versions", "ksaa", "--json", "--pre",
                         "--index-url", "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple",
                         "--trusted-host", "mirrors.tuna.tsinghua.edu.cn"
                     ]
@@ -2650,6 +2777,7 @@ class KotoneBotUI:
             self.config.user_configs.append(default_config)
         self.current_config = self.config.user_configs[0]
 
+
     def create_ui(self) -> gr.Blocks:
         custom_css = """
         #container { max-width: 800px; margin: auto; padding: 20px; }
@@ -2677,6 +2805,9 @@ class KotoneBotUI:
                     self._create_whats_new_tab()
                     self._create_screen_tab()
 
+        # 启动 IdleModeManager 后台线程
+        self.idle_mgr.start()
+
         return app
 
 def main(kaa: Kaa | None = None, start_immidiately: bool = False) -> None:

kotonebot/kaa/metadata.py

@@ -1,6 +1,51 @@
 WHATS_NEW = """
 # 更新日志
 ## kaa
+### 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）
+* [修复] 再次修复商店刷新后第二次购买会跳过第一行的问题（#b72cdf4）
+* [修复] 修复游戏更新导致的培育时识别编成编号失败（#24d14d4）
+* [修复] 修复培育内周数识别失败的问题（#3a84994）
+* [修复] 培育商店中有时候会因为结束按钮被挡住而卡住（#e93cfa8）
+
+其他：
+* [文档] 更新 README（#841fcf2）
+
 ### v2025.8.17.0
 脚本：
 * [修复] 尝试修复进入每日商店时报错的问题（#e9529b7）