From 7fd2270570811c0d29f0d5d87d11bfc4612e0743 Mon Sep 17 00:00:00 2001
From: 905086 <k2049@qq.com>
Date: Sat, 07 Nov 2026 20:30:06 +0800
Subject: [PATCH] feat: 实现用户密码找回功能及相关配套功能

---
 fluttergamebox/lib/store/app_state.dart |  328 ++++++++++++++++++++++++++++++++++++++++++++++++------
 1 files changed, 291 insertions(+), 37 deletions(-)

diff --git a/fluttergamebox/lib/store/app_state.dart b/fluttergamebox/lib/store/app_state.dart
index 9616185..345dd96 100644
--- a/fluttergamebox/lib/store/app_state.dart
+++ b/fluttergamebox/lib/store/app_state.dart
@@ -4,6 +4,7 @@
 
 import 'package:dio/dio.dart';
 import 'package:flutter/foundation.dart';
+import 'package:path/path.dart' as p;
 import 'package:fluttergamebox/api/api_client.dart';
 import 'package:fluttergamebox/api/api_service.dart';
 import 'package:fluttergamebox/utils/util.dart';
@@ -78,21 +79,36 @@
   double get progress => totalBytes > 0 ? received / totalBytes : 0;
 }
 
+/// 解压日志条目(安装阶段展示:百分比 + 解压出的文件路径)
+class ExtractLogEntry {
+  int percent; // 所在压缩包内的进度百分比
+  String path; // 解压出的文件相对路径
+  ExtractLogEntry(this.percent, this.path);
+}
+
 class DownloadTask {
   final int gameId;
   final String title;
   final List<DownloadTaskFile> files;
+  final String launchExe; // 启动程序相对路径(相对游戏安装目录)
+  final bool isTool; // 是否为工具下载任务(工具与游戏id独立,避免误判)
   double speed = 0; // bytes/s
   bool autoShutdown = false;
   bool paused = false;
   bool finished = false;
   bool canceled = false;
+  bool extracting = false; // 正在解压安装
+  bool extractFailed = false; // 解压失败
+  double extractProgress = 0; // 安装(解压)总进度 0~1
+  final List<ExtractLogEntry> extractLog = []; // 解压文件日志
   DateTime? startTime;
 
   DownloadTask(
       {required this.gameId,
       required this.title,
-      required List<DownloadTaskFile> files})
+      required List<DownloadTaskFile> files,
+      this.launchExe = '',
+      this.isTool = false})
       : files = files;
 
   double get totalBytes =>
@@ -120,6 +136,8 @@
   final List<DownloadTask> tasks = [];
   DownloadTask? activeTask;
   bool _loopRunning = false;
+  int _extractTargets = 0; // 需解压的压缩包数量
+  int _extractDone = 0; // 已完成解压的压缩包数量
 
   bool get hasActive => activeTask != null && !activeTask!.finished;
 
@@ -130,6 +148,24 @@
     notifyListeners();
   }
 
