flu-cli-core 1.0.0

package/templates/core_files/network/interceptors/retry_interceptor.dart.template

@@ -0,0 +1,69 @@
+import 'package:dio/dio.dart';
+import 'package:flutter/foundation.dart';
+
+/// 请求重试拦截器
+///
+/// 网络错误时自动重试
+///
+/// 使用示例:
+/// ```dart
+/// AppHttp.init(
+///   interceptors: [
+///     RetryInterceptor(
+///       dio: AppHttp().dio,
+///       maxRetries: 3,
+///       retryDelay: const Duration(seconds: 1),
+///     ),
+///   ],
+/// );
+/// ```
+class RetryInterceptor extends Interceptor {
+  final Dio dio;
+  final int maxRetries;
+  final Duration retryDelay;
+
+  RetryInterceptor({
+    required this.dio,
+    this.maxRetries = 3,
+    this.retryDelay = const Duration(seconds: 1),
+  });
+
+  @override
+  Future<void> onError(
+    DioException err,
+    ErrorInterceptorHandler handler,
+  ) async {
+    // 只重试网络相关错误
+    if (!_shouldRetry(err)) {
+      return handler.next(err);
+    }
+
+    final retryCount = err.requestOptions.extra['retryCount'] ?? 0;
+
+    if (retryCount >= maxRetries) {
+      debugPrint('❌ 已达最大重试次数 ($maxRetries)');
+      return handler.next(err);
+    }
+
+    debugPrint('🔄 网络错误,第 ${retryCount + 1} 次重试...');
+
+    // 延迟后重试
+    await Future.delayed(retryDelay);
+
+    err.requestOptions.extra['retryCount'] = retryCount + 1;
+
+    try {
+      final response = await dio.fetch(err.requestOptions);
+      return handler.resolve(response);
+    } catch (e) {
+      return handler.next(err);
+    }
+  }
+
+  /// 判断是否应该重试
+  bool _shouldRetry(DioException err) {
+    return err.type == DioExceptionType.connectionTimeout ||
+        err.type == DioExceptionType.receiveTimeout ||
+        err.type == DioExceptionType.connectionError;
+  }
+}

package/templates/core_files/network/response_adapter.dart.template

@@ -0,0 +1,69 @@
+import 'app_error_code.dart';
+
+/// 响应数据适配器
+///
+/// 用于将不同后端接口返回的非标准 JSON 格式,
+/// 统一转换为项目标准的 {code, msg, data} 格式。
+abstract class AppResponseAdapter {
+  Map<String, dynamic> adapt(dynamic json);
+}
+
+/// 默认适配器
+/// 对应格式: { "code": 200, "msg": "成功", "data": ... }
+class DefaultResponseAdapter extends AppResponseAdapter {
+  @override
+  Map<String, dynamic> adapt(dynamic json) {
+    if (json is Map) {
+      return {
+        'code': json['code'] ?? AppErrorCode.networkError,
+        'msg': json['msg'] ?? json['message'] ?? '未知错误',
+        'data': json['data'],
+      };
+    }
+    return _buildError('数据格式错误');
+  }
+}
+
+/// WanAndroid 适配器 (示例)
+/// 对应格式: { "errorCode": 0, "errorMsg": "", "data": ... }
+class WanAndroidAdapter extends AppResponseAdapter {
+  @override
+  Map<String, dynamic> adapt(dynamic json) {
+    if (json is Map) {
+      return {
+        'code': json['errorCode'] ?? AppErrorCode.networkError,
+        'msg': json['errorMsg'] ?? '',
+        'data': json['data'],
+      };
+    }
+    return _buildError('数据格式错误');
+  }
+}
+
+/// 辅助方法:构建错误数据
+Map<String, dynamic> _buildError(String msg) {
+  return {
+    'code': AppErrorCode.parseError,
+    'msg': msg,
+    'data': null,
+  };
+}
+
+/// 图虫 API 适配器
+/// 对应格式: { "result": "SUCCESS", "message": "...", "feedList": [...] }
+class TuChongAdapter extends AppResponseAdapter {
+  @override
+  Map<String, dynamic> adapt(dynamic json) {
+    if (json is Map) {
+      final result = json['result'];
+      final isSuccess = result == 'SUCCESS';
+
+      return {
+        'code': isSuccess ? 200 : -1,
+        'msg': json['message'] ?? '',
+        'data': json['feedList'] ?? json['data'],
+      };
+    }
+    return _buildError('数据格式错误');
+  }
+}

