frontengine 1.0.33__tar.gz → 1.0.34__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.33
+Version: 1.0.34
 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
@@ -85,6 +85,50 @@ Audio features are Windows-only and degrade to "no pulse" elsewhere.
 
 ---
 
+## Focus
+
+Two overlays for when the screen is competing with your work, both on the
+**Focus** tab:
+
+- **Dim background windows** — everything except the window you are working in
+  is shaded, at an adjustable strength. Off Windows, where the active window
+  cannot be identified without a native binding, it shades the whole screen.
+- **Cover a distraction** — mask a strip of the screen: the taskbar, a
+  notification corner, an edge, or all of it.
+
+Both pass clicks through, so what they cover still works — it just stops pulling
+your eye.
+
+---
+
+## Wallpaper
+
+Play a folder of images and animations *beneath* every window, from the
+**Wallpaper** tab:
+
+- **A playlist per monitor** — each screen points at its own folder, changes on
+  its own timer, and can be shuffled or read recursively.
+- **React to audio** — the wallpaper can pulse with your speakers' output level,
+  using the same meter-only reading as the pet (no audio is captured).
+
+---
+
+## Community content
+
+- **Steam Workshop** — subscribed items are picked up from Steam's own
+  `steamapps/workshop/content` folder: presets are imported and pet packs are
+  listed with their paths, from **Presets → Import Workshop content**.
+  Publishing to the Workshop needs the Steamworks SDK and is not built in.
+- **Plugins** — a `plugins/` folder can add its own tabs, either through a
+  `FRONTENGINE_TABS` mapping or a `register(registry)` hook.
+
+  > A plugin is Python and runs with the same privileges as FrontEngine — it
+  > cannot be sandboxed. Loading is **off by default** (Settings → Load plugins),
+  > every load is logged, and one broken plugin is skipped rather than stopping
+  > the app. Only install plugins you trust.
+
+---
+
 ## Install
 
 - **System Requirements**

{frontengine-1.0.33 → frontengine-1.0.34}/README.md

@@ -61,6 +61,50 @@ Audio features are Windows-only and degrade to "no pulse" elsewhere.
 
 ---
 
+## Focus
+
+Two overlays for when the screen is competing with your work, both on the
+**Focus** tab:
+
+- **Dim background windows** — everything except the window you are working in
+  is shaded, at an adjustable strength. Off Windows, where the active window
+  cannot be identified without a native binding, it shades the whole screen.
+- **Cover a distraction** — mask a strip of the screen: the taskbar, a
+  notification corner, an edge, or all of it.
+
+Both pass clicks through, so what they cover still works — it just stops pulling
+your eye.
+
+---
+
+## Wallpaper
+
+Play a folder of images and animations *beneath* every window, from the
+**Wallpaper** tab:
+
+- **A playlist per monitor** — each screen points at its own folder, changes on
+  its own timer, and can be shuffled or read recursively.
+- **React to audio** — the wallpaper can pulse with your speakers' output level,
+  using the same meter-only reading as the pet (no audio is captured).
+
+---
+
+## Community content
+
+- **Steam Workshop** — subscribed items are picked up from Steam's own
+  `steamapps/workshop/content` folder: presets are imported and pet packs are
+  listed with their paths, from **Presets → Import Workshop content**.
+  Publishing to the Workshop needs the Steamworks SDK and is not built in.
+- **Plugins** — a `plugins/` folder can add its own tabs, either through a
+  `FRONTENGINE_TABS` mapping or a `register(registry)` hook.
+
+  > A plugin is Python and runs with the same privileges as FrontEngine — it
+  > cannot be sandboxed. Loading is **off by default** (Settings → Load plugins),
+  > every load is logged, and one broken plugin is skipped rather than stopping
+  > the app. Only install plugins you trust.
+
+---
+
 ## Install
 
 - **System Requirements**

frontengine-1.0.34/frontengine/show/focus_shield/focus_shield_widget.py