+  /// 清除指定游戏已完成的任务记录(卸载后不再视为已安装;不影响工具任务)
+  void clearFinishedTask(int gameId) {
+    final t = activeTask;
+    if (t != null && !t.isTool && t.gameId == gameId && t.finished) {
+      activeTask = null;
+      notifyListeners();
+    }
+  }
+
+  /// 清除指定工具已完成的任务记录(工具卸载后不再视为已安装)
+  void clearFinishedToolTask(int toolId) {
+    final t = activeTask;
+    if (t != null && t.isTool && t.gameId == toolId && t.finished) {
+      activeTask = null;
+      notifyListeners();
+    }
+  }
+
   Future<void> startDownload(Game game) async {
     // 获取下载文件列表(服务端校验会员)
     final res = await ApiService.downloadInfo(game.id);
@@ -141,24 +177,55 @@
     if (dlPath.isEmpty) {
       throw '请先在右上角菜单中设置下载安装路径';
     }
-    // 没有文件的游戏:创建占位文件任务(演示下载流程)
-    final tasks = <DownloadTaskFile>[];
+    // 未上传下载文件的游戏无法下载
     if (fileList.isEmpty) {
-      final demoSize = _parseSizeToBytes(game.size);
+      throw '该游戏暂无下载文件,请联系管理员上传游戏压缩包';
+    }
+    final tasks = <DownloadTaskFile>[];
+    for (final f in fileList) {
       tasks.add(DownloadTaskFile(
-          name: '${game.title}.part01.rar',
-          url: '',
-          totalBytes: demoSize));
-    } else {
-      for (final f in fileList) {
-        tasks.add(DownloadTaskFile(
-            name: f['name'] ?? 'file',
-            url: f['url'] ?? '',
-            totalBytes: _parseSizeToBytes(f['size'] ?? '0 B')));
-      }
+          name: f['name'] ?? 'file',
+          url: f['url'] ?? '',
+          totalBytes: _parseSizeToBytes(f['size'] ?? '0 B')));
     }
     final task = DownloadTask(
-        gameId: game.id, title: game.title, files: tasks);
+        gameId: game.id,
+        title: game.title,
+        files: tasks,
+        launchExe: (res['data']['launch_exe'] ?? '') as String);
+    this.tasks.insert(0, task);
+    activeTask = task;
+    notifyListeners();
+    _runLoop();
+  }
+
+  /// 工具安装:下载压缩包并解压(与游戏流程一致,无需会员校验)
+  Future<void> startToolDownload(Tool tool) async {
+    final res = await ApiService.toolDownloadInfo(tool.id);
+    if (res['code'] != 0) {
+      throw res['msg'] ?? '获取下载信息失败';
+    }
+    final List<dynamic> fileList = _parseFiles(res['data']['files']);
+    final dlPath = await AppPrefs.getDownloadPath();
+    if (dlPath.isEmpty) {
+      throw '请先在右上角菜单中设置下载安装路径';
+    }
+    if (fileList.isEmpty) {
+      throw '该工具暂无下载文件,请联系管理员上传压缩包';
+    }
+    final tasks = <DownloadTaskFile>[];
+    for (final f in fileList) {
+      tasks.add(DownloadTaskFile(
+          name: f['name'] ?? 'file',
+          url: f['url'] ?? '',
+          totalBytes: _parseSizeToBytes(f['size'] ?? '0 B')));
+    }
+    final task = DownloadTask(
+        gameId: tool.id,
+        title: tool.name,
+        files: tasks,
+        launchExe: (res['data']['launch_exe'] ?? '') as String,
+        isTool: true);
     this.tasks.insert(0, task);
     activeTask = task;
     notifyListeners();
@@ -231,7 +298,7 @@
       final task = activeTask!;
       task.startTime = DateTime.now();
       final dlPath = await AppPrefs.getDownloadPath();
-      final dir = Directory('$dlPath\\${_safeName(task.title)}');
+      final dir = Directory('$dlPath\\${safeFileName(task.title)}');
       await dir.create(recursive: true);
 
       for (final file in task.files) {
@@ -241,10 +308,7 @@
         await Future.delayed(const Duration(milliseconds: 300));
         if (task.canceled || task.paused) break;
 
-        if (file.url.isEmpty) {
-          // 演示模式:模拟下载
-          await _simulateDownload(task, file);
-        } else {
+        if (file.url.isNotEmpty) {
           await _downloadFile(task, file, '${dir.path}\\${file.name}');
         }
         if (task.canceled || task.paused) break;
@@ -252,6 +316,8 @@
         notifyListeners();
       }
       if (!task.canceled && !task.paused) {
+        // 下载完成:解压压缩包到安装目录并删除压缩包
+        await _installTask(task, dir.path);
         task.finished = true;
         notifyListeners();
       }
@@ -302,26 +368,214 @@
     }
   }
 
