frontengine 1.0.34__tar.gz → 1.0.35__tar.gz

{frontengine-1.0.34 → frontengine-1.0.35}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.34
+Version: 1.0.35
 Summary: FrontEngine is use-define frontview or only use like screen saver
 Author-email: JE-Chen <jechenmailman@gmail.com>
 Project-URL: Homepage, https://github.com/Intergration-Automation-Testing/FrontEngine

{frontengine-1.0.34 → frontengine-1.0.35}/frontengine/show/base_widget.py

@@ -8,6 +8,7 @@ from PySide6.QtWidgets import QWidget
 from frontengine.show.window_helpers import apply_overlay_window_flags, load_overlay_icon
 from frontengine.user_setting.user_setting_file import get_overlay_geometry, save_overlay_geometry
 from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.power_mode.power_mode import DEFAULT_TIER, normalize_tier, tier_render_scale
 
 
 class BaseWidget(QWidget):
@@ -29,6 +30,9 @@ class BaseWidget(QWidget):
         # 綠幕背景色：設了就以不透明色填滿背景，方便 OBS 去背
         # Chroma key colour: fills the background opaquely so OBS can key it out.
         self.background_color: Optional[QColor] = None
+        # 畫質檔位：影響更新頻率上限與算圖縮放（見 utils/power_mode）
+        # Quality tier: caps the refresh rate and scales rendering (see utils/power_mode).
+        self.quality_tier: str = DEFAULT_TIER
         self._drag_origin = None
         self._geometry_restored = False
 
@@ -44,6 +48,27 @@ class BaseWidget(QWidget):
         front_engine_logger.info(f"{self.__class__.__name__} set_ui_variable | opacity: {opacity}")
         self.opacity = opacity
 
