feat: background image

Author: Windsland52

aao/app.py

@@ -31,7 +31,7 @@
 if _ROOT not in sys.path:
     sys.path.insert(0, _ROOT)
 
-from PySide6.QtCore import QThread, QTimer  # noqa: E402
+from PySide6.QtCore import Qt, QThread, QTimer  # noqa: E402
 from PySide6.QtWidgets import (  # noqa: E402
     QApplication,
     QHBoxLayout,
@@ -41,7 +41,6 @@
     QMainWindow,
     QMessageBox,
     QStackedWidget,
-    QWidget,
 )
 
 from aao import config  # noqa: E402
@@ -52,6 +51,7 @@
 from aao.measure.worker import MeasurementWorker  # noqa: E402
 from aao.timeline.editor_window import EditorWindow  # noqa: E402
 from aao.ui.about_page import AboutPage  # noqa: E402
+from aao.ui.background import BackgroundContainer  # noqa: E402
 from aao.ui.calibration_page import CalibrationPage  # noqa: E402
 from aao.ui.farm_page import FarmPage  # noqa: E402
 from aao.ui.log_handler import QtLogHandler  # noqa: E402
@@ -160,6 +160,14 @@ def __init__(
         self.tray.quit_requested.connect(self._quit_from_tray)
         self.tray.show()
 
+        # 背景图（读 settings 启动即应用；后续切换由设置页 background_changed 驱动）
+        from aao.ui.settings_page import load_settings
+
+        bg = load_settings()
+        self._apply_background(
+            bg.get("background_image", ""), bg.get("background_opacity", 25) / 100.0
+        )
+
     # --- 新手引导 ---
 
     @staticmethod
@@ -289,7 +297,8 @@ def _on_profile_saved(self, filename: str) -> None:
         self.nav.setCurrentRow(_PAGE_FARM)
 
     def _build_ui(self) -> None:
-        central = QWidget()
+        central = BackgroundContainer()  # 带 cover 背景图的 central（paintEvent 画图）
+        self.bg_container = central
         root = QHBoxLayout(central)
         root.setContentsMargins(0, 0, 0, 0)
         root.setSpacing(0)
@@ -329,6 +338,23 @@ def _build_ui(self) -> None:
         self.setCentralWidget(central)
         self.nav.currentRowChanged.connect(self.stack.setCurrentIndex)
 
+        # 背景图从侧栏/内容栈/各页根透出。用 objectName 限定透明：只让这些容器本身透明，
+        # 不级联到表格表头/下拉项等子控件——否则 "background: transparent" 会破坏子控件
+        # 渲染（表头变黑、下拉项 focus 时字变白看不清）。控件本身保持 palette 不透明。
+        self.setStyleSheet("#bg_layer { background: transparent; }")
+        for w in (
+            self.nav,
+            self.stack,
+            self.farm_page,
+            self.editor_page,
+            self.calib_page,
+            self.settings_page,
+            self.about_page,
+        ):
+            w.setAttribute(Qt.WidgetAttribute.WA_StyledBackground, True)
+            w.setObjectName("bg_layer")
+        self.settings_page.background_changed.connect(self._apply_background)
+
         # 新手引导：设置页连好窗口 → 引导中则跳校准页；校准页保存 → 跳凹图页 + 标记完成
         # 普通 settings_changed（改端口/profile）不触发引导
         self.settings_page.window_configured.connect(self._on_window_configured)
@@ -355,6 +381,11 @@ def _set_connection_status(self, text: str, color: str) -> None:
         self.status_conn.setText(f"● {text}")
         self.status_conn.setStyleSheet(f"color: {color}; font-weight: bold;")
 
+    def _apply_background(self, path: str, opacity: float) -> None:
+        """应用背景图 + 透明度到 central（设置页 background_changed / 启动时调用）。"""
+        self.bg_container.set_background(path)
+        self.bg_container.set_opacity(opacity)
+
     # --- 测量状态更新 ---
 
     def _on_measure_state(self, state: dict) -> None:

aao/ui/background.py

@@ -0,0 +1,61 @@
+"""主控台背景图层：cover 裁剪绘制图片 + 可调透明度。
+
+cover：按较大缩放比把图片放大至完全覆盖容器，超出部分裁掉（保持原比例，不拉伸变形）。
+透明度：``painter.setOpacity`` 控制，0=不画（纯底色），1=完全不透明；底色取 palette
+的 Window 角色，故半透明图片自然叠在主题背景上，切主题时底色跟随。
+"""
+
+from __future__ import annotations
+
+from PySide6.QtCore import QEvent, QRectF
+from PySide6.QtGui import QPainter, QPaintEvent, QPalette, QPixmap
+from PySide6.QtWidgets import QApplication, QWidget
+
+
+class BackgroundContainer(QWidget):
+    """带背景图的容器：paintEvent 画底色 + cover 裁剪图（可调透明度）。"""
+
+    def __init__(self, parent: QWidget | None = None) -> None:
+        super().__init__(parent)
+        self._pixmap: QPixmap | None = None
+        self._opacity: float = 0.25
+
+    def set_background(self, path: str) -> None:
+        """按路径加载背景图；空路径或加载失败则清除。"""
+        if path:
+            pm = QPixmap(path)
+            self._pixmap = pm if not pm.isNull() else None
+        else:
+            self._pixmap = None
+        self.update()
+
+    def set_opacity(self, opacity: float) -> None:
+        self._opacity = max(0.0, min(1.0, opacity))
+        self.update()
+
+    def changeEvent(self, event: QEvent) -> None:
+        # 主题切换 → palette 变 → 自绘底色需要主动刷新；否则加载背景图时旧底色会滞留，
+        # 看起来像深/浅主题没有生效，直到清除/重载图片触发 update。
+        if event.type() == QEvent.Type.PaletteChange:
+            self.update()
+        super().changeEvent(event)
+
+    def paintEvent(self, _event: QPaintEvent) -> None:
+        painter = QPainter(self)
+        # 底色（主题背景）——直接读 QApplication palette，避免 widget 自身 PaletteChange
+        # 异步传播导致背景层落后一拍（标题栏/状态栏已变，中间仍是上一主题）。
+        app = QApplication.instance()
+        pal = app.palette() if isinstance(app, QApplication) else self.palette()
+        painter.fillRect(self.rect(), pal.color(QPalette.ColorRole.Window))
+        pm = self._pixmap
+        if pm is None or pm.isNull() or self._opacity <= 0:
+            return
+        cw, ch = self.width(), self.height()
+        iw, ih = pm.width(), pm.height()
+        if iw <= 0 or ih <= 0:
+            return
+        painter.setOpacity(self._opacity)
+        # cover：取较大缩放比 → 完全覆盖；居中绘制，超出窗口部分被裁
+        scale = max(cw / iw, ch / ih)
+        dw, dh = iw * scale, ih * scale
+        painter.drawPixmap(QRectF((cw - dw) / 2, (ch - dh) / 2, dw, dh), pm, QRectF(0, 0, iw, ih))

aao/ui/settings_page.py

@@ -9,10 +9,11 @@
 import json
 from typing import TYPE_CHECKING, Any
 
-from PySide6.QtCore import QObject, Qt, QThread, Signal
+from PySide6.QtCore import QObject, Qt, QThread, QTimer, Signal
 from PySide6.QtWidgets import (
     QCheckBox,
     QComboBox,
+    QFileDialog,
     QFormLayout,
     QGroupBox,
     QHBoxLayout,
@@ -22,6 +23,7 @@
     QListWidgetItem,
     QMessageBox,
     QPushButton,
+    QSlider,
     QSpinBox,
     QVBoxLayout,
     QWidget,
@@ -131,6 +133,7 @@ class SettingsPage(QWidget):
 
     settings_changed = Signal()  # 保存后通知 MainWindow（端口/profile 变更需重启生效）
     window_configured = Signal()  # 设为默认窗口后（新手引导用：连完窗口 → 校准）
+    background_changed = Signal(str, float)  # 背景图路径 + 透明度(0-1)，即时应用
 
     def __init__(self):
         super().__init__()
@@ -280,6 +283,28 @@ def _build_ui(self) -> None:
 
         root.addWidget(ui_box)
 
+        # --- 背景图 ---
+        bg_box = QGroupBox("背景图")
+        bg_form = QFormLayout(bg_box)
+        self.edit_bg = QLineEdit()
+        self.edit_bg.setPlaceholderText("可选，留空 = 无背景图")
+        self.btn_bg_pick = QPushButton("📂 选择")
+        self.btn_bg_clear = QPushButton("✕ 清除")
+        bg_file_row = QHBoxLayout()
+        bg_file_row.addWidget(self.edit_bg, 1)
+        bg_file_row.addWidget(self.btn_bg_pick)
+        bg_file_row.addWidget(self.btn_bg_clear)
+        bg_form.addRow("图片:", bg_file_row)
+        self.slider_bg = QSlider(Qt.Orientation.Horizontal)
+        self.slider_bg.setRange(0, 100)
+        self.slider_bg.setValue(25)
+        self.lbl_bg_val = QLabel("25%")
+        bg_op_row = QHBoxLayout()
+        bg_op_row.addWidget(self.slider_bg, 1)
+        bg_op_row.addWidget(self.lbl_bg_val)
+        bg_form.addRow("透明度:", bg_op_row)
+        root.addWidget(bg_box)
+
         root.addStretch()
 
         # 日志
@@ -289,6 +314,9 @@ def _build_ui(self) -> None:
         # 信号
         self.btn_save.clicked.connect(self._on_save)
         self.cb_theme.currentIndexChanged.connect(self._on_theme_changed)
+        self.btn_bg_pick.clicked.connect(self._on_bg_pick)
+        self.btn_bg_clear.clicked.connect(self._on_bg_clear)
+        self.slider_bg.valueChanged.connect(self._on_bg_opacity)
         self.btn_sync.clicked.connect(lambda: self._run_resource("sync", False))
         self.btn_sync_remote.clicked.connect(lambda: self._run_resource("sync", True))
         self.btn_check.clicked.connect(lambda: self._run_resource("check_update", False))
@@ -439,18 +467,55 @@ def _on_theme_changed(self, idx: int) -> None:
         """主题下拉切换：即时应用 + 持久化（纯 UI 偏好，无需重启或点保存按钮）。"""
         mode = theme.MODES[idx]
         theme.apply_theme(mode)
+        # 背景层是自绘的：主题切换后在下一轮事件循环刷新一次，等 Qt 完成 palette 传播。
+        QTimer.singleShot(0, lambda: self._emit_background(save=False))
         s = load_settings()
         s["theme"] = mode
         save_settings(s)
         self.lbl_op.setText(f"主题已切换为：{theme.label(mode)}")
 
+    def _on_bg_pick(self) -> None:
+        path, _ = QFileDialog.getOpenFileName(
+            self, "选择背景图", "", "图片 (*.png *.jpg *.jpeg *.bmp *.webp)"
+        )
+        if not path:
+            return
+        self.edit_bg.setText(path)
+        self._emit_background()
+
+    def _on_bg_clear(self) -> None:
+        self.edit_bg.clear()
+        self._emit_background()
+
+    def _on_bg_opacity(self, value: int) -> None:
+        self.lbl_bg_val.setText(f"{value}%")
+        self._emit_background()
+
+    def _emit_background(self, save: bool = True) -> None:
+        """即时应用背景（发信号给 MainWindow）；默认同时持久化。"""
+        path = self.edit_bg.text().strip()
+        opacity = self.slider_bg.value() / 100.0
+        self.background_changed.emit(path, opacity)
+        if not save:
+            return
+        s = load_settings()
+        s["background_image"] = path
+        s["background_opacity"] = self.slider_bg.value()
+        save_settings(s)
+
     def _load(self) -> None:
         s = load_settings()
         # 主题：静默选中（启动时已由 app.py 应用，这里只同步下拉），切换时才即时生效
         self.cb_theme.blockSignals(True)
         mode = s.get("theme", theme.AUTO)
         self.cb_theme.setCurrentIndex(theme.MODES.index(mode) if mode in theme.MODES else 0)
         self.cb_theme.blockSignals(False)
+        # 背景图：同步控件（启动时由 app.py 应用，这里静默，切换时才 emit）
+        self.edit_bg.setText(s.get("background_image", ""))
+        self.slider_bg.blockSignals(True)
+        self.slider_bg.setValue(int(s.get("background_opacity", 25)))
+        self.slider_bg.blockSignals(False)
+        self.lbl_bg_val.setText(f"{self.slider_bg.value()}%")
         if s.get("profile"):
             self.cb_profile.setCurrentText(s["profile"])
         if s.get("port"):

aao/ui/theme.py

@@ -99,11 +99,29 @@ def light_palette() -> QPalette:
     return p
 
 
-def _apply_palette_for_scheme(scheme: Qt.ColorScheme) -> None:
+def _refresh_existing_widgets(app: QApplication, palette: QPalette) -> None:
+    """同步刷新已存在控件的 palette，避免主题切换时控件外观落后一拍。
+
+    Qt 会异步向现有 widget 分发 PaletteChange；对下拉框/表格/按钮这类控件，
+    视觉上可能要到下一次交互或下一轮切换才更新。这里主动同步 palette + repolish。
+    """
+    for w in app.allWidgets():
+        w.setPalette(palette)
+        w.style().unpolish(w)
+        w.style().polish(w)
+        w.update()
+
+
+def _apply_palette(palette: QPalette) -> None:
     app = QApplication.instance()
     if not isinstance(app, QApplication):
         return
-    app.setPalette(dark_palette() if scheme == Qt.ColorScheme.Dark else light_palette())
+    app.setPalette(palette)
+    _refresh_existing_widgets(app, palette)
+
+
+def _apply_palette_for_scheme(scheme: Qt.ColorScheme) -> None:
+    _apply_palette(dark_palette() if scheme == Qt.ColorScheme.Dark else light_palette())
 
 
 def _on_system_scheme_changed(scheme: Qt.ColorScheme) -> None:
@@ -137,4 +155,4 @@ def apply_theme(mode: str) -> None:
         _listening = True
         _apply_palette_for_scheme(hints.colorScheme())
     else:
-        app.setPalette(dark_palette() if _current_mode == DARK else light_palette())
+        _apply_palette(dark_palette() if _current_mode == DARK else light_palette())