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

kotonebot/kaa/main/dmm_host.py

@@ -1,18 +1,15 @@
-from importlib import resources
 from typing_extensions import override
 
-from kotonebot.client import Device, DeviceImpl
-from kotonebot.client.registration import create_device
-from kotonebot.client.implements.windows import WindowsImplConfig
-from kotonebot.client.implements.remote_windows import RemoteWindowsImplConfig
+from kotonebot.client import Device
 from kotonebot.client.host import HostProtocol, Instance
-from kotonebot.client.host.protocol import WindowsHostConfig, RemoteWindowsHostConfig
+from kotonebot.client.host.windows_common import WindowsRecipes, WindowsHostConfigs, CommonWindowsCreateDeviceMixin
 
 
-DmmHostConfigs = WindowsHostConfig | RemoteWindowsHostConfig
+DmmHostConfigs = WindowsHostConfigs
+DmmRecipes = WindowsRecipes
 
 # TODO: 可能应该把 start_game 和 end_game 里对启停的操作移动到这里来
-class DmmInstance(Instance[DmmHostConfigs]):
+class DmmInstance(CommonWindowsCreateDeviceMixin, Instance[DmmHostConfigs]):
     def __init__(self):
         super().__init__('dmm', 'gakumas')
 
@@ -37,31 +34,11 @@ class DmmInstance(Instance[DmmHostConfigs]):
         raise NotImplementedError()
 
     @override
-    def create_device(self, impl: DeviceImpl, host_config: DmmHostConfigs) -> Device:
-        if impl == 'windows':
-            assert isinstance(host_config, WindowsHostConfig)
-            win_config = WindowsImplConfig(
-                window_title=host_config.window_title,
-                ahk_exe_path=host_config.ahk_exe_path
-            )
-            return create_device(impl, win_config)
+    def create_device(self, impl: DmmRecipes, host_config: DmmHostConfigs) -> Device:
+        """为 DMM 实例创建 Device。"""
+        return super().create_device(impl, host_config)
 
-        elif impl == 'remote_windows':
-            assert isinstance(host_config, RemoteWindowsHostConfig)
-            config = RemoteWindowsImplConfig(
-                windows_impl_config=WindowsImplConfig(
-                    window_title=host_config.windows_host_config.window_title,
-                    ahk_exe_path=host_config.windows_host_config.ahk_exe_path
-                ),
-                host=host_config.host,
-                port=host_config.port
-            )
-            return create_device(impl, config)
-
-        else:
-            raise ValueError(f'Unsupported impl for DMM: {impl}')
-
-class DmmHost(HostProtocol):
+class DmmHost(HostProtocol[DmmRecipes]):
     instance = DmmInstance()
     """DmmInstance 单例。"""
 
@@ -77,3 +54,7 @@ class DmmHost(HostProtocol):
     @staticmethod
     def query(*, id: str) -> Instance | None:
         raise NotImplementedError()
+
+    @staticmethod
+    def recipes() -> 'list[DmmRecipes]':
+        return ['windows', 'remote_windows']

kotonebot/kaa/main/gr.py

@@ -2,6 +2,10 @@ import os
 import traceback
 import zipfile
 import logging
+import copy
+import sys
+import subprocess
+import json
 from functools import partial
 from itertools import chain
 from datetime import datetime, timedelta
@@ -21,7 +25,7 @@ from kotonebot.kaa.common import (
     BaseConfig, APShopItems, CapsuleToysConfig, ClubRewardConfig, PurchaseConfig, ActivityFundsConfig,
     PresentsConfig, AssignmentConfig, ContestConfig, ProduceConfig,
     MissionRewardConfig, DailyMoneyShopItems, ProduceAction,
-    RecommendCardDetectionMode, TraceConfig, StartGameConfig, EndGameConfig, UpgradeSupportCardConfig,
+    RecommendCardDetectionMode, TraceConfig, StartGameConfig, EndGameConfig, UpgradeSupportCardConfig, MiscConfig,
 )
 
 logger = logging.getLogger(__name__)