+    def set_quality_tier(self, tier: str) -> None:
+        """
+        設定畫質檔位。基底類別只記下來並通知子類別，實際怎麼省由子類別決定
+        （例如放慢自己的計時器、用較低解析度算圖）。
+        Set the quality tier. The base class records it and tells the subclass;
+        what to actually give up - timer rate, render resolution - is the
+        subclass's call.
+        """
+        self.quality_tier = normalize_tier(tier)
+        front_engine_logger.info(
+            f"{self.__class__.__name__} set_quality_tier | tier: {self.quality_tier}")
+        self.apply_quality_tier()
+        self.update()
+
+    def apply_quality_tier(self) -> None:
+        """子類別覆寫這裡，把新的檔位套到自己的計時器／算圖上。"""
+
+    def render_scale(self) -> float:
+        """目前檔位的算圖縮放，1.0 表示原生解析度。"""
+        return tier_render_scale(self.quality_tier)
+
     def set_background_color(self, color) -> None:
         """
         設定綠幕背景色（傳 None 取消）。背景以不透明色填滿，內容再依原本的

frontengine-1.0.35/frontengine/show/toast/toast_widget.py

@@ -0,0 +1,120 @@
+"""
+提示卡：在畫面上方短暫顯示一行字（提醒到期、規則觸發等），時間到自己關掉。
+點擊穿透，不會擋到底下的操作。
+
+A toast: a line of text shown briefly near the top of the screen - a reminder
+coming due, a rule firing - that closes itself. Click-through, so it never gets
+in the way of what is underneath.
+"""
+from __future__ import annotations
+
+from typing import Optional
+
+from PySide6.QtCore import Qt, QTimer
+from PySide6.QtGui import QColor, QFont, QFontMetrics, QGuiApplication, QPainter
+
+from frontengine.show.base_widget import BaseWidget
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+
+DEFAULT_DURATION_MS = 5000
+MIN_DURATION_MS = 500
+_PADDING = 18
+_CORNER_RADIUS = 10
+
+
+def clamp_duration(value, fallback: int = DEFAULT_DURATION_MS) -> int:
+    """顯示時間至少半秒，避免設成 0 讓提示閃一下就不見。"""
+    try:
+        return max(MIN_DURATION_MS, int(value))
+    except (TypeError, ValueError):
+        return fallback
+
+
+class ToastWidget(BaseWidget):
+    """
+    一張自動消失的提示卡。文字寬度決定卡片寬度，位置預設貼在主螢幕上方置中。
+    An auto-dismissing toast. The card is sized to its text and sits centred
+    near the top of the primary screen by default.
+    """
+
+    def __init__(self, message: str = "", duration_ms: int = DEFAULT_DURATION_MS,
+                 font_size: int = 18) -> None:
+        front_engine_logger.info(f"[ToastWidget] Init | message={message!r}")
+        super().__init__()
+        self.message: str = str(message)
+        self.duration_ms: int = clamp_duration(duration_ms)
+        self.text_color = QColor("#ffffff")
+        self.card_color = QColor(20, 20, 20, 230)
+        self.opacity = 1.0
+        # 提示卡不該被拖曳擺位，也不接受點擊
+        # A toast is never dragged into place and never takes clicks.
+        self.overlay_lockable = False
+        self._font = QFont()
+        self._font.setPointSize(max(8, int(font_size)))
+        self._close_timer = QTimer(self)
+        self._close_timer.setSingleShot(True)
+        self._close_timer.timeout.connect(self.close)
+        self.set_ui_window_flag(show_on_bottom=False)
+        self.resize_to_message()
+
+    def set_message(self, message: str) -> None:
+        """換一則訊息並重新計算卡片大小。"""
+        self.message = str(message)
+        self.resize_to_message()
+        self.update()
+
+    def card_size(self) -> tuple:
+        """依文字算出卡片的寬高（含內距）。"""
+        metrics = QFontMetrics(self._font)
+        width = metrics.horizontalAdvance(self.message) + _PADDING * 2
+        height = metrics.height() + _PADDING
+        return (max(80, width), max(36, height))
+
+    def resize_to_message(self) -> None:
+        width, height = self.card_size()
+        self.resize(width, height)
+        self.move_to_top_centre()
+
+    def move_to_top_centre(self, screen=None) -> None:
+        """擺到螢幕上方置中（離頂端一小段距離，避開全螢幕程式的標題列）。"""
+        target = screen or QGuiApplication.primaryScreen()
+        if target is None:  # pragma: no cover - no screen at all
+            return
+        available = target.availableGeometry()
+        self.move(
+            available.x() + (available.width() - self.width()) // 2,
+            available.y() + max(24, available.height() // 12),
+        )
+
+    def show_toast(self, screen=None) -> None:
+        """顯示並在時間到時自動關閉。"""
+        self.resize_to_message()
+        self.move_to_top_centre(screen)
+        self.show()
+        self._close_timer.start(self.duration_ms)
+
+    def draw_content(self, painter: QPainter) -> None:
+        painter.setRenderHint(QPainter.RenderHint.Antialiasing, True)
+        painter.setPen(Qt.PenStyle.NoPen)
+        painter.setBrush(self.card_color)
+        painter.drawRoundedRect(self.rect(), _CORNER_RADIUS, _CORNER_RADIUS)
+        painter.setFont(self._font)
+        painter.setPen(self.text_color)
+        painter.drawText(self.rect(), Qt.AlignmentFlag.AlignCenter, self.message)
+
+
+def show_toast(message: str, duration_ms: int = DEFAULT_DURATION_MS,
+               screen=None) -> Optional[ToastWidget]:
+    """
+    顯示一則提示卡並回傳它（訊息為空就不顯示，回傳 None）。呼叫端不必自己
+    管生命週期：時間到會自己 close，而 BaseWidget 帶著 WA_DeleteOnClose。
+    Show a toast and hand it back (None for an empty message). Callers do not
+    have to manage its life: it closes itself, and BaseWidget carries
+    WA_DeleteOnClose.
+    """
+    text = str(message or "").strip()
+    if not text:
+        return None
+    toast = ToastWidget(text, duration_ms)
+    toast.show_toast(screen)
+    return toast

{frontengine-1.0.34 → frontengine-1.0.35}/frontengine/show/wallpaper/wallpaper_widget.py

@@ -13,12 +13,13 @@ from __future__ import annotations
 from pathlib import Path
 from typing import Optional
 
-from PySide6.QtCore import QRect, QTimer
+from PySide6.QtCore import QRect, Qt, QTimer
 from PySide6.QtGui import QMovie, QPainter, QPixmap
 
 from frontengine.show.base_widget import BaseWidget
 from frontengine.utils.audio_meter.audio_envelope import AudioEnvelope
 from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.power_mode.power_mode import tier_interval
 
 _ANIMATED_SUFFIXES = (".gif", ".webp")
 MIN_REACT_SCALE = 1.0
@@ -105,12 +106,17 @@ class WallpaperWidget(BaseWidget):
         if strength is not None:
             self.react_strength = max(0, min(100, int(strength)))
         if self.audio_react:
-            self._react_timer.start(self.REACT_INTERVAL_MS)
+            self._react_timer.start(tier_interval(self.REACT_INTERVAL_MS, self.quality_tier))
         else:
             self._react_timer.stop()
             self.scale = MIN_REACT_SCALE
             self.update()
 
+    def apply_quality_tier(self) -> None:
+        """畫質檔位改變時，跟著調整脈動的更新頻率（算圖縮放在繪製時套用）。"""
+        if self._react_timer.isActive():
+            self._react_timer.start(tier_interval(self.REACT_INTERVAL_MS, self.quality_tier))
+
     def _update_scale(self) -> None:
         """取一次音量、平滑後換成縮放比例。"""
         if not self.audio_react or self._level_provider is None:
@@ -141,6 +147,14 @@ class WallpaperWidget(BaseWidget):
         pixmap = self.current_pixmap()
         if pixmap is None or pixmap.isNull():
             return
+        # 低畫質檔位先把來源縮小再放大回來：算的像素少，看起來只是稍軟。
+        # Lower tiers shrink the source before scaling it back up: fewer pixels
+        # to push, at the cost of a slightly softer picture.
+        scale = self.render_scale()
+        if scale < 1.0:
+            pixmap = pixmap.scaled(
+                max(1, int(pixmap.width() * scale)), max(1, int(pixmap.height() * scale)),
+                Qt.AspectRatioMode.IgnoreAspectRatio, Qt.TransformationMode.FastTransformation)
         width = int(self.width() * self.scale)
         height = int(self.height() * self.scale)
         # 放大時往外溢出，維持置中，畫面才不會出現黑邊

frontengine-1.0.35/frontengine/ui/dialog/app_profile_dialog.py

@@ -0,0 +1,115 @@
+"""
+程式對應預設集：切到某個程式時自動套用一組覆蓋層設定（例如打開剪輯軟體
+就換成「工作」那組）。左欄填程式名稱，右欄挑一個已儲存的預設集。
+
+Per-app profiles: apply a saved preset when a given app takes focus - the
+"work" set when the editor comes up. The left column is the app name, the right
+column picks one of your saved presets.
+"""
+from __future__ import annotations
+
+from typing import Dict, Optional
+
+from PySide6.QtWidgets import (
+    QAbstractItemView, QComboBox, QDialog, QDialogButtonBox, QGridLayout, QLabel, QPushButton,
+    QTableWidget, QTableWidgetItem, QWidget,
+)
+
+from frontengine.user_setting.preset_repository import PresetRepository
+from frontengine.user_setting.user_setting_file import user_setting_dict, write_user_setting
+from frontengine.utils.app_profile.app_profile_service import normalize_profiles
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.smart_pause.pause_rules import normalize_app_name
+
+
+def _t(key: str, fallback: str) -> str:
+    return language_wrapper.language_word_dict.get(key, fallback)
+
+
+def current_profiles() -> Dict[str, str]:
+    """目前設定裡的 {程式: 預設集} 對照表。"""
+    return normalize_profiles(user_setting_dict.get("app_profiles"))
+
+
+class AppProfileDialog(QDialog):
+    """編輯「程式 → 預設集」對照表。"""
+
+    def __init__(self, parent: Optional[QWidget] = None) -> None:
+        front_engine_logger.info("[AppProfileDialog] Init")
+        super().__init__(parent)
+        self.setWindowTitle(_t("app_profile_title", "App profiles"))
+        self.presets = PresetRepository().list_presets()
+
+        self.table = QTableWidget(0, 2)
+        self.table.setHorizontalHeaderLabels([
+            _t("app_profile_app_column", "Application"),
+            _t("app_profile_preset_column", "Preset"),
+        ])
+        self.table.setSelectionBehavior(QAbstractItemView.SelectionBehavior.SelectRows)
+        self.table.horizontalHeader().setStretchLastSection(True)
+
+        self.add_button = QPushButton(_t("app_profile_add", "Add"))
+        self.add_button.clicked.connect(lambda: self.add_row("", ""))
+        self.remove_button = QPushButton(_t("app_profile_remove", "Remove"))
+        self.remove_button.clicked.connect(self.remove_selected_row)
+        self.hint_label = QLabel(
+            _t("app_profile_hint",
+               "Presets are saved from the Presets menu. Without any saved preset "
+               "there is nothing to apply."))
+        self.hint_label.setWordWrap(True)
+
+        self.button_box = QDialogButtonBox(
+            QDialogButtonBox.StandardButton.Ok | QDialogButtonBox.StandardButton.Cancel)
+        self.button_box.accepted.connect(self.accept)
+        self.button_box.rejected.connect(self.reject)
+
+        layout = QGridLayout(self)
+        layout.addWidget(self.table, 0, 0, 1, 2)
+        layout.addWidget(self.add_button, 1, 0)
+        layout.addWidget(self.remove_button, 1, 1)
+        layout.addWidget(self.hint_label, 2, 0, 1, 2)
+        layout.addWidget(self.button_box, 3, 0, 1, 2)
+
+        for app, preset in current_profiles().items():
+            self.add_row(app, preset)
+
+    def add_row(self, app: str = "", preset: str = "") -> None:
+        """加一列（預設集下拉選單列出所有已儲存的預設集）。"""
+        row = self.table.rowCount()
+        self.table.insertRow(row)
+        self.table.setItem(row, 0, QTableWidgetItem(str(app)))
+        combobox = QComboBox()
+        combobox.addItems(self.presets)
+        # 設定裡指到已被刪掉的預設集時，仍把名稱留著讓使用者看得到
+        # Keep a name that points at a deleted preset visible instead of silently
+        # swapping it for another one.
+        if preset and preset not in self.presets:
+            combobox.addItem(str(preset))
+        if preset:
+            combobox.setCurrentText(str(preset))
+        self.table.setCellWidget(row, 1, combobox)
+
+    def remove_selected_row(self) -> None:
+        row = self.table.currentRow()
+        if row >= 0:
+            self.table.removeRow(row)
+
+    def profiles(self) -> Dict[str, str]:
+        """目前表格上的對照表（空白列會被略過）。"""
+        profiles: Dict[str, str] = {}
+        for row in range(self.table.rowCount()):
+            item = self.table.item(row, 0)
+            combobox = self.table.cellWidget(row, 1)
+            app = normalize_app_name(item.text() if item else "")
+            preset = combobox.currentText().strip() if combobox else ""
+            if app and preset:
+                profiles[app] = preset
+        return profiles
+
+    def accept(self) -> None:
+        profiles = self.profiles()
+        user_setting_dict["app_profiles"] = profiles
+        write_user_setting()
+        front_engine_logger.info(f"[AppProfileDialog] saved | {profiles}")
+        super().accept()

frontengine-1.0.35/frontengine/ui/dialog/reminder_dialog.py

@@ -0,0 +1,139 @@
+"""
+自訂提醒設定：每隔一段時間提醒一次（喝水、起來走走），或每天在固定時間
+提醒一次（會議、吃藥）。提醒會以畫面上方的提示卡顯示。
+
+Custom reminder settings: every N minutes (drink water, stand up) or once a day
+at a set time (a meeting, a pill). Reminders appear as a toast near the top of
+the screen.
+"""
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional
+
+from PySide6.QtCore import Qt
+from PySide6.QtWidgets import (
+    QAbstractItemView, QComboBox, QDialog, QDialogButtonBox, QGridLayout, QLabel, QPushButton,
+    QTableWidget, QTableWidgetItem, QWidget,
+)
+
+from frontengine.user_setting.user_setting_file import user_setting_dict, write_user_setting
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.reminder.reminder_service import (
+    KIND_AT, KIND_EVERY, normalize_reminder, normalize_reminders,
+)
+
+_COLUMN_LABEL = 0
+_COLUMN_KIND = 1
+_COLUMN_VALUE = 2
+
+
+def _t(key: str, fallback: str) -> str:
+    return language_wrapper.language_word_dict.get(key, fallback)
+
+
+def current_reminders() -> List[Dict[str, Any]]:
+    """目前設定裡的提醒清單（壞掉的項目會被跳過）。"""
+    return normalize_reminders(user_setting_dict.get("reminders"))
+
+
+class ReminderDialog(QDialog):
+    """編輯自訂提醒清單。"""
+
+    def __init__(self, parent: Optional[QWidget] = None) -> None:
+        front_engine_logger.info("[ReminderDialog] Init")
+        super().__init__(parent)
+        self.setWindowTitle(_t("reminder_title", "Reminders"))
+
+        self.table = QTableWidget(0, 3)
+        self.table.setHorizontalHeaderLabels([
+            _t("reminder_label_column", "Reminder"),
+            _t("reminder_kind_column", "When"),
+            _t("reminder_value_column", "Minutes / time"),
+        ])
+        self.table.setSelectionBehavior(QAbstractItemView.SelectionBehavior.SelectRows)
+        self.table.horizontalHeader().setStretchLastSection(True)
+
+        self.add_button = QPushButton(_t("reminder_add", "Add"))
+        self.add_button.clicked.connect(lambda: self.add_row())
+        self.remove_button = QPushButton(_t("reminder_remove", "Remove"))
+        self.remove_button.clicked.connect(self.remove_selected_row)
+        self.hint_label = QLabel(
+            _t("reminder_hint",
+               "Tick a row to keep it active. \"Every\" takes minutes, \"At\" takes a "
+               "24-hour time such as 14:30."))
+        self.hint_label.setWordWrap(True)
+
+        self.button_box = QDialogButtonBox(
+            QDialogButtonBox.StandardButton.Ok | QDialogButtonBox.StandardButton.Cancel)
+        self.button_box.accepted.connect(self.accept)
+        self.button_box.rejected.connect(self.reject)
+
+        layout = QGridLayout(self)
+        layout.addWidget(self.table, 0, 0, 1, 2)
+        layout.addWidget(self.add_button, 1, 0)
+        layout.addWidget(self.remove_button, 1, 1)
+        layout.addWidget(self.hint_label, 2, 0, 1, 2)
+        layout.addWidget(self.button_box, 3, 0, 1, 2)
+
+        for reminder in current_reminders():
+            self.add_row(reminder)
+
+    def add_row(self, reminder: Optional[Dict[str, Any]] = None) -> None:
+        """加一列；沒給資料就給一筆空白的「每 45 分鐘」。"""
+        entry = reminder or {"label": "", "kind": KIND_EVERY, "minutes": 45, "enabled": True}
+        row = self.table.rowCount()
+        self.table.insertRow(row)
+
+        label_item = QTableWidgetItem(str(entry.get("label", "")))
+        label_item.setFlags(label_item.flags() | Qt.ItemFlag.ItemIsUserCheckable)
+        label_item.setCheckState(Qt.CheckState.Checked if entry.get("enabled", True)
+                                 else Qt.CheckState.Unchecked)
+        self.table.setItem(row, _COLUMN_LABEL, label_item)
+
+        kind_combobox = QComboBox()
+        kind_combobox.addItem(_t("reminder_kind_every", "Every"), KIND_EVERY)
+        kind_combobox.addItem(_t("reminder_kind_at", "At"), KIND_AT)
+        kind_index = kind_combobox.findData(entry.get("kind", KIND_EVERY))
+        kind_combobox.setCurrentIndex(max(0, kind_index))
+        self.table.setCellWidget(row, _COLUMN_KIND, kind_combobox)
+
+        value = entry.get("at") if entry.get("kind") == KIND_AT else entry.get("minutes", 45)
+        self.table.setItem(row, _COLUMN_VALUE, QTableWidgetItem(str(value)))
+
+    def remove_selected_row(self) -> None:
+        row = self.table.currentRow()
+        if row >= 0:
+            self.table.removeRow(row)
+
+    def _row_entry(self, row: int) -> Optional[Dict[str, Any]]:
+        label_item = self.table.item(row, _COLUMN_LABEL)
+        value_item = self.table.item(row, _COLUMN_VALUE)
+        kind_combobox = self.table.cellWidget(row, _COLUMN_KIND)
+        if label_item is None or kind_combobox is None:
+            return None
+        kind = kind_combobox.currentData()
+        value = value_item.text().strip() if value_item else ""
+        entry = {
+            "label": label_item.text().strip(),
+            "kind": kind,
+            "enabled": label_item.checkState() == Qt.CheckState.Checked,
+        }
+        entry["at" if kind == KIND_AT else "minutes"] = value
+        return normalize_reminder(entry)
+
+    def reminders(self) -> List[Dict[str, Any]]:
+        """目前表格上的提醒（格式不對的列會被略過）。"""
+        reminders = []
+        for row in range(self.table.rowCount()):
+            entry = self._row_entry(row)
+            if entry is not None:
+                reminders.append(entry)
+        return reminders
+
+    def accept(self) -> None:
+        reminders = self.reminders()
+        user_setting_dict["reminders"] = reminders
+        write_user_setting()
+        front_engine_logger.info(f"[ReminderDialog] saved | {len(reminders)} reminder(s)")
+        super().accept()

frontengine-1.0.35/frontengine/ui/dialog/smart_pause_dialog.py

@@ -0,0 +1,87 @@
+"""
+智慧暫停設定：決定什麼時候該把覆蓋層暫時收起來——全螢幕程式在前景、
+改用電池供電，或指定的程式取得焦點。
+
+Smart-pause settings: when should the overlays stand down - a fullscreen app in
+front, the machine on battery, or one of your own apps taking focus.
+"""
+from __future__ import annotations
+
+from typing import Any, Dict, Optional
+
+from PySide6.QtWidgets import (
+    QCheckBox, QDialog, QDialogButtonBox, QGridLayout, QLabel, QLineEdit, QWidget,
+)
+
+from frontengine.user_setting.user_setting_file import user_setting_dict, write_user_setting
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.smart_pause.pause_rules import DEFAULT_RULES, parse_app_list
+
+
+def _t(key: str, fallback: str) -> str:
+    return language_wrapper.language_word_dict.get(key, fallback)
+
+
+def current_rules() -> Dict[str, Any]:
+    """從設定讀出目前的暫停規則（缺項目就補上預設值）。"""
+    stored = user_setting_dict.get("smart_pause_rules")
+    rules = dict(DEFAULT_RULES)
+    if isinstance(stored, dict):
+        rules.update({key: stored[key] for key in DEFAULT_RULES if key in stored})
+    rules["apps"] = parse_app_list(rules.get("apps"))
+    return rules
+
+
+class SmartPauseDialog(QDialog):
+    """讓使用者挑選哪些情況要暫停覆蓋層。"""
+
+    def __init__(self, parent: Optional[QWidget] = None) -> None:
+        front_engine_logger.info("[SmartPauseDialog] Init")
+        super().__init__(parent)
+        self.setWindowTitle(_t("smart_pause_title", "Smart pause"))
+        rules = current_rules()
+
+        self.fullscreen_checkbox = QCheckBox(
+            _t("smart_pause_fullscreen", "Pause while a fullscreen app is running"))
+        self.fullscreen_checkbox.setChecked(bool(rules.get("fullscreen", True)))
+        self.battery_checkbox = QCheckBox(
+            _t("smart_pause_battery", "Pause while running on battery"))
+        self.battery_checkbox.setChecked(bool(rules.get("battery", False)))
+        self.apps_label = QLabel(
+            _t("smart_pause_apps_label", "Pause while these apps have focus:"))
+        self.apps_edit = QLineEdit(", ".join(rules.get("apps", [])))
+        self.apps_edit.setPlaceholderText("photoshop, premiere, blender")
+        self.hint_label = QLabel(
+            _t("smart_pause_hint",
+               "Names are matched without the folder or .exe, so \"photoshop\" is enough."))
+        self.hint_label.setWordWrap(True)
+
+        self.button_box = QDialogButtonBox(
+            QDialogButtonBox.StandardButton.Ok | QDialogButtonBox.StandardButton.Cancel)
+        self.button_box.accepted.connect(self.accept)
+        self.button_box.rejected.connect(self.reject)
+
+        layout = QGridLayout(self)
+        layout.addWidget(self.fullscreen_checkbox, 0, 0, 1, 2)
+        layout.addWidget(self.battery_checkbox, 1, 0, 1, 2)
+        layout.addWidget(self.apps_label, 2, 0, 1, 2)
+        layout.addWidget(self.apps_edit, 3, 0, 1, 2)
+        layout.addWidget(self.hint_label, 4, 0, 1, 2)
+        layout.addWidget(self.button_box, 5, 0, 1, 2)
+
+    def rules(self) -> Dict[str, Any]:
+        """目前對話框上的規則。"""
+        return {
+            "fullscreen": self.fullscreen_checkbox.isChecked(),
+            "battery": self.battery_checkbox.isChecked(),
+            "apps": parse_app_list(self.apps_edit.text()),
+        }
+
+    def accept(self) -> None:
+        """寫回設定；服務每次輪詢都會重讀，不需要重啟。"""
+        rules = self.rules()
+        user_setting_dict["smart_pause_rules"] = rules
+        write_user_setting()
+        front_engine_logger.info(f"[SmartPauseDialog] saved | {rules}")
+        super().accept()