-  Future<void> _simulateDownload(
-      DownloadTask task, DownloadTaskFile file) async {
-    file.status = DownloadStatus.downloading;
+  /// 安装目录(与资源库启动逻辑保持一致)
+  Future<String> _installDir(String title) => gameInstallDir(title);
+
+  /// 下载完成后:压缩包解压到安装目录,非压缩包文件移动过去,最后删除压缩包
+  Future<void> _installTask(DownloadTask task, String dlDir) async {
+    final installPath = await _installDir(task.title);
+    final installDir = Directory(installPath);
+    await installDir.create(recursive: true);
+
+    // 区分压缩包和普通文件(演示任务 url 为空,无实际文件)
+    final archives = <File>[];
+    final plainFiles = <File>[];
+    for (final f in task.files) {
+      if (f.url.isEmpty) continue;
+      final file = File(p.join(dlDir, f.name));
+      if (!await file.exists()) continue;
+      final lower = f.name.toLowerCase();
+      if (lower.endsWith('.zip') || lower.endsWith('.rar') || lower.endsWith('.7z')) {
+        archives.add(file);
+      } else {
+        plainFiles.add(file);
+      }
+    }
+    if (archives.isEmpty && plainFiles.isEmpty) return;
+
+    task.extracting = true;
+    task.extractProgress = 0;
+    task.extractLog.clear();
     notifyListeners();
-    const chunk = 1024 * 1024 * 4; // 每tick 4MB
-    final tickMs = 30;
-    while (file.received < file.totalBytes) {
-      if (task.canceled || task.paused) return;
-      await Future.delayed(Duration(milliseconds: tickMs));
-      // 模拟速度 ~100MB/s 波动
-      final speed = (90 + (file.name.hashCode % 20)) * 1024 * 1024.0;
-      file.received =
-          (file.received + speed * tickMs / 1000).clamp(0, file.totalBytes);
-      task.speed = speed;
+    try {
+      // 普通文件直接移动到安装目录
+      for (final f in plainFiles) {
+        await f.rename(p.join(installPath, p.basename(f.path)));
+      }
+      // 多卷压缩包(xxx.partN.rar)只解压第一卷
+      final partRe = RegExp(r'\.part(\d+)\.rar$', caseSensitive: false);
+      final skip = <String>{};
+      for (final a in archives) {
+        final m = partRe.firstMatch(p.basename(a.path));
+        if (m != null && int.parse(m.group(1)!) != 1) {
+          skip.add(a.path);
+        }
+      }
+      _extractTargets = archives.length - skip.length;
+      _extractDone = 0;
+      for (final a in archives) {
+        if (skip.contains(a.path)) continue;
+        await _extractArchive(a, installPath, task);
+      }
+      task.extractProgress = 1;
+      // 全部解压完成后删除压缩包
+      for (final a in archives) {
+        if (await a.exists()) await a.delete();
+      }
+      // 清理下载目录中已空的游戏文件夹
+      final dl = Directory(dlDir);
+      if (await dl.exists()) {
+        try {
+          await dl.delete();
+        } catch (_) {}
+      }
+    } catch (e) {
+      debugLog('install error: $e');
+      task.extractFailed = true;
+    } finally {
+      task.extracting = false;
       notifyListeners();
     }
-    task.speed = 0;
-    notifyListeners();
   }
 
-  String _safeName(String s) =>
-      s.replaceAll(RegExp(r'[\\/:*?"<>|]'), '_');
+  /// 解压单个压缩包到目标目录(7z 时流式读取输出获取进度与文件名)
+  Future<void> _extractArchive(
+      File archive, String destDir, DownloadTask task) async {
+    final lower = archive.path.toLowerCase();
+    final z7 = await _find7z();
+    if (z7 != null) {
+      // 7-Zip 支持全部格式,-bsp1 输出每个文件的进度
+      final proc =
+          await Process.start(z7, ['x', '-y', '-bsp1', '-o$destDir', archive.path]);
+      _consumeExtractOutput(proc, task);
+      final code = await proc.exitCode;
+      if (code != 0) {
+        throw '解压失败: ${p.basename(archive.path)}';
+      }
+    } else if (lower.endsWith('.zip')) {
+      // Windows 10+ 自带 bsdtar,可直接解压 zip(无进度输出,模拟进度前进)
+      _addExtractLog(task, 0, p.basename(archive.path));
+      final sim = _startSimulatedProgress(task);
+      final r = await Process.run('tar', ['-xf', archive.path, '-C', destDir]);
+      sim.cancel();
+      if (r.exitCode != 0) {
+        throw 'tar 解压失败: ${r.stderr}';
+      }
+    } else {
+      // rar/7z:使用本机已安装的 WinRAR(无进度输出,模拟进度前进)
+      final rar = await _findWinRar();
+      if (rar == null) {
+        throw '未找到 7-Zip 或 WinRAR,无法解压 ${p.basename(archive.path)}';
+      }
+      _addExtractLog(task, 0, p.basename(archive.path));
+      final sim = _startSimulatedProgress(task);
+      final r = await Process.run(rar, ['x', '-y', '-o$destDir', archive.path]);
+      sim.cancel();
+      if (r.exitCode != 0) {
+        throw '解压失败: ${r.stderr}';
+      }
+    }
+    _extractDone++;
+    if (_extractTargets > 0) {
+      // 单包完成后按实际完成数推进(模拟进度可能已超前,则不回退)
+      final real = _extractDone / _extractTargets;
+      if (real > task.extractProgress) task.extractProgress = real;
+    }
+    notifyListeners();
+    // 若压缩的是"游戏文件夹本身",解压后只有一层同名目录,将其内容上移
+    await _flattenSingleRoot(destDir);
+  }
+
+  /// 解压无进度输出时(tar/WinRAR),模拟进度缓慢前进(封顶95%,完成后置100%)
+  Timer _startSimulatedProgress(DownloadTask task) {
+    return Timer.periodic(const Duration(milliseconds: 400), (_) {
+      if (task.extractProgress < 0.95) {
+        task.extractProgress =
+            (task.extractProgress + 0.01).clamp(0.0, 0.95).toDouble();
+        notifyListeners();
+      }
+    });
+  }
+
+  /// 跟踪 7z 进度输出(形如 " 13% 148 - 路径\文件.dll"),更新解压进度与日志
+  void _consumeExtractOutput(Process proc, DownloadTask task) {
+    final re = RegExp(r'(\d+)%\s*\d*\s*-?\s*(.*)');
+    void handle(String line) {
+      final m = re.firstMatch(line);
+      if (m == null) return;
+      final percent = (int.tryParse(m.group(1)!) ?? 0) / 100;
+      final name = (m.group(2) ?? '').trim();
+      if (name.isNotEmpty) {
+        final last = task.extractLog.isEmpty ? null : task.extractLog.last;
+        if (last != null && last.path == name) {
+          last.percent = (percent * 100).round();
+        } else {
+          _addExtractLog(task, (percent * 100).round(), name);
+        }
+      }
+      final targets = _extractTargets > 0 ? _extractTargets : 1;
+      task.extractProgress =
+          ((_extractDone + percent) / targets).clamp(0.0, 0.999).toDouble();
+      notifyListeners();
+    }
+
+    proc.stdout
+        .transform(systemEncoding.decoder)
+        .transform(const LineSplitter())
+        .listen(handle);
+    proc.stderr
+        .transform(systemEncoding.decoder)
+        .transform(const LineSplitter())
+        .listen(handle);
+  }
+
+  /// 追加一条解压日志(上限200条,超出时移除最早的)
+  void _addExtractLog(DownloadTask task, int percent, String path) {
+    task.extractLog.add(ExtractLogEntry(percent, path));
+    if (task.extractLog.length > 200) {
+      task.extractLog.removeAt(0);
+    }
+  }
+
+  Future<String?> _find7z() async {
+    final candidates = [
+      '7z',
+      r'C:\Program Files\7-Zip\7z.exe',
+      r'C:\Program Files (x86)\7-Zip\7z.exe',
+    ];
+    for (final c in candidates) {
+      if (c.contains('\\')) {
+        if (await File(c).exists()) return c;
+      } else {
+        try {
+          final r = await Process.run('where', [c]);
+          if (r.exitCode == 0) return c;
+        } catch (_) {}
+      }
+    }
+    return null;
+  }
+
+  Future<String?> _findWinRar() async {
+    final candidates = [
+      r'C:\Program Files\WinRAR\WinRAR.exe',
+      r'C:\Program Files (x86)\WinRAR\WinRAR.exe',
+    ];
+    for (final c in candidates) {
+      if (await File(c).exists()) return c;
+    }
+    return null;
+  }
+
+  /// 目标目录只有一个子目录且无其他文件时,把子目录内容上移一层
+  Future<void> _flattenSingleRoot(String destDir) async {
+    final dest = Directory(destDir);
+    final entries = await dest.list().toList();
+    if (entries.length != 1 || entries.first is! Directory) return;
+    final inner = entries.first as Directory;
+    for (final e in await inner.list().toList()) {
+      await e.rename(p.join(dest.path, p.basename(e.path)));
+    }
+    await inner.delete();
+  }
 }

--
Gitblit v1.10.0