flu-cli-core 1.0.4 → 1.1.0

package/templates/core_files/config/privacy_dialog.dart.template

@@ -0,0 +1,158 @@
+import 'package:flutter/gestures.dart';
+import 'package:flutter/material.dart';
+
+import '../index.dart';
+
+/// 隐私协议确认弹窗
+class PrivacyDialog extends StatelessWidget {
+  const PrivacyDialog({super.key});
+
+  /// 显示弹窗
+  static Future<bool?> show(BuildContext context) {
+    return showDialog<bool>(
+      context: context,
+      barrierDismissible: false,
+      barrierColor: Colors.black.withOpacity(0.32),
+      builder: (context) => const PrivacyDialog(),
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final titleStyle = AppTextStyleConfig.I.titleSmall();
+    final contentStyle = AppTextStyleConfig.I.body();
+    final linkStyle = AppTextStyleConfig.I.body().copyWith(
+          color: AppColorConfig.I.primary,
+        );
+
+    return PopScope(
+      canPop: false,
+      child: Center(
+        child: Container(
+          margin: const EdgeInsets.symmetric(horizontal: 32),
+          padding: const EdgeInsets.all(24),
+          decoration: BoxDecoration(
+            color: Colors.white,
+            borderRadius: BorderRadius.circular(16),
+            boxShadow: const [
+              BoxShadow(
+                color: Color(0x0D000000),
+                blurRadius: 24,
+                offset: Offset(0, 8),
+              ),
+            ],
+          ),
+          child: Column(
+            mainAxisSize: MainAxisSize.min,
+            children: [
+              Text('用户协议与隐私政策', style: titleStyle),
+              const SizedBox(height: 20),
+              ConstrainedBox(
+                constraints: const BoxConstraints(maxHeight: 320),
+                child: SingleChildScrollView(
+                  child: RichText(
+                    text: TextSpan(
+                      style: contentStyle.copyWith(height: 1.6),
+                      children: [
+                        const TextSpan(
+                          text: '欢迎使用 ${EnvConfig.appName}！在您使用前，请您务必仔细阅读',
+                        ),
+                        TextSpan(
+                          text: '《用户协议》',
+                          style: linkStyle,
+                          recognizer: TapGestureRecognizer()
+                            ..onTap = () {
+                              _openAgreementDocument(
+                                context,
+                                AgreementDocumentType.userAgreement,
+                              );
+                            },
+                        ),
+                        const TextSpan(text: '与'),
+                        TextSpan(
+                          text: '《隐私政策》',
+                          style: linkStyle,
+                          recognizer: TapGestureRecognizer()
+                            ..onTap = () {
+                              _openAgreementDocument(
+                                context,
+                                AgreementDocumentType.privacyPolicy,
+                              );
+                            },
+                        ),
+                        const TextSpan(
+                          text: '。我们将严格按照政策规定保护您的个人信息。\n\n'
+                              '1. 我们会收集您的设备信息用于基础统计。\n'
+                              '2. 为了提供更好的服务，我们需要部分系统权限。\n\n'
+                              '如果您同意上述协议，请点击“同意”开始使用。',
+                        ),
+                      ],
+                    ),
+                  ),
+                ),
+              ),
+              const SizedBox(height: 24),
+              Row(
+                children: [
+                  Expanded(
+                    child: OutlinedButton(
+                      onPressed: () {
+                        Navigator.pop(context, false);
+                      },
+                      style: OutlinedButton.styleFrom(
+                        padding: const EdgeInsets.symmetric(vertical: 12),
+                        side: BorderSide(color: AppColorConfig.I.divider),
+                        shape: RoundedRectangleBorder(
+                          borderRadius: BorderRadius.circular(12),
+                        ),
+                      ),
+                      child: Text(
+                        '不同意并退出',
+                        style: AppTextStyleConfig.I.body().copyWith(
+                              color: AppColorConfig.I.titleSecondary,
+                            ),
+                      ),
+                    ),
+                  ),
+                  const SizedBox(width: 16),
+                  Expanded(
+                    child: ElevatedButton(
+                      onPressed: () {
+                        Navigator.pop(context, true);
+                      },
+                      style: ElevatedButton.styleFrom(
+                        backgroundColor: AppColorConfig.I.primary,
+                        padding: const EdgeInsets.symmetric(vertical: 12),
+                        shape: RoundedRectangleBorder(
+                          borderRadius: BorderRadius.circular(12),
+                        ),
+                      ),
+                      child: Text(
+                        '同意',
+                        style: AppTextStyleConfig.I.body().copyWith(
+                              color: Colors.white,
+                            ),
+                      ),
+                    ),
+                  ),
+                ],
+              ),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+
+  Future<void> _openAgreementDocument(
+    BuildContext context,
+    AgreementDocumentType type,
+  ) async {
+    Navigator.push(
+      context,
+      MaterialPageRoute(
+        builder: (context) => AgreementDocumentPage(type: type),
+      ),
+    );
+  }
+}

package/templates/core_files/index.dart.template

@@ -1,4 +1,7 @@
 // 导出核心模块 (按字母顺序排列)
+{{#if_auth}}
+export 'auth/index.dart';
+{{/if_auth}}
 export 'base/index.dart';
 export 'config/index.dart';
 export 'network/index.dart';

package/templates/core_files/mixins/page/keep_alive_mixin.dart.template

@@ -0,0 +1,6 @@
+import 'package:flutter/widgets.dart';
+
+mixin KeepAliveMixin<T extends StatefulWidget> on State<T> {
+  @override
+  bool get wantKeepAlive => true;
+}

package/templates/core_files/mixins/page/scroll_controller_mixin.dart.template

@@ -0,0 +1,7 @@
+mixin ScrollControllerMixin {
+  double lastOffset = 0;
+
+  void cacheScrollOffset(double offset) {
+    lastOffset = offset;
+  }
+}

package/templates/core_files/mixins/service/request_guard_mixin.dart.template

@@ -0,0 +1,18 @@
+mixin RequestGuardMixin {
+  bool _requestInFlight = false;
+
+  bool get hasRequestInFlight => _requestInFlight;
+
+  Future<T> guardRequest<T>(Future<T> Function() action) async {
+    if (_requestInFlight) {
+      throw StateError('A guarded request is already running.');
+    }
+
+    _requestInFlight = true;
+    try {
+      return await action();
+    } finally {
+      _requestInFlight = false;
+    }
+  }
+}

package/templates/core_files/mixins/viewmodel/debounce_mixin.dart.template

@@ -0,0 +1,18 @@
+import 'dart:async';
+
+mixin DebounceMixin {
+  Timer? _debounceTimer;
+
+  void debounce({
+    required Duration duration,
+    required void Function() action,
+  }) {
+    _debounceTimer?.cancel();
+    _debounceTimer = Timer(duration, action);
+  }
+
+  void disposeDebounceMixin() {
+    _debounceTimer?.cancel();
+    _debounceTimer = null;
+  }
+}

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

@@ -40,6 +40,8 @@ class AppHttp {
   static void init({
     AppResponseAdapter? adapter,
     List<Interceptor>? interceptors,
+    List<Interceptor> Function(Dio dio)? interceptorBuilder,
+    Map<String, dynamic> Function()? globalParams,
     bool autoShowError = true,
   }) {
     final instance = AppHttp._instance;
@@ -58,7 +60,14 @@ class AppHttp {
       ),
     );
 
-    // 1. 添加日志拦截器（完整输出，不截断）
+    // 1. 添加全局请求参数拦截器，保证日志记录的是最终请求。
+    if (globalParams != null) {
+      instance._dio.interceptors.add(
+        GlobalParamsInterceptor(getParams: globalParams),
+      );
+    }
+
+    // 2. 添加日志拦截器（完整输出，不截断）
     if (config.enableLog) {
       instance._dio.interceptors.add(
         FullLogInterceptor(
@@ -68,7 +77,7 @@ class AppHttp {
       );
     }
 
-    // 2. 添加响应处理拦截器 (核心)
+    // 3. 添加响应处理拦截器 (核心)
     instance._dio.interceptors.add(
       AppResponseInterceptor(
         adapter: adapter ?? DefaultResponseAdapter(),
@@ -76,12 +85,18 @@ class AppHttp {
       ),
     );
 
-    // 2.5 添加网络错误拦截器
+    // 4. 添加网络错误拦截器
     instance._dio.interceptors.add(
       NetworkErrorInterceptor(autoShowError: autoShowError),
     );
 
-    // 3. 添加自定义拦截器
+    // 5. 添加需要复用当前 Dio 实例的自定义拦截器。
+    final builtInterceptors = interceptorBuilder?.call(instance._dio);
+    if (builtInterceptors != null) {
+      instance._dio.interceptors.addAll(builtInterceptors);
+    }
+
+    // 6. 添加普通自定义拦截器。
     if (interceptors != null) {
       instance._dio.interceptors.addAll(interceptors);
     }

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

@@ -8,5 +8,9 @@ export 'app_http.dart';
 export 'app_response.dart';
 // 网络拦截器
 export 'interceptors/index.dart';
+{{#if_network_monitor}}
+// 网络状态监听
+export 'network_monitor.dart';
+{{/if_network_monitor}}
 // 网络响应适配器
 export 'response_adapter.dart';

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

@@ -0,0 +1,77 @@
+import 'package:dio/dio.dart';
+import 'package:flutter/foundation.dart';
+
+/// 全局参数自动注入拦截器。
+class GlobalParamsInterceptor extends Interceptor {
+  GlobalParamsInterceptor({
+    required this.getParams,
+    this.injectToData = true,
+  });
+
+  final Map<String, dynamic> Function() getParams;
+  final bool injectToData;
+
+  static bool _isGetLike(String? method) {
+    final m = (method ?? 'GET').toUpperCase();
+    return m == 'GET' || m == 'HEAD';
+  }
+
+  void _mergeIntoQuery(RequestOptions options, Map<String, dynamic> params) {
+    final newQueryParams = Map<String, dynamic>.from(options.queryParameters);
+    newQueryParams.addAll(params);
+    options.queryParameters = newQueryParams;
+  }
+
+  void _mergeIntoBody(RequestOptions options, Map<String, dynamic> params) {
+    if (options.data == null) {
+      options.data = Map<String, dynamic>.from(params);
+      return;
+    }
+    if (options.data is Map) {
+      final newData = Map<String, dynamic>.from(options.data as Map);
+      newData.addAll(params);
+      options.data = newData;
+      return;
+    }
+    if (options.data is FormData) {
+      final formData = options.data as FormData;
+      for (final entry in params.entries) {
+        formData.fields.add(MapEntry(entry.key, entry.value?.toString() ?? ''));
+      }
+      return;
+    }
+    assert(() {
+      debugPrint(
+        'GlobalParamsInterceptor: 未注入全局参数，body 类型 '
+        '${options.data.runtimeType} 不支持合并',
+      );
+      return true;
+    }());
+  }
+
+  @override
+  void onRequest(RequestOptions options, RequestInterceptorHandler handler) {
+    try {
+      final params = getParams();
+      if (params.isEmpty) {
+        return handler.next(options);
+      }
+
+      if (_isGetLike(options.method)) {
+        _mergeIntoQuery(options, params);
+        return handler.next(options);
+      }
+
+      if (injectToData) {
+        _mergeIntoBody(options, params);
+      } else {
+        _mergeIntoQuery(options, params);
+      }
+
+      handler.next(options);
+    } catch (error) {
+      debugPrint('GlobalParamsInterceptor Error: $error');
+      handler.next(options);
+    }
+  }
+}

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

@@ -1,6 +1,9 @@
 export 'app_response_interceptor.dart';
+{{#if_auth}}
 export 'auth_interceptor.dart';
+{{/if_auth}}
 export 'error_interceptor.dart';
+export 'global_params_interceptor.dart';
 export 'log_interceptor.dart';
 export 'network_error_interceptor.dart';
 export 'retry_interceptor.dart';

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

@@ -0,0 +1,18 @@
+import 'package:connectivity_plus/connectivity_plus.dart';
+
+/// 提供最小网络状态监听封装，供项目初始化或全局状态层接入。
+class NetworkMonitor {
+  NetworkMonitor({
+    Connectivity? connectivity,
+  }) : _connectivity = connectivity ?? Connectivity();
+
+  final Connectivity _connectivity;
+
+  Stream<List<ConnectivityResult>> watch() {
+    return _connectivity.onConnectivityChanged;
+  }
+
+  Future<List<ConnectivityResult>> current() {
+    return _connectivity.checkConnectivity();
+  }
+}

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

@@ -13,6 +13,14 @@ abstract class AppResponseAdapter {
 class DefaultResponseAdapter extends AppResponseAdapter {
   @override
   Map<String, dynamic> adapt(dynamic json) {
+    if (json is List) {
+      return {
+        'code': AppErrorCode.success,
+        'msg': '成功',
+        'data': json,
+      };
+    }
+
     if (json is Map) {
       return {
         'code': json['code'] ?? AppErrorCode.networkError,
@@ -48,22 +56,3 @@ Map<String, dynamic> _buildError(String 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

@@ -12,8 +12,7 @@ class AppRoutes {
   // 路由常量
   static const String home = '/';
   static const String splash = '/splash';
-  static const String egList = '/eg-list';
-  static const String userList = '/user-list';
+  // 网络示例路由 - 由 CLI 动态注入
 
   // __ROUTE_CONFIG_START__
   /// Material 路由映射
@@ -21,10 +20,8 @@ class AppRoutes {
   static Map<String, WidgetBuilder> get routes {
     return {
       home: (context) => const HomePage(),
-      userList: (context) => const UserListPage(),
-      {{#if_network}}
-      egList: (context) => const EgListPage(),
-      {{/if_network}}
+      splash: (context) => const SplashPage(),
+      // 网络示例路由映射 - 由 CLI 动态注入
       // --- 在此下方添加您的自定义路由 ---
     };
   }

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

@@ -10,6 +10,12 @@ abstract class StorageKeys {
   /// 当前应用版本（用于版本迁移）
   static const appVersion = 'app_version';
 
+  /// 是否已同意隐私协议
+  static const privacyAgreed = 'app_privacy_agreed';
+
+  /// 已接受的协议版本
+  static const agreementAcceptedVersion = 'app_agreement_accepted_version';
+
   // ==================== 用户相关 ====================
 
   /// 用户 Token

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

@@ -0,0 +1,32 @@
+import 'package:flutter/material.dart';
+
+/// 统一维护项目级颜色令牌，供 Theme 和文本样式配置复用。
+class AppColorConfig {
+  static AppColorConfig get I => const AppColorConfig();
+
+  const AppColorConfig({
+    this.primary = const Color(0xFF3B82F6),
+    this.secondary = const Color(0xFF22C55E),
+    this.background = const Color(0xFFF8FAFC),
+    this.surface = Colors.white,
+    this.title = const Color(0xFF111827),
+    this.titleSecondary = const Color(0xFF4B5563),
+    this.caption = const Color(0xFF6B7280),
+    this.divider = const Color(0xFFE5E7EB),
+    this.error = const Color(0xFFEF4444),
+    this.success = const Color(0xFF22C55E),
+    this.warning = const Color(0xFFF59E0B),
+  });
+
+  final Color primary;
+  final Color secondary;
+  final Color background;
+  final Color surface;
+  final Color title;
+  final Color titleSecondary;
+  final Color caption;
+  final Color divider;
+  final Color error;
+  final Color success;
+  final Color warning;
+}

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

@@ -0,0 +1,22 @@
+/// 统一维护语义化字号，避免模板默认暴露 s12/s14 这类数字别名。
+class AppTextSizeConfig {
+  const AppTextSizeConfig({
+    this.caption = 12,
+    this.bodySmall = 13,
+    this.body = 14,
+    this.bodyLarge = 16,
+    this.titleSmall = 18,
+    this.title = 20,
+    this.titleLarge = 24,
+    this.headline = 28,
+  });
+
+  final double caption;
+  final double bodySmall;
+  final double body;
+  final double bodyLarge;
+  final double titleSmall;
+  final double title;
+  final double titleLarge;
+  final double headline;
+}

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

@@ -0,0 +1,139 @@
+import 'package:flutter/material.dart';
+
+import 'app_color_config.dart';
+import 'app_text_size_config.dart';
+
+/// 基于颜色和字号配置生成语义化文本样式，允许调用方按场景覆盖细节。
+class AppTextStyleConfig {
+  const AppTextStyleConfig({
+    this.colors = const AppColorConfig(),
+    this.sizes = const AppTextSizeConfig(),
+    this.fontFamily,
+  });
+
+  static AppTextStyleConfig get I => const AppTextStyleConfig();
+
+  final AppColorConfig colors;
+  final AppTextSizeConfig sizes;
+  final String? fontFamily;
+
+  TextStyle caption({
+    Color? color,
+    FontWeight? fontWeight,
+    double? height,
+  }) {
+    return _style(
+      fontSize: sizes.caption,
+      color: color ?? colors.caption,
+      fontWeight: fontWeight,
+      height: height,
+    );
+  }
+
+  TextStyle bodySmall({
+    Color? color,
+    FontWeight? fontWeight,
+    double? height,
+  }) {
+    return _style(
+      fontSize: sizes.bodySmall,
+      color: color ?? colors.titleSecondary,
+      fontWeight: fontWeight,
+      height: height,
+    );
+  }
+
+  TextStyle body({
+    Color? color,
+    FontWeight? fontWeight,
+    double? height,
+  }) {
+    return _style(
+      fontSize: sizes.body,
+      color: color ?? colors.title,
+      fontWeight: fontWeight,
+      height: height,
+    );
+  }
+
+  TextStyle bodyLarge({
+    Color? color,
+    FontWeight? fontWeight,
+    double? height,
+  }) {
+    return _style(
+      fontSize: sizes.bodyLarge,
+      color: color ?? colors.title,
+      fontWeight: fontWeight,
+      height: height,
+    );
+  }
+
+  TextStyle titleSmall({
+    Color? color,
+    FontWeight? fontWeight,
+    double? height,
+  }) {
+    return _style(
+      fontSize: sizes.titleSmall,
+      color: color ?? colors.title,
+      fontWeight: fontWeight ?? FontWeight.w600,
+      height: height,
+    );
+  }
+
+  TextStyle title({
+    Color? color,
+    FontWeight? fontWeight,
+    double? height,
+  }) {
+    return _style(
+      fontSize: sizes.title,
+      color: color ?? colors.title,
+      fontWeight: fontWeight ?? FontWeight.w600,
+      height: height,
+    );
+  }
+
+  TextStyle titleLarge({
+    Color? color,
+    FontWeight? fontWeight,
+    double? height,
+  }) {
+    return _style(
+      fontSize: sizes.titleLarge,
+      color: color ?? colors.title,
+      fontWeight: fontWeight ?? FontWeight.w700,
+      height: height,
+    );
+  }
+
+  TextStyle headline({
+    Color? color,
+    FontWeight? fontWeight,
+    double? height,
+  }) {
+    return _style(
+      fontSize: sizes.headline,
+      color: color ?? colors.title,
+      fontWeight: fontWeight ?? FontWeight.w700,
+      height: height,
+    );
+  }
+
+  TextStyle _style({
+    required double fontSize,
+    required Color color,
+    FontWeight? fontWeight,
+    double? height,
+  }) {
+    // 所有语义样式最终都落到同一个底层构造，避免模板里出现重复 TextStyle 拼装。
+    return TextStyle(
+      fontSize: fontSize,
+      color: color,
+      fontWeight: fontWeight,
+      height: height,
+      fontFamily: fontFamily,
+    );
+  }
+}