现在支持在外观设置调节是否显示番剧卡片的简介。现在媒体库界面支持了显示远程访问快捷入口。现在支持在播放器菜单里导出弹幕文件。让程序实现单进程以防止多开软件。现在库管理内对文件夹进行操作之后不会显示为空文件夹了。细节调整。2026.0129

Author: MCDFsteve

lib/main.dart

@@ -13,7 +13,6 @@ import 'package:nipaplay/utils/theme_notifier.dart';
 import 'package:nipaplay/utils/system_resource_monitor.dart';
 import 'package:nipaplay/themes/nipaplay/widgets/custom_scaffold.dart';
 import 'package:nipaplay/themes/nipaplay/widgets/menu_button.dart';
-import 'package:nipaplay/themes/nipaplay/widgets/nipaplay_window.dart';
 import 'package:nipaplay/themes/nipaplay/widgets/system_resource_display.dart';
 import 'package:window_manager/window_manager.dart';
 import 'package:provider/provider.dart';
@@ -53,6 +52,7 @@ import 'package:nipaplay/utils/storage_service.dart';
 import 'package:permission_handler/permission_handler.dart';
 import 'package:nipaplay/services/debug_log_service.dart';
 import 'package:nipaplay/services/file_association_service.dart';
+import 'package:nipaplay/services/single_instance_service.dart';
 import 'package:nipaplay/danmaku_abstraction/danmaku_kernel_factory.dart';
 import 'package:nipaplay/themes/nipaplay/widgets/splash_screen.dart';
 import 'package:shared_preferences/shared_preferences.dart';
@@ -75,6 +75,7 @@ import 'package:nipaplay/models/anime_detail_display_mode.dart';
 import 'package:nipaplay/models/background_image_render_mode.dart';
 import 'constants/settings_keys.dart';
 import 'player_abstraction/media_kit_player_adapter.dart';
+import 'utils/launch_file_handler.dart';
 import 'package:nipaplay/services/desktop_exit_handler_stub.dart'
     if (dart.library.io) 'package:nipaplay/services/desktop_exit_handler.dart';
 
@@ -110,6 +111,23 @@ void main(List<String> args) async {
     return;
   }
 
+  String? launchFilePath;
+  if (globals.isDesktop && args.isNotEmpty) {
+    final filePath = args.first;
+    if (await File(filePath).exists()) {
+      launchFilePath = filePath;
+    }
+  }
+
+  if (globals.isDesktop) {
+    final isPrimary = await SingleInstanceService.ensureSingleInstance(
+      launchFilePath: launchFilePath,
+    );
+    if (!isPrimary) {
+      return;
+    }
+  }
+
   WatchHistoryDatabase.ensureInitialized();
 
   // 安装 HTTP 客户端覆盖（自签名证书信任规则），尽早生效
