905086
2026-11-07 0b4478cf6c0eb509c95a9bec2cc7bda37b259e10
feat: 新增工具管理功能及工具下载安装流程
13 files modified
266 ■■■■■ changed files
fluttergamebox/lib/api/api_service.dart 6 ●●●●● patch | view | raw | blame | history
fluttergamebox/lib/pages/detail_page.dart 1 ●●●●● patch | view | raw | blame | history
fluttergamebox/lib/pages/library_page.dart 1 ●●●●● patch | view | raw | blame | history
fluttergamebox/lib/pages/main_shell.dart 17 ●●●●● patch | view | raw | blame | history
fluttergamebox/lib/pages/tools_page.dart 130 ●●●●● patch | view | raw | blame | history
fluttergamebox/lib/store/app_state.dart 41 ●●●●● patch | view | raw | blame | history
fluttergamebox/lib/widgets/download_manager.dart 12 ●●●●● patch | view | raw | blame | history
server/admin/index.html 7 ●●●●● patch | view | raw | blame | history
server/handlers/admin.go 2 ●●●●● patch | view | raw | blame | history
server/handlers/auth.go 4 ●●●●● patch | view | raw | blame | history
server/handlers/games.go 39 ●●●●● patch | view | raw | blame | history
server/main.go 1 ●●●●● patch | view | raw | blame | history
server/models/models.go 5 ●●●●● patch | view | raw | blame | history
fluttergamebox/lib/api/api_service.dart
@@ -118,6 +118,7 @@
  final String cover;
  final String description;
  final String fileUrl;
  final String launchExe;
  Tool({
    required this.id,
    required this.name,
@@ -125,6 +126,7 @@
    required this.cover,
    required this.description,
    required this.fileUrl,
    this.launchExe = '',
  });
  factory Tool.fromJson(Map<String, dynamic> j) => Tool(
        id: j['id'],
@@ -133,6 +135,7 @@
        cover: j['cover'] ?? '',
        description: j['description'] ?? '',
        fileUrl: j['file_url'] ?? '',
        launchExe: j['launch_exe'] ?? '',
      );
}
@@ -190,6 +193,9 @@
    return (res['data'] as List).map((e) => Tool.fromJson(e)).toList();
  }
  static Future<Map<String, dynamic>> toolDownloadInfo(int toolId) async =>
      await ApiClient.get('/api/tools/$toolId/download');
  static Future<String> announcements() async {
    final res = await ApiClient.get('/api/announcements');
    if (res['code'] != 0) return '';
fluttergamebox/lib/pages/detail_page.dart
@@ -537,6 +537,7 @@
              final installed = _installed ||
                  (t != null &&
                      t.gameId == game!.id &&
                      !t.isTool &&
                      t.finished &&
                      !t.extractFailed);
              return SizedBox(
fluttergamebox/lib/pages/library_page.dart
@@ -371,6 +371,7 @@
    return _installed ||
        (t != null &&
            t.gameId == widget.game.id &&
            !t.isTool &&
            t.finished &&
            !t.extractFailed);
  }
fluttergamebox/lib/pages/main_shell.dart
@@ -620,7 +620,7 @@
      case '游戏恢复':
        _showToast('游戏恢复功能:重新下载可恢复游戏文件');
      case '重启应用':
        _showToast('应用重启中...');
        _restartApp();
      case '检查更新':
        _showToast('当前已是最新版本!');
      case '退出应用':
@@ -628,6 +628,21 @@
    }
  }
  /// 重启应用:启动新的应用进程后退出当前进程
  Future<void> _restartApp() async {
    try {
      // 以分离模式启动当前应用的 exe(带原有启动参数)
      await Process.start(
        Platform.resolvedExecutable,
        Platform.executableArguments,
        mode: ProcessStartMode.detached,
      );
    } catch (_) {
      // 启动失败时仍尝试退出(下次手动打开)
    }
    exit(0);
  }
  void _showToast(String msg) {
    final ctx = context;
    // 使用全局 overlay 显示
fluttergamebox/lib/pages/tools_page.dart
@@ -1,4 +1,4 @@
import 'package:flutter/material.dart';
import 'package:flutter/material.dart';
import 'package:fluttergamebox/api/api_client.dart';
import 'package:fluttergamebox/api/api_service.dart';
import 'package:fluttergamebox/common/theme.dart';
@@ -15,7 +15,6 @@
class _ToolsPageState extends State<ToolsPage>
    with AutomaticKeepAliveClientMixin {
  List<Tool> tools = [];
  final Set<int> _installed = {};
  bool _loading = true;
  @override
@@ -36,14 +35,7 @@
    });
  }
  Future<void> _install(Tool tool) async {
    if (_installed.contains(tool.id)) return;
    // 模拟安装
    setState(() => _installed.add(tool.id));
    _toast('${tool.name} 安装完成');
  }
  void _toast(String msg) {
  void _toast(String msg, {bool error = false}) {
    final overlay = Overlay.of(context);
    final entry = OverlayEntry(
      builder: (context) => Positioned(
@@ -56,12 +48,12 @@
            padding:
                const EdgeInsets.symmetric(horizontal: 16, vertical: 12),
            decoration: BoxDecoration(
              color: AppColors.green,
              color: error ? AppColors.red : AppColors.green,
              borderRadius: BorderRadius.circular(6),
            ),
            child: Row(
              children: [
                const Icon(Icons.check_circle,
                Icon(error ? Icons.error_outline : Icons.check_circle,
                    color: Colors.white, size: 18),
                const SizedBox(width: 8),
                Expanded(
@@ -100,8 +92,8 @@
                      fontWeight: FontWeight.w500)),
              const SizedBox(width: 12),
              const Text('游戏必备运行库和实用工具',
                  style: TextStyle(
                      color: AppColors.textGray, fontSize: 13)),
                  style:
                      TextStyle(color: AppColors.textGray, fontSize: 13)),
            ],
          ),
          const SizedBox(height: 16),
@@ -126,7 +118,7 @@
                        ),
                        itemCount: tools.length,
                        itemBuilder: (context, i) =>
                            _ToolCard(tool: tools[i], installed: _installed.contains(tools[i].id), onInstall: () => _install(tools[i])),
                            _ToolCard(tool: tools[i], onError: _toast),
                      ),
          ),
        ],
