feat(Search): 桌面端与移动端统一搜索框架

- 删除 _searchTarget 手动簿记，改用固定连接 + currentWidget 路由
- searchEdit 实例化移到 __init__ 遵循四段式骨架
- 移动端共享搜索框放在页面上方，页面切换自动重接
- filterToolBar 去掉 searchLineEdit，改为 filterSegment 居左
- 添加 android/preview.py 在桌面预览移动端 UI

Author: XiaoYouChR

android/preview.py

@@ -0,0 +1,46 @@
+"""在桌面上预览移动端 UI，用于开发调试。
+
+用法: uv run python android/preview.py
+"""
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
+
+import app.platform.android as _android
+_android.nativeLibraryDir = lambda: ""
+_android.isStorageGranted = lambda: True
+_android.requestStoragePermission = lambda: None
+_android.sharedText = lambda: None
+_android.clearShare = lambda: None
+_android.isSystemDark = lambda: False
+
+import app.platform.android_notification as _notif
+_notif.isNotificationEnabled = lambda: True
+_notif.requestNotificationPermission = lambda: None
+
+
+if __name__ == "__main__":
+    from main import setupEnvironment
+    from app.platform.application import SingletonApplication
+    from app.startup import loadEngine, loadPacks, startEngine, stopEngine
+
+    setupEnvironment()
+    app = SingletonApplication(sys.argv, "gd3-mobile-preview")
+
+    from app.view.mobile import setupAndroid
+    setupAndroid()
+
+    loadEngine(app)
+    loadPacks()
+
+    from app.view.mobile.window import MobileMainWindow
+    from app.view.mobile.device import setupTouchScrolling
+    window = MobileMainWindow()
+    window.resize(400, 800)
+    window.show()
+    setupTouchScrolling(window)
+
+    startEngine()
+    app.aboutToQuit.connect(stopEngine)
+    sys.exit(app.exec())

app/view/mobile/setting_page.py

@@ -1,7 +1,7 @@
 from PySide6.QtCore import Qt
 from PySide6.QtGui import QColor, QPalette
 from PySide6.QtWidgets import QHBoxLayout, QSizePolicy, QVBoxLayout, QWidget
-from qfluentwidgets import SearchLineEdit, SettingCard, SwitchButton, isDarkTheme, qconfig
+from qfluentwidgets import SettingCard, SwitchButton, isDarkTheme, qconfig
 
 from app.view.components.setting_card_group import CollapsibleSettingCardGroup
 from app.view.pages.setting_page import SettingPage
@@ -12,12 +12,6 @@
 class MobileSettingPage(SettingPage):
     def __init__(self, parent=None):
         super().__init__(parent)
-
-        self.searchEdit = SearchLineEdit(self.container)
-        self.searchEdit.setPlaceholderText(self.tr("搜索设置"))
-        self.vBoxLayout.insertWidget(0, self.searchEdit)
-        self.searchEdit.textChanged.connect(self.setSearchText)
-
         self._setScrollContentOpaque()
 
     def showEvent(self, event):

app/view/mobile/task_page.py

@@ -51,10 +51,10 @@ def _initLayout(self) -> None:
         filterToolBarLayout = QHBoxLayout(self.filterToolBar)
         filterToolBarLayout.setContentsMargins(10, 0, 10, 4)
         filterToolBarLayout.setSpacing(6)
-        filterToolBarLayout.addWidget(self.sortButton)
         filterToolBarLayout.addWidget(self.filterSegment)
+        filterToolBarLayout.addStretch(1)
+        filterToolBarLayout.addWidget(self.sortButton)
         filterToolBarLayout.addWidget(self.categoryFilterButton)
-        filterToolBarLayout.addWidget(self.searchLineEdit, 1)
 
         layout = QVBoxLayout(self)
         layout.setContentsMargins(0, 0, 0, 0)

app/view/mobile/window.py

@@ -2,9 +2,9 @@
 
 from PySide6.QtCore import QEvent, QSize, Qt
 from PySide6.QtGui import QColor, QIcon, QPainter
-from PySide6.QtWidgets import QApplication, QStackedWidget, QVBoxLayout, QWidget
+from PySide6.QtWidgets import QApplication, QHBoxLayout, QStackedWidget, QVBoxLayout, QWidget
 from qfluentwidgets import (
-    FluentIcon, InfoBar, InfoBarPosition, PrimaryToolButton,
+    FluentIcon, InfoBar, InfoBarPosition, PrimaryToolButton, SearchLineEdit,
     Theme, isDarkTheme, qconfig,
 )
 
@@ -38,6 +38,7 @@ def __init__(self):
         )
         self.taskPage = MobileTaskPage(self)
         self.settingPage = MobileSettingPage(self)
+        self.searchEdit = SearchLineEdit(self)
         self.addButton = PrimaryToolButton(FluentIcon.ADD, self)
         self.vBoxLayout = QVBoxLayout(self)
 
@@ -50,13 +51,16 @@ def __init__(self):
         self._bind()
         self._updatePermissionBanner()
         self._updateAddButtonVisibility()
+        self._updateSearchTarget(self.taskPage)
 
     def _initWidget(self):
         self.setObjectName("MobileMainWindow")
         self.setWindowIcon(QIcon(":/image/logo.png"))
         self.setWindowTitle("Ghost Downloader")
         self.taskPage.setObjectName("taskInterface")
         self.settingPage.setObjectName("settingInterface")
+        self.searchEdit.setClearButtonEnabled(True)
+        self.taskPage.searchLineEdit.hide()
         self.addButton.setFixedSize(56, 56)
         self.addButton.setIconSize(QSize(22, 22))
         self.addButton.raise_()
@@ -68,12 +72,21 @@ def _initLayout(self):
         self.vBoxLayout.setSpacing(0)
         self.vBoxLayout.addWidget(self.permissionBanner, 0)
         self.vBoxLayout.addWidget(self.notificationBanner, 0)
+        searchBar = QWidget(self)
+        searchBarLayout = QHBoxLayout(searchBar)
+        searchBarLayout.setContentsMargins(10, 6, 10, 6)
+        searchBarLayout.addWidget(self.searchEdit)
+        self.vBoxLayout.addWidget(searchBar, 0)
         self.vBoxLayout.addWidget(self.stackedWidget, 1)
         self.vBoxLayout.addWidget(self.navigationBar, 0)
 
     def _bind(self):
         self.navigationBar.currentChanged.connect(self.stackedWidget.setCurrentIndex)
         self.navigationBar.currentChanged.connect(lambda *_: self._updateAddButtonVisibility())
+        self.navigationBar.currentChanged.connect(
+            lambda index: self._updateSearchTarget(self.stackedWidget.widget(index))
+        )
+        self.searchEdit.textChanged.connect(self._onSearchTextChanged)
         self.taskPage.selectionModeChanged.connect(lambda *_: self._updateAddButtonVisibility())
         self.addButton.clicked.connect(self._showAddTaskDialog)
         self._draft.taskConfirmed.connect(taskService.add)
@@ -87,6 +100,19 @@ def _addPage(self, page: QWidget, icon: FluentIcon, text: str):
         self.stackedWidget.addWidget(page)
         self.navigationBar.addItem(icon, text)
 
+    def _onSearchTextChanged(self, text: str) -> None:
+        page = self.stackedWidget.currentWidget()
+        if hasattr(page, 'setSearchText'):
+            page.setSearchText(text)
+
+    def _updateSearchTarget(self, page: QWidget) -> None:
+        self.searchEdit.clear()
+        if hasattr(page, 'setSearchText'):
+            self.searchEdit.setPlaceholderText(page.searchPlaceholder)
+            self.searchEdit.show()
+        else:
+            self.searchEdit.hide()
+
     def _onSystemColorSchemeChanged(self, colorScheme):
         if cfg.themeMode.value != Theme.AUTO:
             return

app/view/pages/setting_page.py

@@ -319,7 +319,7 @@ def _initCards(self) -> None:
         self.feedbackCard = PrimaryPushSettingCard(
             self.tr("提供反馈"), FluentIcon.FEEDBACK,
             self.tr("提供反馈"),
-            self.tr("通过提供反馈来帮助我们改进 Ghost Downloader（日志）"),
+            self.tr("通过提供反馈来帮助我们改进 Ghost Downloader，也可查看日志排查问题"),
         )
         self.openLogButton = PushButton(self.tr("查看日志"), self.feedbackCard)
         self.feedbackCard.hBoxLayout.insertSpacing(6, 8)

app/view/windows/main_window.py

@@ -31,14 +31,14 @@ class MainWindow(MSFluentWindow):
     def __init__(self, parent=None):
         self._isGeometryRestored = False
         self._isBackgroundEffectDirty = False
-        self._searchTarget = None
+        self.searchEdit = None
         super().__init__(parent)
         self.setMicaEffectEnabled(False)
         self.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose)
 
         self._pages: dict[str, QWidget] = {}
-
         self._draft = TaskDraft(parent=self)
+        self.searchEdit = SearchLineEdit(self.titleBar)
 
         self._initWidget()
         self._initLayout()
@@ -52,7 +52,6 @@ def _initWidget(self) -> None:
         if sys.platform == "darwin":
             self.titleBar.hBoxLayout.insertSpacing(0, 60)
 
-        self.searchEdit = SearchLineEdit(self.titleBar)
         self.searchEdit.setClearButtonEnabled(True)
         self.searchEdit.hide()
         self.searchEdit.raise_()
@@ -112,14 +111,14 @@ def _showPage(self, pageClass: type[QWidget]) -> None:
         self.navigationInterface.setCurrentItem(routeKey)
         self._updateSearchTarget(page)
 
+    def _onSearchTextChanged(self, text: str) -> None:
+        page = self.stackedWidget.currentWidget()
+        if hasattr(page, 'setSearchText'):
+            page.setSearchText(text)
+
     def _updateSearchTarget(self, page: QWidget) -> None:
         self.searchEdit.clear()
-        if self._searchTarget is not None:
-            self.searchEdit.textChanged.disconnect(self._searchTarget)
-            self._searchTarget = None
         if hasattr(page, 'setSearchText'):
-            self._searchTarget = page.setSearchText
-            self.searchEdit.textChanged.connect(self._searchTarget)
             self.searchEdit.setPlaceholderText(page.searchPlaceholder)
             self.searchEdit.show()
         else:
@@ -146,6 +145,7 @@ def _bind(self) -> None:
         QApplication.instance().styleHints().colorSchemeChanged.connect(self._onSystemColorSchemeChanged)
         self.titleBar.closeBtn.clicked.disconnect(self.close)
         self.titleBar.closeBtn.clicked.connect(self._onCloseClicked)
+        self.searchEdit.textChanged.connect(self._onSearchTextChanged)
 
         from PySide6.QtGui import QKeySequence, QShortcut
         QShortcut(QKeySequence.StandardKey.Find, self).activated.connect(self._onSearchShortcut)
@@ -294,7 +294,7 @@ def _onCloseClicked(self) -> None:
 
     def resizeEvent(self, event) -> None:
         super().resizeEvent(event)
-        if self._searchTarget is not None:
+        if self.searchEdit is not None and self.searchEdit.isVisible():
             self._refreshSearchEditGeometry()
 
     def closeEvent(self, event) -> None: