1

app/lib/main.dart

@@ -2,6 +2,8 @@ import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:media_kit/media_kit.dart';
 
+import 'core/media/download_manager.dart';
+import 'core/media/local_media_server.dart';
 import 'core/storage/local_store.dart';
 import 'core/storage/search_history_store.dart';
 import 'core/storage/watch_dedup_store.dart';
@@ -22,8 +24,32 @@ Future<void> main() async {
   await SearchHistoryStore.init();
   // 观看上报去重（持久化；不初始化则观看计费/游客免费额度链路失效）
   await WatchDedupStore.init();
+  // 本地媒体服务：HLS 1G 分片缓存（回看免下载）+ 已下载视频离线播放
+  await LocalMediaServer.I.init();
 
-  runApp(const ProviderScope(child: VideoApp()));
+  runApp(ProviderScope(
+    overrides: const [],
+    child: const _AppInitializer(),
+  ));
+}
+
+/// 初始化需要 Provider 环境的单例（下载管理器扫描本地已下载列表）
+class _AppInitializer extends ConsumerStatefulWidget {
+  const _AppInitializer();
+
+  @override
+  ConsumerState<_AppInitializer> createState() => _AppInitializerState();
+}
+
+class _AppInitializerState extends ConsumerState<_AppInitializer> {
+  @override
+  void initState() {
+    super.initState();
+    ref.read(downloadManagerProvider.notifier).init();
+  }
+
+  @override
+  Widget build(BuildContext context) => const VideoApp();
 }
 
 class VideoApp extends ConsumerWidget {