@@ -33,6 +37,7 @@ ConfigKey = Literal[
     'check_emulator', 'emulator_path',
     'adb_emulator_name', 'emulator_args',
     '_mumu_index', '_leidian_index',
+    'mumu_background_mode',
 
     # purchase
     'purchase_enabled',
@@ -86,6 +91,9 @@ ConfigKey = Literal[
     'presents_enabled',
     'trace_recommend_card_detection',
     
+    # misc
+    'check_update', 'auto_install_update',
+    
     '_selected_backend_index'
     
 ]
@@ -94,17 +102,30 @@ ConfigSetFunction = Callable[[BaseConfig, Dict[ConfigKey, Any]], None]
 ConfigBuilderReturnValue = Tuple[ConfigSetFunction, Dict[ConfigKey, GradioInput]]
 
 def _save_bug_report(
+    title: str,
+    description: str,
     version: str,
+    upload: bool,
     path: str | None = None
 ) -> Generator[str, None, str]:
     """
     保存报告
 
-    :param path: 保存的路径。若为 `None`，则保存到 `./reports/bug-{YY-MM-DD HH-MM-SS}.zip`。
+    :param title: 标题
+    :param description: 描述
+    :param version: 版本号
+    :param upload: 是否上传
+    :param path: 保存的路径。若为 `None`，则保存到 `./reports/bug-YY-MM-DD HH-MM-SS_标题.zip`。
     :return: 保存的路径
     """
     from kotonebot import device
     from kotonebot.backend.context import ContextStackVars
+    import re
+
+    # 过滤标题中的非法文件名字符
+    def sanitize_filename(s: str) -> str:
+        # 替换 \/:*?"<>| 为空或下划线
+        return re.sub(r'[\\/:*?"<>|]', '_', s)
 
     # 确保目录存在
     os.makedirs('logs', exist_ok=True)
@@ -112,8 +133,18 @@ def _save_bug_report(
 
     error = ""
     if path is None:
-        path = f'./reports/bug-{datetime.now().strftime("%y-%m-%d %H-%M-%S")}.zip'
+        safe_title = sanitize_filename(title)[:30] or "无标题"
+        timestamp = datetime.now().strftime("%y-%m-%d-%H-%M-%S")
+        path = f'./reports/bug_{timestamp}_{safe_title}.zip'
     with zipfile.ZipFile(path, 'w', zipfile.ZIP_DEFLATED, compresslevel=9) as zipf:
+        # 打包描述文件
+        yield "### 打包描述文件..."
+        try:
+            description_content = f"标题：{title}\n类型：bug\n内容：\n{description}"
+            zipf.writestr('description.txt', description_content.encode('utf-8'))
+        except Exception as e:
+            error += f"保存描述文件失败：{str(e)}\n"
+
         # 打包截图
         yield "### 打包上次截图..."
         try:
@@ -158,12 +189,16 @@ def _save_bug_report(
         # 写出版本号
         zipf.writestr('version.txt', version)
 
+    if not upload:
+        yield f"### 报告已保存至 {os.path.abspath(path)}"
+        return path
+
     # 上传报告
-    from kotonebot.ui.file_host.sensio import upload
+    from kotonebot.ui.file_host.sensio import upload as upload_file
     yield "### 上传报告..."
     url = ''
     try:
-        url = upload(path)
+        url = upload_file(path)
     except Exception as e:
         yield f"### 上传报告失败：{str(e)}\n\n"
         return ''
@@ -371,9 +406,41 @@ class KotoneBotUI:
             assert key in CONFIG_KEY_VALUE, f"未知的配置项：{key}"
             key = cast(ConfigKey, key)
             data[key] = value
-        # 设置结果
+        
+        # 先设置options
         for (set_func, _) in return_values:
             set_func(options, data)
+        
+        # 验证规则1：截图方法验证
+        screenshot_method = self.current_config.backend.screenshot_impl
+        backend_type = self.current_config.backend.type
+        
+        valid_screenshot_methods = {
+            'mumu12': ['adb', 'adb_raw', 'uiautomator2', 'nemu_ipc'],
+            'leidian': ['adb', 'adb_raw', 'uiautomator2'],
+            'custom': ['adb', 'adb_raw', 'uiautomator2'],
+            'dmm': ['remote_windows', 'windows']
+        }
+        
+        if screenshot_method not in valid_screenshot_methods.get(backend_type, []):
+            gr.Warning(f"截图方法 '{screenshot_method}' 不适用于当前选择的模拟器类型，配置未保存。")
+            return ""
+        
+        # 验证规则2：若启用培育，那么培育偶像不能为空
+        if options.produce.enabled and not options.produce.idols:
+            gr.Warning("启用培育时，培育偶像不能为空，配置未保存。")
+            return ""
+        
+        # 验证规则3：若启用AP/金币购买，对应的商品不能为空
+        if options.purchase.ap_enabled and not options.purchase.ap_items:
+            gr.Warning("启用AP购买时，AP商店购买物品不能为空，配置未保存。")
+            return ""
+        
+        if options.purchase.money_enabled and not options.purchase.money_items:
+            gr.Warning("启用金币购买时，金币商店购买物品不能为空，配置未保存。")
+            return ""
+        
+        # 验证通过，保存配置
         self.current_config.options = options
         try:
             save_config(self.config, "config.json")
@@ -393,7 +460,14 @@ class KotoneBotUI:
             if self._kaa.upgrade_msg:
                 gr.Markdown('### 配置升级报告')
                 gr.Markdown(self._kaa.upgrade_msg)
-            gr.Markdown('脚本报错或者卡住？点击"日志"选项卡中的"一键导出报告"可以快速反馈！')
+            gr.Markdown('脚本报错或者卡住？前往"反馈"选项卡可以快速导出报告！')
+            
+            # 添加调试模式警告
+            if self.current_config.keep_screenshots:
+                gr.Markdown(
+                    '<div style="color: red; font-size: larger;">当前启用了调试功能「保留截图数据」，调试结束后正常使用时建议关闭此选项！</div>',
+                    elem_classes=["debug-warning"]
+                )
 
             task_status = gr.Dataframe(
                 headers=["任务", "状态"],
@@ -555,7 +629,9 @@ class KotoneBotUI:
             #     choices = ['windows', 'remote_windows']
             # else:  # Mumu, Leidian, Custom
             #     choices = ['adb', 'adb_raw', 'uiautomator2']
-            choices = ['adb', 'adb_raw', 'uiautomator2', 'windows', 'remote_windows']
+            # else:
+            #     raise ValueError(f'Unsupported backend type: {type_in_config}')
+            choices = ['adb', 'adb_raw', 'uiautomator2', 'windows', 'remote_windows', 'nemu_ipc']
             if impl_value not in choices:
                 new_value = choices[0]
             else:
@@ -576,13 +652,21 @@ class KotoneBotUI:
                             choices=[(i.name, i.id) for i in instances],
                             interactive=True
                         )
+                        mumu_background_mode = gr.Checkbox(
+                            label="MuMu12 模拟器后台保活模式",
+                            value=self.current_config.backend.mumu_background_mode,
+                            info=BackendConfig.model_fields['mumu_background_mode'].description,
+                            interactive=True
+                        )
                     except:  # noqa: E722
                         logger.exception('Failed to list installed MuMu12')
                         gr.Markdown('获取 MuMu12 模拟器列表失败，请升级模拟器到最新版本。若问题依旧，前往 QQ 群、QQ 频道或 Github 反馈 bug。')
                         mumu_instance = gr.Dropdown(visible=False)
+                        mumu_background_mode = gr.Checkbox(visible=False)
                 else:
                     # 为了让 return 收集组件时不报错
                     mumu_instance = gr.Dropdown(visible=False)
+                    mumu_background_mode = gr.Checkbox(visible=False)
 
             with gr.Tab("雷电", interactive=has_leidian, id="leidian") as tab_leidian:
                 gr.Markdown("已选中雷电模拟器")
@@ -661,7 +745,7 @@ class KotoneBotUI:
         #     choices = ['adb', 'adb_raw', 'uiautomator2']
         # else:
         #     raise ValueError(f'Unsupported backend type: {type_in_config}')
-        choices = ['adb', 'adb_raw', 'uiautomator2', 'windows', 'remote_windows']
+        choices = ['adb', 'adb_raw', 'uiautomator2', 'windows', 'remote_windows', 'nemu_ipc']
         screenshot_impl = gr.Dropdown(
             choices=choices,
             value=self.current_config.backend.screenshot_impl,
@@ -711,6 +795,7 @@ class KotoneBotUI:
             if current_tab == 0:  # Mumu
                 self.current_config.backend.type = 'mumu12'
                 self.current_config.backend.instance_id = data['_mumu_index']
+                self.current_config.backend.mumu_background_mode = data['mumu_background_mode']
             elif current_tab == 1:  # Leidian
                 self.current_config.backend.type = 'leidian'
                 self.current_config.backend.instance_id = data['_leidian_index']
@@ -741,7 +826,8 @@ class KotoneBotUI:
             'adb_emulator_name': adb_emulator_name,
             'emulator_args': emulator_args,
             '_mumu_index': mumu_instance,
-            '_leidian_index': leidian_instance
+            '_leidian_index': leidian_instance,
+            'mumu_background_mode': mumu_background_mode
         }
 
     def _create_purchase_settings(self) -> ConfigBuilderReturnValue:
@@ -1389,6 +1475,35 @@ class KotoneBotUI:
             'trace_recommend_card_detection': trace_recommend_card_detection
         }
 
+    def _create_misc_settings(self) -> ConfigBuilderReturnValue:
+        with gr.Column():
+            gr.Markdown("### 杂项设置")
+            check_update = gr.Dropdown(
+                choices=[
+                    ("启动时检查更新", "startup"),
+                    ("从不检查更新", "never")
+                ],
+                value=self.current_config.options.misc.check_update,
+                label="检查更新时机",
+                info=MiscConfig.model_fields['check_update'].description,
+                interactive=True
+            )
+            auto_install_update = gr.Checkbox(
+                label="自动安装更新",
+                value=self.current_config.options.misc.auto_install_update,
+                info=MiscConfig.model_fields['auto_install_update'].description,
+                interactive=True
+            )
+        
+        def set_config(config: BaseConfig, data: dict[ConfigKey, Any]) -> None:
+            config.misc.check_update = data['check_update']
+            config.misc.auto_install_update = data['auto_install_update']
+        
+        return set_config, {
+            'check_update': check_update,
+            'auto_install_update': auto_install_update
+        }
+
     def _create_settings_tab(self) -> None:
         with gr.Tab("设置"):
             gr.Markdown("## 设置")
@@ -1426,6 +1541,9 @@ class KotoneBotUI:
             # 跟踪设置
             trace_settings = self._create_trace_settings()
 
+            # 杂项设置
+            misc_settings = self._create_misc_settings()
+
             # 启动游戏设置
             start_game_settings = self._create_start_game_settings()
 
@@ -1449,7 +1567,8 @@ class KotoneBotUI:
                 capsule_toys_settings,
                 start_game_settings,
                 end_game_settings,
-                trace_settings
+                trace_settings,
+                misc_settings
             ] # list of (set_func, { 'key': component, ... })
             all_components = [list(ret[1].values()) for ret in all_return_values] # [[c1, c2], [c3], ...]
             all_components = list(chain(*all_components)) # [c1, c2, c3, ...]
@@ -1460,39 +1579,260 @@ class KotoneBotUI:
             )
 
     def _create_log_tab(self) -> None:
