安全设置中新增预览设置功能

- 新增 预览设置开关 ，在 安全设置页面 新增控制是否在打开设置的验证过程中显示预览按钮的功能
- 优化 验证窗口显示逻辑 ， 预览按钮 只在 打开设置 操作时显示，其他验证场景不显示预览按钮
- 修复 预览设置开关稳定性 ，解决 开关操作 可能导致 软件卡退 的问题，改进 UI状态 处理逻辑避免闪烁
- 优化 预览功能 ， 预览设置开关 默认为 开启状态 ，用户可控制是否在验证过程中显示预览按钮

Author: lzy98276

CHANGELOG/v1.3.2-alpha.6/CHANGELOG.md

@@ -12,6 +12,7 @@ v2.0 - Koharu（小鸟游星野） Alpha 6
 - 新增 **闪抽点击后禁用功能**，新增**点击后禁用时间设置**，支持设置**0-60s**的禁用时间，防止频繁点击
 - 新增 **通知窗口字体设置**，新增通知窗口支持独立的字体设置功能
 - 新增 **自动保存窗口大小设置**，新增设置是否自动保存窗口大小功能
+- 新增 **预览设置开关**，在**安全设置页面**新增控制是否在打开设置的验证过程中显示预览按钮的功能
 
 ## 💡 功能优化
 
@@ -27,6 +28,8 @@ v2.0 - Koharu（小鸟游星野） Alpha 6
 - 优化 **阈值设置文本**，将**主窗口显示阈值**改为**浮窗通知阈值**，并更新描述为"设置触发浮窗通知的人数/奖数阈值，超过此数值则不显示浮窗通知"，使用户更容易理解功能作用
 - 优化 **通知窗口字体应用**，优化字体设置应用方式，将字体设置正确应用到标签组件而非布局对象
 - 优化 **通知窗口字体同步**，优化通知窗口根据类型使用相应功能的字体设置，确保与主界面保持一致
+- 优化 **预览功能**，**预览设置开关**默认为**开启状态**，用户可控制是否在验证过程中显示预览按钮
+- 优化 **验证窗口显示逻辑**，**预览按钮**只在**打开设置**操作时显示，其他验证场景不显示预览按钮
 
 ## 🐛 修复问题
 
@@ -48,6 +51,7 @@ v2.0 - Koharu（小鸟游星野） Alpha 6
 - 修复 **文件写入权限**，新增使用**临时文件**策略避免secrets.json写入时的权限拒绝问题
 - 修复 **U盘验证布局**，优化仅在需要**U盘验证**时才显示相关控件（状态标签和刷新按钮）
 - 修复 **安全验证流程**，新增验证通过后**刷新下拉框**显示状态的功能
+- 修复 **预览设置开关稳定性**，解决**开关操作**可能导致**软件卡退**的问题，改进**UI状态**处理逻辑避免闪烁
 
 ## 🔧 其它变更
 

app/Language/modules/safety_settings.py

@@ -155,6 +155,12 @@
             "description": "启用后导入版本不匹配时需验证",
             "switchbutton_name": {"enable": "", "disable": ""},
         },
+        "preview_settings": {"name": "预览设置"},
+        "preview_settings_switch": {
+            "name": "设置预览开关",
+            "description": "进入设置的验证时允许预览设置",
+            "switchbutton_name": {"enable": "", "disable": ""},
+        },
     },
     "EN_US": {
         "title": {
@@ -309,5 +315,11 @@
             "name": "Version mismatch import validation",
             "description": "Authentication is required for importing versions when they do not match",
         },
+        "preview_settings": {"name": "Preview settings"},
+        "preview_settings_switch": {
+            "name": "Preview settings switch",
+            "description": "Enable preview settings switch",
+            "switchbutton_name": {"enable": "", "disable": ""},
+        },
     },
 }

app/common/safety/verify_ops.py

@@ -55,9 +55,11 @@ def should_require_password(op: str) -> bool:
     return ok
 
 