@@ -124,17 +142,9 @@ void main(List<String> args) async {
   final debugLogService = DebugLogService();
   debugLogService.initialize();
 
-  // 检查是否有文件路径参数传入
-  String? launchFilePath;
-
-  // 桌面平台通过命令行参数传入
-  if (!kIsWeb && args.isNotEmpty && globals.isDesktop) {
-    final filePath = args.first;
-    if (await File(filePath).exists()) {
-      launchFilePath = filePath;
-      debugLogService.addLog('应用启动时收到命令行文件路径: $filePath',
-          level: 'INFO', tag: 'FileAssociation');
-    }
+  if (launchFilePath != null) {
+    debugLogService.addLog('应用启动时收到命令行文件路径: $launchFilePath',
+        level: 'INFO', tag: 'FileAssociation');
   }
 
   // Android平台通过Intent传入
@@ -394,7 +404,7 @@ void main(List<String> args) async {
           if (uiThemeProvider.isCupertinoTheme) {
             _navigateToPage(context, 3); // Cupertino 主题保留底部设置页
           } else {
-            _showSettingsWindow(context); // Nipaplay 主题使用弹窗设置页
+            SettingsPage.showWindow(context); // Nipaplay 主题使用弹窗设置页
           }
         });
 
@@ -658,6 +668,11 @@ class _NipaPlayAppState extends State<NipaPlayApp> {
     super.initState();
     // 启动后设置WatchHistoryProvider监听ScanService
     WidgetsBinding.instance.addPostFrameCallback((_) {
+      if (globals.isDesktop) {
+        SingleInstanceService.registerMessageHandler(
+          _handleSingleInstanceMessage,
+        );
+      }
       DesktopExitHandler.instance.initialize(navigatorKey);
 
       // 调试：启动时打印数据库内容
@@ -685,6 +700,44 @@ class _NipaPlayAppState extends State<NipaPlayApp> {
     });
   }
 
+  Future<void> _handleSingleInstanceMessage(
+    SingleInstanceMessage message,
+  ) async {
+    if (!mounted) {
+      return;
+    }
+    if (message.focus) {
+      await _focusMainWindow();
+    }
+    final filePath = message.filePath;
+    if (filePath != null) {
+      await LaunchFileHandler.handle(
+        filePath,
+        onError: (error) {
+          if (mounted) {
+            BlurSnackBar.show(context, error);
+          }
+        },
+      );
+    }
+  }
+
+  Future<void> _focusMainWindow() async {
+    if (!globals.isDesktop) {
+      return;
+    }
+    try {
+      final isMinimized = await windowManager.isMinimized();
+      if (isMinimized) {
+        await windowManager.restore();
+      }
+      await windowManager.show();
+      await windowManager.focus();
+    } catch (e) {
+      debugPrint('[SingleInstance] 唤起窗口失败: $e');
+    }
+  }
+
   @override
   Widget build(BuildContext context) {
     return DropTarget(
@@ -1000,37 +1053,14 @@ class MainPageState extends State<MainPage>
 
   // 处理启动文件
   Future<void> _handleLaunchFile(String filePath) async {
-    try {
-      debugPrint('[FileAssociation] 处理启动文件: $filePath');
-
-      // 检查是否存在历史记录
-      WatchHistoryItem? historyItem =
-          await WatchHistoryManager.getHistoryItem(filePath);
-
-      historyItem ??= WatchHistoryItem(
-        filePath: filePath,
-        animeName: path.basenameWithoutExtension(filePath),
-        watchProgress: 0,
-        lastPosition: 0,
-        duration: 0,
-        lastWatchTime: DateTime.now(),
-      );
-
-      final playableItem = PlayableItem(
-        videoPath: filePath,
-        title: historyItem.animeName,
-        historyItem: historyItem,
-      );
-
-      await PlaybackService().play(playableItem);
-
-      debugPrint('[FileAssociation] 启动文件已提交给PlaybackService');
-    } catch (e) {
-      debugPrint('[FileAssociation] 启动文件播放失败: $e');
-      if (mounted) {
-        BlurSnackBar.show(context, '无法播放启动文件: $e');
-      }
-    }
+    await LaunchFileHandler.handle(
+      filePath,
+      onError: (error) {
+        if (mounted) {
+          BlurSnackBar.show(context, error);
+        }
+      },
+    );
   }
 
   // 检查窗口是否已最大化
@@ -1246,7 +1276,7 @@ class MainPageState extends State<MainPage>
                     height: kWindowCaptionHeight,
                     child: Center(
                       child: _SettingsEntryButton(
-                        onPressed: () => _showSettingsWindow(context),
+                        onPressed: () => SettingsPage.showWindow(context),
                       ),
                     ),
                   ),
@@ -1523,48 +1553,3 @@ void _navigateToPage(BuildContext context, int pageIndex) {
         '[Dart - _navigateToPage] 备选方案: 使用TabChangeNotifier请求切换到标签页$pageIndex');
   }
 }
-
-void _showSettingsWindow(BuildContext context) {
-  final appearanceSettings =
-      Provider.of<AppearanceSettingsProvider>(context, listen: false);
-  final enableAnimation = appearanceSettings.enablePageAnimation;
-  final screenSize = MediaQuery.of(context).size;
-  final isCompactLayout = screenSize.width < 900;
-  final maxWidth = isCompactLayout ? screenSize.width * 0.95 : 980.0;
-  final maxHeightFactor = isCompactLayout ? 0.9 : 0.85;
-
-  NipaplayWindow.show(
-    context: context,
-    enableAnimation: enableAnimation,
-    child: NipaplayWindowScaffold(
-      maxWidth: maxWidth,
-      maxHeightFactor: maxHeightFactor,
-      onClose: () => Navigator.of(context).pop(),
-      child: Column(
-        crossAxisAlignment: CrossAxisAlignment.start,
-        children: [
-          Builder(
-            builder: (innerContext) {
-              final titleStyle = Theme.of(innerContext)
-                  .textTheme
-                  .titleLarge
-                  ?.copyWith(fontWeight: FontWeight.bold);
-              return GestureDetector(
-                behavior: HitTestBehavior.opaque,
-                onPanUpdate: (details) {
-                  NipaplayWindowPositionProvider.of(innerContext)
-                      ?.onMove(details.delta);
-                },
-                child: Padding(
-                  padding: const EdgeInsets.fromLTRB(16, 16, 16, 8),
-                  child: Text('设置', style: titleStyle),
-                ),
-              );
-            },
-          ),
-          const Expanded(child: SettingsPage()),
-        ],
-      ),
-    ),
-  );
-}

lib/pages/anime_page.dart

@@ -40,6 +40,8 @@ import 'package:nipaplay/models/playable_item.dart';
 import 'package:nipaplay/providers/dandanplay_remote_provider.dart';
 import 'package:nipaplay/pages/tab_labels.dart';
 import 'package:flutter_svg/flutter_svg.dart';
+import 'package:nipaplay/themes/nipaplay/pages/settings_page.dart';
+import 'package:nipaplay/utils/globals.dart' as globals;
 
 // Custom ScrollBehavior for NoScrollbarBehavior is removed as NestedScrollView handles scrolling differently.
 
@@ -274,6 +276,7 @@ class _MediaLibraryTabsState extends State<_MediaLibraryTabs> with TickerProvide
 
   // 添加变量追踪“添加媒体服务器”入口的悬停状态
   bool _isAddEntryHovered = false;
+  bool _isRemoteAccessHovered = false;
 
   // 动态计算标签页数量
   int get _tabCount {
@@ -555,6 +558,54 @@ class _MediaLibraryTabsState extends State<_MediaLibraryTabs> with TickerProvide
     }
   }
 