-        with gr.Tab("日志"):
-            gr.Markdown("## 日志")
-
+        with gr.Tab("反馈"):
+            gr.Markdown("## 反馈")
+            gr.Markdown('脚本报错或者卡住？在这里填写信息可以快速反馈！')
             with gr.Column():
+                report_title = gr.Textbox(label="标题", placeholder="用一句话概括问题")
+                report_type = gr.Dropdown(label="反馈类型", choices=["bug"], value="bug", interactive=False)
+                report_description = gr.Textbox(label="描述", lines=5, placeholder="详细描述问题。例如：什么时候出错、是否每次都出错、出错时的步骤是什么")
                 with gr.Row():
-                    export_dumps_btn = gr.Button("导出 dump")
-                    export_logs_btn = gr.Button("导出日志")
-                with gr.Row():
-                    save_report_btn = gr.Button("一键导出报告")
+                    upload_report_btn = gr.Button("上传")
+                    save_local_report_btn = gr.Button("保存至本地")
+
                 result_text = gr.Markdown("等待操作\n\n\n")
 
-            export_dumps_btn.click(
-                fn=self.export_dumps,
-                outputs=[result_text]
-            )
-            export_logs_btn.click(
-                fn=self.export_logs,
+            def on_upload_click(title: str, description: str):
+                yield from _save_bug_report(title, description, self._kaa.version, upload=True)
+
+            def on_save_local_click(title: str, description: str):
+                yield from _save_bug_report(title, description, self._kaa.version, upload=False)
+
+            upload_report_btn.click(
+                fn=on_upload_click,
+                inputs=[report_title, report_description],
                 outputs=[result_text]
             )
-            save_report_btn.click(
-                fn=partial(_save_bug_report, version=self._kaa.version),
+            save_local_report_btn.click(
+                fn=on_save_local_click,
+                inputs=[report_title, report_description],
                 outputs=[result_text]
             )
 
     def _create_whats_new_tab(self) -> None:
-        """创建更新日志标签页，并显示最新版本更新内容"""
-        with gr.Tab("更新日志"):
-            from kotonebot.kaa.metadata import WHATS_NEW
-            gr.Markdown(WHATS_NEW)
+        """创建更新标签页"""
+        with gr.Tab("更新"):
+            gr.Markdown("## 版本管理")
+
+            # 更新日志
+            with gr.Accordion("更新日志", open=False):
+                from kotonebot.kaa.metadata import WHATS_NEW
+                gr.Markdown(WHATS_NEW)
+
+            # 载入信息按钮
+            load_info_btn = gr.Button("载入信息", variant="primary")
+
+            # 状态信息
+            status_text = gr.Markdown("")
+
+            # 版本选择下拉框（用于安装）
+            version_dropdown = gr.Dropdown(
+                label="选择要安装的版本",
+                choices=[],
+                value=None,
+                visible=False,
+                interactive=True
+            )
+
+            # 安装选定版本按钮
+            install_selected_btn = gr.Button("安装选定版本", visible=False)
+
+            def list_all_versions():
+                """列出所有可用版本"""
+                import logging
+                logger = logging.getLogger(__name__)
+
+                try:
+                    # 构建命令，使用清华镜像源
+                    cmd = [
+                        sys.executable, "-m", "pip", "index", "versions", "ksaa", "--json",
+                        "--index-url", "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple",
+                        "--trusted-host", "mirrors.tuna.tsinghua.edu.cn"
+                    ]
+                    logger.info(f"执行命令: {' '.join(cmd)}")
+
+                    # 使用 pip index versions --json 来获取版本信息
+                    result = subprocess.run(
+                        cmd,
+                        capture_output=True,
+                        text=True,
+                        timeout=30
+                    )
+
+                    logger.info(f"命令返回码: {result.returncode}")
+                    if result.stdout:
+                        logger.info(f"命令输出: {result.stdout[:500]}...")  # 只记录前500字符
+                    if result.stderr:
+                        logger.warning(f"命令错误输出: {result.stderr}")
+
+                    if result.returncode != 0:
+                        error_msg = f"获取版本列表失败: {result.stderr}"
+                        logger.error(error_msg)
+                        return (
+                            error_msg,
+                            gr.Button(value="载入信息", interactive=True),
+                            gr.Dropdown(visible=False),
+                            gr.Button(visible=False)
+                        )
+
+                    # 解析 JSON 输出
+                    try:
+                        data = json.loads(result.stdout)
+                        versions = data.get("versions", [])
+                        latest_version = data.get("latest", "")
+                        installed_version = data.get("installed_version", "")
+
+                        logger.info(f"解析到 {len(versions)} 个版本")
+                        logger.info(f"最新版本: {latest_version}")
+                        logger.info(f"已安装版本: {installed_version}")
+
+                    except json.JSONDecodeError as e:
+                        error_msg = f"解析版本信息失败: {str(e)}"
+                        logger.error(error_msg)
+                        return (
+                            error_msg,
+                            gr.Button(value="载入信息", interactive=True),
+                            gr.Dropdown(visible=False),
+                            gr.Button(visible=False)
+                        )
+
+                    if not versions:
+                        error_msg = "未找到可用版本"
+                        logger.warning(error_msg)
+                        return (
+                            error_msg,
+                            gr.Button(value="载入信息", interactive=True),
+                            gr.Dropdown(visible=False),
+                            gr.Button(visible=False)
+                        )
+
+                    # 构建状态信息
+                    status_info = []
+                    if installed_version:
+                        status_info.append(f"**当前安装版本:** {installed_version}")
+                    if latest_version:
+                        status_info.append(f"**最新版本:** {latest_version}")
+                    status_info.append(f"**找到 {len(versions)} 个可用版本**")
+
+                    status_message = "\n\n".join(status_info)
+                    logger.info(f"版本信息载入完成: {status_message}")
+
+                    # 返回更新后的组件
+                    return (
+                        status_message,
+                        gr.Button(value="载入信息", interactive=True),
+                        gr.Dropdown(choices=versions, value=versions[0] if versions else None, visible=True, label="选择要安装的版本"),
+                        gr.Button(visible=True, value="安装选定版本")
+                    )
+
+                except subprocess.TimeoutExpired:
+                    error_msg = "获取版本列表超时"
+                    logger.error(error_msg)
+                    return (
+                        error_msg,
+                        gr.Button(value="载入信息", interactive=True),
+                        gr.Dropdown(visible=False),
+                        gr.Button(visible=False)
+                    )
+                except Exception as e:
+                    error_msg = f"获取版本列表失败: {str(e)}"
+                    logger.error(error_msg)
+                    return (
+                        error_msg,
+                        gr.Button(value="载入信息", interactive=True),
+                        gr.Dropdown(visible=False),
+                        gr.Button(visible=False)
+                    )
+
+            def install_selected_version(selected_version: str):
+                """安装选定的版本"""
+                import logging
+                import threading
+                import time
+                logger = logging.getLogger(__name__)
+
+                if not selected_version:
+                    error_msg = "请先选择一个版本"
+                    logger.warning(error_msg)
+                    return error_msg
+
+                def install_and_exit():
+                    """在后台线程中执行安装并退出程序"""
+                    try:
+                        # 等待一小段时间确保UI响应已返回
+                        time.sleep(1)
+
+                        # 构建启动器命令
+                        bootstrap_path = os.path.join(os.getcwd(), "bootstrap.pyz")
+                        cmd = [sys.executable, bootstrap_path, f"--install-version={selected_version}"]
+                        logger.info(f"开始通过启动器安装版本 {selected_version}")
+                        logger.info(f"执行命令: {' '.join(cmd)}")
+
+                        # 启动启动器进程（不等待完成）
+                        subprocess.Popen(
+                            cmd,
+                            cwd=os.getcwd(),
+                            creationflags=subprocess.CREATE_NEW_CONSOLE if os.name == 'nt' else 0
+                        )
+
+                        # 等待一小段时间确保启动器启动
+                        time.sleep(2)
+
+                        # 退出当前程序
+                        logger.info("安装即将开始，正在退出当前程序...")
+                        os._exit(0)
+
+                    except Exception as e:
+                        raise
+
+                try:
+                    # 在后台线程中执行安装和退出
+                    install_thread = threading.Thread(target=install_and_exit, daemon=True)
+                    install_thread.start()
+
+                    return f"正在启动器中安装版本 {selected_version}，程序将自动重启..."
+
+                except Exception as e:
+                    error_msg = f"启动安装进程失败: {str(e)}"
+                    logger.error(error_msg)
+                    return error_msg
+
+            def load_info_with_button_state():
+                """载入信息并管理按钮状态"""
+                import logging
+                logger = logging.getLogger(__name__)
+
+                logger.info("开始载入版本信息")
+
+                # 先禁用按钮
+                yield (
+                    "正在载入版本信息...",
+                    gr.Button(value="载入中...", interactive=False),
+                    gr.Dropdown(visible=False),
+                    gr.Button(visible=False)
+                )
+
+                # 执行载入操作
+                result = list_all_versions()
+                logger.info("版本信息载入操作完成")
+                yield result
+
+            # 绑定事件
+            load_info_btn.click(
+                fn=load_info_with_button_state,
+                outputs=[status_text, load_info_btn, version_dropdown, install_selected_btn]
+            )
+
+            install_selected_btn.click(
+                fn=install_selected_version,
+                inputs=[version_dropdown],
+                outputs=[status_text]
+            )
 
     def _create_screen_tab(self) -> None:
         with gr.Tab("画面"):
             gr.Markdown("## 当前设备画面")
+            refresh_btn = gr.Button("刷新画面", variant="primary")
             WIDTH = 720 // 3
             HEIGHT = 1280 // 3
             last_update_text = gr.Markdown("上次更新时间：无数据")
@@ -1501,14 +1841,14 @@ class KotoneBotUI:
             def update_screenshot():
                 ctx = ContextStackVars.current()
                 if ctx is None:
-                    return [None, last_update_text.value]
+                    return [None, "上次更新时间：无上下文数据"]
                 screenshot = ctx._screenshot
                 if screenshot is None:
-                    return [None, last_update_text.value]
+                    return [None, "上次更新时间：无截图数据"]
                 screenshot = cv2.cvtColor(screenshot, cv2.COLOR_BGR2RGB)
                 return screenshot, f"上次更新时间：{datetime.now().strftime('%Y-%m-%d %H:%M:%S')}"
 
-            gr.Timer(0.3).tick(
+            refresh_btn.click(
                 fn=update_screenshot,
                 outputs=[screenshot_display, last_update_text]
             )