package/templates/core_files/router/app_routes.dart.template

@@ -0,0 +1,32 @@
+import 'package:flutter/material.dart';
+// PAGES_IMPORT_PLACEHOLDER
+
+/// 应用路由配置
+///
+/// 使用方式：
+/// Navigator.pushNamed(context, AppRoutes.home);
+/// 或 NavigatorUtil.pushNamed(AppRoutes.home);
+class AppRoutes {
+  AppRoutes._();
+
+  // 路由常量
+  static const String home = '/';
+  static const String splash = '/splash';
+  static const String egList = '/eg-list';
+  static const String userList = '/user-list';
+
+  // __ROUTE_CONFIG_START__
+  /// Material 路由映射
+  /// 在 app.dart 中使用: MaterialApp(routes: AppRoutes.routes, ...)
+  static Map<String, WidgetBuilder> get routes {
+    return {
+      home: (context) => const HomePage(),
+      userList: (context) => const UserListPage(),
+      {{#if_network}}
+      egList: (context) => const EgListPage(),
+      {{/if_network}}
+      // --- 在此下方添加您的自定义路由 ---
+    };
+  }
+  // __ROUTE_CONFIG_END__
+}

package/templates/core_files/router/index.dart.template

@@ -0,0 +1,3 @@
+// 导出路由相关类 (按字母顺序排列)
+export 'app_routes.dart';
+export 'navigator_util.dart';

package/templates/core_files/router/navigator_util_getx.dart.template

@@ -0,0 +1,131 @@
+import 'package:flutter/material.dart';
+import 'package:get/get.dart';
+
+// ------------------------------
+// 导航工具类 (GetX 模式)
+// 提供页面跳转、返回等常用导航功能
+// ------------------------------
+class NavigatorUtil {
+  // ------------------------------
+  // 1. 静态属性
+  // ------------------------------
+  /// 私有构造函数
+  NavigatorUtil._();
+
+  // GetX 模式：不需要 GlobalKey
+
+  // ------------------------------
+  // 2. 页面跳转方法
+  // ------------------------------
+  /// 普通页面跳转
+  ///
+  /// [page] 目标页面
+  /// [replace] 是否替换当前页面
+  /// [clearStack] 是否清空导航栈
+  static Future<T?> push<T>(
+    Widget page, {
+    bool replace = false,
+    bool clearStack = false,
+  }) async {
+    if (clearStack) {
+      return await Get.offAll<T>(() => page);
+    } else if (replace) {
+      return await Get.off<T>(() => page);
+    } else {
+      return await Get.to<T>(() => page);
+    }
+  }
+
+  /// 带自定义动画的页面跳转
+  ///
+  /// [page] 目标页面
+  /// [duration] 动画持续时间
+  static Future<T?> pushWithAnimation<T>(
+    Widget page, {
+    required RouteTransitionsBuilder transition,
+    Duration duration = const Duration(milliseconds: 300),
+    Curve curve = Curves.easeInOut,
+  }) async {
+    // GetX 模式：使用 Get.to 的 transition 参数
+    return await Get.to<T>(
+      () => page,
+      transition: Transition.fadeIn,
+      duration: duration,
+    );
+  }
+
+  /// 命名路由跳转
+  ///
+  /// [routeName] 路由名称
+  /// [arguments] 路由参数
+  /// [replace] 是否替换当前页面
+  /// [clearStack] 是否清空导航栈
+  static Future<T?> pushNamed<T>(
+    String routeName, {
+    Object? arguments,
+    bool replace = false,
+    bool clearStack = false,
+  }) async {
+    if (clearStack) {
+      return await Get.offAllNamed<T>(routeName, arguments: arguments);
+    } else if (replace) {
+      return await Get.offNamed<T>(routeName, arguments: arguments);
+    } else {
+      return await Get.toNamed<T>(routeName, arguments: arguments);
+    }
+  }
+
+  // ------------------------------
+  // 3. 页面返回方法
+  // ------------------------------
+  /// 返回上一页
+  ///
+  /// [result] 返回结果
+  static void pop<T>([T? result]) {
+    Get.back<T>(result: result);
+  }
+
+  /// 返回上一页，如果键盘弹起则先关闭键盘
+  static void popWithKeyboardCheck<T>([T? result]) {
+    // GetX 模式：直接返回
+    Get.back<T>(result: result);
+  }
+
+  /// 检查是否可以返回
+  static bool canPop() {
+    return Get.isDialogOpen ?? false;
+  }
+
+  /// 返回到指定页面
+  ///
+  /// [routeName] 目标路由名称
+  static void popUntil(String routeName) {
+    Get.until((route) => route.settings.name == routeName);
+  }
+
+  /// 返回到根页面
+  static void popToRoot() {
+    Get.offAllNamed('/');
+  }
+
+  // ------------------------------
+  // 4. 路由参数处理方法
+  // ------------------------------
+  /// 获取路由传递的参数
+  static T? getArguments<T>([T? defaultValue]) {
+    try {
+      final args = Get.arguments;
+      if (args == null) return defaultValue;
+
+      if (args is T) {
+        return args ;
+      } else {
+        debugPrint('路由参数类型不匹配: 期望 ${T.toString()}, 实际 ${args.runtimeType}');
+        return defaultValue;
+      }
+    } catch (e) {
+      debugPrint('获取路由参数异常: $e');
+      return defaultValue;
+    }
+  }
+}

package/templates/core_files/router/navigator_util_material.dart.template

@@ -0,0 +1,191 @@
+import 'package:flutter/material.dart';
+
+// ------------------------------
+// 导航工具类 (Material 模式)
+// 提供页面跳转、返回等常用导航功能
+// ------------------------------
+class NavigatorUtil {
+  // ------------------------------
+  // 1. 静态属性
+  // ------------------------------
+  /// 私有构造函数
+  NavigatorUtil._();
+
+  /// 全局导航键（Material 模式）
+  static final GlobalKey<NavigatorState> navigatorKey =
+      GlobalKey<NavigatorState>();
+
+  /// 全局 ScaffoldMessenger 键，用于显示 SnackBar
+  static final GlobalKey<ScaffoldMessengerState> scaffoldMessengerKey =
+      GlobalKey<ScaffoldMessengerState>();
+
+  /// 获取导航状态
+  static NavigatorState? get navigator => navigatorKey.currentState;
+
+  /// 获取当前上下文
+  static BuildContext? get context => navigatorKey.currentContext;
+
+  // ------------------------------
+  // 2. 页面跳转方法
+  // ------------------------------
+  /// 普通页面跳转
+  ///
+  /// [page] 目标页面
+  /// [replace] 是否替换当前页面
+  /// [clearStack] 是否清空导航栈
+  static Future<T?> push<T>(
+    Widget page, {
+    bool replace = false,
+    bool clearStack = false,
+  }) async {
+    final Route<T> route = MaterialPageRoute<T>(
+      builder: (BuildContext context) => page,
+    );
+
+    if (clearStack) {
+      return await navigator?.pushAndRemoveUntil<T>(
+        route,
+        (Route<dynamic> route) => false,
+      );
+    } else if (replace) {
+      return await navigator?.pushReplacement<T, dynamic>(route);
+    } else {
+      return await navigator?.push<T>(route);
+    }
+  }
+
+  /// 带自定义动画的页面跳转
+  ///
+  /// [page] 目标页面
+  /// [transition] 过渡动画构建器
+  /// [duration] 动画持续时间
+  /// [curve] 动画曲线
+  static Future<T?> pushWithAnimation<T>(
+    Widget page, {
+    required RouteTransitionsBuilder transition,
+    Duration duration = const Duration(milliseconds: 300),
+    Curve curve = Curves.easeInOut,
+  }) async {
+    final Route<T> route = PageRouteBuilder<T>(
+      pageBuilder: (
+        BuildContext context,
+        Animation<double> animation,
+        Animation<double> secondaryAnimation,
+      ) {
+        return page;
+      },
+      transitionDuration: duration,
+      transitionsBuilder: transition,
+    );
+
+    return await navigator?.push<T>(route);
+  }
+
+  /// 命名路由跳转
+  ///
+  /// [routeName] 路由名称
+  /// [arguments] 路由参数
+  /// [replace] 是否替换当前页面
+  /// [clearStack] 是否清空导航栈
+  static Future<T?> pushNamed<T>(
+    String routeName, {
+    Object? arguments,
+    bool replace = false,
+    bool clearStack = false,
+  }) async {
+    if (clearStack) {
+      return await navigator?.pushNamedAndRemoveUntil<T>(
+        routeName,
+        (Route<dynamic> route) => false,
+        arguments: arguments,
+      );
+    } else if (replace) {
+      return await navigator?.pushReplacementNamed<T, dynamic>(
+        routeName,
+        arguments: arguments,
+      );
+    } else {
+      return await navigator?.pushNamed<T>(
+        routeName,
+        arguments: arguments,
+      );
+    }
+  }
+
+  // ------------------------------
+  // 3. 页面返回方法
+  // ------------------------------
+  /// 返回上一页
+  ///
+  /// [result] 返回结果
+  static void pop<T>([T? result]) {
+    if (navigator?.canPop() ?? false) {
+      navigator?.pop<T>(result);
+    }
+  }
+
+  /// 返回上一页，如果键盘弹起则先关闭键盘
+  static void popWithKeyboardCheck<T>([T? result]) {
+    final context = navigatorKey.currentContext;
+    if (context == null) {
+      pop<T>(result);
+      return;
+    }
+
+    final hasFocus = FocusScope.of(context).hasFocus;
+    if (hasFocus) {
+      FocusScope.of(context).unfocus();
+      WidgetsBinding.instance.addPostFrameCallback((_) {
+        Future.delayed(const Duration(milliseconds: 400), () {
+          pop<T>(result);
+        });
+      });
+    } else {
+      pop<T>(result);
+    }
+  }
+
+  /// 检查是否可以返回
+  static bool canPop() {
+    return navigator?.canPop() ?? false;
+  }
+
+  /// 返回到指定页面
+  ///
+  /// [routeName] 目标路由名称
+  static void popUntil(String routeName) {
+    navigator?.popUntil(ModalRoute.withName(routeName));
+  }
+
+  /// 返回到根页面
+  static void popToRoot() {
+    navigator?.popUntil((route) => route.isFirst);
+  }
+
+  // ------------------------------
+  // 4. 路由参数处理方法
+  // ------------------------------
+  /// 获取路由传递的参数
+  static T? getArguments<T>([T? defaultValue]) {
+    final context = navigatorKey.currentContext;
+    if (context == null) return defaultValue;
+
+    final ModalRoute<dynamic>? route = ModalRoute.of(context);
+    if (route == null) return defaultValue;
+
+    final args = route.settings.arguments;
+    if (args == null) return defaultValue;
+
+    try {
+      if (args is T) {
+        return args as T;
+      } else {
+        debugPrint('路由参数类型不匹配: 期望 ${T.toString()}, 实际 ${args.runtimeType}');
+        return defaultValue;
+      }
+    } catch (e) {
+      debugPrint('获取路由参数异常: $e');
+      return defaultValue;
+    }
+  }
+}

package/templates/core_files/storage/index.dart.template

@@ -0,0 +1,3 @@
+// 导出存储层类 (按字母顺序排列)
+export 'storage_keys.dart';
+export 'storage_util.dart';

package/templates/core_files/storage/storage_keys.dart.template

@@ -0,0 +1,34 @@
+/// 存储键常量
+///
+/// 统一管理所有本地存储的键名，避免硬编码
+abstract class StorageKeys {
+  // ==================== 应用相关 ====================
+
+  /// 是否首次启动
+  static const isFirstLaunch = 'app_is_first_launch';
+
+  /// 当前应用版本（用于版本迁移）
+  static const appVersion = 'app_version';
+
+  // ==================== 用户相关 ====================
+
+  /// 用户 Token
+  static const userToken = 'user_token';
+
+  /// 用户 ID
+  static const userId = 'user_id';
+
+  /// 是否已登录
+  static const isLoggedIn = 'user_is_logged_in';
+
+  // ==================== 设置相关 ====================
+
+  /// 主题模式（light/dark/system）
+  static const themeMode = 'setting_theme_mode';
+
+  /// 语言
+  static const language = 'setting_language';
+
+  // ==================== 用户可扩展 ====================
+  // 在此添加项目特定的键...
+}

package/templates/core_files/storage/storage_util.dart.template

@@ -0,0 +1,102 @@
+import 'package:shared_preferences/shared_preferences.dart';
+
+/// 本地存储工具
+///
+/// 封装 SharedPreferences，提供类型安全的存取方法
+///
+/// 使用示例：
+/// ```dart
+/// // 存储
+/// await StorageUtil.setString('username', 'john');
+/// await StorageUtil.setBool('isVip', true);
+///
+/// // 读取
+/// final username = StorageUtil.getString('username');
+/// final isVip = StorageUtil.getBool('isVip', defaultValue: false);
+/// ```
+class StorageUtil {
+  static SharedPreferences? _prefs;
+
+  /// 初始化（必须在使用前调用）
+  static Future<void> init() async {
+    _prefs = await SharedPreferences.getInstance();
+  }
+
+  static SharedPreferences get _instance {
+    if (_prefs == null) {
+      throw StateError('StorageUtil 未初始化，请先调用 StorageUtil.init()');
+    }
+    return _prefs!;
+  }
+
+  /// 是否已初始化
+  static bool get isInitialized => _prefs != null;
+
+  // ==================== String ====================
+
+  static Future<bool> setString(String key, String value) =>
+      _instance.setString(key, value);
+
+  static String? getString(String key) => _instance.getString(key);
+
+  static String getStringOrDefault(String key, {String defaultValue = ''}) =>
+      _instance.getString(key) ?? defaultValue;
+
+  // ==================== Int ====================
+
+  static Future<bool> setInt(String key, int value) =>
+      _instance.setInt(key, value);
+
+  static int? getInt(String key) => _instance.getInt(key);
+
+  static int getIntOrDefault(String key, {int defaultValue = 0}) =>
+      _instance.getInt(key) ?? defaultValue;
+
+  // ==================== Double ====================
+
+  static Future<bool> setDouble(String key, double value) =>
+      _instance.setDouble(key, value);
+
+  static double? getDouble(String key) => _instance.getDouble(key);
+
+  static double getDoubleOrDefault(String key, {double defaultValue = 0.0}) =>
+      _instance.getDouble(key) ?? defaultValue;
+
+  // ==================== Bool ====================
+
+  static Future<bool> setBool(String key, bool value) =>
+      _instance.setBool(key, value);
+
+  static bool? getBool(String key) => _instance.getBool(key);
+
+  static bool getBoolOrDefault(String key, {bool defaultValue = false}) =>
+      _instance.getBool(key) ?? defaultValue;
+
+  // ==================== StringList ====================
+
+  static Future<bool> setStringList(String key, List<String> value) =>
+      _instance.setStringList(key, value);
+
+  static List<String>? getStringList(String key) =>
+      _instance.getStringList(key);
+
+  static List<String> getStringListOrDefault(
+    String key, {
+    List<String> defaultValue = const [],
+  }) =>
+      _instance.getStringList(key) ?? defaultValue;
+
+  // ==================== 通用操作 ====================
+
+  /// 删除指定键
+  static Future<bool> remove(String key) => _instance.remove(key);
+
+  /// 清空所有数据
+  static Future<bool> clear() => _instance.clear();
+
+  /// 是否包含指定键
+  static bool containsKey(String key) => _instance.containsKey(key);
+
+  /// 获取所有键
+  static Set<String> getKeys() => _instance.getKeys();
+}

package/templates/core_files/theme/app_theme.dart.template

@@ -0,0 +1,37 @@
+import 'package:flutter/material.dart';
+
+class AppTheme {
+  /// 亮色主题（函数级注释）
+  static ThemeData light() {
+    return ThemeData(
+      brightness: Brightness.light,
+      primaryColor: const Color(0xFF3B82F6),
+      colorScheme: const ColorScheme.light(
+        primary: Color(0xFF3B82F6),
+        secondary: Color(0xFF22C55E),
+      ),
+      appBarTheme: const AppBarTheme(
+        elevation: 0,
+        centerTitle: true,
+        backgroundColor: Colors.white,
+        foregroundColor: Colors.black87,
+      ),
+      scaffoldBackgroundColor: const Color(0xFFF8FAFC),
+    );
+  }
+
+  /// 暗色主题（函数级注释）
+  static ThemeData dark() {
+    return ThemeData(
+      brightness: Brightness.dark,
+      colorScheme: const ColorScheme.dark(
+        primary: Color(0xFF60A5FA),
+        secondary: Color(0xFF34D399),
+      ),
+      appBarTheme: const AppBarTheme(
+        elevation: 0,
+        centerTitle: true,
+      ),
+    );
+  }
+}

package/templates/core_files/theme/index.dart.template

@@ -0,0 +1,3 @@
+// 导出主题类 (按字母顺序排列)
+export 'app_theme.dart';
+export 'status_views_theme.dart';