@@ -135,15 +127,50 @@
  }
}
class _ToolCard extends StatelessWidget {
class _ToolCard extends StatefulWidget {
  final Tool tool;
  final bool installed;
  final VoidCallback onInstall;
  const _ToolCard({
    required this.tool,
    required this.installed,
    required this.onInstall,
  });
  final void Function(String msg, {bool error}) onError;
  const _ToolCard({required this.tool, required this.onError});
  @override
  State<_ToolCard> createState() => _ToolCardState();
}
class _ToolCardState extends State<_ToolCard> {
  bool _installed = false;
  @override
  void initState() {
    super.initState();
    _checkInstalled();
  }
  Future<void> _checkInstalled() async {
    final ok = await isGameInstalled(widget.tool.name, widget.tool.launchExe);
    if (mounted) setState(() => _installed = ok);
  }
  /// 启动已安装的工具
  Future<void> _launch() async {
    final ok =
        await launchInstalledGame(widget.tool.name, widget.tool.launchExe);
    if (!ok) widget.onError('未找到工具文件,请重新下载安装', error: true);
  }
  /// 安装:选择下载路径后下载并解压(与游戏流程一致)
  Future<void> _install() async {
    final ok = await showDialog<bool>(
      context: context,
      builder: (context) =>
          DownloadPathDialog(gameTitle: widget.tool.name),
    );
    if (ok != true) return;
    try {
      await DownloadManager.instance.startToolDownload(widget.tool);
      if (mounted) showDownloadDialog(context);
    } catch (e) {
      widget.onError(e.toString(), error: true);
    }
  }
  @override
  Widget build(BuildContext context) {
@@ -163,13 +190,13 @@
                  borderRadius: const BorderRadius.vertical(
                      top: Radius.circular(6)),
                  child: Image.network(
                    ApiClient.baseUrl + tool.cover,
                    ApiClient.baseUrl + widget.tool.cover,
                    fit: BoxFit.cover,
                    errorBuilder: (_, __, ___) => Container(
                      color: const Color(0xFF2A2E45),
                      child: Center(
                        child: Text(
                          tool.name.characters.first,
                          widget.tool.name.characters.first,
                          style: const TextStyle(
                              color: AppColors.textDim, fontSize: 28),
                        ),
@@ -202,37 +229,74 @@
            padding: const EdgeInsets.all(10),
            child: Column(
              children: [
                Text(tool.description,
                // 工具名称
                Text(widget.tool.name,
                    maxLines: 1,
                    overflow: TextOverflow.ellipsis,
                    style: const TextStyle(
                        color: Colors.white, fontSize: 12)),
                        color: Colors.white,
                        fontSize: 12,
                        fontWeight: FontWeight.w500)),
                if (widget.tool.description.isNotEmpty) ...[
                  const SizedBox(height: 4),
                  // 工具描述
                  Text(widget.tool.description,
                      maxLines: 1,
                      overflow: TextOverflow.ellipsis,
                      style: const TextStyle(
                          color: AppColors.textDim, fontSize: 11)),
                ],
                const SizedBox(height: 8),
                Row(
                // 按钮状态随下载管理器任务实时变化
                ListenableBuilder(
                  listenable: DownloadManager.instance,
                  builder: (context, _) {
                    final t = DownloadManager.instance.activeTask;
                    final busy = t != null &&
                        t.isTool &&
                        t.gameId == widget.tool.id &&
                        !t.finished;
                    final installed = _installed ||
                        (t != null &&
                            t.isTool &&
                            t.gameId == widget.tool.id &&
                            t.finished &&
                            !t.extractFailed);
                    return Row(
                  children: [
                    Text(tool.size,
                        Text(widget.tool.size,
                        style: const TextStyle(
                            color: AppColors.textDim, fontSize: 11)),
                    const Spacer(),
                    GestureDetector(
                      onTap: onInstall,
                          onTap: busy
                              ? null
                              : () => installed ? _launch() : _install(),
                      child: Container(
                        padding: const EdgeInsets.symmetric(
                            horizontal: 14, vertical: 4),
                        decoration: BoxDecoration(
                          color: installed
                              color: busy
                              ? const Color(0xFF3A3F52)
                              : AppColors.accent,
                                  : installed
                                      ? AppColors.accent
                                      : AppColors.green,
                          borderRadius: BorderRadius.circular(3),
                        ),
                        child: Text(
                          installed ? '已安装' : '安装',
                              busy
                                  ? '下载中'
                                  : installed
                                      ? '启动'
                                      : '安装',
                          style: const TextStyle(
                              color: Colors.white, fontSize: 11),
                        ),
                      ),
                    ),
                  ],
                    );
                  },
                ),
              ],
            ),
fluttergamebox/lib/store/app_state.dart
@@ -91,6 +91,7 @@
  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;
@@ -106,7 +107,8 @@
      {required this.gameId,
      required this.title,
      required List<DownloadTaskFile> files,
      this.launchExe = ''})
      this.launchExe = '',
      this.isTool = false})
      : files = files;
  double get totalBytes =>
@@ -146,10 +148,10 @@
    notifyListeners();
  }
  /// 清除指定游戏已完成的任务记录(卸载后不再视为已安装)
  /// 清除指定游戏已完成的任务记录(卸载后不再视为已安装;不影响工具任务)
  void clearFinishedTask(int gameId) {
    final t = activeTask;
    if (t != null && t.gameId == gameId && t.finished) {
    if (t != null && !t.isTool && t.gameId == gameId && t.finished) {
      activeTask = null;
      notifyListeners();
    }
@@ -188,6 +190,39 @@
    _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();
    _runLoop();
  }
  /// 服务端files字段为JSON字符串或数组,统一解析为List
  List<dynamic> _parseFiles(dynamic raw) {
    if (raw is List) return raw;
fluttergamebox/lib/widgets/download_manager.dart
@@ -54,7 +54,7 @@
  Future<void> _launchGame(DownloadTask task) async {
    final ok = await launchInstalledGame(task.title, task.launchExe);
    if (!ok && mounted) {
      _toast('未找到游戏文件,请重新下载安装');
      _toast(task.isTool ? '未找到工具文件,请重新下载安装' : '未找到游戏文件,请重新下载安装');
    }
  }
@@ -475,13 +475,13 @@
                          padding: const EdgeInsets.symmetric(vertical: 12),
                        ),
                        child: (task.finished && !task.extractFailed)
                            ? const Row(
                            ? Row(
                                mainAxisAlignment: MainAxisAlignment.center,
                                children: [
                                  Icon(Icons.play_arrow, size: 18),
                                  SizedBox(width: 8),
                                  Text('启动游戏',
                                      style: TextStyle(fontSize: 14)),
                                  const Icon(Icons.play_arrow, size: 18),
                                  const SizedBox(width: 8),
                                  Text(task.isTool ? '启动' : '启动游戏',
                                      style: const TextStyle(fontSize: 14)),
                                ],
                              )
                            : const Text('取消安装'),
server/admin/index.html
@@ -96,9 +96,9 @@
    <div class="nav-tabs">
      <button class="active" data-tab="keys" onclick="switchTab('keys')">密钥管理</button>
      <button data-tab="games" onclick="switchTab('games')">游戏管理</button>
      <button data-tab="tools" onclick="switchTab('tools')">工具管理</button>
      <button data-tab="cats" onclick="switchTab('cats')">类别管理</button>
      <button data-tab="ann" onclick="switchTab('ann')">公告设置</button>
      <button data-tab="tools" onclick="switchTab('tools')">工具管理</button>
    </div>
    <button id="logoutBtn" onclick="logout()">退出登录</button>
  </div>
@@ -246,6 +246,9 @@
      <input id="t_file_url" placeholder="安装包URL,或点击上传">
      <input type="file" onchange="uploadSingle(this, 'file', 't_file_url')">
    </div>
    <div class="form-row"><label>启动程序路径</label>
      <input id="t_launch_exe" placeholder="解压后目录内的相对路径,如 A1524\\setup.exe">
    </div>
    <div class="form-row"><label>描述</label><textarea id="t_description"></textarea></div>
    <div style="display:flex;gap:10px;justify-content:flex-end;margin-top:16px">
      <button class="btn btn-gray" onclick="hideToolModal()">取消</button>
@@ -595,6 +598,7 @@
  document.getElementById('t_size').value = t ? (t.size || '') : '';
  document.getElementById('t_cover').value = t ? (t.cover || '') : '';
  document.getElementById('t_file_url').value = t ? (t.file_url || '') : '';
  document.getElementById('t_launch_exe').value = t ? (t.launch_exe || '') : '';
  document.getElementById('t_description').value = t ? (t.description || '') : '';
  renderToolCover();
  document.getElementById('toolModal').classList.remove('hidden');
@@ -607,6 +611,7 @@
    size: document.getElementById('t_size').value.trim(),
    cover: document.getElementById('t_cover').value.trim(),
    file_url: document.getElementById('t_file_url').value.trim(),
    launch_exe: document.getElementById('t_launch_exe').value.trim(),
    description: document.getElementById('t_description').value.trim(),
  };
  if (!body.name) return toast('请填写工具名称', true);
server/handlers/admin.go
@@ -196,6 +196,7 @@
        Cover       string `json:"cover"`
        Description string `json:"description"`
        FileURL     string `json:"file_url"`
        LaunchExe   string `json:"launch_exe"`
    }
    if err := c.ShouldBindJSON(&req); err != nil || strings.TrimSpace(req.Name) == "" {
        c.JSON(http.StatusOK, gin.H{"code": 1, "msg": "请填写工具名称"})
@@ -215,6 +216,7 @@
    tool.Cover = req.Cover
    tool.Description = req.Description
    tool.FileURL = req.FileURL
    tool.LaunchExe = req.LaunchExe
    if req.ID > 0 {
        config.DB.Save(&tool)
    } else {
server/handlers/auth.go
@@ -155,9 +155,9 @@
        c.JSON(http.StatusOK, gin.H{"code": 1, "msg": "用户不存在"})
        return
    }
    // 查询会员有效期(永久卡 expired_at 为 NULL;取最大的未过期时间)
    // 查询会员有效期(永久卡 expired_at 为 NULL;冻结的密钥不计入会员;取最大的未过期时间)
    var keys []models.MemberKey
    config.DB.Where("user_id = ? AND (expired_at IS NULL OR expired_at > ?)", userID, time.Now()).Find(&keys)
    config.DB.Where("user_id = ? AND frozen = ? AND (expired_at IS NULL OR expired_at > ?)", userID, false, time.Now()).Find(&keys)
    permanent := false
    var expire *time.Time
    for i := range keys {
server/handlers/games.go
@@ -3,6 +3,7 @@
import (
    "net/http"
    "strconv"
    "strings"
    "time"
    "gamebox-server/config"
@@ -101,6 +102,33 @@
    c.JSON(http.StatusOK, gin.H{"code": 0, "data": tools})
}
// ToolDownloadInfo 工具下载信息(无需会员校验,返回格式与游戏下载一致)
func ToolDownloadInfo(c *gin.Context) {
    var tool models.Tool
    if err := config.DB.First(&tool, c.Param("id")).Error; err != nil {
        c.JSON(http.StatusOK, gin.H{"code": 1, "msg": "工具不存在"})
        return
    }
    if tool.FileURL == "" {
        c.JSON(http.StatusOK, gin.H{"code": 1, "msg": "该工具暂无下载文件,请联系管理员上传"})
        return
    }
    // 压缩包文件名取 URL 最后一段
    fileName := tool.FileURL
    if idx := strings.LastIndex(tool.FileURL, "/"); idx >= 0 && idx < len(tool.FileURL)-1 {
        fileName = tool.FileURL[idx+1:]
    }
    if q := strings.Index(fileName, "?"); q > 0 {
        fileName = fileName[:q]
    }
    files := []gin.H{{"name": fileName, "url": tool.FileURL, "size": tool.Size}}
    c.JSON(http.StatusOK, gin.H{"code": 0, "data": gin.H{
        "name":       tool.Name,
        "files":      files,
        "launch_exe": tool.LaunchExe,
    }})
}
// GetAnnouncements 公告
func GetAnnouncements(c *gin.Context) {
    var anns []models.Announcement
@@ -200,11 +228,18 @@
        c.JSON(http.StatusOK, gin.H{"code": 1, "msg": "游戏不存在"})
        return
    }
    // 校验会员是否有效(永久卡 expired_at 为 NULL)
    // 校验会员是否有效(永久卡 expired_at 为 NULL;冻结的密钥视为无效)
    var keys []models.MemberKey
    config.DB.Where("user_id = ? AND (expired_at IS NULL OR expired_at > ?)", userID, time.Now()).Find(&keys)
    config.DB.Where("user_id = ? AND frozen = ? AND (expired_at IS NULL OR expired_at > ?)", userID, false, time.Now()).Find(&keys)
    if len(keys) == 0 {
        // 用户绑定的密钥被冻结时给出精确提示
        var frozenCount int64
        config.DB.Model(&models.MemberKey{}).Where("user_id = ? AND frozen = ?", userID, true).Count(&frozenCount)
        if frozenCount > 0 {
            c.JSON(http.StatusOK, gin.H{"code": 2, "msg": "您的密钥已被冻结,无法下载,请联系管理员激活密钥!"})
        } else {
        c.JSON(http.StatusOK, gin.H{"code": 2, "msg": "您的会员已到期,无法下载游戏。请激活新的会员密钥!"})
        }
        return
    }
    // 加入资源库 & 下载计数
server/main.go
@@ -39,6 +39,7 @@
        api.GET("/games", handlers.GetGames)
        api.GET("/banners", handlers.GetBanners)
        api.GET("/tools", handlers.GetTools)
        api.GET("/tools/:id/download", handlers.ToolDownloadInfo)
        api.GET("/announcements", handlers.GetAnnouncements)
        api.GET("/games/:id", handlers.GetGameDetail) // 支持可选登录
server/models/models.go
@@ -52,10 +52,11 @@
type Tool struct {
    ID          uint      `gorm:"primaryKey" json:"id"`
    Name        string    `gorm:"size:100" json:"name"`
    Size        string    `gorm:"size:20" json:"size"`
    Size        string    `gorm:"size:20" json:"size"` // 展示用大小,如 85.2MB
    Cover       string    `gorm:"size:255" json:"cover"`
    Description string    `gorm:"size:500" json:"description"`
    FileURL     string    `gorm:"size:255" json:"file_url"`
    FileURL     string    `gorm:"size:255" json:"file_url"`    // 下载压缩包URL
    LaunchExe   string    `gorm:"size:255" json:"launch_exe"` // 启动程序相对路径(相对解压后目录)
    CreatedAt   time.Time `json:"created_at"`
}