@@ -0,0 +1,137 @@
+"""
+專注用的兩種遮罩：
+  - DimBackgroundWidget：把作用中視窗以外的地方壓暗，視線自然留在手上的工作
+  - DistractionMaskWidget：蓋住指定的螢幕區域（工作列、通知角落）
+兩者都是點擊穿透的，所以被遮住的地方仍然可以正常點擊。
+
+Two focus masks: one dims everything except the active window so your eye stays
+on the work, the other covers a chosen strip of the screen (the taskbar, a
+notification corner). Both pass clicks through, so what is covered still works.
+"""
+from __future__ import annotations
+
+import sys
+from typing import List, Optional, Tuple
+
+from PySide6.QtCore import QRect, QTimer
+from PySide6.QtGui import QColor, QPainter
+
+from frontengine.show.base_widget import BaseWidget
+from frontengine.utils.focus_shield.focus_shield import (
+    REGION_BOTTOM, clamp_percent, mask_rect, surrounding_rects,
+)
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+
+DEFAULT_DIM = 45
+
+
+def active_window_rect() -> Optional[Tuple[int, int, int, int]]:
+    """
+    回傳目前作用中視窗的 (x, y, w, h)；取不到或非 Windows 回傳 None
+    （其他平台會退化成「整片壓暗」，仍然可用）。
+    The active window's rectangle, or None off Windows — where the dimmer simply
+    shades the whole screen instead.
+    """
+    if sys.platform != "win32":
+        return None
+    try:
+        import ctypes
+        from ctypes import wintypes
+
+        user32 = ctypes.windll.user32
+        hwnd = user32.GetForegroundWindow()
+        if not hwnd:
+            return None
+        rect = wintypes.RECT()
+        if not user32.GetWindowRect(hwnd, ctypes.byref(rect)):
+            return None
+        return (rect.left, rect.top, rect.right - rect.left, rect.bottom - rect.top)
+    except Exception as error:  # pragma: no cover - Win32 boundary
+        front_engine_logger.debug(f"[focus_shield] active window unavailable: {error!r}")
+        return None
+
+
+class DimBackgroundWidget(BaseWidget):
+    """
+    背景變暗：只有作用中視窗保持原樣，其餘壓暗；視窗換了會自動跟上。
+    """
+
+    REFRESH_MS = 250
+
+    def __init__(self, dim: int = DEFAULT_DIM) -> None:
+        front_engine_logger.info(f"[DimBackgroundWidget] Init | dim={dim}")
+        super().__init__()
+        self.opacity = 1.0
+        self.dim = clamp_percent(dim, DEFAULT_DIM)
+        self.shaded: List[Tuple[int, int, int, int]] = []
+        self._window_provider = active_window_rect
+        self._timer = QTimer(self)
+        self._timer.timeout.connect(self.refresh)
+
+    def set_window_provider(self, provider) -> None:
+        """注入作用中視窗來源（測試用）。"""
+        self._window_provider = provider
+
+    def set_dim(self, dim: int) -> None:
+        self.dim = clamp_percent(dim, DEFAULT_DIM)
+        self.update()
+
+    def start_following(self, interval_ms: int = REFRESH_MS) -> None:
+        self.refresh()
+        self._timer.start(max(50, int(interval_ms)))
+
+    def screen_rect(self) -> Tuple[int, int, int, int]:
+        geometry = self.geometry()
+        return (geometry.x(), geometry.y(), geometry.width(), geometry.height())
+
+    def refresh(self) -> None:
+        """重新計算要壓暗的區塊。"""
+        try:
+            active = self._window_provider()
+        except Exception:  # pragma: no cover - defensive around providers
+            active = None
+        rects = surrounding_rects(self.screen_rect(), active)
+        origin_x, origin_y = self.x(), self.y()
+        # 換算成本視窗的座標系 / Convert to this widget's own coordinates
+        self.shaded = [(x - origin_x, y - origin_y, w, h) for x, y, w, h in rects]
+        self.update()
+
+    def draw_content(self, painter: QPainter) -> None:
+        shade = QColor(0, 0, 0, int(255 * self.dim / 100.0))
+        for x, y, width, height in self.shaded:
+            painter.fillRect(QRect(x, y, width, height), shade)
+
+    def closeEvent(self, event) -> None:
+        if self._timer.isActive():
+            self._timer.stop()
+        super().closeEvent(event)
+
+
+class DistractionMaskWidget(BaseWidget):
+    """
+    干擾遮罩：把螢幕的某個區域（預設底部，正好蓋住工作列）以不透明色蓋掉。
+    """
+
+    def __init__(self, region: str = REGION_BOTTOM, percent: int = 6,
+                 color: str = "#101010") -> None:
+        front_engine_logger.info(
+            f"[DistractionMaskWidget] Init | region={region}, percent={percent}")
+        super().__init__()
+        self.opacity = 1.0
+        self.region = region
+        self.percent = clamp_percent(percent)
+        self.mask_color = QColor(color) if QColor(color).isValid() else QColor("#101010")
+
+    def geometry_for(self, screen_rect: Tuple[int, int, int, int]) -> QRect:
+        """算出這個遮罩該放在哪裡、多大。"""
+        x, y, width, height = mask_rect(screen_rect, self.region, self.percent)
+        return QRect(x, y, width, height)
+
+    def set_region(self, region: Optional[str] = None, percent: Optional[int] = None) -> None:
+        if region is not None:
+            self.region = region
+        if percent is not None:
+            self.percent = clamp_percent(percent)
+
+    def draw_content(self, painter: QPainter) -> None:
+        painter.fillRect(self.rect(), self.mask_color)

