frontengine 1.0.37__tar.gz → 1.0.39__tar.gz

{frontengine-1.0.37 → frontengine-1.0.39}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.37
+Version: 1.0.39
 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
@@ -143,6 +143,17 @@ Measuring and capture tools on the **Tools** tab:
   `hsl(...)` or a CSS custom property.
 - **Region capture** — drag out an area; it lands on the clipboard and can be
   saved to a file.
+- **Read text** — drag out an area to copy the text in it, translate it, or ask
+  a question about it.
+  > This is the **only** feature here that sends screen content off the
+  > machine: the selection goes to Anthropic's API using your own
+  > `ANTHROPIC_API_KEY`. It asks once before the first send, remembers the
+  > answer, and the consent can be withdrawn from the result window at any
+  > time. Without consent or without a key, nothing is sent.
+- **Record area** — drag out an area and record it to an animated GIF, with the
+  camera composited into the corner if you want the reaction-video look.
+  Recording is capped by both length and frame count, because every frame is
+  held in memory.
 - **Pin a window** — keep another program's window on top, or fade it, while
   you work against it. Only stacking and opacity are touched, never window
   content. Windows only.
@@ -166,6 +177,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.37 → frontengine-1.0.39}/README.md

@@ -119,6 +119,17 @@ Measuring and capture tools on the **Tools** tab:
   `hsl(...)` or a CSS custom property.
 - **Region capture** — drag out an area; it lands on the clipboard and can be
   saved to a file.
+- **Read text** — drag out an area to copy the text in it, translate it, or ask
+  a question about it.
+  > This is the **only** feature here that sends screen content off the
+  > machine: the selection goes to Anthropic's API using your own
+  > `ANTHROPIC_API_KEY`. It asks once before the first send, remembers the
+  > answer, and the consent can be withdrawn from the result window at any
+  > time. Without consent or without a key, nothing is sent.
+- **Record area** — drag out an area and record it to an animated GIF, with the
+  camera composited into the corner if you want the reaction-video look.
+  Recording is capped by both length and frame count, because every frame is
+  held in memory.
 - **Pin a window** — keep another program's window on top, or fade it, while
   you work against it. Only stacking and opacity are touched, never window
   content. Windows only.
@@ -142,6 +153,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.39/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.39/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.39/frontengine/ui/dialog/screen_text_dialog.py

@@ -0,0 +1,120 @@
+"""
+畫面文字視窗：顯示 Claude 從截圖讀出來的結果，並提供複製。
+
+第一次使用會先問一次「要把截圖送到 Anthropic 的 API 嗎」，同意後才會送，
+而且這個選擇記在設定裡，隨時可以在這裡收回。
+
+The screen-text window: show what Claude read from the capture, and offer to
+copy it.
+
+The first use asks whether the screenshot may be sent to Anthropic's API.
+Nothing is sent before that is answered, the choice is remembered, and it can
+be withdrawn from right here.
+"""
+from __future__ import annotations
+
+from typing import Optional
+
+from PySide6.QtGui import QGuiApplication
+from PySide6.QtWidgets import (
+    QCheckBox, QDialog, QDialogButtonBox, QGridLayout, QLabel, QMessageBox, QPlainTextEdit,
+    QPushButton, 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.screen_text.screen_text_service import API_KEY_ENV, api_key
+
+CONSENT_KEY = "screen_text_consent"
+
+
+def _t(key: str, fallback: str) -> str:
+    return language_wrapper.language_word_dict.get(key, fallback)
+
+
+def has_consent() -> bool:
+    """使用者是否已經同意把截圖送出去。"""
+    return bool(user_setting_dict.get(CONSENT_KEY))
+
+
+def set_consent(granted: bool) -> None:
+    """記住（或收回）同意。"""
+    user_setting_dict[CONSENT_KEY] = bool(granted)
+    write_user_setting()
+    front_engine_logger.info(f"[ScreenText] consent = {bool(granted)}")
+
+
+def ask_for_consent(parent: Optional[QWidget] = None) -> bool:
+    """
+    問使用者要不要把截圖送到 Anthropic。已經同意過就直接回 True，不再打擾。
+    Ask whether screenshots may go to Anthropic. Already-granted consent returns
+    True without asking again.
+    """
+    if has_consent():
+        return True
+    answer = QMessageBox.question(
+        parent,
+        _t("screen_text_consent_title", "Send this screenshot?"),
+        _t("screen_text_consent_body",
+           "Reading text needs the captured area sent to Anthropic's API. It leaves this "
+           "machine, and anything visible in the selection goes with it. Your own "
+           "ANTHROPIC_API_KEY is used. Send captures?"),
+        QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.No,
+        QMessageBox.StandardButton.No)
+    granted = answer == QMessageBox.StandardButton.Yes
+    set_consent(granted)
+    return granted
+
+
+class ScreenTextDialog(QDialog):
+    """顯示讀到的文字，可複製，也可以在這裡收回同意。"""
+
+    def __init__(self, text: str = "", parent: Optional[QWidget] = None) -> None:
+        front_engine_logger.info("[ScreenTextDialog] Init")
+        super().__init__(parent)
+        self.setWindowTitle(_t("screen_text_title", "Text on screen"))
+
+        self.text_edit = QPlainTextEdit(str(text))
+        self.text_edit.setReadOnly(False)
+        self.copy_button = QPushButton(_t("screen_text_copy", "Copy"))
+        self.copy_button.clicked.connect(self.copy_text)
+        self.consent_checkbox = QCheckBox(
+            _t("screen_text_consent_toggle", "Allow sending captures to Anthropic"))
+        self.consent_checkbox.setChecked(has_consent())
+        self.consent_checkbox.toggled.connect(set_consent)
+        self.hint_label = QLabel(self.status_text())
+        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.text_edit, 0, 0, 1, 2)
+        layout.addWidget(self.copy_button, 1, 0)
+        layout.addWidget(self.consent_checkbox, 1, 1)
+        layout.addWidget(self.hint_label, 2, 0, 1, 2)
+        layout.addWidget(self.button_box, 3, 0, 1, 2)
+
+    @staticmethod
+    def status_text() -> str:
+        """說明目前為什麼可用或不可用。"""
+        if api_key() is None:
+            return _t("screen_text_no_key",
+                      "Set {env} in your environment to use this.").format(env=API_KEY_ENV)
+        return _t("screen_text_ready",
+                  "Captures are sent to Anthropic only while the box above is ticked.")
+
+    def set_text(self, text: str) -> None:
+        self.text_edit.setPlainText(str(text or ""))
+
+    def text(self) -> str:
+        return self.text_edit.toPlainText()
+
+    def copy_text(self) -> bool:
+        """把結果放到剪貼簿。"""
+        clipboard = QGuiApplication.clipboard()
+        if clipboard is None:  # pragma: no cover - no clipboard at all
+            return False
+        clipboard.setText(self.text())
+        return True

frontengine-1.0.39/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))