+  void _openRemoteAccessSettings() {
+    SettingsPage.showWindow(
+      context,
+      initialEntryId: SettingsPage.entryRemoteAccess,
+    );
+  }
+
+  Widget _buildRemoteAccessEntry({
+    required Color iconColor,
+    required Color textColor,
+  }) {
+    const Color hoverColor = Color(0xFFFF2E55);
+    final Color displayColor = _isRemoteAccessHovered ? hoverColor : textColor;
+
+    return Padding(
+      padding: const EdgeInsets.only(bottom: 12.0),
+      child: MouseRegion(
+        cursor: SystemMouseCursors.click,
+        onEnter: (_) => setState(() => _isRemoteAccessHovered = true),
+        onExit: (_) => setState(() => _isRemoteAccessHovered = false),
+        child: GestureDetector(
+          onTap: _openRemoteAccessSettings,
+          child: AnimatedScale(
+            scale: _isRemoteAccessHovered ? 1.1 : 1.0,
+            duration: const Duration(milliseconds: 200),
+            curve: Curves.easeOut,
+            child: Row(
+              mainAxisSize: MainAxisSize.min,
+              children: [
+                Icon(Icons.link, size: 18, color: displayColor),
+                const SizedBox(width: 6),
+                Text(
+                  '远程访问',
+                  locale: const Locale("zh-Hans", "zh"),
+                  style: TextStyle(
+                    color: displayColor,
+                    fontSize: 18,
+                    fontWeight: FontWeight.bold,
+                  ),
+                ),
+              ],
+            ),
+          ),
+        ),
+      ),
+    );
+  }
+
   Widget _buildAddMediaServerEntry({
     required Color iconColor,
     required Color textColor,
@@ -920,6 +971,13 @@ class _MediaLibraryTabsState extends State<_MediaLibraryTabs> with TickerProvide
                           ),
                         ),
                         const SizedBox(width: 8),
