新增游戏功能记录模块

lib/data/database_helper.dart

@@ -72,7 +72,7 @@ class DatabaseHelper {
 
     return await openDatabase(
       path,
-      version: 30,
+      version: 34,
       onCreate: _createDB,
       onUpgrade: _onUpgrade,
     );
@@ -278,6 +278,67 @@ class DatabaseHelper {
         await db.execute("ALTER TABLE reader_books ADD COLUMN authors TEXT DEFAULT ''");
       }
     }
+    if (oldVersion < 31) {
+      // 创建游戏表
+      await db.execute('''
+        CREATE TABLE IF NOT EXISTS games (
+          id TEXT PRIMARY KEY,
+          title TEXT NOT NULL,
+          cover_path TEXT,
+          rating REAL,
+          status TEXT NOT NULL DEFAULT 'want_to_play',
+          category TEXT NOT NULL DEFAULT 'digital',
+          platforms TEXT DEFAULT '[]',
+          versions TEXT DEFAULT '[]',
+          genres TEXT DEFAULT '[]',
+          play_time_hours INTEGER DEFAULT 0,
+          play_time_minutes INTEGER DEFAULT 0,
+          purchase_platforms TEXT DEFAULT '[]',
+          purchase_date TEXT,
+          purchase_price TEXT,
+          cover_offset REAL DEFAULT 0,
+          created_at TEXT NOT NULL,
+          updated_at TEXT NOT NULL,
+          is_deleted INTEGER DEFAULT 0
+        )
+      ''');
+    }
+    if (oldVersion < 32) {
+      // games表添加summary字段
+      await db.execute('ALTER TABLE games ADD COLUMN summary TEXT');
+    }
+    if (oldVersion < 34) {
+      // 确保games表summary字段存在
+      final columns = await db.rawQuery('PRAGMA table_info(games)');
+      if (!columns.any((col) => col['name'] == 'summary')) {
+        await db.execute('ALTER TABLE games ADD COLUMN summary TEXT');
+      }
+      // 确保游戏评价表和游戏截图表存在
+      await db.execute('''
+        CREATE TABLE IF NOT EXISTS game_reviews (
+          id TEXT PRIMARY KEY,
+          game_id TEXT NOT NULL,
+          content TEXT NOT NULL,
+          reviewer TEXT,
+          source TEXT,
+          review_type INTEGER DEFAULT 1,
+          is_deleted INTEGER DEFAULT 0,
+          created_at TEXT NOT NULL,
+          updated_at TEXT NOT NULL,
+          FOREIGN KEY (game_id) REFERENCES games (id)
+        )
+      ''');
+      await db.execute('''
+        CREATE TABLE IF NOT EXISTS game_screenshots (
+          id TEXT PRIMARY KEY,
+          game_id TEXT NOT NULL,
+          screenshot_path TEXT NOT NULL,
+          is_deleted INTEGER DEFAULT 0,
+          created_at TEXT NOT NULL,
+          FOREIGN KEY (game_id) REFERENCES games (id)
+        )
+      ''');
+    }
   }
 
   /// 升级books表到V27（添加阅读始末日期字段）
@@ -831,6 +892,59 @@ class DatabaseHelper {
         updated_at TEXT NOT NULL
       )
     ''');
+
+    // 游戏表
+    await db.execute('''
+      CREATE TABLE games (
+        id TEXT PRIMARY KEY,
+        title TEXT NOT NULL,
+        cover_path TEXT,
+        rating REAL,
+        status TEXT NOT NULL DEFAULT 'want_to_play',
+        category TEXT NOT NULL DEFAULT 'digital',
+        platforms TEXT DEFAULT '[]',
+        versions TEXT DEFAULT '[]',
+        genres TEXT DEFAULT '[]',
+        play_time_hours INTEGER DEFAULT 0,
+        play_time_minutes INTEGER DEFAULT 0,
+        purchase_platforms TEXT DEFAULT '[]',
+        purchase_date TEXT,
+        purchase_price TEXT,
+        summary TEXT,
+        cover_offset REAL DEFAULT 0,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL,
+        is_deleted INTEGER DEFAULT 0
+      )
+    ''');
+
+    // 游戏评价表
+    await db.execute('''
+      CREATE TABLE game_reviews (
+        id TEXT PRIMARY KEY,
+        game_id TEXT NOT NULL,
+        content TEXT NOT NULL,
+        reviewer TEXT,
+        source TEXT,
+        review_type INTEGER DEFAULT 1,
+        is_deleted INTEGER DEFAULT 0,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL,
+        FOREIGN KEY (game_id) REFERENCES games (id)
+      )
+    ''');
+
+    // 游戏截图表
+    await db.execute('''
+      CREATE TABLE game_screenshots (
+        id TEXT PRIMARY KEY,
+        game_id TEXT NOT NULL,
+        screenshot_path TEXT NOT NULL,
+        is_deleted INTEGER DEFAULT 0,
+        created_at TEXT NOT NULL,
+        FOREIGN KEY (game_id) REFERENCES games (id)
+      )
+    ''');
   }
 
   // 关闭数据库

lib/data/game/game_dao.dart

@@ -0,0 +1,153 @@
+import 'package:flutter/foundation.dart';
+import '../../models/data_models.dart';
+import '../database_helper.dart';
+
+/// 游戏数据访问对象
+class GameDao {
+  final DatabaseHelper _dbHelper = DatabaseHelper.instance;
+
+  Future<T> _wrap<T>(String op, Future<T> Function() fn) async {
+    try {
+      return await fn();
+    } catch (e) {
+      debugPrint('[GameDao] $op error: $e');
+      rethrow;
+    }
+  }
+
+  // 获取所有游戏记录（未删除的）
+  Future<List<Game>> getAllGames() => _wrap('getAllGames', () async {
+    final db = await _dbHelper.database;
+    final List<Map<String, dynamic>> maps = await db.query(
+      'games',
+      where: 'is_deleted = ?',
+      whereArgs: [0],
+      orderBy: 'created_at DESC',
+    );
+    return List.generate(maps.length, (i) => Game.fromJson(maps[i]));
+  });
+
+  // 分页查询游戏记录
+  Future<List<Game>> getGamesPaged({String? status, int limit = 20, int offset = 0, int sortMode = 0}) => _wrap('getGamesPaged', () async {
+    final db = await _dbHelper.database;
+    String where = 'is_deleted = 0';
+    List<dynamic> whereArgs = [];
+    if (status != null && status.isNotEmpty) {
+      where += ' AND status = ?';
+      whereArgs.add(status);
+    }
+    final maps = await db.query('games', where: where, whereArgs: whereArgs,
+        orderBy: _buildGameOrderBy(sortMode), limit: limit, offset: offset);
+    return List.generate(maps.length, (i) => Game.fromJson(maps[i]));
+  });
+
+  static String _buildGameOrderBy(int sortMode) {
+    switch (sortMode) {
+      case 1: return 'created_at DESC';
+      case 2: return 'rating DESC NULLS LAST, updated_at DESC';
+      default: return 'updated_at DESC';
+    }
+  }
+
+  // 搜索游戏（标题）
+  Future<List<Game>> searchGames(String keyword) => _wrap('searchGames', () async {
+    final db = await _dbHelper.database;
+    final likeKeyword = '%$keyword%';
+    final List<Map<String, dynamic>> maps = await db.query(
+      'games',
+      where: 'title LIKE ? AND is_deleted = ?',
+      whereArgs: [likeKeyword, 0],
+      orderBy: 'created_at DESC',
+    );
+    return maps.map((m) => Game.fromJson(m)).toList();
+  });
+
+  // 添加游戏记录
+  Future<int> insertGame(Game game) => _wrap('insertGame', () async {
+    final db = await _dbHelper.database;
+    return await db.insert('games', game.toJson());
+  });
+
+  // 更新游戏记录
+  Future<int> updateGame(Game game) => _wrap('updateGame', () async {
+    final db = await _dbHelper.database;
+    return await db.update(
+      'games',
+      game.toJson(),
+      where: 'id = ?',
+      whereArgs: [game.id],
+    );
+  });
+
+  // 仅更新封面偏移量
+  Future<void> updateCoverOffset(String gameId, double offset) => _wrap('updateCoverOffset', () async {
+    final db = await _dbHelper.database;
+    await db.update('games', {'cover_offset': offset}, where: 'id = ?', whereArgs: [gameId]);
+  });
+
+  // 删除游戏记录（软删除）
+  Future<int> deleteGame(String id) => _wrap('deleteGame', () async {
+    final db = await _dbHelper.database;
+    return await db.update(
+      'games',
+      {'is_deleted': 1, 'updated_at': DateTime.now().toIso8601String()},
+      where: 'id = ?',
+      whereArgs: [id],
+    );
+  });
+
+  // 获取所有类型（去重）
+  Future<List<String>> getAllGenres() => _wrap('getAllGenres', () async {
+    final games = await getAllGames();
+    final genres = <String>{};
+    for (final game in games) {
+      genres.addAll(game.genres);
+    }
+    return genres.toList()..sort();
+  });
+
+  // 获取所有平台（去重）
+  Future<List<String>> getAllPlatforms() => _wrap('getAllPlatforms', () async {
+    final games = await getAllGames();
+    final platforms = <String>{};
+    for (final game in games) {
+      platforms.addAll(game.platforms);
+    }
+    return platforms.toList()..sort();
+  });
+
+  // ========== 回收站相关方法 ==========
+
+  // 获取已删除的游戏
+  Future<List<Game>> getDeletedGames() => _wrap('getDeletedGames', () async {
+    final db = await _dbHelper.database;
+    final List<Map<String, dynamic>> maps = await db.query(
+      'games',
+      where: 'is_deleted = ?',
+      whereArgs: [1],
+      orderBy: 'created_at DESC',
+    );
+    return List.generate(maps.length, (i) => Game.fromJson(maps[i]));
+  });
+
+  // 恢复已删除的游戏
+  Future<int> restoreGame(String id) => _wrap('restoreGame', () async {
+    final db = await _dbHelper.database;
+    return await db.update(
+      'games',
+      {'is_deleted': 0, 'updated_at': DateTime.now().toIso8601String()},
+      where: 'id = ?',
+      whereArgs: [id],
+    );
+  });
+
+  // 彻底删除游戏
+  Future<int> permanentDeleteGame(String id) => _wrap('permanentDeleteGame', () async {
+    final db = await _dbHelper.database;
+    return await db.delete(
+      'games',
+      where: 'id = ?',
+      whereArgs: [id],
+    );
+  });
+}

lib/data/game/game_review_dao.dart

@@ -0,0 +1,131 @@
+import 'package:flutter/foundation.dart';
+import '../database_helper.dart';
+import '../../models/data_models.dart';
+
+/// 游戏评价数据访问对象
+class GameReviewDao {
+  final DatabaseHelper _dbHelper = DatabaseHelper.instance;
+
+  Future<T> _wrap<T>(String op, Future<T> Function() fn) async {
+    try {
+      return await fn();
+    } catch (e) {
+      debugPrint('[GameReviewDao] $op error: $e');
+      rethrow;
+    }
+  }
+
+  /// 获取游戏的所有评价
+  Future<List<GameReview>> getReviewsByGameId(String gameId) => _wrap('getReviewsByGameId', () async {
+    final db = await _dbHelper.database;
+    final List<Map<String, dynamic>> maps = await db.query(
+      'game_reviews',
+      where: 'game_id = ? AND is_deleted = 0',
+      whereArgs: [gameId],
+      orderBy: 'created_at DESC',
+    );
+    return List.generate(maps.length, (i) => GameReview.fromJson(maps[i]));
+  });
+
+  /// 根据ID获取评价
+  Future<GameReview?> getReviewById(String id) => _wrap('getReviewById', () async {
+    final db = await _dbHelper.database;
+    final List<Map<String, dynamic>> maps = await db.query(
+      'game_reviews',
+      where: 'id = ? AND is_deleted = 0',
+      whereArgs: [id],
+    );
+    if (maps.isEmpty) return null;
+    return GameReview.fromJson(maps.first);
+  });
+
+  /// 添加评价
+  Future<int> insertReview(GameReview review) => _wrap('insertReview', () async {
+    final db = await _dbHelper.database;
+    return await db.insert('game_reviews', review.toJson());
+  });
+
+  /// 更新评价
+  Future<int> updateReview(GameReview review) => _wrap('updateReview', () async {
+    final db = await _dbHelper.database;
+    return await db.update(
+      'game_reviews',
+      review.toJson(),
+      where: 'id = ?',
+      whereArgs: [review.id],
+    );
+  });
+
+  /// 软删除评价
+  Future<int> deleteReview(String id) => _wrap('deleteReview', () async {
+    final db = await _dbHelper.database;
+    return await db.update(
+      'game_reviews',
+      {'is_deleted': 1, 'updated_at': DateTime.now().toUtc().toIso8601String()},
+      where: 'id = ?',
+      whereArgs: [id],
+    );
+  });
+
+  /// 获取游戏评价数量
+  Future<int> getReviewCount(String gameId) => _wrap('getReviewCount', () async {
+    final db = await _dbHelper.database;
+    final result = await db.rawQuery(
+      'SELECT COUNT(*) as count FROM game_reviews WHERE game_id = ? AND is_deleted = 0',
+      [gameId],
+    );
+    return result.first['count'] as int? ?? 0;
+  });
+
+  /// 获取短评列表
+  Future<List<GameReview>> getShortReviews(String gameId) => _wrap('getShortReviews', () async {
+    final db = await _dbHelper.database;
+    final List<Map<String, dynamic>> maps = await db.query(
+      'game_reviews',
+      where: 'game_id = ? AND review_type = 1 AND is_deleted = 0',
+      whereArgs: [gameId],
+      orderBy: 'created_at DESC',
+    );
+    return List.generate(maps.length, (i) => GameReview.fromJson(maps[i]));
+  });
+
+  /// 获取长评列表
+  Future<List<GameReview>> getLongReviews(String gameId) => _wrap('getLongReviews', () async {
+    final db = await _dbHelper.database;
+    final List<Map<String, dynamic>> maps = await db.query(
+      'game_reviews',
+      where: 'game_id = ? AND review_type = 2 AND is_deleted = 0',
+      whereArgs: [gameId],
+      orderBy: 'created_at DESC',
+    );
+    return List.generate(maps.length, (i) => GameReview.fromJson(maps[i]));
+  });
+
+  /// 获取已删除的评价
+  Future<List<GameReview>> getDeletedReviews() => _wrap('getDeletedReviews', () async {
+    final db = await _dbHelper.database;
+    final List<Map<String, dynamic>> maps = await db.query(
+      'game_reviews',
+      where: 'is_deleted = 1',
+      orderBy: 'updated_at DESC',
+    );
+    return List.generate(maps.length, (i) => GameReview.fromJson(maps[i]));
+  });
+
+  /// 恢复已删除的评价
+  Future<int> restoreReview(String id) => _wrap('restoreReview', () async {
+    final db = await _dbHelper.database;
+    return await db.update(
+      'game_reviews',
+      {'is_deleted': 0, 'updated_at': DateTime.now().toUtc().toIso8601String()},
+      where: 'id = ?',
+      whereArgs: [id],
+    );
+  });
+
+  /// 永久删除评价
+  Future<int> permanentDeleteReview(String id) => _wrap('permanentDeleteReview', () async {
+    final db = await _dbHelper.database;
+    return await db.delete('game_reviews', where: 'id = ?', whereArgs: [id]);
+  });
+}

lib/data/game/game_screenshot_dao.dart

@@ -0,0 +1,68 @@
+import 'package:flutter/foundation.dart';
+import '../database_helper.dart';
+import '../../models/data_models.dart';
+
+/// 游戏截图数据访问对象
+class GameScreenshotDao {
+  final DatabaseHelper _dbHelper = DatabaseHelper.instance;
+
+  Future<T> _wrap<T>(String op, Future<T> Function() fn) async {
+    try {
+      return await fn();
+    } catch (e) {
+      debugPrint('[GameScreenshotDao] $op error: $e');
+      rethrow;
+    }
+  }
+
+  /// 获取游戏的所有截图
+  Future<List<GameScreenshot>> getScreenshotsByGameId(String gameId) => _wrap('getScreenshotsByGameId', () async {
+    final db = await _dbHelper.database;
+    final List<Map<String, dynamic>> maps = await db.query(
+      'game_screenshots',
+      where: 'game_id = ? AND is_deleted = 0',
+      whereArgs: [gameId],
+      orderBy: 'created_at DESC',
+    );
+    return List.generate(maps.length, (i) => GameScreenshot.fromJson(maps[i]));
+  });
+
+  /// 根据ID获取截图
+  Future<GameScreenshot?> getScreenshotById(String id) => _wrap('getScreenshotById', () async {
+    final db = await _dbHelper.database;
+    final List<Map<String, dynamic>> maps = await db.query(
+      'game_screenshots',
+      where: 'id = ? AND is_deleted = 0',
+      whereArgs: [id],
+    );
+    if (maps.isEmpty) return null;
+    return GameScreenshot.fromJson(maps.first);
+  });
+
+  /// 添加截图
+  Future<int> insertScreenshot(GameScreenshot screenshot) => _wrap('insertScreenshot', () async {
+    final db = await _dbHelper.database;
+    return await db.insert('game_screenshots', screenshot.toJson());
+  });
+
+  /// 软删除截图
+  Future<int> deleteScreenshot(String id) => _wrap('deleteScreenshot', () async {
+    final db = await _dbHelper.database;
+    return await db.update(
+      'game_screenshots',
+      {'is_deleted': 1},
+      where: 'id = ?',
+      whereArgs: [id],
+    );
+  });
+
+  /// 获取游戏截图数量
+  Future<int> getScreenshotCount(String gameId) => _wrap('getScreenshotCount', () async {
+    final db = await _dbHelper.database;
+    final result = await db.rawQuery(
+      'SELECT COUNT(*) as count FROM game_screenshots WHERE game_id = ? AND is_deleted = 0',
+      [gameId],
+    );
+    return result.first['count'] as int? ?? 0;
+  });
+}