二次开发源码提交

2026-05-15 08:52:48 +08:00
parent 4131f7321a
commit eb35a1d067
191 changed files with 34566 additions and 0 deletions
@@ -0,0 +1,161 @@
+import 'dart:io';
+
+import 'package:logger/logger.dart';
+import 'package:path/path.dart' as p;
+import 'package:path_provider/path_provider.dart';
+
+/// 应用日志类
+class AppLogger {
+  AppLogger._();
+  static Logger? _logger;
+  static File? _logFile;
+
+  /// 初始化日志，必须在 main 中 await
+  static Future<void> init() async {
+    if (_logger != null) return;
+
+    // 1. 获取日志存储路径 (Windows: $HOME/AppData/Roaming/com.limo/cloudreve4_flutter/logs)
+    final appDir = await getApplicationSupportDirectory();
+    final logDir = Directory(p.join(appDir.path, 'logs'));
+    if (!await logDir.exists()) {
+      await logDir.create(recursive: true);
+    }
+    _logFile = File(p.join(logDir.path, 'log.txt'));
+
+    // 2. 配置多路输出：同时输出到控制台和文件
+    _logger = Logger(
+      printer: PrettyPrinter(
+        methodCount: 0,
+        errorMethodCount: 5,
+        lineLength: 80,
+        colors: true,
+        printEmojis: true,
+        dateTimeFormat: DateTimeFormat.dateAndTime,
+      ),
+      output: MultiOutput([
+        ConsoleOutput(),
+        CustomFileOutput(
+          file: _logFile!,
+        ),
+      ]),
+      filter: ProductionFilter(),
+    );
+  }
+
+  // 使用 getter 确保 logger 已初始化，防止空指针
+  static Logger get _instance {
+    _logger ??= Logger(
+      printer: PrettyPrinter(
+        methodCount: 0,
+        colors: true,
+        printEmojis: true,
+        dateTimeFormat: DateTimeFormat.onlyTimeAndSinceStart,
+      ),
+    );
+    return _logger!;
+  }
+
+  /// Debug 级别日志
+  static void d(String message) => _instance.d(message);
+
+  /// Info 级别日志
+  static void i(String message) =>  _instance.i(message);
+
+  /// Warning 级别日志
+  static void w(String message) =>  _instance.w(message);
+
+  /// Error 级别日志
+  static void e(String message) =>  _instance.e(message);
+
+  /// Debug 级别日志（支持格式化）
+  static void df(String message, List<Object> args) =>  _instance.d(message, error: args);
+
+  /// Info 级别日志（支持格式化）
+  static void ifn(String message, List<Object> args) => _instance.i(message, error: args);
+
+  /// Warning 级别日志（支持格式化）
+  static void wf(String message, List<Object> args) => _instance.w(message, error: args);
+
+  /// Error 级别日志（支持格式化）
+  static void ef(String message, List<Object> args) => _instance.e(message, error: args);
+
+  /// 获取日志文件路径
+  static Future<String> get logFilePath async {
+    if (_logFile != null) return _logFile!.path;
+    final appDir = await getApplicationSupportDirectory();
+    return p.join(appDir.path, 'logs', 'log.txt');
+  }
+
+  /// 获取日志文件大小（字节）
+  static Future<int> get logFileSize async {
+    final path = await logFilePath;
+    final file = File(path);
+    if (await file.exists()) {
+      return await file.length();
+    }
+    return 0;
+  }
+
+  /// 清空日志文件（内容清零，不删除文件）
+  static Future<void> clearLog() async {
+    final path = await logFilePath;
+    final file = File(path);
+    if (await file.exists()) {
+      await file.writeAsString('');
+    }
+  }
+
+  /// 导出日志文件到指定目录
+  static Future<String?> exportLog(String targetDir) async {
+    final srcPath = await logFilePath;
+    final srcFile = File(srcPath);
+    if (!await srcFile.exists()) return null;
+
+    final timestamp = DateTime.now().toIso8601String().replaceAll(':', '-').substring(0, 19);
+    final destPath = p.join(targetDir, 'cloudreve_log_$timestamp.txt');
+    await srcFile.copy(destPath);
+    return destPath;
+  }
+
+  /// 读取日志内容（用于预览）
+  static Future<String> readLog({int maxLines = 500}) async {
+    final path = await logFilePath;
+    final file = File(path);
+    if (!await file.exists()) return '';
+
+    final lines = await file.readAsLines();
+    if (lines.length <= maxLines) {
+      return lines.join('\n');
+    }
+    return '... (仅显示最近 $maxLines 行)\n\n'
+        '${lines.sublist(lines.length - maxLines).join('\n')}';
+  }
+}
+
+/// 定义一个简单的自定义 FileOutput，防止 Logger 自带版本不支持追加
+class CustomFileOutput extends LogOutput {
+  final File file;
+  CustomFileOutput({required this.file});
+
+  @override
+  void output(OutputEvent event) {
+    for (var line in event.lines) {
+      // 过滤掉 ANSI 颜色代码，防止 log.txt 乱码
+      final cleanLine = line.replaceAll(RegExp(r'\x1B\[[0-9;]*[a-zA-Z]'), '');
+      file.writeAsStringSync('$cleanLine\n', mode: FileMode.writeOnlyAppend);
+    }
+  }
+}
+
+/// 日志帮助类
+/// 提供一个全局的静态日志实例
+class Log {
+  static void d(String message) => AppLogger.d(message);
+  static void i(String message) => AppLogger.i(message);
+  static void w(String message) => AppLogger.w(message);
+  static void e(String message) => AppLogger.e(message);
+  static void df(String message, List<Object> args) => AppLogger.df(message, args);
+  static void ifn(String message, List<Object> args) => AppLogger.ifn(message, args);
+  static void wf(String message, List<Object> args) => AppLogger.wf(message, args);
+  static void ef(String message, List<Object> args) => AppLogger.ef(message, args);
+}