feat(app): 搜索改为调用后端并渲染卡片结果

lib/pages/discover/discover_binding.dart

@@ -1,6 +1,7 @@
-// Author: fruit.com.cn
+// Author: fruit.com.cn
 
 import '../../core/data/models/drama.dart';
+import '../../core/data/repositories/search_repository.dart';
 import '../../core/data/repositories/watch_history_repository.dart';
 import 'discover_logic.dart';
 
@@ -8,5 +9,10 @@ class DiscoverBinding {
   DiscoverLogic create({
     required Drama drama,
     required WatchHistoryRepository history,
-  }) => DiscoverLogic(drama: drama, history: history);
+    SearchRepository? search,
+  }) => DiscoverLogic(
+    drama: drama,
+    history: history,
+    searchRepository: search,
+  );
 }

lib/pages/discover/discover_logic.dart

@@ -1,20 +1,29 @@
 // Author: fruit.com.cn
 
+import 'dart:async';
+
 import 'package:flutter/material.dart';
 
 import '../../core/data/models/drama.dart';
 import '../../core/data/models/watch_progress.dart';
+import '../../core/data/remote/api_exception.dart';
+import '../../core/data/repositories/search_repository.dart';
 import '../../core/data/repositories/watch_history_repository.dart';
 import '../../l10n/app_localizations.dart';
 
 enum DiscoverPageAction { home, my, watchlist, detail, resume }
 
 class DiscoverLogic extends ChangeNotifier {
-  DiscoverLogic({required this.history, required this.drama}) {
+  DiscoverLogic({
+    required this.history,
+    required this.drama,
+    this.searchRepository,
+  }) {
     refreshPosition();
   }
 
   final WatchHistoryRepository history;
+  final SearchRepository? searchRepository;
   Drama drama;
   late Future<Duration?> position;
   WatchProgress? resumeRecord;
@@ -22,6 +31,17 @@ class DiscoverLogic extends ChangeNotifier {
   final FocusNode searchFocus = FocusNode();
   final ScrollController scroll = ScrollController();
   bool searchOpen = false;
+
+  /// 搜索防抖与分页口径：与后端 `/app/search` 一致。
+  Duration searchDebounce = const Duration(milliseconds: 350);
+  static const int searchPageSize = 20;
+  List<Drama> searchResults = const [];
+  int searchTotal = 0;
+  bool searchLoading = false;
+  String? searchError;
+  Timer? _searchTimer;
+  String _lastRequestedQuery = '';
+  int _searchRequest = 0;
   bool _disposed = false;
 
   void notify() {
@@ -51,20 +71,89 @@ class DiscoverLogic extends ChangeNotifier {
     notify();
   }
 
-  void onSearchChanged() => notify();
+  bool get hasSearchQuery => search.text.trim().isNotEmpty;
 
-  List<Drama> filtered(List<Drama> dramas) {
-    final query = search.text.trim().toLowerCase();
-    if (query.isEmpty) return dramas;
-    return dramas.where((drama) {
-      final haystack = [
-        drama.title,
-        drama.genre,
-        drama.category,
-        drama.synopsis,
-      ].join(' ').toLowerCase();
-      return haystack.contains(query);
-    }).toList();
+  /// 输入变化只触发后端查询；本地不再做标题/简介匹配。
+  void onSearchChanged() {
+    final query = search.text.trim();
+    if (query.isEmpty) {
+      _resetSearch();
+      notify();
+      return;
+    }
+    notify();
+    _scheduleSearch(query);
+  }
+
+  /// 搜索态展示后端结果，非搜索态展示剧场自身的可见短剧。
+  List<Drama> visibleDramas(List<Drama> fallback) {
+    if (!hasSearchQuery) return fallback;
+    return searchResults;
+  }
+
+  Future<void> retrySearch() async {
+    final query = search.text.trim();
+    if (query.isEmpty) return;
+    await _runSearch(query);
+  }
+
+  void _resetSearch() {
+    _searchTimer?.cancel();
+    _searchRequest++;
+    searchResults = const [];
+    searchTotal = 0;
+    searchLoading = false;
+    searchError = null;
+    _lastRequestedQuery = '';
+  }
+
+  void _scheduleSearch(String query) {
+    final alreadyRequested = query == _lastRequestedQuery;
+    if (alreadyRequested && (searchLoading || searchResults.isNotEmpty || searchError != null)) {
+      return;
+    }
+    _lastRequestedQuery = query;
+    _searchTimer?.cancel();
+    if (searchDebounce == Duration.zero) {
+      unawaited(_runSearch(query));
+      return;
+    }
+    _searchTimer = Timer(searchDebounce, () => unawaited(_runSearch(query)));
+  }
+
+  Future<void> _runSearch(String query) async {
+    final repository = searchRepository;
+    if (repository == null) return;
+    final request = ++_searchRequest;
+    searchLoading = true;
+    searchError = null;
+    notify();
+    try {
+      final result = await repository.search(
+        query,
+        pageIndex: 1,
+        pageSize: searchPageSize,
+      );
+      if (request != _searchRequest) return;
+      searchResults = result.list;
+      searchTotal = result.total;
+    } on ApiException catch (exception) {
+      _applySearchError(request, exception.message);
+    } catch (_) {
+      _applySearchError(request, 'searchFailed');
+    } finally {
+      if (request == _searchRequest) {
+        searchLoading = false;
+        notify();
+      }
+    }
+  }
+
+  void _applySearchError(int request, String message) {
+    if (request != _searchRequest) return;
+    searchError = message;
+    searchResults = const [];
+    searchTotal = 0;
   }
 
   Drama? resumeDrama(List<Drama> dramas) {
@@ -165,6 +254,7 @@ class DiscoverLogic extends ChangeNotifier {
   @override
   void dispose() {
     _disposed = true;
+    _searchTimer?.cancel();
     search.dispose();
     searchFocus.dispose();
     scroll.dispose();

lib/pages/discover/discover_view.dart

@@ -8,8 +8,10 @@ import '../../core/config/app_config.dart';
 import '../../core/data/models/drama.dart';
 import '../../core/data/models/home_feed.dart';
 import '../../core/data/models/watch_progress.dart';
+import '../../core/data/repositories/search_repository.dart';
 import '../../core/data/repositories/watch_history_repository.dart';
 import '../../core/data/services/category_controller.dart';
+import '../../core/formatting/error_text.dart';
 import '../../core/theme/app_colors.dart';
 import '../../core/theme/app_dimens.dart';
 import '../../core/theme/app_theme.dart';
@@ -30,6 +32,7 @@ class DiscoverPage extends StatefulWidget {
     required this.duration,
     this.focusSearch = false,
     this.history,
+    this.searchRepository,
     this.embedded = false,
     this.active = true,
     this.searchRequest = 0,
@@ -48,6 +51,7 @@ class DiscoverPage extends StatefulWidget {
   final Duration duration;
   final bool focusSearch;
   final WatchHistoryRepository? history;
+  final SearchRepository? searchRepository;
   final bool embedded;
   final bool active;
   final int searchRequest;
@@ -74,6 +78,7 @@ class _DiscoverPageState extends State<DiscoverPage> {
     logic = DiscoverBinding().create(
       drama: widget.drama,
       history: widget.history ?? context.read<WatchHistoryRepository>(),
+      search: widget.searchRepository ?? context.read<SearchRepository>(),
     );
     if (widget.focusSearch) {
       logic.searchOpen = true;
@@ -115,7 +120,7 @@ class _DiscoverPageState extends State<DiscoverPage> {
     final l10n = AppLocalizations.of(context)!;
     final categories = context.watch<CategoryController>();
     final allDramas = [...?widget.dramas, ...categories.visibleDramas];
-    final visible = logic.filtered(categories.visibleDramas);
+    final visible = logic.visibleDramas(categories.visibleDramas);
     final content = SafeArea(
       bottom: !widget.embedded,
       child: Column(
@@ -235,7 +240,10 @@ class _DiscoverPageState extends State<DiscoverPage> {
           l10n: l10n,
           categories: categories,
           dramas: visible,
-          searching: logic.search.text.trim().isNotEmpty,
+          searching: logic.hasSearchQuery,
+          searchLoading: logic.searchLoading,
+          searchError: logic.searchError,
+          onRetrySearch: () => logic.retrySearch(),
           onOpen: (drama) => logic.openCard(
             context,
             drama,
@@ -329,6 +337,7 @@ class _DiscoverPageState extends State<DiscoverPage> {
           controller: logic.search,
           focusNode: logic.searchFocus,
           onChanged: (_) => logic.onSearchChanged(),
+
           onTapOutside: (_) => logic.searchFocus.unfocus(),
           textInputAction: TextInputAction.search,
           style: const TextStyle(color: AppColors.onSurface, fontSize: 13),
@@ -343,6 +352,12 @@ class _DiscoverPageState extends State<DiscoverPage> {
               color: AppColors.subtle,
               size: 17,
             ),
+            suffixIcon: logic.searchLoading
+                ? const Padding(
+                    padding: EdgeInsets.all(11),
+                    child: CircularProgressIndicator(strokeWidth: 2),
+                  )
+                : null,
             contentPadding: const EdgeInsets.symmetric(horizontal: 12),
             enabledBorder: OutlineInputBorder(
               borderRadius: BorderRadius.circular(20),

lib/pages/discover/widgets/home_drama_grid.dart

@@ -8,6 +8,9 @@ class _HomeDramaGrid extends StatelessWidget {
     required this.categories,
     required this.dramas,
     required this.searching,
+    required this.searchLoading,
+    required this.searchError,
+    required this.onRetrySearch,
     required this.onOpen,
   });
 
@@ -15,6 +18,9 @@ class _HomeDramaGrid extends StatelessWidget {
   final CategoryController categories;
   final List<Drama> dramas;
   final bool searching;
+  final bool searchLoading;
+  final String? searchError;
+  final VoidCallback onRetrySearch;
   final ValueChanged<Drama> onOpen;
 
   @override
@@ -37,6 +43,29 @@ class _HomeDramaGrid extends StatelessWidget {
         ),
       );
     }
+    if (searching && searchLoading) {
+      return const SliverFillRemaining(
+        hasScrollBody: false,
+        child: Center(
+          child: CircularProgressIndicator(
+            key: Key('discover-search-loading'),
+            strokeWidth: 2,
+          ),
+        ),
+      );
+    }
+    if (searching && searchError != null) {
+      return _fill(
+        EmptyState(
+          key: const Key('discover-search-error'),
+          icon: Icons.cloud_off_rounded,
+          title: errorText(l10n, searchError, l10n.searchFailed),
+          actionLabel: l10n.retry,
+          actionKey: const Key('discover-search-retry'),
+          onAction: onRetrySearch,
+        ),
+      );
+    }
     if (dramas.isEmpty) {
       return _fill(
         EmptyState(