frontengine 1.0.36__tar.gz → 1.0.38__tar.gz

{frontengine-1.0.36 → frontengine-1.0.38}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.36
+Version: 1.0.38
 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
@@ -166,6 +166,31 @@ that caps every overlay's refresh rate and drops its render resolution.
 
 ---
 
+## Screen time, clipboard and layouts
+
+Three things that remember, all of them **off until you switch them on** and
+all of them **local — nothing here is ever sent anywhere**:
+
+- **Screen time** (Settings → Screen time) — which apps had focus and for how
+  long, with a daily breakdown and a seven-day summary. It pauses while you are
+  away from the keyboard, keeps 60 days at most, and **clearing deletes the
+  file itself**. While it is off, no file is created at all.
+- **Clipboard history** (Settings → Clipboard history) — search what you copied
+  and pin the phrases you reuse. Clipboards routinely hold passwords, so this
+  is kept **in memory only** unless you separately tick "keep between
+  sessions".
+- **Window layouts** (Tools tab) — save where every window sits and put them
+  back later. Windows are matched by title, and one that is not on screen is
+  skipped rather than guessed at. Windows only.
+
+The **Screen care** tab also gains **colour-vision simulation** — protanopia,
+deuteranopia, tritanopia and achromatopsia at an adjustable severity, using the
+Machado et al. (2009) model. Unlike the other overlays it is opaque, because
+showing what someone else sees means repainting the screen rather than tinting
+it.
+
+---
+
 ## Community content
 
 - **Steam Workshop** — subscribed items are picked up from Steam's own

{frontengine-1.0.36 → frontengine-1.0.38}/README.md

@@ -142,6 +142,31 @@ that caps every overlay's refresh rate and drops its render resolution.
 
 ---
 
+## Screen time, clipboard and layouts
+
+Three things that remember, all of them **off until you switch them on** and
+all of them **local — nothing here is ever sent anywhere**:
+
+- **Screen time** (Settings → Screen time) — which apps had focus and for how
+  long, with a daily breakdown and a seven-day summary. It pauses while you are
+  away from the keyboard, keeps 60 days at most, and **clearing deletes the
+  file itself**. While it is off, no file is created at all.
+- **Clipboard history** (Settings → Clipboard history) — search what you copied
+  and pin the phrases you reuse. Clipboards routinely hold passwords, so this
+  is kept **in memory only** unless you separately tick "keep between
+  sessions".
+- **Window layouts** (Tools tab) — save where every window sits and put them
+  back later. Windows are matched by title, and one that is not on screen is
+  skipped rather than guessed at. Windows only.
+
+The **Screen care** tab also gains **colour-vision simulation** — protanopia,
+deuteranopia, tritanopia and achromatopsia at an adjustable severity, using the
+Machado et al. (2009) model. Unlike the other overlays it is opaque, because
+showing what someone else sees means repainting the screen rather than tinting
+it.
+
+---
+
 ## Community content
 
 - **Steam Workshop** — subscribed items are picked up from Steam's own

frontengine-1.0.38/frontengine/show/screen_care/color_vision_widget.py

@@ -0,0 +1,147 @@
+"""
+色覺模擬覆蓋層：抓一張畫面、套上色覺缺陷的轉換、再整片蓋回去。
+
+這一層和其他覆蓋層不同：它必須是不透明的，因為「模擬看不清楚的顏色」沒辦法
+用半透明疊色做到——得真的把底下的畫面重畫一次。畫面只在記憶體裡轉換，不存檔。
+
+A colour-vision overlay: grab the screen, apply the deficiency transform, and
+paint the result back over everything.
+
+It is opaque, unlike the other overlays: simulating a colour deficiency cannot
+be done by tinting, it needs the picture underneath redrawn. The grab is
+transformed in memory and never saved.
+"""
+from __future__ import annotations
+
+from typing import Optional
+
+import numpy
+from PySide6.QtCore import Qt, QTimer
+from PySide6.QtGui import QGuiApplication, QImage, QPainter, QPixmap
+
+from frontengine.show.base_widget import BaseWidget
+from frontengine.utils.color_vision.color_vision import (
+    KIND_DEUTERANOPIA, clamp_severity, normalize_kind, simulate_array,
+)
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.power_mode.power_mode import tier_interval
+
+# 色覺模擬不需要很高的更新率，五分之一秒足夠，也省下大量重繪
+# The simulation does not need a high refresh rate; five per second is plenty
+# and saves a great deal of redrawing.
+REFRESH_INTERVAL_MS = 200
+
+
+def image_to_array(image: QImage) -> Optional[numpy.ndarray]:
+    """
+    QImage -> H x W x 3 的 uint8 陣列。每列可能有補齊位元組，所以要照
+    bytesPerLine 切，不能直接 reshape。
+    QImage to an H x W x 3 uint8 array. Rows can be padded, so slice by
+    bytesPerLine rather than reshaping the raw buffer.
+    """
+    if image is None or image.isNull():
+        return None
+    converted = image.convertToFormat(QImage.Format.Format_RGB888)
+    width, height, stride = converted.width(), converted.height(), converted.bytesPerLine()
+    if width <= 0 or height <= 0:
+        return None
+    buffer = numpy.frombuffer(converted.constBits(), dtype=numpy.uint8, count=stride * height)
+    return buffer.reshape((height, stride))[:, : width * 3].reshape(
+        (height, width, 3)).copy()
+
+
+def array_to_image(pixels: numpy.ndarray) -> Optional[QImage]:
+    """H x W x 3 的 uint8 陣列 -> QImage（複製一份，不依賴呼叫端的緩衝區）。"""
+    data = numpy.ascontiguousarray(pixels, dtype=numpy.uint8)
+    if data.ndim != 3 or data.shape[2] != 3:
+        return None
+    height, width, _channels = data.shape
+    image = QImage(data.tobytes(), width, height, width * 3, QImage.Format.Format_RGB888)
+    return image.copy()
+
+
+class ColorVisionWidget(BaseWidget):
+    """
+    色覺模擬層。擷取函式可注入，所以不需要真的螢幕也測得到轉換流程。
+    """
+
+    def __init__(self, kind: str = KIND_DEUTERANOPIA, severity: float = 1.0) -> None:
+        front_engine_logger.info(f"[ColorVisionWidget] Init | kind={kind}")
+        super().__init__()
+        self.kind = normalize_kind(kind)
+        self.severity = clamp_severity(severity)
+        self.opacity = 1.0
+        self.simulated: Optional[QPixmap] = None
+        self._grabber = self._default_grabber
+        self._timer = QTimer(self)
+        self._timer.timeout.connect(self.refresh)
+        # 這一層是不透明的：它要蓋掉底下的畫面，而不是疊在上面
+        # This layer is opaque - it replaces what is underneath rather than
+        # tinting it.
+        self.setAttribute(Qt.WidgetAttribute.WA_TranslucentBackground, False)
+
+    @staticmethod
+    def _default_grabber(rect):  # pragma: no cover - needs a real screen
+        screen = QGuiApplication.primaryScreen()
+        if screen is None:
+            return None
+        return screen.grabWindow(0, rect.x(), rect.y(), rect.width(), rect.height())
+
+    def set_grabber(self, grabber) -> None:
+        """設定螢幕擷取函式（測試會換成假的）。"""
+        self._grabber = grabber or self._default_grabber
+
+    def set_simulation(self, kind: Optional[str] = None,
+                       severity: Optional[float] = None) -> None:
+        """換一種色覺類型或嚴重程度，立刻重畫。"""
+        if kind is not None:
+            self.kind = normalize_kind(kind)
+        if severity is not None:
+            self.severity = clamp_severity(severity)
+        self.refresh()
+
+    def start(self) -> None:
+        self.refresh()
+        self._timer.start(tier_interval(REFRESH_INTERVAL_MS, self.quality_tier))
+
+    def stop(self) -> None:
+        self._timer.stop()
+
+    def apply_quality_tier(self) -> None:
+        if self._timer.isActive():
+            self._timer.start(tier_interval(REFRESH_INTERVAL_MS, self.quality_tier))
+
+    def refresh(self) -> None:
+        """抓一次畫面、轉換、準備重畫。"""
+        geometry = self.geometry()
+        try:
+            # 擷取時先把自己藏起來，否則會拍到上一次的模擬結果，越疊越糊
+            # Hide first, or the grab catches the previous simulation and the
+            # picture degrades with every pass.
+            was_visible = self.isVisible()
+            if was_visible:
+                self.setVisible(False)
+            pixmap = self._grabber(geometry)
+            if was_visible:
+                self.setVisible(True)
+        except Exception as error:  # pragma: no cover - screen grab boundary
+            front_engine_logger.warning(f"[ColorVisionWidget] grab failed: {error!r}")
+            return
+        if pixmap is None or pixmap.isNull():
+            return
+        pixels = image_to_array(pixmap.toImage())
+        if pixels is None:
+            return
+        image = array_to_image(simulate_array(pixels, self.kind, self.severity))
+        if image is not None:
+            self.simulated = QPixmap.fromImage(image)
+            self.update()
+
+    def draw_content(self, painter: QPainter) -> None:
+        if self.simulated is None or self.simulated.isNull():
+            return
+        painter.drawPixmap(self.rect(), self.simulated)
+
+    def closeEvent(self, event) -> None:
+        self.stop()
+        super().closeEvent(event)