{frontengine-1.0.33 → frontengine-1.0.34}/frontengine/show/pet/desktop_pet.py

@@ -1,6 +1,5 @@
 import json
 import random as _random_module
-import sys
 from datetime import datetime, timedelta
 from pathlib import Path
 from urllib.parse import urlparse

frontengine-1.0.34/frontengine/show/wallpaper/wallpaper_widget.py

@@ -0,0 +1,155 @@
+"""
+桌布覆蓋層：在所有視窗底下播放圖片或動圖，可依系統音量脈動（音訊反應桌布），
+並由播放清單定時換張。音量來源沿用寵物已經在用的系統峰值電表，只讀電表、
+不擷取音訊內容。
+
+A wallpaper layer: plays an image or animation beneath every window, optionally
+pulsing with the system output level, with a playlist swapping it over time.
+The level comes from the same meter the pet uses — a meter reading only, never
+captured audio.
+"""
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Optional
+
+from PySide6.QtCore import QRect, 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
+
+_ANIMATED_SUFFIXES = (".gif", ".webp")
+MIN_REACT_SCALE = 1.0
+MAX_REACT_SCALE = 1.25
+
+
+def react_scale(level, strength: int = 100) -> float:
+    """
+    把音量 (0~1) 換成桌布的縮放比例：安靜時 1.0，最大聲時最多放大 25%。
+    strength 是效果強度百分比，0 代表完全不反應。
+    Map an audio level to a wallpaper scale: 1.0 when quiet, up to +25% loud.
+    """
+    try:
+        clamped = max(0.0, min(1.0, float(level)))
+    except (TypeError, ValueError):
+        return MIN_REACT_SCALE
+    try:
+        share = max(0, min(100, int(strength))) / 100.0
+    except (TypeError, ValueError):
+        share = 1.0
+    return MIN_REACT_SCALE + (MAX_REACT_SCALE - MIN_REACT_SCALE) * clamped * share
+
+
+class WallpaperWidget(BaseWidget):
+    """
+    桌布：顯示一張圖或一段動圖，位於所有視窗底下；可選擇隨系統音量脈動。
+    """
+
+    REACT_INTERVAL_MS = 33
+
+    def __init__(self, media_path: str = "", audio_react: bool = False,
+                 react_strength: int = 100) -> None:
+        front_engine_logger.info(
+            f"[WallpaperWidget] Init | path={media_path}, audio_react={audio_react}")
+        super().__init__()
+        self.opacity = 1.0
+        self.media_path: Optional[Path] = None
+        self._movie: Optional[QMovie] = None
+        self._pixmap: Optional[QPixmap] = None
+        self.audio_react = bool(audio_react)
+        self.react_strength = max(0, min(100, int(react_strength)))
+        self.scale = MIN_REACT_SCALE
+        self._level_provider = None
+        self._envelope = AudioEnvelope()
+        self._react_timer = QTimer(self)
+        self._react_timer.timeout.connect(self._update_scale)
+        if media_path:
+            self.set_media(media_path)
+
+    def set_media(self, media_path: str) -> bool:
+        """換一張桌布；載不起來時保留原本的並回傳 False。"""
+        path = Path(media_path)
+        if not path.is_file():
+            front_engine_logger.warning(f"[WallpaperWidget] missing media: {path}")
+            return False
+        if path.suffix.lower() in _ANIMATED_SUFFIXES:
+            movie = QMovie(str(path))
+            if not movie.isValid():
+                return False
+            self._stop_movie()
+            self._movie = movie
+            self._pixmap = None
+            movie.frameChanged.connect(self.update)
+            movie.start()
+        else:
+            pixmap = QPixmap(str(path))
+            if pixmap.isNull():
+                return False
+            self._stop_movie()
+            self._pixmap = pixmap
+            self._movie = None
+        self.media_path = path
+        self.update()
+        return True
+
+    def set_audio_level_provider(self, provider) -> None:
+        """設定音量來源（回傳 0~1 或 None）。"""
+        self._level_provider = provider
+        self._envelope.reset()
+
+    def set_audio_react(self, enabled: bool, strength: Optional[int] = None) -> None:
+        """開關音訊反應並視需要調整強度。"""
+        self.audio_react = bool(enabled)
+        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)
+        else:
+            self._react_timer.stop()
+            self.scale = MIN_REACT_SCALE
+            self.update()
+
+    def _update_scale(self) -> None:
+        """取一次音量、平滑後換成縮放比例。"""
+        if not self.audio_react or self._level_provider is None:
+            self.scale = MIN_REACT_SCALE
+            return
+        try:
+            level = self._level_provider()
+        except Exception:  # pragma: no cover - defensive around providers
+            level = None
+        if level is None:
+            self.scale = MIN_REACT_SCALE
+            self._envelope.reset()
+        else:
+            self.scale = react_scale(self._envelope.push(level), self.react_strength)
+        self.update()
+
+    def _stop_movie(self) -> None:
+        if self._movie is not None:
+            self._movie.stop()
+            self._movie = None
+
+    def current_pixmap(self) -> Optional[QPixmap]:
+        if self._movie is not None:
+            return self._movie.currentPixmap()
+        return self._pixmap
+
+    def draw_content(self, painter: QPainter) -> None:
+        pixmap = self.current_pixmap()
+        if pixmap is None or pixmap.isNull():
+            return
+        width = int(self.width() * self.scale)
+        height = int(self.height() * self.scale)
+        # 放大時往外溢出，維持置中，畫面才不會出現黑邊
+        # Overflow outward and stay centred so no bars appear while pulsing.
+        painter.drawPixmap(
+            QRect((self.width() - width) // 2, (self.height() - height) // 2, width, height), pixmap)
+
+    def closeEvent(self, event) -> None:
+        if self._react_timer.isActive():
+            self._react_timer.stop()
+        self._stop_movie()
+        super().closeEvent(event)

{frontengine-1.0.33 → frontengine-1.0.34}/frontengine/ui/main_ui.py

@@ -4,7 +4,7 @@ from pathlib import Path
 from typing import Dict, Optional, Type
 
 from PySide6.QtCore import QByteArray, QTimer, QCoreApplication
-from PySide6.QtGui import QIcon, Qt, QSurfaceFormat
+from PySide6.QtGui import QIcon, Qt
 from PySide6.QtWidgets import QMainWindow, QApplication, QGridLayout, QTabWidget, QMenuBar, QWidget
 from qt_material import apply_stylesheet
 
@@ -18,6 +18,7 @@ from frontengine.ui.menu.preset_menu import (
 )
 from frontengine.ui.menu.settings_menu import build_settings_menu
 from frontengine.ui.page.control_center.control_center_ui import ControlCenterUI
+from frontengine.ui.page.focus.focus_setting_ui import FocusSettingUI
 from frontengine.ui.page.gif.gif_setting_ui import GIFSettingUI
 from frontengine.ui.page.image.image_setting_ui import ImageSettingUI
 from frontengine.ui.page.particle.particle_setting_ui import ParticleSettingUI
@@ -28,6 +29,7 @@ from frontengine.ui.page.screen_care.screen_care_setting_ui import ScreenCareSet
 from frontengine.ui.page.sound_player.sound_player_setting_ui import SoundPlayerSettingUI
 from frontengine.ui.page.text.text_setting_ui import TextSettingUI
 from frontengine.ui.page.video.video_setting_ui import VideoSettingUI
+from frontengine.ui.page.wallpaper.wallpaper_setting_ui import WallpaperSettingUI
 from frontengine.ui.page.web.web_setting_ui import WEBSettingUI
 from frontengine.user_setting.user_setting_file import (
     get_hotkey_bindings,
@@ -40,6 +42,7 @@ from frontengine.utils.critical_exit.win32_vk import keyboard_keys_table
 from frontengine.utils.hotkey.hotkey_service import HotkeyService
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.utils.plugins.plugin_loader import load_plugins
 from frontengine.utils.preset_schedule.preset_schedule_service import PresetScheduleService
 from frontengine.utils.smart_pause.smart_pause_service import SmartPauseService
 from frontengine.utils.theme_schedule.theme_schedule_service import ThemeScheduleService
@@ -107,6 +110,8 @@ class FrontEngineMainUI(QMainWindow):
         self.pet_setting_ui = PetSettingUI()
         self.screen_care_setting_ui = ScreenCareSettingUI()
         self.presentation_setting_ui = PresentationSettingUI()
+        self.wallpaper_setting_ui = WallpaperSettingUI()
+        self.focus_setting_ui = FocusSettingUI()
 
         # 控制中心
         # Control Center
@@ -127,6 +132,13 @@ class FrontEngineMainUI(QMainWindow):
         self.menu_bar = QMenuBar()
         self.setMenuBar(self.menu_bar)
 
+        # 使用者明確開啟時才載入外掛（外掛與本程式同權限，無法沙箱化）
+        # Plugins load only when explicitly enabled; they run with our privileges.
+        loaded_plugins = load_plugins(
+            FrontEngine_EXTEND_TAB, enabled=bool(user_setting_dict.get("load_plugins")))
+        if loaded_plugins:
+            front_engine_logger.info(f"[FrontEngineMainUI] plugin tabs: {loaded_plugins}")
+
         # 加入各 Tab
         # Add tabs
         self._add_tabs()
@@ -215,6 +227,8 @@ class FrontEngineMainUI(QMainWindow):
             (self.pet_setting_ui, "tab_pet_text"),
             (self.screen_care_setting_ui, "tab_screen_care_text"),
             (self.presentation_setting_ui, "tab_presentation_text"),
+            (self.wallpaper_setting_ui, "tab_wallpaper_text"),
+            (self.focus_setting_ui, "tab_focus_text"),
             (self.control_center_ui, "tab_control_center_text"),
         ]
 

{frontengine-1.0.33 → frontengine-1.0.34}/frontengine/ui/menu/preset_menu.py

@@ -7,6 +7,9 @@ from PySide6.QtGui import QAction
 from PySide6.QtWidgets import QFileDialog, QInputDialog, QMessageBox
 
 from frontengine.user_setting.preset_repository import PresetRepository
+from frontengine.utils.workshop.workshop_content import (
+    KIND_PET_PACK, KIND_PRESET, find_workshop_dir, preset_files, scan_workshop_items,
+)
 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
@@ -296,6 +299,66 @@ def _import_package_action(ui: "FrontEngineMainUI") -> Callable[[], None]:
     return handler
 
 
+def _workshop_action(ui: "FrontEngineMainUI") -> Callable[[], None]:
+    """
+    匯入 Steam 創意工坊已訂閱的內容：掃描 Steam 下載的資料夾，把預設集複製進來，
+    動作包則列出路徑供寵物頁選用。找不到 Steam 時請使用者自己指定路徑。
+    Import subscribed Steam Workshop content: copy presets in, and list pet packs
+    with their paths so the pet page can point at them. If Steam is not where we
+    expect, ask the user where it is.
+    """
+    def handler() -> None:
+        front_engine_logger.info("[PresetMenu] import workshop content")
+        title = _t("workshop_menu_import", "Import Workshop content...")
+        content_dir = find_workshop_dir()
+        if content_dir is None:
+            chosen = QFileDialog.getExistingDirectory(
+                ui, _t("workshop_pick_steam", "Where is Steam installed?"))
+            if not chosen:
+                return
+            content_dir = find_workshop_dir(extra_paths=[chosen])
+        if content_dir is None:
+            QMessageBox.information(
+                ui, title, _t("workshop_not_found", "No Workshop content found for FrontEngine."))
+            return
+        items = scan_workshop_items(content_dir)
+        if not items:
+            QMessageBox.information(
+                ui, title,
+                _t("workshop_no_items", "Nothing subscribed yet - subscribe in Steam first."))
+            return
+        imported, packs = _install_workshop_items(items)
+        lines = [
+            _t("workshop_imported_presets", "Presets imported: {count}").format(count=imported),
+            _t("workshop_found_packs", "Pet packs available: {count}").format(count=len(packs)),
+        ]
+        lines.extend(f"- {title_}: {path}" for title_, path in packs[:8])
+        QMessageBox.information(ui, title, chr(10).join(lines))
+
+    return handler
+
+
+def _install_workshop_items(items) -> tuple:
+    """把預設集複製進本機的 presets/，並回傳可用的動作包 (名稱, 路徑)。"""
+    repository = PresetRepository()
+    imported = 0
+    packs = []
+    for item in items:
+        if item["kind"] == KIND_PET_PACK:
+            packs.append((item["title"], item["path"]))
+            continue
+        if item["kind"] != KIND_PRESET:
+            continue
+        for preset_path in preset_files(item["path"]):
+            try:
+                repository.import_preset(Path(preset_path))
+                imported += 1
+            except Exception as error:  # pragma: no cover - third-party content
+                front_engine_logger.warning(
+                    f"[PresetMenu] workshop preset failed: {preset_path} ({error!r})")
+    return (imported, packs)
+
+
 def build_preset_menu(ui: "FrontEngineMainUI") -> None:
     """
     Build the Presets menu with Save / Load / Delete / Export / Import actions.
@@ -314,6 +377,7 @@ def build_preset_menu(ui: "FrontEngineMainUI") -> None:
         ("preset_menu_import_package", "Import package (+media)...", _import_package_action),
         ("preset_menu_set_startup", "Set as startup preset...", _set_startup_action),
         ("preset_menu_clear_startup", "Clear startup preset", _clear_startup_action),
+        ("workshop_menu_import", "Import Workshop content...", _workshop_action),
     ):
         action = QAction(_t(label_key, fallback), menu)
         action.triggered.connect(callback_factory(ui))

{frontengine-1.0.33 → frontengine-1.0.34}/frontengine/ui/menu/settings_menu.py

@@ -58,6 +58,12 @@ def build_settings_menu(ui: "FrontEngineMainUI") -> None:
     restore_action.toggled.connect(lambda checked: _toggle_restore_session(checked))
     menu.addAction(restore_action)
     ui.restore_session_action = restore_action
+    plugins_action = QAction(_t("settings_menu_plugins", "Load plugins (advanced)"), menu)
+    plugins_action.setCheckable(True)
+    plugins_action.setChecked(bool(user_setting_dict.get("load_plugins")))
+    plugins_action.toggled.connect(lambda checked: _toggle_plugins(ui, checked))
+    menu.addAction(plugins_action)
+    ui.plugins_action = plugins_action
 
     menu.addSeparator()
     export_action = QAction(_t("settings_menu_export", "Export settings..."), menu)
@@ -89,6 +95,24 @@ def _toggle_restore_session(enabled: bool) -> None:
     """開關「還原上次工作階段」。"""
     user_setting_dict["restore_last_session"] = bool(enabled)
     write_user_setting()
+def _toggle_plugins(ui: "FrontEngineMainUI", enabled: bool) -> None:
+    """
+    開關外掛載入。外掛是 Python 程式、與本程式同權限，無法沙箱化，
+    因此開啟時明確告知風險，並在下次啟動才生效。
+    Toggle plugin loading. Plugins are Python and run with this application's
+    own privileges — they cannot be sandboxed — so say so plainly when it is
+    switched on. It takes effect on the next launch.
+    """
+    user_setting_dict["load_plugins"] = bool(enabled)
+    write_user_setting()
+    if enabled:
+        QMessageBox.warning(
+            ui,
+            _t("settings_menu_plugins", "Load plugins (advanced)"),
+            _t("settings_plugins_warning",
+               "Plugins are Python code and run with the same privileges as FrontEngine. "
+               "Only install plugins you trust. Takes effect on the next launch."),
+        )
 
 
 def _toggle_theme_schedule(ui: "FrontEngineMainUI", enabled: bool) -> None: