ok-script 2.0.23b1__tar.gz → 3.0.0b2__tar.gz

{ok_script-2.0.23b1 → ok_script-3.0.0b2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ok-script
-Version: 2.0.23b1
+Version: 3.0.0b2
 Summary: Vibe Coding Automation Framework
 Author-email: ok-oldking <firedcto@gmail.com>
 License: ok-script License
@@ -230,6 +230,16 @@ python -m venv .venv
 - [白荆回廊](https://github.com/ok-oldking/ok-baijing)（停止维护）
 - [崩坏：星穹铁道](https://github.com/Shasnow/ok-starrailassistant)（停止维护）
 
+## 开发 ok-script
+
+在本仓库中测试界面改动时，可以用 [main.py](main.py) 中的演示配置直接从源码启动 GUI：
+
+```powershell
+.\.venv\Scripts\python.exe main.py
+```
+
+它以记事本为目标窗口，无需游戏，并注册了一个演示一次性任务和一个触发任务，让任务、计划任务和模板页面都有内容。设置和日志保存在已被 git 忽略的 `configs/` 和 `logs/` 目录中。需要测试其他选项时，修改 `main.py` 中的 `config` 字典或演示任务即可。
+
 ## 社区与发布
 
 - 开发者 QQ 群：938132715

{ok_script-2.0.23b1 → ok_script-3.0.0b2}/README.md

@@ -106,6 +106,16 @@ python -m venv .venv
 - [白荆回廊](https://github.com/ok-oldking/ok-baijing)（停止维护）
 - [崩坏：星穹铁道](https://github.com/Shasnow/ok-starrailassistant)（停止维护）
 
+## 开发 ok-script
+
+在本仓库中测试界面改动时，可以用 [main.py](main.py) 中的演示配置直接从源码启动 GUI：
+
+```powershell
+.\.venv\Scripts\python.exe main.py
+```
+
+它以记事本为目标窗口，无需游戏，并注册了一个演示一次性任务和一个触发任务，让任务、计划任务和模板页面都有内容。设置和日志保存在已被 git 忽略的 `configs/` 和 `logs/` 目录中。需要测试其他选项时，修改 `main.py` 中的 `config` 字典或演示任务即可。
+
 ## 社区与发布
 
 - 开发者 QQ 群：938132715

{ok_script-2.0.23b1 → ok_script-3.0.0b2}/ok/__init__.py

@@ -310,6 +310,8 @@ class App(_OverlayConfigMixin):
         self.global_config = task_executor.global_config if task_executor else None
         from ok.ui.qt.util.app import init_app_config
         self.app, self.locale = init_app_config()
+        from ok.ui.qt.common.config import cfg as ui_config
+        ui_config.language_changed.connect(self._on_language_changed)
         install_qt_event_dispatcher()
         self.app.aboutToQuit.connect(self._close_device_manager)
         if task_executor is not None:
@@ -461,6 +463,44 @@ class App(_OverlayConfigMixin):
         self.do_show_main()
 
     def do_show_main(self):
+        self._create_main_window()
+        self.main_window.show()
+        self.main_window.bring_to_front()
+
+        logger.debug(f'show_main_window end')
+
+    def _on_language_changed(self):
+        # The signal comes from a widget in the window being replaced; rebuild once it returns.
+        from PySide6.QtCore import QTimer
+        QTimer.singleShot(0, self._apply_language)
+
+    def _apply_language(self):
+        from ok.ui.qt.util.app import install_translator
+        self.locale = install_translator(self.app)
+        self.po_translation = None
+        if og.executor is not None:
+            og.executor.locale = self.locale
+            og.executor.load_tr()
+        logger.info(f'language changed to {self.locale.name()}')
+
+        old_window = self.main_window
+        if old_window is None:
+            return
+        # Every page translates its text on construction, so build a fresh window.
+        visible = old_window.isVisible()
+        old_window.update_ok_config()
+        old_window.dispose()
+        self._create_main_window()
+        # Startup work in the first showEvent has already run for this process.
+        self.main_window.shown = True
+        self.main_window.switch_to(self.main_window.setting_tab)
+        if visible:
+            self.main_window.show()
+            self.main_window.bring_to_front()
+        old_window.hide()
+        old_window.deleteLater()
+
+    def _create_main_window(self):
         from ok.ui.qt.MainWindow import MainWindow
 
         self.main_window = MainWindow(self, self.config, self.ok_config, self.icon, self.title, self.version,
@@ -482,11 +522,6 @@ class App(_OverlayConfigMixin):
             if hasattr(og.my_app, 'on_show_main_window'):
                 og.my_app.on_show_main_window(self.main_window)
 
-        self.main_window.show()
-        self.main_window.bring_to_front()
-
-        logger.debug(f'show_main_window end')
-
     def exec(self):
         logger.info('app.exec()')
         import signal

{ok_script-2.0.23b1 → ok_script-3.0.0b2}/ok/core/events.py

@@ -45,6 +45,10 @@ class EventSignal:
             elif callback in self._subscribers:
                 self._subscribers.remove(callback)
 
+    def disconnect_where(self, predicate: Callable[[Callable[..., Any]], bool]) -> None:
+        with self._lock:
+            self._subscribers = [callback for callback in self._subscribers if not predicate(callback)]
+
     def emit(self, *args: Any, **kwargs: Any) -> None:
         with self._lock:
             subscribers = tuple(self._subscribers)
@@ -94,6 +98,12 @@ class EventBus:
             self.any.emit(EventMessage(name, args, kwargs))
         return forward
 
+    def disconnect_where(self, predicate: Callable[[Callable[..., Any]], bool]) -> None:
+        """Remove every subscriber of every event for which ``predicate`` is true."""
+        self.any.disconnect_where(predicate)
+        for name in self._event_names:
+            getattr(self, name).disconnect_where(predicate)
+
     def emit_draw_box(self, key=None, boxes=None, color=None, frame=None, debug=True):
         self.draw_box.emit(key, boxes, color, frame, debug)
 

{ok_script-2.0.23b1 → ok_script-3.0.0b2}/ok/ui/qt/MainWindow.py

@@ -2,7 +2,7 @@ import os
 import threading
 
 import pyappify
-from PySide6.QtCore import QCoreApplication, QEvent, QSize, Qt, QTimer
+from PySide6.QtCore import QCoreApplication, QEvent, QObject, QSize, Qt, QTimer
 from PySide6.QtGui import QColor
 from PySide6.QtWidgets import QApplication, QHBoxLayout, QMenu, QStackedWidget, QSystemTrayIcon, QVBoxLayout
 
@@ -34,6 +34,7 @@ from ok.ui.qt.common.config import cfg as ui_config
 from ok.ui.qt.kit import Dialog, KitWindow, NavigationView, Theme as KitTheme, set_toast_bottom_margin, show_toast, \
     theme as kit_theme
 from ok.ui.qt.kit.theme import set_style_property
+from ok.ui.qt.shell.lazy_page import LazyPage
 from ok.ui.qt.shell.nav_icons import nav_icon
 from ok.ui.qt.shell.run_bar import RunBar
 from ok.ui.qt.util.Alert import alert_error
@@ -117,7 +118,7 @@ class MainWindow(KitWindow):
         set_toast_bottom_margin(self, PAGE_MARGIN)
 
         self.schedule_tab = None
-        self.global_config_tabs = []
+        self.global_config_tabs = []  # [(config, LazyPage)]
 
         # Prepare custom tabs and separate them by add_after_default_tabs
         before_custom_tabs = []
@@ -155,9 +156,13 @@ class MainWindow(KitWindow):
             self.edit_task_tab = EditTaskTab()
             self.add_page(self.edit_task_tab, "pen", self.tr('Script'), SECTION_DEVELOP)
 
+        # Settings, Templates and global config pages are rarely opened, so they are
+        # built on first use (LazyPage) to keep window construction fast.
         if og.task_manager.has_custom or debug:
-            from ok.ui.qt.tasks.TemplateTab import TemplateTab
-            self.template_tab = TemplateTab(config=config)
+            def template_tab():
+                from ok.ui.qt.tasks.TemplateTab import TemplateTab
+                return TemplateTab(config=config)
+            self.template_tab = LazyPage(template_tab)
             self.add_page(self.template_tab, "image", self.tr('Templates'), SECTION_DEVELOP)
 
         from ok.ui.qt.debug.diagnosis_page import DiagnosisPage
@@ -192,9 +197,11 @@ class MainWindow(KitWindow):
         notification_tab = None
         for name, config_obj, option in global_config.get_all_visible_configs():
             if getattr(option, 'show_at_tab', False):
-                from ok.ui.qt.settings.GlobalConfigTab import GlobalConfigTab
-                config_tab = GlobalConfigTab(config_obj, option)
-                self.global_config_tabs.append(config_tab)
+                def global_config_tab(config_obj=config_obj, option=option):
+                    from ok.ui.qt.settings.GlobalConfigTab import GlobalConfigTab
+                    return GlobalConfigTab(config_obj, option)
+                config_tab = LazyPage(global_config_tab)
+                self.global_config_tabs.append((config_obj, config_tab))
                 if name == NOTIFICATION_OPTION_NAME:
                     notification_tab = config_tab
                 else:
@@ -204,8 +211,10 @@ class MainWindow(KitWindow):
             self.notification_tab = notification_tab
             self.add_page(notification_tab, "bell", self.app.tr(NOTIFICATION_OPTION_NAME), SECTION_GAME)
 
-        from ok.ui.qt.settings.settings_page import SettingsPage
-        self.setting_tab = SettingsPage()
+        def settings_page():
+            from ok.ui.qt.settings.settings_page import SettingsPage
+            return SettingsPage()
+        self.setting_tab = LazyPage(settings_page)
         self.add_page(self.setting_tab, "gear", self.tr('Settings'), bottom=True)
 
         from ok.ui.qt.about.AboutTab import AboutTab
@@ -275,6 +284,8 @@ class MainWindow(KitWindow):
     def switch_to(self, widget):
         if self.stack.indexOf(widget) < 0:
             return
+        if isinstance(widget, LazyPage):
+            widget.page()
         self.stack.setCurrentWidget(widget)
         self.navigation.set_current(widget.objectName())
 
@@ -442,12 +453,12 @@ class MainWindow(KitWindow):
                 logger.debug(f'bring_to_front native activation failed: {e}')
 
     def goto_global_config(self, key):
-        for config_tab in self.global_config_tabs:
-            if config_tab.has_key(key):
+        for config_obj, config_tab in self.global_config_tabs:
+            if key in config_obj:
                 self.switch_to(config_tab)
                 return
         self.switch_to(self.setting_tab)
-        self.setting_tab.goto_config(key)
+        self.setting_tab.page().goto_config(key)
 
     def tray_quit(self):
         logger.info('main window tray_quit')
@@ -669,6 +680,30 @@ class MainWindow(KitWindow):
                 except Exception as e:
                     logger.error(f'Error importing .okscript file: {e}')
 
+    def dispose(self):
+        """Release app-wide hooks so a replacement window can take over, e.g. after a language change."""
+        if self.update_check_timer is not None:
+            self.update_check_timer.stop()
+        self.tray.hide()
+        self.run_bar.dispose()
+        notification_manager = getattr(self, 'notification_manager', None)
+        if notification_manager is not None:
+            # Stopping waits for the pipeline thread; keep the GUI thread free.
+            threading.Thread(target=notification_manager.stop, name='NotificationStop', daemon=True).start()
+        controller = getattr(self, '_imported_tab_controller', None)
+        if controller is not None:
+            controller.dispose()
+        for page in list(self._pages.values()):
+            cleanup = getattr(page, 'dispose', None) or getattr(page, 'stop_worker', None)
+            if callable(cleanup):
+                try:
+                    cleanup()
+                except Exception as error:
+                    logger.error(f'Failed to dispose page {page.objectName()}', error)
+        # The event bus holds strong references; drop the ones owned by this window's widgets.
+        owners = {id(obj) for obj in (self, *self.findChildren(QObject))}
+        communicate.disconnect_where(lambda callback: id(getattr(callback, '__self__', None)) in owners)
+
     def closeEvent(self, event):
         if self.app.exit_event.is_set():
             logger.info("Window closed exit_event.is_set")

{ok_script-2.0.23b1 → ok_script-3.0.0b2}/ok/ui/qt/common/config.py

@@ -39,13 +39,13 @@ def deserialize_language(value) -> Language:
 
 
 class UiConfig(QObject):
-    """The language (applied on restart) and the theme mode (applied live).
+    """The language and the theme mode, both applied live.
 
     The file also accepts the older qfluentwidgets layout
     (``MainWindow.Language`` and ``QFluentWidgets.ThemeMode``).
     """
 
-    restart_required = Signal()
+    language_changed = Signal()
     theme_changed = Signal()
 
     def __init__(self, path: str):
@@ -83,7 +83,7 @@ class UiConfig(QObject):
             return
         self.language = language
         self.save()
-        self.restart_required.emit()
+        self.language_changed.emit()
 
     def set_theme_mode(self, mode: str) -> None:
         mode = getattr(mode, "value", mode)

{ok_script-2.0.23b1 → ok_script-3.0.0b2}/ok/ui/qt/kit/buttons.py

@@ -6,7 +6,7 @@ from ok.ui.qt.kit.icons import icon as kit_icon
 from ok.ui.qt.kit.theme import set_style_property, theme
 
 VARIANTS = ("secondary", "primary", "tonal", "subtle", "danger")
-SIZES = {"normal": (36, 14, 16), "small": (30, 10, 14)}
+SIZES = {"normal": (36, 14, 18), "small": (30, 10, 16)}
 
 _ICON_COLOR = {"primary": "on_accent", "danger": "danger"}
 
@@ -48,7 +48,8 @@ class Button(QPushButton):
         height, padding, _ = SIZES[size]
         layout = QHBoxLayout(self)
         layout.setContentsMargins(padding, 0, padding, 0)
-        layout.setSpacing(8)
+        # Glyphs leave a few pixels of air inside their box, so this reads wider than it is.
+        layout.setSpacing(5)
         layout.addStretch(1)
         layout.addWidget(self._icon_label)
         layout.addWidget(self._text_label)

{ok_script-2.0.23b1 → ok_script-3.0.0b2}/ok/ui/qt/kit/icons.py

@@ -17,9 +17,10 @@ from PySide6.QtGui import QColor, QIcon, QIconEngine, QImage, QPainter, QPixmap
 from PySide6.QtSvg import QSvgRenderer
 
 _PATHS = {
-    "play": '<path d="M7 4.5v15l12-7.5z" fill="currentColor" stroke="none"/>',
-    "pause": '<path d="M8 5v14M16 5v14"/>',
-    "stop": '<rect x="6" y="6" width="12" height="12" rx="2" fill="currentColor" stroke="none"/>',
+    "play": '<path d="M7 3.5v17L20.5 12z" fill="currentColor" stroke="currentColor" stroke-width="1.5"/>',
+    "pause": '<rect x="5.5" y="4" width="4.5" height="16" rx="1.25" fill="currentColor" stroke="none"/>'
+             '<rect x="14" y="4" width="4.5" height="16" rx="1.25" fill="currentColor" stroke="none"/>',
+    "stop": '<rect x="4.5" y="4.5" width="15" height="15" rx="2.5" fill="currentColor" stroke="none"/>',
     "power": '<path d="M12 3v9M6.3 6.8a8 8 0 1 0 11.4 0"/>',
     "check": '<path d="M5 12.5l4.5 4.5L19 7"/>',
     "x": '<path d="M6 6l12 12M18 6 6 18"/>',

{ok_script-2.0.23b1 → ok_script-3.0.0b2}/ok/ui/qt/kit/qss.py

@@ -218,12 +218,13 @@ QAbstractItemView {{
     selection-color: {text};
     outline: 0;
 }}
+QTableView::item {{ padding: 0 12px; }}
 QHeaderView::section {{
     background: {surface_alt};
     color: {text_secondary};
     border: 0;
     border-bottom: 1px solid {border};
-    padding: 6px 10px;
+    padding: 6px 12px;
     font-weight: 600;
 }}
 
@@ -387,6 +388,11 @@ QLabel#taskTile {{
     font-size: 12px;
     font-weight: 600;
 }}
+TaskIconTile#taskTile {{
+    background: transparent;
+    border: 0;
+    border-radius: 0;
+}}
 QPushButton#sectionHeader {{
     background: transparent;
     border: 0;

{ok_script-2.0.23b1 → ok_script-3.0.0b2}/ok/ui/qt/settings/settings_page.py

@@ -9,7 +9,6 @@ from PySide6.QtWidgets import QButtonGroup, QFrame, QHBoxLayout, QPushButton, QS
 from ok import og
 from ok.ui.qt.common.config import Language, cfg
 from ok.ui.qt.kit.cards import SettingGroup, SettingRow
-from ok.ui.qt.kit.feedback import show_toast
 from ok.ui.qt.kit.inputs import ComboBox
 from ok.ui.qt.kit.labels import Label
 from ok.ui.qt.kit.tabs import TabStrip
@@ -83,7 +82,6 @@ class SettingsPage(QWidget):
         layout.addWidget(anchor_holder)
         layout.addWidget(self.scroll, 1)
         theme.install(self)
-        cfg.restart_required.connect(self._show_restart_notice)
 
     # --- sections -------------------------------------------------------------
 
@@ -163,6 +161,3 @@ class SettingsPage(QWidget):
 
     def _set_theme(self, key: str) -> None:
         cfg.set_theme_mode(key)
-
-    def _show_restart_notice(self) -> None:
-        show_toast(self, _t('Configuration takes effect after restart'), _t('Updated successfully'), "success")

ok_script-3.0.0b2/ok/ui/qt/shell/lazy_page.py

@@ -0,0 +1,32 @@
+from PySide6.QtWidgets import QVBoxLayout, QWidget
+
+
+class LazyPage(QWidget):
+    """Stands in for a page in the main stack and builds it on first use.
+
+    Use :meth:`page` to reach the real page; it is built if needed.
+    """
+
+    def __init__(self, factory, parent=None):
+        super().__init__(parent)
+        self._factory = factory
+        self._page = None
+        self._layout = QVBoxLayout(self)
+        self._layout.setContentsMargins(0, 0, 0, 0)
+
+    def is_built(self) -> bool:
+        return self._page is not None
+
+    def page(self) -> QWidget:
+        if self._page is None:
+            self._page = self._factory()
+            self._factory = None
+            self._layout.addWidget(self._page)
+        return self._page
+
+    def dispose(self) -> None:
+        if self._page is None:
+            return
+        cleanup = getattr(self._page, 'dispose', None) or getattr(self._page, 'stop_worker', None)
+        if callable(cleanup):
+            cleanup()

{ok_script-2.0.23b1 → ok_script-3.0.0b2}/ok/ui/qt/shell/run_bar.py

@@ -41,9 +41,14 @@ def format_elapsed(seconds: float) -> str:
 
 
 def game_display_name(config) -> str:
-    """The game's name from the ``game_name`` config, or a generic "Game"."""
+    """The translated ``game_name`` config, or a generic "Game"."""
 
-    return (config or {}).get('game_name') or _t("RunBar", "Game")
+    from ok import og
+
+    name = (config or {}).get('game_name')
+    if name:
+        return og.app.tr(name) if og.app is not None else name
+    return _t("RunBar", "Game")
 
 
 @dataclass
@@ -321,6 +326,17 @@ class RunBar(QFrame):
 
     # --- global hotkey (runs on the handler thread) ----------------------------
 
+    def dispose(self) -> None:
+        """Release the hotkey and stop polling so a replacement run bar can bind it."""
+        self.timer.stop()
+        self.handler.post(self._release_hotkey)
+        self.handler.join(1)
+
+    def _release_hotkey(self) -> None:
+        # The hotkey belongs to the thread that registered it, so release it there.
+        windll.user32.UnregisterHotKey(None, HOTKEY_ID)
+        self.handler.stop()
+
     def _check_hotkey(self) -> None:
         new_hotkey = self.basic_options.get('Start/Stop')
         if new_hotkey != self.current_hotkey:

{ok_script-2.0.23b1 → ok_script-3.0.0b2}/ok/ui/qt/tasks/tasks_page.py

@@ -111,6 +111,14 @@ def task_icon(task):
     return None if resolved == FALLBACK else resolved
 
 
+def task_category_icon(key, fallback=None):
+    """Resolve app-provided category artwork, keeping the default kit icons."""
+
+    config = getattr(og, 'config', None) or {}
+    source = config.get('task_category_icons', {}).get(key, fallback)
+    return nav_icon(source) if source is not None else None
+
+
 def split_leading_symbol(name: str):
     """Split a leading emoji or symbol off a task name: ``("📅", "Daily Task")``.
 
@@ -176,7 +184,7 @@ def matches_filter(task, key: str, is_trigger: bool) -> bool:
 # --- list -------------------------------------------------------------------------
 
 class TaskIconTile(QLabel):
-    """The task's own icon on a rounded tile, or its monogram."""
+    """The task's own icon or monogram, without a background tile."""
 
     def __init__(self, task, size: int = 36, parent=None):
         super().__init__(parent)
@@ -313,7 +321,7 @@ class TaskSection(Card):
 
     toggled = Signal(bool)
 
-    def __init__(self, title: str, icon_name: str, parent=None):
+    def __init__(self, title: str, icon_name, parent=None):
         super().__init__(parent)
         self.rows = []
         self._expanded = True
@@ -388,7 +396,9 @@ class TaskSection(Card):
 
     def _refresh_icons(self) -> None:
         dpr = self.devicePixelRatioF()
-        self.icon_label.setPixmap(kit_icon(self._icon_name, "text", 1.8).pixmap(QSize(16, 16), dpr))
+        source = nav_icon(self._icon_name)
+        icon = kit_icon(source, "text", 1.8) if isinstance(source, str) else source
+        self.icon_label.setPixmap(icon.pixmap(QSize(16, 16), dpr))
         chevron = "chevron-up" if self._expanded else "chevron-down"
         self.chevron.setPixmap(kit_icon(chevron, "text_tertiary", 2).pixmap(QSize(14, 14), dpr))
 
@@ -471,6 +481,9 @@ class TaskDetail(QWidget):
         self.info_table.verticalHeader().hide()
         self.info_table.horizontalHeader().setSectionResizeMode(0, QHeaderView.ResizeMode.ResizeToContents)
         self.info_table.horizontalHeader().setStretchLastSection(True)
+        # Left-aligned headers line up with the padded cell text below them.
+        self.info_table.horizontalHeader().setDefaultAlignment(Qt.AlignmentFlag.AlignLeft | Qt.AlignmentFlag.AlignVCenter)
+        self.info_table.verticalHeader().setDefaultSectionSize(40)
         self.info_table.setEditTriggers(QAbstractItemView.EditTrigger.NoEditTriggers)
         self.info_table.setSelectionMode(QAbstractItemView.SelectionMode.NoSelection)
         self.pages = QStackedWidget()
@@ -670,8 +683,8 @@ class TasksPage(QWidget):
         top.addWidget(self.filter_tabs)
         top.addStretch(1)
 
-        self.onetime_section = TaskSection(_t("TasksPage", "On-demand"), "bolt")
-        self.trigger_section = TaskSection(_t("TasksPage", "Triggers"), "timer")
+        self.onetime_section = TaskSection(_t("TasksPage", "On-demand"), task_category_icon(KIND_ONETIME, "bolt"))
+        self.trigger_section = TaskSection(_t("TasksPage", "Triggers"), task_category_icon(KIND_TRIGGER, "timer"))
         self.onetime_section.toggled.connect(lambda _on: self._layout_sections())
         self.trigger_section.toggled.connect(lambda _on: self._layout_sections())
         self.list_column = QVBoxLayout()
@@ -743,10 +756,13 @@ class TasksPage(QWidget):
 
         both_kinds = bool(self.onetime_tasks) and bool(self.trigger_tasks)
         groups = task_groups(self.onetime_tasks + self.trigger_tasks)
-        self.filter_tabs.add_tab(KIND_ALL, _t("TasksPage", "All"), len(self.onetime_tasks) + len(self.trigger_tasks))
+        self.filter_tabs.add_tab(KIND_ALL, _t("TasksPage", "All"), len(self.onetime_tasks) + len(self.trigger_tasks),
+                                 task_category_icon(KIND_ALL))
         if both_kinds:
-            self.filter_tabs.add_tab(KIND_ONETIME, _t("TasksPage", "On-demand"), len(self.onetime_tasks), "bolt")
-            self.filter_tabs.add_tab(KIND_TRIGGER, _t("TasksPage", "Triggers"), len(self.trigger_tasks), "timer")
+            self.filter_tabs.add_tab(KIND_ONETIME, _t("TasksPage", "On-demand"), len(self.onetime_tasks),
+                                     task_category_icon(KIND_ONETIME, "bolt"))
+            self.filter_tabs.add_tab(KIND_TRIGGER, _t("TasksPage", "Triggers"), len(self.trigger_tasks),
+                                     task_category_icon(KIND_TRIGGER, "timer"))
         if groups:
             self.filter_tabs.add_separator()
             for name, group_icon in groups.items():

{ok_script-2.0.23b1 → ok_script-3.0.0b2}/ok/ui/qt/util/app.py

@@ -9,6 +9,27 @@ from ok.ui.qt.common.config import cfg
 
 logger = Logger.get_logger(__name__)
 
+_translator = None
+
+
+def install_translator(app):
+    """Replace the installed Qt translator with one for ``cfg.language``; returns the locale."""
+    global _translator
+    if _translator is not None:
+        app.removeTranslator(_translator)
+        _translator.deleteLater()
+        _translator = None
+    locale = cfg.language.value
+    translator = QTranslator(app)
+    if translator.load(locale.name(), ":/i18n"):
+        app.installTranslator(translator)
+        _translator = translator
+        logger.info(f"translator install success {locale}, {QCoreApplication.translate('MainWindow', 'Debug')}")
+    else:
+        translator.deleteLater()
+        logger.info(f"No translation available for {locale}, falling back to English/default.")
+    return locale
+
 
 def init_app_config():
     logger.debug(f'resources.qt_resource_name {resources.qt_resource_name} theme {cfg.theme_mode}')
@@ -20,13 +41,7 @@ def init_app_config():
     app.setAttribute(Qt.AA_UseHighDpiPixmaps)
     app.setAttribute(Qt.AA_DontCreateNativeWidgetSiblings)
 
-    locale = cfg.language.value
-    translator = QTranslator(app)
-    if translator.load(locale.name(), ":/i18n"):
-        app.installTranslator(translator)
-        logger.info(f"translator install success {locale}, {QCoreApplication.translate('MainWindow', 'Debug')}")
-    else:
-        logger.info(f"No translation available for {locale}, falling back to English/default.")
+    locale = install_translator(app)
 
     from ok.ui.qt.kit import Theme, theme
     theme.set_theme(Theme(cfg.theme_mode))

{ok_script-2.0.23b1 → ok_script-3.0.0b2}/ok_script.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ok-script
-Version: 2.0.23b1
+Version: 3.0.0b2
 Summary: Vibe Coding Automation Framework
 Author-email: ok-oldking <firedcto@gmail.com>
 License: ok-script License
@@ -230,6 +230,16 @@ python -m venv .venv
 - [白荆回廊](https://github.com/ok-oldking/ok-baijing)（停止维护）
 - [崩坏：星穹铁道](https://github.com/Shasnow/ok-starrailassistant)（停止维护）
 
+## 开发 ok-script
+
+在本仓库中测试界面改动时，可以用 [main.py](main.py) 中的演示配置直接从源码启动 GUI：
+
+```powershell
+.\.venv\Scripts\python.exe main.py
+```
+
+它以记事本为目标窗口，无需游戏，并注册了一个演示一次性任务和一个触发任务，让任务、计划任务和模板页面都有内容。设置和日志保存在已被 git 忽略的 `configs/` 和 `logs/` 目录中。需要测试其他选项时，修改 `main.py` 中的 `config` 字典或演示任务即可。
+
 ## 社区与发布
 
 - 开发者 QQ 群：938132715

{ok_script-2.0.23b1 → ok_script-3.0.0b2}/ok_script.egg-info/SOURCES.txt

@@ -214,6 +214,7 @@ ok/ui/qt/settings/settings_page.py
 ok/ui/qt/shell/__init__.py
 ok/ui/qt/shell/connection.py
 ok/ui/qt/shell/diagnostics.py
+ok/ui/qt/shell/lazy_page.py
 ok/ui/qt/shell/log_page.py
 ok/ui/qt/shell/nav_icons.py
 ok/ui/qt/shell/run_bar.py
@@ -306,6 +307,7 @@ tests/test_handler.py
 tests/test_headless_imports.py
 tests/test_inline_ok_requirements.py
 tests/test_kit.py
+tests/test_lazy_page.py
 tests/test_log_page.py
 tests/test_logger.py
 tests/test_main_window_notifications.py

ok_script-3.0.0b2/tests/test_lazy_page.py

@@ -0,0 +1,47 @@
+import os
+import unittest
+from unittest.mock import Mock
+
+os.environ.setdefault('QT_QPA_PLATFORM', 'offscreen')
+
+from PySide6.QtWidgets import QApplication, QWidget
+
+from ok.ui.qt.shell.lazy_page import LazyPage
+
+
+class TestLazyPage(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        cls.qt_app = QApplication.instance() or QApplication([])
+
+    def test_builds_once_on_first_use(self):
+        factory = Mock(side_effect=QWidget)
+        lazy = LazyPage(factory)
+
+        self.assertFalse(lazy.is_built())
+        factory.assert_not_called()
+
+        page = lazy.page()
+        self.assertIs(page, lazy.page())
+        self.assertIs(lazy, page.parentWidget())
+        factory.assert_called_once_with()
+
+    def test_dispose_skips_unbuilt_page(self):
+        factory = Mock(side_effect=QWidget)
+        LazyPage(factory).dispose()
+
+        factory.assert_not_called()
+
+    def test_dispose_forwards_to_built_page(self):
+        page = QWidget()
+        page.dispose = Mock()
+        lazy = LazyPage(lambda: page)
+        lazy.page()
+
+        lazy.dispose()
+
+        page.dispose.assert_called_once_with()
+
+
+if __name__ == "__main__":
+    unittest.main()

{ok_script-2.0.23b1 → ok_script-3.0.0b2}/tests/test_main_window_system_theme.py

@@ -48,7 +48,7 @@ class TestUiConfig(unittest.TestCase):
             self.assertEqual("dark", config.theme_mode)
 
             restart, themed = Mock(), Mock()
-            config.restart_required.connect(restart)
+            config.language_changed.connect(restart)
             config.theme_changed.connect(themed)
             config.set_language(Language.ENGLISH)
             config.set_theme_mode("light")