frontengine-1.0.38/frontengine/ui/dialog/clipboard_dialog.py

@@ -0,0 +1,147 @@
+"""
+剪貼簿歷史視窗：搜尋、釘選、貼回去。
+
+預設不記錄；要記錄得自己在這裡打開。除非再額外勾選「保存到檔案」，否則
+內容只留在記憶體，關掉程式就沒了——剪貼簿裡常有密碼，這是刻意的預設。
+
+The clipboard history window: search, pin, put back.
+
+Recording is off until switched on here, and unless "keep between sessions" is
+also ticked the history lives in memory only and is gone when the app closes.
+Clipboards routinely hold passwords; that default is deliberate.
+"""
+from __future__ import annotations
+
+from typing import Optional
+
+from PySide6.QtCore import Qt
+from PySide6.QtGui import QGuiApplication
+from PySide6.QtWidgets import (
+    QAbstractItemView, QCheckBox, QDialog, QDialogButtonBox, QGridLayout, QLabel, QLineEdit,
+    QListWidget, QListWidgetItem, QPushButton, QWidget,
+)
+
+from frontengine.user_setting.user_setting_file import user_setting_dict, write_user_setting
+from frontengine.utils.clipboard.clipboard_history import ClipboardHistory, preview
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.multi_language.language_wrapper import language_wrapper
+
+_PIN_MARK = "📌 "
+
+
+def _t(key: str, fallback: str) -> str:
+    return language_wrapper.language_word_dict.get(key, fallback)
+
+
+class ClipboardDialog(QDialog):
+    """瀏覽剪貼簿歷史並貼回去。"""
+
+    def __init__(self, history: ClipboardHistory, parent: Optional[QWidget] = None) -> None:
+        front_engine_logger.info("[ClipboardDialog] Init")
+        super().__init__(parent)
+        self.setWindowTitle(_t("clipboard_title", "Clipboard history"))
+        self.history = history
+
+        self.search_edit = QLineEdit()
+        self.search_edit.setPlaceholderText(_t("clipboard_search", "Search..."))
+        self.search_edit.textChanged.connect(self.reload_entries)
+
+        self.entry_list = QListWidget()
+        self.entry_list.setSelectionMode(QAbstractItemView.SelectionMode.SingleSelection)
+        self.entry_list.itemDoubleClicked.connect(lambda _item: self.copy_selected())
+
+        self.copy_button = QPushButton(_t("clipboard_copy", "Copy"))
+        self.copy_button.clicked.connect(self.copy_selected)
+        self.pin_button = QPushButton(_t("clipboard_pin", "Pin / unpin"))
+        self.pin_button.clicked.connect(self.toggle_pin_selected)
+        self.remove_button = QPushButton(_t("clipboard_remove", "Remove"))
+        self.remove_button.clicked.connect(self.remove_selected)
+        self.clear_button = QPushButton(_t("clipboard_clear", "Clear (keep pinned)"))
+        self.clear_button.clicked.connect(self.clear_history)
+
+        self.persist_checkbox = QCheckBox(
+            _t("clipboard_persist", "Keep this history between sessions"))
+        self.persist_checkbox.setChecked(bool(user_setting_dict.get("clipboard_persist")))
+        self.persist_checkbox.toggled.connect(self._store_persist)
+        self.hint_label = QLabel(
+            _t("clipboard_hint",
+               "History stays on this machine and is never sent anywhere. Unless you tick "
+               "the box above it is kept in memory only, because clipboards often hold "
+               "passwords."))
+        self.hint_label.setWordWrap(True)
+
+        self.button_box = QDialogButtonBox(QDialogButtonBox.StandardButton.Close)
+        self.button_box.rejected.connect(self.reject)
+
+        layout = QGridLayout(self)
+        layout.addWidget(self.search_edit, 0, 0, 1, 4)
+        layout.addWidget(self.entry_list, 1, 0, 1, 4)
+        layout.addWidget(self.copy_button, 2, 0)
+        layout.addWidget(self.pin_button, 2, 1)
+        layout.addWidget(self.remove_button, 2, 2)
+        layout.addWidget(self.clear_button, 2, 3)
+        layout.addWidget(self.persist_checkbox, 3, 0, 1, 4)
+        layout.addWidget(self.hint_label, 4, 0, 1, 4)
+        layout.addWidget(self.button_box, 5, 0, 1, 4)
+
+        self.reload_entries()
+
+    def reload_entries(self) -> int:
+        """依搜尋字串重畫清單，回傳顯示的筆數。"""
+        self.entry_list.clear()
+        for entry in self.history.search(self.search_edit.text()):
+            label = (_PIN_MARK if entry["pinned"] else "") + preview(entry["text"])
+            item = QListWidgetItem(label)
+            item.setData(Qt.ItemDataRole.UserRole, entry["text"])
+            item.setToolTip(entry["text"])
+            self.entry_list.addItem(item)
+        return self.entry_list.count()
+
+    def selected_text(self) -> Optional[str]:
+        item = self.entry_list.currentItem()
+        if item is None:
+            return None
+        return str(item.data(Qt.ItemDataRole.UserRole))
+
+    def copy_selected(self) -> bool:
+        """把選到的內容放回剪貼簿。"""
+        text = self.selected_text()
+        if text is None:
+            return False
+        clipboard = QGuiApplication.clipboard()
+        if clipboard is None:  # pragma: no cover - no clipboard at all
+            return False
+        clipboard.setText(text)
+        return True
+
+    def toggle_pin_selected(self) -> bool:
+        text = self.selected_text()
+        if text is None:
+            return False
+        current = next((entry for entry in self.history.entries if entry["text"] == text), None)
+        if current is None:
+            return False
+        self.history.set_pinned(text, not current["pinned"])
+        self.reload_entries()
+        return True
+
+    def remove_selected(self) -> bool:
+        text = self.selected_text()
+        if text is None:
+            return False
+        removed = self.history.remove(text)
+        self.reload_entries()
+        return removed
+
+    def clear_history(self) -> None:
+        """清空未釘選的紀錄。"""
+        self.history.clear(keep_pinned=True)
+        self.reload_entries()
+
+    def _store_persist(self, enabled: bool) -> None:
+        user_setting_dict["clipboard_persist"] = bool(enabled)
+        if not enabled:
+            # 取消保存時把已經寫下去的內容一併移除，不留殘影
+            # Turning saving off also clears what was already written down.
+            user_setting_dict["clipboard_entries"] = []
+        write_user_setting()

frontengine-1.0.38/frontengine/ui/dialog/usage_report_dialog.py

@@ -0,0 +1,120 @@
+"""
+使用時間報告：今天各程式用了多久，以及最近七天的總量。
+
+這份資料只存在本機的 frontengine_usage.json，不會傳到任何地方；統計預設關閉，
+而且這裡就有「清除」按鈕，按下去連檔案一起刪掉。
+
+The usage report: how long each app had focus today, plus the last seven days.
+
+The data lives only in the local frontengine_usage.json and goes nowhere else.
+Tracking is off by default, and the clear button here deletes the file itself.
+"""
+from __future__ import annotations
+
+from typing import Optional
+
+from PySide6.QtWidgets import (
+    QCheckBox, QDialog, QDialogButtonBox, QGridLayout, QHeaderView, QLabel, QPushButton,
+    QTableWidget, QTableWidgetItem, QWidget,
+)
+
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.usage_tracking.usage_tracker import UsageTracker, format_duration
+
+
+def _t(key: str, fallback: str) -> str:
+    return language_wrapper.language_word_dict.get(key, fallback)
+
+
+def share_percent(seconds: float, total: float) -> int:
+    """某個程式佔今天的百分比；今天還沒有紀錄就是 0。"""
+    if total <= 0:
+        return 0
+    return int(round(max(0.0, min(1.0, seconds / total)) * 100))
+
+
+class UsageReportDialog(QDialog):
+    """顯示今天的使用時間，並提供開關與清除。"""
+
+    def __init__(self, tracker: UsageTracker, parent: Optional[QWidget] = None,
+                 enabled: bool = False, on_toggle=None, on_clear=None) -> None:
+        front_engine_logger.info("[UsageReportDialog] Init")
+        super().__init__(parent)
+        self.setWindowTitle(_t("usage_title", "Screen time"))
+        self.tracker = tracker
+        self._on_toggle = on_toggle
+        self._on_clear = on_clear
+
+        self.enable_checkbox = QCheckBox(_t("usage_enable", "Track which apps I use"))
+        self.enable_checkbox.setChecked(bool(enabled))
+        self.enable_checkbox.toggled.connect(self._toggle)
+
+        self.total_label = QLabel()
+        self.table = QTableWidget(0, 3)
+        self.table.setHorizontalHeaderLabels([
+            _t("usage_app_column", "Application"),
+            _t("usage_time_column", "Time"),
+            _t("usage_share_column", "Share"),
+        ])
+        self.table.horizontalHeader().setSectionResizeMode(
+            0, QHeaderView.ResizeMode.Stretch)
+        self.table.verticalHeader().setVisible(False)
+
+        self.week_label = QLabel()
+        self.week_label.setWordWrap(True)
+        self.refresh_button = QPushButton(_t("usage_refresh", "Refresh"))
+        self.refresh_button.clicked.connect(self.reload_report)
+        self.clear_button = QPushButton(_t("usage_clear", "Clear history"))
+        self.clear_button.clicked.connect(self.clear_history)
+        self.hint_label = QLabel(
+            _t("usage_hint",
+               "This is stored on this machine only and is never sent anywhere. "
+               "Clearing deletes the file itself."))
+        self.hint_label.setWordWrap(True)
+
+        self.button_box = QDialogButtonBox(QDialogButtonBox.StandardButton.Close)
+        self.button_box.rejected.connect(self.reject)
+
+        layout = QGridLayout(self)
+        layout.addWidget(self.enable_checkbox, 0, 0, 1, 2)
+        layout.addWidget(self.total_label, 1, 0, 1, 2)
+        layout.addWidget(self.table, 2, 0, 1, 2)
+        layout.addWidget(self.week_label, 3, 0, 1, 2)
+        layout.addWidget(self.refresh_button, 4, 0)
+        layout.addWidget(self.clear_button, 4, 1)
+        layout.addWidget(self.hint_label, 5, 0, 1, 2)
+        layout.addWidget(self.button_box, 6, 0, 1, 2)
+
+        self.reload_report()
+
+    def reload_report(self) -> int:
+        """重畫今天的排行，回傳列數。"""
+        total = self.tracker.total_seconds()
+        self.total_label.setText(
+            _t("usage_total", "Today: {total}").format(total=format_duration(total)))
+        rows = self.tracker.top_apps(limit=12)
+        self.table.setRowCount(len(rows))
+        for index, (app, seconds) in enumerate(rows):
+            self.table.setItem(index, 0, QTableWidgetItem(app))
+            self.table.setItem(index, 1, QTableWidgetItem(format_duration(seconds)))
+            self.table.setItem(index, 2, QTableWidgetItem(f"{share_percent(seconds, total)}%"))
+        self.week_label.setText(self.week_summary())
+        return len(rows)
+
+    def week_summary(self) -> str:
+        """最近七天的一行摘要。"""
+        parts = [f"{day[5:]} {format_duration(seconds)}"
+                 for day, seconds in self.tracker.recent_days(7)]
+        return "  ·  ".join(parts)
+
+    def clear_history(self) -> None:
+        """清掉所有統計（含磁碟上的檔案）。"""
+        self.tracker.clear()
+        if self._on_clear is not None:
+            self._on_clear()
+        self.reload_report()
+
+    def _toggle(self, enabled: bool) -> None:
+        if self._on_toggle is not None:
+            self._on_toggle(bool(enabled))