-def require_and_run(op: str, parent, func):
+def require_and_run(op: str, parent, func, on_preview=None):
     if not should_require_password(op):
         func()
         return
     logger.debug(f"触发验证窗口：{op}")
-    create_verify_password_window(on_verified=func)
+    create_verify_password_window(
+        on_verified=func, on_preview=on_preview, operation_type=op
+    )

app/page_building/page_template.py

@@ -25,16 +25,49 @@ def __new__(cls, content_widget_class=None, parent: QFrame = None, **kwargs):
         # 直接创建新实例，不使用缓存
         return super(PageTemplate, cls).__new__(cls)
 
-    def __init__(self, content_widget_class=None, parent: QFrame = None, **kwargs):
+    def __init__(
+        self,
+        content_widget_class=None,
+        parent: QFrame = None,
+        is_preview_mode=False,
+        **kwargs,
+    ):
         super().__init__(parent=parent)
 
         self.ui_created = False
         self.content_created = False
         self.content_widget_class = content_widget_class
+        self._is_preview_mode = is_preview_mode
 
         self.__connectSignalToSlot()
         self.create_ui_components()
 
+    @property
+    def is_preview_mode(self):
+        """获取是否为预览模式"""
+        return self._is_preview_mode
+
+    @is_preview_mode.setter
+    def is_preview_mode(self, value):
+        """设置是否为预览模式，并在值改变时触发锁定逻辑
+
+        Args:
+            value: 是否为预览模式
+        """
+        self._is_preview_mode = value
+        # 如果内容组件已经创建完成，立即执行锁定逻辑
+        if (
+            self.content_created
+            and hasattr(self, "contentWidget")
+            and self.contentWidget
+        ):
+            if value:
+                self._lock_all_widgets(self.contentWidget)
+            else:
+                # 如果不是预览模式，可以选择解锁所有组件
+                # 但通常情况下，预览模式是一次性的，所以这里可以不处理
+                pass
+
     def __connectSignalToSlot(self):
         qconfig.themeChanged.connect(setTheme)
 
@@ -86,7 +119,7 @@ def _ensure_scroll_area(self):
 
     def create_content(self):
         """后台创建内容组件，避免堵塞进程 - 使用延迟创建的布局"""
-        if not self.ui_created or self.content_created or not self.content_widget_class:
+        if not self.ui_created or not self.content_widget_class:
             return
 
         # 确保滚动区域已创建
@@ -113,10 +146,25 @@ def create_content(self):
                 content_cls = self.content_widget_class
                 content_name = getattr(content_cls, "__name__", str(content_cls))
 
-            # 实例化并添加到延迟创建的布局
-            self.contentWidget = content_cls(self)
-            self._inner_layout_lazy.addWidget(self.contentWidget)
-            self.content_created = True
+            # 如果内容组件尚未创建，创建并添加到布局
+            if not self.content_created:
+                # 实例化并添加到延迟创建的布局
+                self.contentWidget = content_cls(self)
+                self._inner_layout_lazy.addWidget(self.contentWidget)
+                self.content_created = True
+
+                # 如果是预览模式，立即锁定所有组件
+                if self.is_preview_mode:
+                    self._lock_all_widgets(self.contentWidget)
+            else:
+                # 如果内容组件已经创建，检查是否需要更新锁定状态
+                if hasattr(self, "contentWidget") and self.contentWidget:
+                    if self.is_preview_mode:
+                        self._lock_all_widgets(self.contentWidget)
+                    else:
+                        # 如果不是预览模式，可以选择解锁所有组件
+                        # 但通常情况下，预览模式是一次性的，所以这里可以不处理
+                        pass
 
             elapsed = time.perf_counter() - start
             loguru.logger.debug(f"创建内容组件 {content_name} 耗时: {elapsed:.3f}s")
@@ -154,7 +202,51 @@ def create_empty_content(self, message="该页面正在开发中，敬请期待
         self.inner_layout_personal.addWidget(self.contentWidget)
         self.content_created = True
 
-    @classmethod
+    def _lock_all_widgets(self, widget):
+        """递归锁定所有子组件，包括嵌套的组件和GroupHeaderCardWidget内部的控件
+
+        Args:
+            widget: 要锁定的根组件
+        """
+        if widget is None:
+            return
+
+        # 首先锁定当前组件
+        if hasattr(widget, "setEnabled"):
+            widget.setEnabled(False)
+
+        # 特殊处理GroupHeaderCardWidget，确保锁定所有addItem或addGroup添加的控件
+        try:
+            if hasattr(widget, "widgets"):
+                # 如果GroupHeaderCardWidget有widgets属性，锁定所有widgets
+                for w in widget.widgets:
+                    if isinstance(w, QWidget):
+                        self._lock_all_widgets(w)
+            elif hasattr(widget, "items"):
+                # 如果有items属性，锁定所有items
+                for item in widget.items:
+                    if hasattr(item, "widget") and isinstance(item.widget, QWidget):
+                        self._lock_all_widgets(item.widget)
+                    elif isinstance(item, QWidget):
+                        self._lock_all_widgets(item)
+        except Exception as e:
+            logger.debug(f"处理特殊组件时出错: {e}")
+
+        # 然后递归锁定所有直接子组件
+        for child in widget.children():
+            if isinstance(child, QWidget):
+                self._lock_all_widgets(child)
+
+        # 最后，检查是否有contentWidget或其他可能包含控件的属性
+        if hasattr(widget, "contentWidget") and isinstance(
+            widget.contentWidget, QWidget
+        ):
+            self._lock_all_widgets(widget.contentWidget)
+        if hasattr(widget, "centralWidget") and isinstance(
+            widget.centralWidget, QWidget
+        ):
+            self._lock_all_widgets(widget.centralWidget)
+
     def clear_instance_cache(cls):
         """清除实例缓存，用于强制重新创建页面"""
         cls._instances.clear()
@@ -186,13 +278,14 @@ class PivotPageTemplate(QFrame):
     - 支持按需重新加载
     """
 
-    def __init__(self, page_config: dict, parent: QFrame = None):
+    def __init__(self, page_config: dict, parent: QFrame = None, is_preview_mode=False):
         """
         初始化 Pivot 页面模板
 
         Args:
             page_config: 页面配置字典，格式为 {"page_name": "display_name", ...}
             parent: 父窗口
+            is_preview_mode: 是否为预览模式
         """
         super().__init__(parent=parent)
 
@@ -204,11 +297,33 @@ def __init__(self, page_config: dict, parent: QFrame = None):
         self.base_path = "app.view.settings.list_management"  # 默认基础路径
         self._page_load_order = []  # 页面加载顺序，用于LRU卸载
         self.MAX_CACHED_PAGES = MAX_CACHED_PAGES  # 最大同时保留在内存中的页面数量
+        self._is_preview_mode = is_preview_mode
 
         self.__connectSignalToSlot()
 
         QTimer.singleShot(0, self.create_ui_components)
 
+    @property
+    def is_preview_mode(self):
+        """获取是否为预览模式"""
+        return self._is_preview_mode
+
+    @is_preview_mode.setter
+    def is_preview_mode(self, value):
+        """设置是否为预览模式，并在值改变时触发锁定逻辑
+
+        Args:
+            value: 是否为预览模式
+        """
+        self._is_preview_mode = value
+        # 如果已经有加载的页面，立即执行锁定逻辑
+        if hasattr(self, "page_infos"):
+            for page_name, info in self.page_infos.items():
+                if info.get("loaded") and info.get("widget"):
+                    widget = info.get("widget")
+                    if widget:
+                        self._lock_all_widgets(widget)
+
     def __connectSignalToSlot(self):
         """连接信号与槽"""
         qconfig.themeChanged.connect(setTheme)
@@ -348,6 +463,10 @@ def _load_page_content(
             widget = content_widget_class(self)
             widget.setObjectName(page_name)
 
+            # 如果是预览模式，锁定所有组件
+            if self.is_preview_mode:
+                self._lock_all_widgets(widget)
+
             # 清除加载提示（使用安全的 takeAt 循环以避免 Qt C++ 对象提前删除问题）
             try:
                 while inner_layout.count() > 0:
@@ -534,6 +653,51 @@ def get_current_page(self) -> str:
         """获取当前页面名称"""
         return self.current_page
 
+    def _lock_all_widgets(self, widget):
+        """递归锁定所有子组件，包括嵌套的组件和GroupHeaderCardWidget内部的控件
+
+        Args:
+            widget: 要锁定的根组件
+        """
+        if widget is None:
+            return
+
+        # 首先锁定当前组件
+        if hasattr(widget, "setEnabled"):
+            widget.setEnabled(False)
+
+        # 特殊处理GroupHeaderCardWidget，确保锁定所有addItem或addGroup添加的控件
+        try:
+            if hasattr(widget, "widgets"):
+                # 如果GroupHeaderCardWidget有widgets属性，锁定所有widgets
+                for w in widget.widgets:
+                    if isinstance(w, QWidget):
+                        self._lock_all_widgets(w)
+            elif hasattr(widget, "items"):
+                # 如果有items属性，锁定所有items
+                for item in widget.items:
+                    if hasattr(item, "widget") and isinstance(item.widget, QWidget):
+                        self._lock_all_widgets(item.widget)
+                    elif isinstance(item, QWidget):
+                        self._lock_all_widgets(item)
+        except Exception as e:
+            logger.debug(f"处理特殊组件时出错: {e}")
+
+        # 然后递归锁定所有直接子组件
+        for child in widget.children():
+            if isinstance(child, QWidget):
+                self._lock_all_widgets(child)
+
+        # 最后，检查是否有contentWidget或其他可能包含控件的属性
+        if hasattr(widget, "contentWidget") and isinstance(
+            widget.contentWidget, QWidget
+        ):
+            self._lock_all_widgets(widget.contentWidget)
+        if hasattr(widget, "centralWidget") and isinstance(
+            widget.centralWidget, QWidget
+        ):
+            self._lock_all_widgets(widget.centralWidget)
+
     def get_page(self, page_name: str):
         """根据页面名称获取页面组件"""
         return self.pages.get(page_name, None)

app/page_building/security_window.py

@@ -119,11 +119,17 @@ def create_unbind_usb_window():
 
 
 class verify_password_window_template(PageTemplate):
-    def __init__(self, parent=None):
-        super().__init__(content_widget_class=VerifyPasswordWindow, parent=parent)
+    def __init__(self, parent=None, operation_type=None):
+        super().__init__(
+            content_widget_class=VerifyPasswordWindow,
+            parent=parent,
+            operation_type=operation_type,
+        )
 
 
-def create_verify_password_window(on_verified=None):
+def create_verify_password_window(
+    on_verified=None, on_preview=None, operation_type=None
+):
     title = get_content_name_async("basic_safety_settings", "safety_switch")
     if "verify_password" in _security_window_instances:
         w = _security_window_instances["verify_password"]
@@ -136,18 +142,28 @@ def create_verify_password_window(on_verified=None):
             _security_window_instances.pop("verify_password", None)
     window = SimpleWindowTemplate(title, width=480, height=240)
     page = window.add_page_from_template(
-        "verify_password", verify_password_window_template
+        "verify_password",
+        verify_password_window_template,
+        operation_type=operation_type,
     )
     window.switch_to_page("verify_password")
+    content = getattr(page, "contentWidget", None)
     if on_verified:
         try:
-            content = getattr(page, "contentWidget", None)
             if content is not None and hasattr(content, "verified"):
                 content.verified.connect(on_verified)
             elif hasattr(page, "verified"):
                 page.verified.connect(on_verified)
         except Exception:
             pass
+    if on_preview:
+        try:
+            if content is not None and hasattr(content, "previewRequested"):
+                content.previewRequested.connect(on_preview)
+            elif hasattr(page, "previewRequested"):
+                page.previewRequested.connect(on_preview)
+        except Exception:
+            pass
     _security_window_instances["verify_password"] = window
     window.windowClosed.connect(
         lambda: _security_window_instances.pop("verify_password", None)