+                        if (!globals.isPhone) ...[
+                          _buildRemoteAccessEntry(
+                            iconColor: activeColor,
+                            textColor: unselectedLabelColor,
+                          ),
+                          const SizedBox(width: 12),
+                        ],
                         _buildAddMediaServerEntry(
                           iconColor: activeColor,
                           textColor: unselectedLabelColor,

lib/pages/media_library_page.dart

@@ -25,6 +25,7 @@ import 'package:nipaplay/themes/nipaplay/widgets/horizontal_anime_card.dart';
 import 'package:nipaplay/themes/nipaplay/widgets/local_library_control_bar.dart';
 import 'package:nipaplay/themes/nipaplay/widgets/smb_connection_dialog.dart';
 import 'package:nipaplay/themes/nipaplay/widgets/webdav_connection_dialog.dart';
+import 'package:nipaplay/providers/appearance_settings_provider.dart';
 import 'dart:ui' as ui;
 
 // Define a callback type for when an episode is selected for playing
@@ -697,9 +698,17 @@ style: TextStyle(color: Colors.grey, fontSize: 16),
                   radius: const Radius.circular(2),
                   child: GridView.builder(
                     controller: _gridScrollController,
-                    gridDelegate: const SliverGridDelegateWithMaxCrossAxisExtent(
-                      maxCrossAxisExtent: 500,
-                      mainAxisExtent: 140,
+                    gridDelegate: SliverGridDelegateWithMaxCrossAxisExtent(
+                      maxCrossAxisExtent: context
+                              .watch<AppearanceSettingsProvider>()
+                              .showAnimeCardSummary
+                          ? HorizontalAnimeCard.detailedGridMaxCrossAxisExtent
+                          : HorizontalAnimeCard.compactGridMaxCrossAxisExtent,
+                      mainAxisExtent: context
+                              .watch<AppearanceSettingsProvider>()
+                              .showAnimeCardSummary
+                          ? HorizontalAnimeCard.detailedCardHeight
+                          : HorizontalAnimeCard.compactCardHeight,
                       mainAxisSpacing: 16,
                       crossAxisSpacing: 16,
                     ),

lib/pages/new_series_page.dart

@@ -180,13 +180,19 @@ class _NewSeriesPageState extends State<NewSeriesPage> with AutomaticKeepAliveCl
   }
 
   SliverPadding _buildAnimeGridSliver(List<BangumiAnime> animes, int weekdayKey) {
+    final showSummary =
+        context.watch<AppearanceSettingsProvider>().showAnimeCardSummary;
     return SliverPadding(
       padding: const EdgeInsets.symmetric(horizontal: 16.0, vertical: 8.0),
       sliver: SliverGrid(
         key: ValueKey<String>('sliver_grid_for_weekday_$weekdayKey'),
-        gridDelegate: const SliverGridDelegateWithMaxCrossAxisExtent(
-          maxCrossAxisExtent: 500,
-          mainAxisExtent: 140,
+        gridDelegate: SliverGridDelegateWithMaxCrossAxisExtent(
+          maxCrossAxisExtent: showSummary
+              ? HorizontalAnimeCard.detailedGridMaxCrossAxisExtent
+              : HorizontalAnimeCard.compactGridMaxCrossAxisExtent,
+          mainAxisExtent: showSummary
+              ? HorizontalAnimeCard.detailedCardHeight
+              : HorizontalAnimeCard.compactCardHeight,
           mainAxisSpacing: 16,
           crossAxisSpacing: 16,
         ),