{frontengine-1.0.36 → frontengine-1.0.38}/frontengine/ui/main_ui.py

@@ -1,5 +1,6 @@
 import os
 import sys
+from os import getcwd
 from pathlib import Path
 from typing import Dict, Optional, Type
 
@@ -49,6 +50,11 @@ from frontengine.utils.plugins.plugin_loader import load_plugins
 from frontengine.utils.preset_schedule.preset_schedule_service import PresetScheduleService
 from frontengine.ui.dialog.smart_pause_dialog import current_rules
 from frontengine.utils.app_profile.app_profile_service import AppProfileService
+from frontengine.utils.clipboard.clipboard_history import DEFAULT_LIMIT, ClipboardHistory
+from frontengine.utils.clipboard.clipboard_watcher import ClipboardWatcher
+from frontengine.utils.json.json_repository import JsonRepository
+from frontengine.utils.usage_tracking.usage_service import UsageTrackingService
+from frontengine.utils.usage_tracking.usage_tracker import USAGE_FILE, UsageTracker
 from frontengine.utils.reminder.reminder_service import ReminderService
 from frontengine.utils.smart_pause.smart_pause_service import SmartPauseService
 from frontengine.utils.theme_schedule.theme_schedule_service import ThemeScheduleService
@@ -201,6 +207,23 @@ class FrontEngineMainUI(QMainWindow):
         )
         self.app_profile_service.start()
 
+        # 使用時間統計：預設關閉，只寫本機檔案，使用者可隨時清除
+        # Usage tracking: off by default, local file only, clearable at any time.
+        self.usage_tracker = UsageTracker(JsonRepository(Path(getcwd()) / USAGE_FILE))
+        self.usage_service = UsageTrackingService(self.usage_tracker)
+        if user_setting_dict.get("usage_tracking"):
+            self.usage_service.start()
+
+        # 剪貼簿歷史：預設關閉；未勾選保存時只留在記憶體
+        # Clipboard history: off by default, memory only unless saving is on.
+        self.clipboard_history = ClipboardHistory(
+            limit=user_setting_dict.get("clipboard_limit", DEFAULT_LIMIT))
+        if user_setting_dict.get("clipboard_persist"):
+            self.clipboard_history.load(user_setting_dict.get("clipboard_entries"))
+        self.clipboard_watcher = ClipboardWatcher(self.clipboard_history)
+        if user_setting_dict.get("clipboard_history"):
+            self.clipboard_watcher.start()
+
         # 自訂提醒（喝水、久坐、每日鬧鐘），到期時以提示卡顯示
         # Custom reminders - water, posture, a daily alarm - shown as a toast.
         self.reminder_service = ReminderService(
@@ -436,6 +459,36 @@ class FrontEngineMainUI(QMainWindow):
         front_engine_logger.info(f"[MainUI] reminder | {label}")
         self._last_toast = show_toast(label)
 
+    def _persist_clipboard(self) -> None:
+        """
+        只有使用者勾選「保存到檔案」時才把剪貼簿歷史寫下來；沒勾就確保
+        設定裡不留任何內容。
+        Write the clipboard history down only when the user asked for it; when
+        they did not, make sure nothing is left behind in the settings.
+        """
+        if user_setting_dict.get("clipboard_persist"):
+            user_setting_dict["clipboard_entries"] = self.clipboard_history.to_list()
+        else:
+            user_setting_dict["clipboard_entries"] = []
+
+    def set_usage_tracking(self, enabled: bool) -> None:
+        """開關使用時間統計並記住選擇。"""
+        user_setting_dict["usage_tracking"] = bool(enabled)
+        write_user_setting()
+        if enabled:
+            self.usage_service.start()
+        else:
+            self.usage_service.stop()
+
+    def set_clipboard_history(self, enabled: bool) -> None:
+        """開關剪貼簿歷史紀錄並記住選擇。"""
+        user_setting_dict["clipboard_history"] = bool(enabled)
+        write_user_setting()
+        if enabled:
+            self.clipboard_watcher.start()
+        else:
+            self.clipboard_watcher.stop()
+
     def refresh_rule_services(self) -> None:
         """
         設定對話框按下確定後呼叫：規則與對照表都是每次輪詢重讀，所以只要把
@@ -454,6 +507,11 @@ class FrontEngineMainUI(QMainWindow):
             self.preset_schedule_service.stop()
         if getattr(self, "theme_schedule_service", None) is not None:
             self.theme_schedule_service.stop()
+        if getattr(self, "usage_service", None) is not None:
+            self.usage_service.stop()
+        if getattr(self, "clipboard_watcher", None) is not None:
+            self.clipboard_watcher.stop()
+            self._persist_clipboard()
         if getattr(self, "widgets_setting_ui", None) is not None:
             self.widgets_setting_ui.save_notes()
             self.widgets_setting_ui.stop_spectrum()

{frontengine-1.0.36 → frontengine-1.0.38}/frontengine/ui/menu/settings_menu.py

@@ -7,9 +7,11 @@ from PySide6.QtGui import QAction
 from PySide6.QtWidgets import QDialog, QFileDialog, QMessageBox
 
 from frontengine.ui.dialog.app_profile_dialog import AppProfileDialog
+from frontengine.ui.dialog.clipboard_dialog import ClipboardDialog
 from frontengine.ui.dialog.hotkey_settings_dialog import HotkeySettingsDialog
 from frontengine.ui.dialog.reminder_dialog import ReminderDialog
 from frontengine.ui.dialog.smart_pause_dialog import SmartPauseDialog
+from frontengine.ui.dialog.usage_report_dialog import UsageReportDialog
 from frontengine.user_setting.user_setting_file import (
     export_user_setting,
     import_user_setting,
@@ -85,6 +87,23 @@ def build_settings_menu(ui: "FrontEngineMainUI") -> None:
     menu.addAction(reminder_action)
     ui.reminder_action = reminder_action
 
+    usage_action = QAction(_t("settings_menu_usage", "Screen time..."), menu)
+    usage_action.triggered.connect(lambda: _open_usage_dialog(ui))
+    menu.addAction(usage_action)
+    ui.usage_action = usage_action
+
+    clipboard_action = QAction(_t("settings_menu_clipboard", "Clipboard history..."), menu)
+    clipboard_action.triggered.connect(lambda: _open_clipboard_dialog(ui))
+    menu.addAction(clipboard_action)
+    ui.clipboard_action = clipboard_action
+
+    clipboard_toggle = QAction(_t("settings_menu_clipboard_record", "Record clipboard"), menu)
+    clipboard_toggle.setCheckable(True)
+    clipboard_toggle.setChecked(bool(user_setting_dict.get("clipboard_history")))
+    clipboard_toggle.toggled.connect(lambda checked: ui.set_clipboard_history(checked))
+    menu.addAction(clipboard_toggle)
+    ui.clipboard_toggle_action = clipboard_toggle
+
     menu.addSeparator()
     export_action = QAction(_t("settings_menu_export", "Export settings..."), menu)
     export_action.triggered.connect(lambda: _export_settings(ui))
@@ -95,6 +114,22 @@ def build_settings_menu(ui: "FrontEngineMainUI") -> None:
     menu.addAction(import_action)
 
 
+def _open_usage_dialog(ui: "FrontEngineMainUI") -> None:
+    """開使用時間報告；開關與清除都由對話框直接作用在主視窗的服務上。"""
+    front_engine_logger.info("[SettingsMenu] open UsageReportDialog")
+    dialog = UsageReportDialog(
+        ui.usage_tracker, ui,
+        enabled=bool(user_setting_dict.get("usage_tracking")),
+        on_toggle=ui.set_usage_tracking)
+    dialog.exec()
+
+
+def _open_clipboard_dialog(ui: "FrontEngineMainUI") -> None:
+    """開剪貼簿歷史。"""
+    front_engine_logger.info("[SettingsMenu] open ClipboardDialog")
+    ClipboardDialog(ui.clipboard_history, ui).exec()
+
+
 def _open_dialog(ui: "FrontEngineMainUI", dialog_class) -> bool:
     """
     開一個設定對話框並回傳使用者是否按下確定。三個規則類對話框都自己負責寫回