Merge branch 'linfeng/drone_scoring/dev_1.1.0/2026630' into linfeng/drone_video/dev_1.1.0/20260707

android/app/src/main/AndroidManifest.xml

@@ -22,7 +22,7 @@
         android:required="true" />
 
     <application
-        android:label="飞行极控录像工作台"
+        android:label="SportsX裁判工作台"
         android:name="${applicationName}"
         android:icon="@mipmap/ic_launcher"
         android:usesCleartextTraffic="true">

build-apk-split.sh

@@ -3,4 +3,6 @@ set -e
 
 flutter build apk --release --split-per-abi
 
-echo "构建完成时间: $(date '+%Y-%m-%d %H:%M:%S')"
+# echo "构建完成时间: $(date '+%Y-%m-%d %H:%M:%S')"
+
+pgyer upload build/app/outputs/flutter-apk/app-arm64-v8a-release.apk --build-update-description "新增可视化请求插件"

ios/Podfile.lock

@@ -1,9 +1,26 @@
 PODS:
+  - apivideo_live_stream (0.0.1):
+    - ApiVideoLiveStream (= 1.4.1)
+    - Flutter
+  - ApiVideoLiveStream (1.4.1):
+    - HaishinKit (= 1.7.3)
   - connectivity_plus (0.0.1):
     - Flutter
+  - device_info_plus (0.0.1):
+    - Flutter
   - Flutter (1.0.0)
+  - HaishinKit (1.7.3):
+    - Logboard (~> 2.4.1)
+  - Logboard (2.4.2)
+  - mobile_scanner (7.0.0):
+    - Flutter
+    - FlutterMacOS
+  - native_device_orientation (0.0.1):
+    - Flutter
   - permission_handler_apple (9.4.8):
     - Flutter
+  - share_plus (0.0.1):
+    - Flutter
   - shared_preferences_foundation (0.0.1):
     - Flutter
     - FlutterMacOS
@@ -12,36 +29,72 @@ PODS:
     - FlutterMacOS
   - url_launcher_ios (0.0.1):
     - Flutter
+  - webview_flutter_wkwebview (0.0.1):
+    - Flutter
+    - FlutterMacOS
 
 DEPENDENCIES:
+  - apivideo_live_stream (from `.symlinks/plugins/apivideo_live_stream/ios`)
   - connectivity_plus (from `.symlinks/plugins/connectivity_plus/ios`)
+  - device_info_plus (from `.symlinks/plugins/device_info_plus/ios`)
   - Flutter (from `Flutter`)
+  - mobile_scanner (from `.symlinks/plugins/mobile_scanner/darwin`)
+  - native_device_orientation (from `.symlinks/plugins/native_device_orientation/ios`)
   - permission_handler_apple (from `.symlinks/plugins/permission_handler_apple/ios`)
+  - share_plus (from `.symlinks/plugins/share_plus/ios`)
   - shared_preferences_foundation (from `.symlinks/plugins/shared_preferences_foundation/darwin`)
   - sqflite_darwin (from `.symlinks/plugins/sqflite_darwin/darwin`)
   - url_launcher_ios (from `.symlinks/plugins/url_launcher_ios/ios`)
+  - webview_flutter_wkwebview (from `.symlinks/plugins/webview_flutter_wkwebview/darwin`)
+
+SPEC REPOS:
+  trunk:
+    - ApiVideoLiveStream
+    - HaishinKit
+    - Logboard
 
 EXTERNAL SOURCES:
+  apivideo_live_stream:
+    :path: ".symlinks/plugins/apivideo_live_stream/ios"
   connectivity_plus:
     :path: ".symlinks/plugins/connectivity_plus/ios"
+  device_info_plus:
+    :path: ".symlinks/plugins/device_info_plus/ios"
   Flutter:
     :path: Flutter
+  mobile_scanner:
+    :path: ".symlinks/plugins/mobile_scanner/darwin"
+  native_device_orientation:
+    :path: ".symlinks/plugins/native_device_orientation/ios"
   permission_handler_apple:
     :path: ".symlinks/plugins/permission_handler_apple/ios"
+  share_plus:
+    :path: ".symlinks/plugins/share_plus/ios"
   shared_preferences_foundation:
     :path: ".symlinks/plugins/shared_preferences_foundation/darwin"
   sqflite_darwin:
     :path: ".symlinks/plugins/sqflite_darwin/darwin"
   url_launcher_ios:
     :path: ".symlinks/plugins/url_launcher_ios/ios"
+  webview_flutter_wkwebview:
+    :path: ".symlinks/plugins/webview_flutter_wkwebview/darwin"
 
 SPEC CHECKSUMS:
+  apivideo_live_stream: caab45dd35fb3b140d423c099d0f6672378e7abe
+  ApiVideoLiveStream: 8f9dce7f6d15d5e4bb3c7a25e406bf2a36337a5a
   connectivity_plus: cb623214f4e1f6ef8fe7403d580fdad517d2f7dd
+  device_info_plus: 21fcca2080fbcd348be798aa36c3e5ed849eefbe
   Flutter: cabc95a1d2626b1b06e7179b784ebcf0c0cde467
+  HaishinKit: 326e27c4d06427ba53bffc68e516a92033293051
+  Logboard: 759d82599c439945d430d5a0958455b5a1974a0c
+  mobile_scanner: 9157936403f5a0644ca3779a38ff8404c5434a93
+  native_device_orientation: d6a4dc6887cd8a5ce1049962367aec60139ea0f1
   permission_handler_apple: 92d754bbaa7361d436db2d6c3c1c2a0fdcec462e
+  share_plus: 50da8cb520a8f0f65671c6c6a99b3617ed10a58a
   shared_preferences_foundation: 7036424c3d8ec98dfe75ff1667cb0cd531ec82bb
   sqflite_darwin: 20b2a3a3b70e43edae938624ce550a3cbf66a3d0
   url_launcher_ios: 7a95fa5b60cc718a708b8f2966718e93db0cef1b
+  webview_flutter_wkwebview: 8ebf4fded22593026f7dbff1fbff31ea98573c8d
 
 PODFILE CHECKSUM: 858401fbd980bedce6ecd2f9b429bf271f11f74b
 

lib/app/bootstrap.dart

@@ -3,10 +3,14 @@ import 'dart:async';
 import 'package:flutter/material.dart';
 import 'package:flutter/services.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:flutter_ume/flutter_ume.dart';
+import 'package:flutter_ume_kit_device/components/device_info/device_info_panel.dart';
+import 'package:flutter_ume_kit_dio/flutter_ume_kit_dio.dart';
 import 'package:recording_tool/app/app.dart';
 import 'package:recording_tool/app/config/app_config.dart';
 import 'package:recording_tool/core/cache/app_storage.dart';
 import 'package:recording_tool/core/logging/app_logger.dart';
+import 'package:recording_tool/core/network/app_dio.dart';
 import 'package:recording_tool/core/platform/app_platform_info.dart';
 
 class AppBootstrapper {
@@ -25,7 +29,21 @@ class AppBootstrapper {
 
     AppLogger.debug('App started in ${AppConfig.current.environment.name}');
 
-    runApp(const ProviderScope(child: FlutterTemplateApp()));
+    // 注册 UME 调试插件（DioInspector 需与业务共用同一 Dio 实例）
+    PluginManager.instance
+      ..register(DioInspector(dio: AppDio.instance))
+      ..register(DeviceInfoPanel());
+
+    runApp(
+      UMEWidget(
+        enable: true,
+        child: Stack(
+          alignment: Alignment.center,
+          children: [const ProviderScope(child: FlutterTemplateApp())],
+        ),
+      ),
+    );
+    // runApp(const ProviderScope(child: FlutterTemplateApp()));
 
     // Load native package metadata after the first frame can render.
     // Awaiting MethodChannel calls before runApp() can stall the Android

lib/app/config/api_common.dart

@@ -8,6 +8,15 @@ enum AuthApi {
   /// 根据赛事目录获取视频列表
   getRecordList('/api/files'),
 
+  /// 获取参赛队伍列表
+  getTeamList('/api/events/device/item/group'),
+
+  /// 参赛队伍详情
+  getTeamDetail('/api/events/device/schedule/pending'),
+
+  /// 人工设置晋级/淘汰
+  setTeamStatus('/api/events/device/schedule/team/score'),
+
   /// 获取选手的赛事信息
   playerRegistrationList('/api/events/device/player/registration/list');
 

lib/app/config/app_config.dart

@@ -8,11 +8,13 @@ class EnvironmentValues {
     required this.environment,
     required this.baseUrl,
     required this.enableNetworkLog,
+    this.mainRefereeScoreH5Url = '',
   });
 
   final AppEnvironment environment;
   final String baseUrl;
   final bool enableNetworkLog;
+  final String mainRefereeScoreH5Url;
 }
 
 class AppConfig {
@@ -21,8 +23,10 @@ class AppConfig {
   static late EnvironmentValues current;
   static AppPackageInfo? packageInfo;
 
-  static const appName = '飞行极控录像工作台';
+  static const appName = 'SportsX裁判工作台';
-  static const designSize = Size(375, 812);
+  static const designSize = Size(640, 1024);
+
+  /// 主裁判计分 H5 链接
 
   static void configure({
     required AppEnvironment environment,
@@ -34,16 +38,22 @@ class AppConfig {
         environment: AppEnvironment.dev,
         // baseUrl: 'http://192.168.1.104:8000',
         baseUrl: 'https://apitest.dronex.cc',
+        mainRefereeScoreH5Url:
+            'https://drone.apptest.sportsx.cc/#/pages/h5/score-entry',
         enableNetworkLog: true,
       ),
       AppEnvironment.staging => const EnvironmentValues(
         environment: AppEnvironment.staging,
         baseUrl: 'https://apitest.dronex.cc',
+        mainRefereeScoreH5Url:
+            'https://drone.apptest.sportsx.cc/#/pages/h5/score-entry',
         enableNetworkLog: true,
       ),
       AppEnvironment.prod => const EnvironmentValues(
         environment: AppEnvironment.prod,
         baseUrl: 'https://api.dronex.cc',
+        mainRefereeScoreH5Url:
+            'https://drone.sportsx.cc/#/pages/h5/score-entry',
         enableNetworkLog: false,
       ),
     };

lib/core/network/app_dio.dart

@@ -0,0 +1,21 @@
+import 'package:dio/dio.dart';
+import 'package:recording_tool/app/config/app_config.dart';
+
+/// 应用全局 Dio 单例，供业务请求与调试插件共用。
+class AppDio {
+  AppDio._();
+
+  static Dio? _instance;
+
+  static Dio get instance {
+    return _instance ??= Dio(
+      BaseOptions(
+        baseUrl: AppConfig.current.baseUrl,
+        connectTimeout: const Duration(seconds: 30),
+        receiveTimeout: const Duration(seconds: 30),
+        sendTimeout: const Duration(seconds: 30),
+        responseType: ResponseType.json,
+      ),
+    );
+  }
+}

lib/core/network/header_interceptor.dart

@@ -2,9 +2,12 @@ import 'dart:io';
 
 import 'package:dio/dio.dart';
 import 'package:recording_tool/app/config/app_config.dart';
+import 'package:recording_tool/app/router/app_navigator.dart';
 import 'package:recording_tool/core/cache/app_storage.dart';
 import 'package:recording_tool/core/cache/storage_keys.dart';
 import 'package:recording_tool/core/utils/device_utils.dart';
+import 'package:recording_tool/features/auth/pages/page_auth.dart';
+import 'package:recording_tool/shared/widgets/app_toast.dart';
 
 class HeaderInterceptor extends Interceptor {
   @override
@@ -36,6 +39,8 @@ class HeaderInterceptor extends Interceptor {
   ) async {
     if (err.response?.statusCode == 401) {
       await AppStorage.remove(StorageKeys.authToken);
+      AppToast.show('口令已过期，请重新输入执裁口令');
+      AppNavigator.pushAndRemoveUntil(AuthPageWidget());
     }
     handler.next(err);
   }

lib/core/network/providers/dio_providers.dart

@@ -2,36 +2,36 @@ import 'package:dio/dio.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:recording_tool/app/config/app_config.dart';
 import 'package:recording_tool/core/network/api_client.dart';
+import 'package:recording_tool/core/network/app_dio.dart';
 import 'package:recording_tool/core/network/header_interceptor.dart';
 import 'package:recording_tool/core/network/offline_queue/offline_queue_interceptor.dart';
 import 'package:recording_tool/core/network/providers/network_providers.dart';
 import 'package:recording_tool/core/network/providers/offline_queue_providers.dart';
 
+bool _dioConfigured = false;
+
 final dioProvider = Provider<Dio>((ref) {
-  final dio = Dio(
+  final dio = AppDio.instance;
-    BaseOptions(
-      baseUrl: AppConfig.current.baseUrl,
-      connectTimeout: const Duration(seconds: 30),
-      receiveTimeout: const Duration(seconds: 30),
-      sendTimeout: const Duration(seconds: 30),
-      responseType: ResponseType.json,
-    ),
-  );
 
-  dio.interceptors.add(HeaderInterceptor());
+  if (!_dioConfigured) {
+    _dioConfigured = true;
+    dio.interceptors.add(HeaderInterceptor());
 
-  final monitor = ref.watch(networkMonitorProvider);
+    final monitor = ref.read(networkMonitorProvider);
-  final queueManager = ref.watch(offlineQueueManagerProvider);
+    final queueManager = ref.read(offlineQueueManagerProvider);
-  dio.interceptors.add(
+    dio.interceptors.add(
-    OfflineQueueInterceptor(
+      OfflineQueueInterceptor(
-      monitor: monitor,
+        monitor: monitor,
-      manager: queueManager,
+        manager: queueManager,
-      enabled: false,
+        enabled: false,
-    ),
+      ),
-  );
+    );
 
-  if (AppConfig.current.enableNetworkLog) {
+    if (AppConfig.current.enableNetworkLog) {
-    dio.interceptors.add(LogInterceptor(requestBody: true, responseBody: true));
+      dio.interceptors.add(
+        LogInterceptor(requestBody: true, responseBody: true),
+      );
+    }
   }
 
   return dio;

lib/features/auth/model/model_jwt.dart

@@ -15,9 +15,9 @@ class JwtDecodedData {
   int? deviceId;
   String? deviceRole;
   String? eventName;
-  double? oId;
+  String? oId;
-  List<double>? oIds;
+  List<String>? oIds;
-  double? organizerId;
+  String? organizerId;
 
   JwtDecodedData({
     this.authType,
@@ -31,26 +31,33 @@ class JwtDecodedData {
   });
 
   factory JwtDecodedData.fromJson(Map<String, dynamic> json) => JwtDecodedData(
-    authType: json["authType"],
+    authType: json['authType']?.toString(),
-    deviceCode: json["deviceCode"],
+    deviceCode: json['deviceCode']?.toString(),
-    deviceId: json["deviceId"],
+    deviceId: _readInt(json['deviceId']),
-    deviceRole: json["deviceRole"],
+    deviceRole: json['deviceRole']?.toString(),
-    eventName: json["eventName"],
+    eventName: json['eventName']?.toString(),
-    oId: json["oId"]?.toDouble(),
+    oId: json['oId']?.toString(),
-    oIds: json["oIds"] == null
+    oIds: json['oIds'] == null
         ? []
-        : List<double>.from(json["oIds"]!.map((x) => x?.toDouble())),
+        : List<String>.from(json['oIds']!.map((x) => x?.toString())),
-    organizerId: json["organizerId"]?.toDouble(),
+    organizerId: json['organizerId']?.toString(),
   );
 
   Map<String, dynamic> toJson() => {
-    "authType": authType,
+    'authType': authType,
-    "deviceCode": deviceCode,
+    'deviceCode': deviceCode,
-    "deviceId": deviceId,
+    'deviceId': deviceId,
-    "deviceRole": deviceRole,
+    'deviceRole': deviceRole,
-    "eventName": eventName,
+    'eventName': eventName,
-    "oId": oId,
+    'oId': oId,
-    "oIds": oIds == null ? [] : List<dynamic>.from(oIds!.map((x) => x)),
+    'oIds': oIds == null ? [] : List<dynamic>.from(oIds!.map((x) => x)),
-    "organizerId": organizerId,
+    'organizerId': organizerId,
   };
 }
+
+int? _readInt(dynamic value) {
+  if (value == null) return null;
+  if (value is int) return value;
+  if (value is num) return value.toInt();
+  return int.tryParse(value.toString());
+}

lib/features/auth/pages/page_auth.dart

@@ -1,15 +1,20 @@
 import 'dart:async';
 
 import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:flutter_screenutil/flutter_screenutil.dart';
 import 'package:recording_tool/app/router/app_navigator.dart';
 import 'package:recording_tool/core/cache/app_storage.dart';
 import 'package:recording_tool/core/cache/storage_keys.dart';
+import 'package:recording_tool/core/utils/device_utils.dart';
 import 'package:recording_tool/core/utils/util_search_nasIp.dart';
 import 'package:recording_tool/features/auth/view_model_auth/view_model_auth.dart';
 import 'package:recording_tool/features/scan_qrcode/pages/page_scan_qrcode.dart';
-import 'package:recording_tool/shared/widgets/widgets.dart';
+import 'package:recording_tool/gen/assets.gen.dart';
+import 'package:recording_tool/shared/widgets/app_button.dart';
+import 'package:recording_tool/shared/widgets/app_dialog.dart';
+import 'package:recording_tool/shared/widgets/app_toast.dart';
 
 class AuthPageWidget extends ConsumerStatefulWidget {
   const AuthPageWidget({super.key});
@@ -19,13 +24,12 @@ class AuthPageWidget extends ConsumerStatefulWidget {
 }
 
 class _AuthPageWidgetState extends ConsumerState<AuthPageWidget> {
-  late TextEditingController? _controller;
+  late final TextEditingController _controller;
 
   @override
   void initState() {
     super.initState();
-    _controller = TextEditingController();
+    _controller = TextEditingController(text: '999779');
-    _controller?.text = '555';
 
     WidgetsBinding.instance.addPostFrameCallback((_) async {
       // 静默探测 NAS，不阻塞登录 / 自动跳转
@@ -40,7 +44,7 @@ class _AuthPageWidgetState extends ConsumerState<AuthPageWidget> {
 
   @override
   void dispose() {
-    _controller?.dispose();
+    _controller.dispose();
     super.dispose();
   }
 
@@ -48,52 +52,204 @@ class _AuthPageWidgetState extends ConsumerState<AuthPageWidget> {
   Widget build(BuildContext context) {
     final authState = ref.watch(authProvider);
 
-    return Center(
+    return AnnotatedRegion<SystemUiOverlayStyle>(
-      child: Column(
+      value: SystemUiOverlayStyle.dark.copyWith(
-        children: [
+        statusBarColor: Colors.transparent,
-          SizedBox(height: 180.h),
+        systemNavigationBarColor: Colors.white,
-          AppText('裁判工作台', fontSize: 30.sp),
+      ),
-          SizedBox(height: 20.h),
+      child: Scaffold(
-          Text(
+        backgroundColor: Colors.white,
-            '输入执裁口令',
+        body: Stack(
-            style: TextStyle(fontSize: 18.sp, color: Colors.black),
+          children: [
-          ),
+            Positioned(
-          SizedBox(height: 20.h),
+              top: 0,
-
+              left: 0,
-          Container(
+              right: 0,
-            padding: EdgeInsets.symmetric(horizontal: 20.w),
+              child: Image.asset(
-            child: Column(
+                _AuthAssets.pageBg,
-              children: [
+                width: double.infinity,
-                AppTextField(controller: _controller),
+                fit: BoxFit.fitWidth,
-                SizedBox(height: 20.h),
+              ),
-                SizedBox(
+            ),
-                  width: double.maxFinite,
+            SafeArea(
-                  child: AppButton(
+              child: Padding(
-                    label: '确定',
+                padding: EdgeInsets.symmetric(horizontal: 32.w),
-                    onPressed: () async {
+                child: SingleChildScrollView(
-                      final code = _controller?.text;
+                  child: Column(
-                      final success = await ref
+                    children: [
-                          .read(authProvider.notifier)
+                      SizedBox(height: 190.h),
-                          .auth(code ?? '');
+                      ClipRRect(
-                      if (!mounted) return;
+                        borderRadius: BorderRadius.circular(24.r),
-                      if (success) {
+                        child: Image.asset(
-                        AppNavigator.push(const ScanQrCodePage());
+                          _AuthAssets.appIcon,
-                        return;
+                          width: 82.w,
-                      }
+                          height: 82.w,
-                      final message = ref.read(authProvider).errorMessage;
+                          fit: BoxFit.cover,
-                      if (message != null && message.isNotEmpty) {
+                        ),
-                        AppToast.show(message);
+                      ),
-                      }
+                      SizedBox(height: 18.h),
-                    },
+                      Image.asset(
-                    variant: AppButtonVariant.secondary,
+                        _AuthAssets.appNameText,
-                    isLoading: authState.isLoading,
+                        width: 132.w,
+                        height: 28.w,
+                        fit: BoxFit.cover,
+                      ),
+                      SizedBox(height: 78.h),
+                      _PassCodeInput(controller: _controller),
+                      SizedBox(height: 20.h),
+                      _GradientConfirmButton(
+                        isLoading: authState.isLoading,
+                        onPressed: _handleSubmit,
+                      ),
+                      SizedBox(height: 20.h),
+                      AppButton(
+                        onPressed: () async {
+                          final deviceCode = await DeviceUtils.deviceCode();
+                          if (!mounted) return;
+                          AppDialog.confirm(context, title: '设备码:$deviceCode');
+                        },
+                        label: '获取设备码',
+                      ),
+                    ],
                   ),
                 ),
-              ],
+              ),
             ),
+          ],
+        ),
+      ),
+    );
+  }
+
+  Future<void> _handleSubmit() async {
+    final success = await ref
+        .read(authProvider.notifier)
+        .auth(_controller.text);
+    if (!mounted) return;
+    if (success) {
+      AppNavigator.push(const ScanQrCodePage());
+      return;
+    }
+    final message = ref.read(authProvider).errorMessage;
+    if (message != null && message.isNotEmpty) {
+      AppToast.show(message);
+    }
+  }
+}
+
+class _PassCodeInput extends StatelessWidget {
+  const _PassCodeInput({required this.controller});
+
+  final TextEditingController controller;
+
+  @override
+  Widget build(BuildContext context) {
+    return Container(
+      height: 50.h,
+      decoration: BoxDecoration(
+        color: Colors.white,
+        borderRadius: BorderRadius.circular(12.r),
+        boxShadow: [
+          BoxShadow(
+            color: Colors.black.withValues(alpha: 0.08),
+            blurRadius: 10.r,
+            offset: Offset(0, 2.h),
           ),
         ],
       ),
+      child: TextField(
+        controller: controller,
+        keyboardType: TextInputType.number,
+        textAlign: TextAlign.center,
+        maxLength: 6,
+        inputFormatters: [
+          FilteringTextInputFormatter.digitsOnly,
+          LengthLimitingTextInputFormatter(6),
+        ],
+        style: TextStyle(
+          color: const Color(0xFF2F3338),
+          fontSize: 16.sp,
+          fontWeight: FontWeight.w500,
+        ),
+        decoration: InputDecoration(
+          hintText: '请输入执裁口令',
+          hintStyle: TextStyle(
+            color: const Color(0xFFB6B9BF),
+            fontSize: 16.sp,
+            fontWeight: FontWeight.w400,
+          ),
+          counterText: '',
+          border: InputBorder.none,
+          contentPadding: EdgeInsets.symmetric(
+            horizontal: 16.w,
+            vertical: 14.h,
+          ),
+        ),
+      ),
     );
   }
 }
+
+class _GradientConfirmButton extends StatelessWidget {
+  const _GradientConfirmButton({
+    required this.isLoading,
+    required this.onPressed,
+  });
+
+  final bool isLoading;
+  final VoidCallback onPressed;
+
+  @override
+  Widget build(BuildContext context) {
+    return Opacity(
+      opacity: isLoading ? 0.72 : 1,
+      child: GestureDetector(
+        onTap: isLoading ? null : onPressed,
+        child: Container(
+          height: 50.h,
+          width: double.infinity,
+          alignment: Alignment.center,
+          decoration: BoxDecoration(
+            borderRadius: BorderRadius.circular(25.r),
+            gradient: const LinearGradient(
+              colors: [Color(0xFF268DFF), Color(0xFF5DD4F6)],
+            ),
+            boxShadow: [
+              BoxShadow(
+                color: const Color(0xFF2196F3).withValues(alpha: 0.28),
+                blurRadius: 14.r,
+                offset: Offset(0, 6.h),
+              ),
+            ],
+          ),
+          child: isLoading
+              ? SizedBox.square(
+                  dimension: 18.r,
+                  child: CircularProgressIndicator(
+                    strokeWidth: 2.r,
+                    valueColor: const AlwaysStoppedAnimation<Color>(
+                      Colors.white,
+                    ),
+                  ),
+                )
+              : Text(
+                  '确定',
+                  style: TextStyle(
+                    color: Colors.white,
+                    fontSize: 16.sp,
+                    fontWeight: FontWeight.w500,
+                  ),
+                ),
+        ),
+      ),
+    );
+  }
+}
+
+class _AuthAssets {
+  const _AuthAssets._();
+
+  static String pageBg = Assets.images.imagePageBg.path;
+  static String appIcon = Assets.images.imageAppIcon.path;
+  static String appNameText = Assets.images.imageAppNameText.path;
+}

lib/features/auth/view_model_auth/view_model_auth.dart

@@ -1,3 +1,4 @@
+import 'package:flutter/foundation.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:flutter_riverpod/legacy.dart';
 import 'package:jwt_decoder/jwt_decoder.dart';
@@ -49,12 +50,16 @@ class AuthViewModel extends StateNotifier<AuthState> {
   /// 解析 TOKEN，并更新状态
   Future<bool> parseTokenSetState(String token) async {
     final decoded = JwtDecoder.decode(token);
-    if (decoded['data'] != null && decoded['data'] is Map<String, dynamic>) {
+    final rawData = decoded['data'];
-      final data = JwtDecodedData.fromJson(decoded['data']);
+    if (rawData is! Map) return false;
+    try {
+      final data = JwtDecodedData.fromJson(Map<String, dynamic>.from(rawData));
       state = state.copyWith(jwtDecodedData: data);
       return true;
+    } catch (error) {
+      debugPrint('认证失败，请重试: $error');
+      return false;
     }
-    return false;
   }
 
   /// 获取赛事列表

lib/features/competition_teams/model/model_competition_team.dart

@@ -0,0 +1,171 @@
+class CompetitionPlayer {
+  const CompetitionPlayer({required this.id, required this.name});
+
+  final String id;
+  final String name;
+}
+
+class CompetitionTeam {
+  const CompetitionTeam({
+    required this.id,
+    required this.name,
+    required this.players,
+  });
+
+  final String id;
+  final String name;
+  final List<CompetitionPlayer> players;
+
+  String get playerNames => players.map((player) => player.name).join('、');
+}
+
+class CompetitionMatchup {
+  const CompetitionMatchup({
+    required this.id,
+    required this.teamA,
+    required this.teamB,
+    this.winnerTeamId,
+  });
+
+  final String id;
+  final CompetitionTeam teamA;
+  final CompetitionTeam teamB;
+  final String? winnerTeamId;
+
+  CompetitionMatchup copyWith({String? winnerTeamId}) {
+    return CompetitionMatchup(
+      id: id,
+      teamA: teamA,
+      teamB: teamB,
+      winnerTeamId: winnerTeamId ?? this.winnerTeamId,
+    );
+  }
+}
+
+/// 参赛项目/组别列表项（来自 /api/events/device/item/group）
+class CompetitionTeamListItem {
+  const CompetitionTeamListItem({
+    required this.eventId,
+    required this.itemId,
+    required this.name,
+    required this.groupName,
+    this.matchStartTime = '',
+    this.matchEndTime = '',
+    this.matchups = const [],
+  });
+
+  final String eventId;
+  final String itemId;
+  final String name;
+  final String groupName;
+  final String matchStartTime;
+  final String matchEndTime;
+
+  /// 对阵明细暂未由列表接口返回，默认空
+  final List<CompetitionMatchup> matchups;
+
+  String get title => groupName.isEmpty ? name : '$name （$groupName）';
+
+  String get scheduleTime {
+    if (matchStartTime.isEmpty && matchEndTime.isEmpty) return '';
+    if (matchStartTime.isNotEmpty && matchEndTime.isNotEmpty) {
+      return '$matchStartTime-$matchEndTime';
+    }
+    if (matchStartTime.isNotEmpty) return matchStartTime;
+    return matchEndTime;
+  }
+
+  factory CompetitionTeamListItem.fromJson(Map<String, dynamic> json) {
+    return CompetitionTeamListItem(
+      eventId: (json['eventId'] ?? '').toString(),
+      itemId: (json['itemId'] ?? '').toString(),
+      name: (json['name'] ?? '').toString(),
+      groupName: (json['groupName'] ?? '').toString(),
+      matchStartTime: (json['matchStartTime'] ?? '').toString(),
+      matchEndTime: (json['matchEndTime'] ?? '').toString(),
+    );
+  }
+
+  CompetitionTeamListItem copyWith({List<CompetitionMatchup>? matchups}) {
+    return CompetitionTeamListItem(
+      eventId: eventId,
+      itemId: itemId,
+      name: name,
+      groupName: groupName,
+      matchStartTime: matchStartTime,
+      matchEndTime: matchEndTime,
+      matchups: matchups ?? this.matchups,
+    );
+  }
+}
+
+class CompetitionTeamPageResult {
+  const CompetitionTeamPageResult({
+    required this.items,
+    required this.total,
+    required this.page,
+    required this.pageSize,
+  });
+
+  final List<CompetitionTeamListItem> items;
+  final int total;
+  final int page;
+  final int pageSize;
+
+  bool get hasMore => page * pageSize < total;
+
+  factory CompetitionTeamPageResult.fromJson(
+    dynamic json, {
+    required int page,
+    required int pageSize,
+  }) {
+    if (json is List) {
+      // 整表无分页：本页即全部，hasMore = false
+      final items = json
+          .whereType<Map>()
+          .map(
+            (item) => CompetitionTeamListItem.fromJson(
+              Map<String, dynamic>.from(item),
+            ),
+          )
+          .toList(growable: false);
+      final effectivePageSize = items.isEmpty ? pageSize : items.length;
+      return CompetitionTeamPageResult(
+        items: items,
+        total: items.length,
+        page: page,
+        pageSize: effectivePageSize,
+      );
+    }
+
+    if (json is Map) {
+      final map = Map<String, dynamic>.from(json);
+      final rawItems =
+          map['items'] ?? map['rows'] ?? map['list'] ?? map['records'];
+      final items = rawItems is List
+          ? rawItems
+                .whereType<Map>()
+                .map(
+                  (item) => CompetitionTeamListItem.fromJson(
+                    Map<String, dynamic>.from(item),
+                  ),
+                )
+                .toList(growable: false)
+          : const <CompetitionTeamListItem>[];
+      final total = (map['total'] as num?)?.toInt() ?? items.length;
+      return CompetitionTeamPageResult(
+        items: items,
+        total: total,
+        page: page,
+        pageSize: pageSize,
+      );
+    }
+
+    return CompetitionTeamPageResult(
+      items: const [],
+      total: 0,
+      page: page,
+      pageSize: pageSize,
+    );
+  }
+}

lib/features/competition_teams/model/model_competition_team_detail.dart

@@ -0,0 +1,174 @@
+/// 参赛队伍详情
+class CompetitionTeamDetail {
+  String? scheduleId;
+  String? itemId;
+  String? eventId;
+  String? itemName;
+  String? groupName;
+  String? matchPlace;
+  String? matchStartTime;
+  String? matchEndTime;
+  List<Matchup>? matchups;
+
+  CompetitionTeamDetail({
+    this.scheduleId,
+    this.itemId,
+    this.eventId,
+    this.itemName,
+    this.groupName,
+    this.matchPlace,
+    this.matchStartTime,
+    this.matchEndTime,
+    this.matchups,
+  });
+
+  factory CompetitionTeamDetail.fromJson(Map<String, dynamic> json) =>
+      CompetitionTeamDetail(
+        scheduleId: json['scheduleId']?.toString(),
+        itemId: json['itemId']?.toString(),
+        eventId: json['eventId']?.toString(),
+        itemName: json['itemName']?.toString(),
+        groupName: json['groupName']?.toString(),
+        matchPlace: json['matchPlace']?.toString(),
+        matchStartTime: json['matchStartTime']?.toString(),
+        matchEndTime: json['matchEndTime']?.toString(),
+        matchups: json['matchups'] == null
+            ? const []
+            : List<Matchup>.from(
+                (json['matchups'] as List).whereType<Map>().map(
+                  (x) => Matchup.fromJson(Map<String, dynamic>.from(x)),
+                ),
+              ),
+      );
+
+  /// 兼容 data 为对象或数组（取首项）
+  factory CompetitionTeamDetail.fromResponse(dynamic json) {
+    if (json is List) {
+      if (json.isEmpty) return CompetitionTeamDetail(matchups: const []);
+      final first = json.first;
+      if (first is Map) {
+        return CompetitionTeamDetail.fromJson(Map<String, dynamic>.from(first));
+      }
+      return CompetitionTeamDetail(matchups: const []);
+    }
+    if (json is Map) {
+      return CompetitionTeamDetail.fromJson(Map<String, dynamic>.from(json));
+    }
+    return CompetitionTeamDetail(matchups: const []);
+  }
+
+  Map<String, dynamic> toJson() => {
+    'scheduleId': scheduleId,
+    'itemId': itemId,
+    'eventId': eventId,
+    'itemName': itemName,
+    'groupName': groupName,
+    'matchPlace': matchPlace,
+    'matchStartTime': matchStartTime,
+    'matchEndTime': matchEndTime,
+    'matchups': matchups == null
+        ? []
+        : List<dynamic>.from(matchups!.map((x) => x.toJson())),
+  };
+}
+
+class Matchup {
+  String? matchTitle;
+  String? opponentId;
+  List<Team>? teamA;
+  List<Team>? teamB;
+
+  Matchup({this.matchTitle, this.opponentId, this.teamA, this.teamB});
+
+  factory Matchup.fromJson(Map<String, dynamic> json) => Matchup(
+    matchTitle: json['matchTitle']?.toString(),
+    opponentId: json['opponentId']?.toString(),
+    teamA: json['teamA'] == null
+        ? const []
+        : List<Team>.from(
+            (json['teamA'] as List).whereType<Map>().map(
+              (x) => Team.fromJson(Map<String, dynamic>.from(x)),
+            ),
+          ),
+    teamB: json['teamB'] == null
+        ? const []
+        : List<Team>.from(
+            (json['teamB'] as List).whereType<Map>().map(
+              (x) => Team.fromJson(Map<String, dynamic>.from(x)),
+            ),
+          ),
+  );
+
+  Map<String, dynamic> toJson() => {
+    'matchTitle': matchTitle,
+    'opponentId': opponentId,
+    'teamA': teamA == null
+        ? []
+        : List<dynamic>.from(teamA!.map((x) => x.toJson())),
+    'teamB': teamB == null
+        ? []
+        : List<dynamic>.from(teamB!.map((x) => x.toJson())),
+  };
+}
+
+class Team {
+  String? teamName;
+  List<Player>? players;
+
+  Team({this.teamName, this.players});
+
+  String get playerNames => (players ?? const <Player>[])
+      .map((player) => player.name?.trim() ?? '')
+      .where((name) => name.isNotEmpty)
+      .join('、');
+
+  /// 队长 Player.id；无队长则取首个选手
+  String? get leaderUserId {
+    final list = players ?? const <Player>[];
+    for (final player in list) {
+      final id = player.id?.trim() ?? '';
+      if (player.isLeader == true && id.isNotEmpty) return id;
+    }
+    if (list.isEmpty) return null;
+    final firstId = list.first.id?.trim() ?? '';
+    return firstId.isEmpty ? null : firstId;
+  }
+
+  factory Team.fromJson(Map<String, dynamic> json) => Team(
+    teamName: json['teamName']?.toString(),
+    players: json['players'] == null
+        ? const []
+        : List<Player>.from(
+            (json['players'] as List).whereType<Map>().map(
+              (x) => Player.fromJson(Map<String, dynamic>.from(x)),
+            ),
+          ),
+  );
+
+  Map<String, dynamic> toJson() => {
+    'teamName': teamName,
+    'players': players == null
+        ? []
+        : List<dynamic>.from(players!.map((x) => x.toJson())),
+  };
+}
+
+class Player {
+  String? id;
+  String? name;
+  bool? isLeader;
+
+  Player({this.id, this.name, this.isLeader});
+
+  factory Player.fromJson(Map<String, dynamic> json) => Player(
+    id: json['id']?.toString(),
+    name: json['name']?.toString(),
+    isLeader: json['isLeader'] as bool?,
+  );
+
+  Map<String, dynamic> toJson() => {
+    'id': id,
+    'name': name,
+    'isLeader': isLeader,
+  };
+}

lib/features/competition_teams/pages/page_competition_team_detail.dart

@@ -0,0 +1,352 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+import 'package:recording_tool/core/network/api_exception.dart';
+import 'package:recording_tool/features/competition_teams/model/model_competition_team.dart';
+import 'package:recording_tool/features/competition_teams/model/model_competition_team_detail.dart';
+import 'package:recording_tool/features/competition_teams/widgets/widget_manual_winner_dialog.dart';
+import 'package:recording_tool/features/events/request_model/request_model_event.dart';
+import 'package:recording_tool/features/events/server/server_events.dart';
+import 'package:recording_tool/shared/widgets/app_empty_view.dart';
+import 'package:recording_tool/shared/widgets/app_toast.dart';
+
+class CompetitionTeamDetailPage extends ConsumerStatefulWidget {
+  const CompetitionTeamDetailPage({super.key, required this.detail});
+
+  final CompetitionTeamDetail detail;
+
+  @override
+  ConsumerState<CompetitionTeamDetailPage> createState() =>
+      _CompetitionTeamDetailPageState();
+}
+
+class _CompetitionTeamDetailPageState
+    extends ConsumerState<CompetitionTeamDetailPage> {
+  /// matchupIndex -> winner side index（0=teamA，1=teamB）
+  final Map<int, int> _winners = {};
+
+  CompetitionTeamDetail get _detail => widget.detail;
+
+  String get _title {
+    final name = _detail.itemName?.trim() ?? '';
+    final group = _detail.groupName?.trim() ?? '';
+    if (name.isEmpty) return '参赛队伍';
+    return group.isEmpty ? name : '$name （$group）';
+  }
+
+  List<Matchup> get _matchups => _detail.matchups ?? const <Matchup>[];
+
+  CompetitionTeam _toCompetitionTeam(Team team, {required String fallbackId}) {
+    return CompetitionTeam(
+      id: team.leaderUserId ?? fallbackId,
+      name: team.teamName?.trim().isNotEmpty == true ? team.teamName! : '未命名队伍',
+      players: (team.players ?? const <Player>[])
+          .map(
+            (player) => CompetitionPlayer(
+              id: player.id?.trim() ?? '',
+              name: player.name?.trim().isNotEmpty == true
+                  ? player.name!
+                  : '选手',
+            ),
+          )
+          .toList(growable: false),
+    );
+  }
+
+  CompetitionMatchup? _toCompetitionMatchup(Matchup matchup, int index) {
+    final teamA = matchup.teamA;
+    final teamB = matchup.teamB;
+    if (teamA == null || teamA.isEmpty || teamB == null || teamB.isEmpty) {
+      return null;
+    }
+    final winnerSide = _winners[index];
+    final convertedA = _toCompetitionTeam(teamA.first, fallbackId: 'team-a');
+    final convertedB = _toCompetitionTeam(teamB.first, fallbackId: 'team-b');
+    return CompetitionMatchup(
+      id: '${_detail.scheduleId ?? _detail.itemId ?? 'match'}-$index',
+      teamA: convertedA,
+      teamB: convertedB,
+      winnerTeamId: winnerSide == 0
+          ? convertedA.id
+          : winnerSide == 1
+          ? convertedB.id
+          : null,
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final matchups = _matchups;
+
+    return Scaffold(
+      backgroundColor: Colors.white,
+      appBar: AppBar(title: Text(_title)),
+      body: matchups.isEmpty
+          ? const AppEmptyView(message: '暂无对阵信息')
+          : ListView.separated(
+              padding: EdgeInsets.fromLTRB(20.w, 24.h, 20.w, 36.h),
+              itemCount: matchups.length,
+              separatorBuilder: (_, _) => SizedBox(height: 22.h),
+              itemBuilder: (context, index) {
+                final raw = matchups[index];
+                final matchup = _toCompetitionMatchup(raw, index);
+                if (matchup == null) {
+                  return const SizedBox.shrink();
+                }
+                return _MatchupCard(
+                  matchup: matchup,
+                  index: index,
+                  matchTitle: raw.matchTitle?.trim() ?? '',
+                  onManualProcess: () => _handleManualProcess(raw, index),
+                );
+              },
+            ),
+    );
+  }
+
+  Team? _sideTeam(Matchup matchup, {required bool isTeamA}) {
+    final list = isTeamA ? matchup.teamA : matchup.teamB;
+    if (list == null || list.isEmpty) return null;
+    return list.first;
+  }
+
+  Future<void> _handleManualProcess(Matchup raw, int index) async {
+    final winnerSide = await ManualWinnerDialog.show(
+      context,
+      matchup: raw,
+      initialWinnerSideIndex: _winners[index],
+    );
+    if (winnerSide == null || !mounted) return;
+
+    final teamA = _sideTeam(raw, isTeamA: true);
+    final teamB = _sideTeam(raw, isTeamA: false);
+    final winnerTeam = winnerSide == 0 ? teamA : teamB;
+    final loserTeam = winnerSide == 0 ? teamB : teamA;
+
+    final winnerLeaderId = winnerTeam?.leaderUserId;
+    final loserLeaderId = loserTeam?.leaderUserId;
+    if (winnerLeaderId == null ||
+        winnerLeaderId.isEmpty ||
+        loserLeaderId == null ||
+        loserLeaderId.isEmpty) {
+      AppToast.show('无法识别双方队长');
+      return;
+    }
+
+    try {
+      await ref
+          .read(eventsServerProvider)
+          .setTeamStatus(
+            req: SetTeamStatusReq(
+              scheduleId: _detail.scheduleId ?? '',
+              opponentId: raw.opponentId ?? '',
+              teamScore: [
+                TeamScore(
+                  userId: winnerLeaderId,
+                  firstHalfScore: 0,
+                  secondHalfScore: 0,
+                  decisiveScore: 0,
+                  ifWithdraw: true,
+                ),
+                TeamScore(
+                  userId: loserLeaderId,
+                  firstHalfScore: 0,
+                  secondHalfScore: 0,
+                  decisiveScore: 0,
+                  ifWithdraw: false,
+                ),
+              ],
+            ),
+          );
+      if (!mounted) return;
+      setState(() => _winners[index] = winnerSide);
+      final winnerName = winnerTeam?.teamName?.trim().isNotEmpty == true
+          ? winnerTeam!.teamName!
+          : '胜方';
+      AppToast.show('已设置$winnerName直接获胜');
+    } catch (error) {
+      if (!mounted) return;
+      final message = error is ApiException && error.message.isNotEmpty
+          ? error.message
+          : '设置失败，请重试';
+      AppToast.show(message);
+    }
+  }
+}
+
+class _MatchupCard extends StatelessWidget {
+  const _MatchupCard({
+    required this.matchup,
+    required this.index,
+    required this.matchTitle,
+    required this.onManualProcess,
+  });
+
+  final CompetitionMatchup matchup;
+  final int index;
+  final String matchTitle;
+  final VoidCallback onManualProcess;
+
+  @override
+  Widget build(BuildContext context) {
+    final title = matchTitle.isEmpty ? '第 ${index + 1} 场' : matchTitle;
+    return Container(
+      key: ValueKey('competition-matchup-${matchup.id}'),
+      padding: EdgeInsets.fromLTRB(16.w, 10.h, 16.w, 18.h),
+      decoration: BoxDecoration(
+        color: Colors.white,
+        border: Border.all(color: const Color(0xFFC7CCD4)),
+        borderRadius: BorderRadius.circular(12.r),
+      ),
+      child: Column(
+        children: [
+          Row(
+            children: [
+              Expanded(
+                child: Text(
+                  title,
+                  maxLines: 1,
+                  overflow: TextOverflow.ellipsis,
+                  style: TextStyle(
+                    fontSize: 14.sp,
+                    color: const Color(0xFF7A828E),
+                  ),
+                ),
+              ),
+              TextButton(
+                key: ValueKey('manual-process-${matchup.id}'),
+                onPressed: onManualProcess,
+                child: Text(
+                  '人工处理',
+                  style: TextStyle(
+                    fontSize: 17.sp,
+                    fontWeight: FontWeight.w600,
+                    color: const Color(0xFF078AF2),
+                  ),
+                ),
+              ),
+            ],
+          ),
+          SizedBox(height: 8.h),
+          Row(
+            crossAxisAlignment: CrossAxisAlignment.center,
+            children: [
+              Expanded(
+                child: _TeamPanel(
+                  team: matchup.teamA,
+                  alignment: CrossAxisAlignment.start,
+                  winner: matchup.winnerTeamId == matchup.teamA.id,
+                  accentColor: const Color(0xFFFF6B75),
+                ),
+              ),
+              Padding(
+                padding: EdgeInsets.symmetric(horizontal: 12.w),
+                child: Text(
+                  'VS',
+                  style: TextStyle(
+                    fontSize: 21.sp,
+                    fontWeight: FontWeight.w700,
+                    color: const Color(0xFF303640),
+                  ),
+                ),
+              ),
+              Expanded(
+                child: _TeamPanel(
+                  team: matchup.teamB,
+                  alignment: CrossAxisAlignment.end,
+                  textAlign: TextAlign.end,
+                  winner: matchup.winnerTeamId == matchup.teamB.id,
+                  accentColor: const Color(0xFF20BFA9),
+                ),
+              ),
+            ],
+          ),
+        ],
+      ),
+    );
+  }
+}
+
+class _TeamPanel extends StatelessWidget {
+  const _TeamPanel({
+    required this.team,
+    required this.alignment,
+    required this.winner,
+    required this.accentColor,
+    this.textAlign = TextAlign.start,
+  });
+
+  final CompetitionTeam team;
+  final CrossAxisAlignment alignment;
+  final TextAlign textAlign;
+  final bool winner;
+  final Color accentColor;
+
+  @override
+  Widget build(BuildContext context) {
+    return Column(
+      crossAxisAlignment: alignment,
+      children: [
+        AnimatedContainer(
+          duration: const Duration(milliseconds: 180),
+          padding: EdgeInsets.symmetric(horizontal: 8.w, vertical: 4.h),
+          decoration: BoxDecoration(
+            color: winner
+                ? accentColor.withValues(alpha: 0.14)
+                : Colors.transparent,
+            borderRadius: BorderRadius.circular(8.r),
+          ),
+          child: Row(
+            mainAxisSize: MainAxisSize.min,
+            children: [
+              Flexible(
+                child: Text(
+                  team.name,
+                  textAlign: textAlign,
+                  style: TextStyle(
+                    fontSize: 18.sp,
+                    fontWeight: FontWeight.w600,
+                    color: const Color(0xFF282E37),
+                  ),
+                ),
+              ),
+              if (winner) ...[
+                SizedBox(width: 5.w),
+                Icon(Icons.emoji_events, size: 17.r, color: accentColor),
+              ],
+            ],
+          ),
+        ),
+        SizedBox(height: 10.h),
+        Text(
+          team.playerNames,
+          textAlign: textAlign,
+          style: TextStyle(
+            fontSize: 15.sp,
+            height: 1.45,
+            color: const Color(0xFF4E5662),
+          ),
+        ),
+        if (winner) ...[
+          SizedBox(height: 8.h),
+          Container(
+            key: ValueKey('winner-${team.id}'),
+            padding: EdgeInsets.symmetric(horizontal: 9.w, vertical: 3.h),
+            decoration: BoxDecoration(
+              color: accentColor,
+              borderRadius: BorderRadius.circular(10.r),
+            ),
+            child: Text(
+              '胜方',
+              style: TextStyle(
+                fontSize: 12.sp,
+                fontWeight: FontWeight.w700,
+                color: Colors.white,
+              ),
+            ),
+          ),
+        ],
+      ],
+    );
+  }
+}

lib/features/competition_teams/pages/page_competition_team_list.dart

@@ -0,0 +1,184 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+import 'package:recording_tool/app/router/app_navigator.dart';
+import 'package:recording_tool/features/competition_teams/model/model_competition_team.dart';
+import 'package:recording_tool/features/competition_teams/pages/page_competition_team_detail.dart';
+import 'package:recording_tool/features/competition_teams/server/server_competition_teams.dart';
+import 'package:recording_tool/features/competition_teams/view_model/view_model_competition_teams.dart';
+import 'package:recording_tool/shared/widgets/app_empty_view.dart';
+import 'package:recording_tool/shared/widgets/app_error_view.dart';
+import 'package:recording_tool/shared/widgets/app_loading_view.dart';
+import 'package:recording_tool/shared/widgets/app_refresh_list.dart';
+import 'package:recording_tool/shared/widgets/app_toast.dart';
+
+class CompetitionTeamListPage extends ConsumerStatefulWidget {
+  const CompetitionTeamListPage({super.key});
+
+  @override
+  ConsumerState<CompetitionTeamListPage> createState() =>
+      _CompetitionTeamListPageState();
+}
+
+class _CompetitionTeamListPageState
+    extends ConsumerState<CompetitionTeamListPage> {
+  @override
+  void initState() {
+    super.initState();
+    WidgetsBinding.instance.addPostFrameCallback((_) {
+      ref.read(competitionTeamsProvider.notifier).loadInitial();
+    });
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final state = ref.watch(competitionTeamsProvider);
+    return Scaffold(
+      backgroundColor: Colors.white,
+      appBar: AppBar(title: const Text('参赛队伍')),
+      body: SafeArea(
+        top: false,
+        child: Builder(
+          builder: (context) {
+            if (state.isInitialLoading && state.items.isEmpty) {
+              return const AppLoadingView(message: '正在加载参赛队伍...');
+            }
+            if (state.errorMessage != null && state.items.isEmpty) {
+              return AppErrorView(
+                message: state.errorMessage!,
+                onRetry: () =>
+                    ref.read(competitionTeamsProvider.notifier).loadInitial(),
+              );
+            }
+
+            return AppRefreshList<CompetitionTeamListItem>(
+              items: state.items,
+              onRefresh: ref.read(competitionTeamsProvider.notifier).refresh,
+              onLoadMore: ref.read(competitionTeamsProvider.notifier).loadMore,
+              enablePullUp: state.hasMore,
+              padding: EdgeInsets.fromLTRB(20.w, 18.h, 20.w, 28.h),
+              separator: SizedBox(height: 14.h),
+              empty: const AppEmptyView(message: '暂无参赛队伍'),
+              itemBuilder: (context, item, index) {
+                return _CompetitionScheduleCard(
+                  item: item,
+                  onTap: () async {
+                    try {
+                      final detail = await ref
+                          .read(competitionTeamsServerProvider)
+                          .fetchTeamDetail(
+                            itemId: item.itemId,
+                            eventId: item.eventId,
+                          );
+                      if (!context.mounted) return;
+                      AppNavigator.push(
+                        CompetitionTeamDetailPage(detail: detail),
+                        context: context,
+                      );
+                    } catch (error) {
+                      AppToast.show('对阵详情加载失败，请重试');
+                    }
+                  },
+                );
+              },
+            );
+          },
+        ),
+      ),
+    );
+  }
+}
+
+class _CompetitionScheduleCard extends StatelessWidget {
+  const _CompetitionScheduleCard({required this.item, required this.onTap});
+
+  final CompetitionTeamListItem item;
+  final VoidCallback onTap;
+
+  @override
+  Widget build(BuildContext context) {
+    final scheduleText = item.scheduleTime.isEmpty ? '时间待定' : item.scheduleTime;
+
+    return Material(
+      key: ValueKey('competition-team-item-${item.itemId}'),
+      color: Colors.white,
+      borderRadius: BorderRadius.circular(14.r),
+      child: InkWell(
+        onTap: onTap,
+        borderRadius: BorderRadius.circular(14.r),
+        child: Container(
+          constraints: BoxConstraints(minHeight: 142.h),
+          padding: EdgeInsets.all(16.r),
+          decoration: BoxDecoration(
+            borderRadius: BorderRadius.circular(14.r),
+            border: Border.all(color: const Color(0xFFD7DBE2)),
+            boxShadow: const [
+              BoxShadow(
+                color: Color(0x0F1A2230),
+                blurRadius: 16,
+                offset: Offset(0, 6),
+              ),
+            ],
+          ),
+          child: Row(
+            children: [
+              Expanded(
+                child: Column(
+                  crossAxisAlignment: CrossAxisAlignment.start,
+                  children: [
+                    Text(
+                      item.title,
+                      maxLines: 1,
+                      overflow: TextOverflow.ellipsis,
+                      style: TextStyle(
+                        fontSize: 19.sp,
+                        fontWeight: FontWeight.w600,
+                        color: const Color(0xFF20242B),
+                      ),
+                    ),
+                    SizedBox(height: 18.h),
+                    _InfoLine(
+                      icon: Icons.schedule_outlined,
+                      text: scheduleText,
+                    ),
+                  ],
+                ),
+              ),
+              SizedBox(width: 14.w),
+              Icon(
+                Icons.chevron_right,
+                size: 28.r,
+                color: const Color(0xFF9AA3AF),
+              ),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+}
+
+class _InfoLine extends StatelessWidget {
+  const _InfoLine({required this.icon, required this.text});
+
+  final IconData icon;
+  final String text;
+
+  @override
+  Widget build(BuildContext context) {
+    return Row(
+      children: [
+        Icon(icon, size: 18.r, color: const Color(0xFF7B8491)),
+        SizedBox(width: 8.w),
+        Expanded(
+          child: Text(
+            text,
+            maxLines: 1,
+            overflow: TextOverflow.ellipsis,
+            style: TextStyle(fontSize: 15.sp, color: const Color(0xFF525B68)),
+          ),
+        ),
+      ],
+    );
+  }
+}

lib/features/competition_teams/pages/page_event_team_match.dart

@@ -0,0 +1,717 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+import 'package:recording_tool/app/config/app_config.dart';
+import 'package:recording_tool/app/router/app_navigator.dart';
+import 'package:recording_tool/core/network/api_exception.dart';
+import 'package:recording_tool/features/competition_teams/model/model_competition_team.dart';
+import 'package:recording_tool/features/competition_teams/model/model_competition_team_detail.dart';
+import 'package:recording_tool/features/competition_teams/widgets/widget_manual_winner_dialog.dart';
+import 'package:recording_tool/features/events/model/model_event_info.dart';
+import 'package:recording_tool/features/events/request_model/request_model_event.dart';
+import 'package:recording_tool/features/events/server/server_events.dart';
+import 'package:recording_tool/gen/assets.gen.dart';
+import 'package:recording_tool/shared/widgets/app_bar.dart';
+import 'package:recording_tool/shared/widgets/app_qr_scanner_dialog.dart';
+import 'package:recording_tool/shared/widgets/app_toast.dart';
+import 'package:recording_tool/shared/widgets/app_webview.dart';
+
+typedef TeamQrScanner = Future<String?> Function(BuildContext context);
+
+class EventTeamMatchPage extends ConsumerStatefulWidget {
+  const EventTeamMatchPage({
+    super.key,
+    required this.playerId,
+    this.qrScanner,
+    required this.detail,
+    required this.item,
+  });
+
+  final CompetitionTeamDetail detail;
+  final String playerId;
+  final TeamQrScanner? qrScanner;
+  final EventRegistrationItem item;
+
+  @override
+  ConsumerState<EventTeamMatchPage> createState() => _EventTeamMatchPageState();
+}
+
+class _EventTeamMatchPageState extends ConsumerState<EventTeamMatchPage> {
+  final Set<String> _verifiedUserIds = <String>{};
+
+  /// 0 = 红队(teamA)，1 = 蓝队(teamB)
+  int? _winnerSideIndex;
+
+  CompetitionTeamDetail get _detail => widget.detail;
+
+  /// 备注：teamA 为红队，teamB 为蓝队。
+  Matchup? get _firstMatchup {
+    final matchups = _detail.matchups;
+    if (matchups == null || matchups.isEmpty) return null;
+    return matchups.first;
+  }
+
+  /// 红队（teamA）
+  Team? get _redRawTeam {
+    final teams = _firstMatchup?.teamA;
+    if (teams == null || teams.isEmpty) return null;
+    return teams.first;
+  }
+
+  /// 蓝队（teamB）
+  Team? get _blueRawTeam {
+    final teams = _firstMatchup?.teamB;
+    if (teams == null || teams.isEmpty) return null;
+    return teams.first;
+  }
+
+  CompetitionTeam get _redTeam => _toCompetitionTeam(
+    _redRawTeam,
+    fallbackId: 'red-team',
+    fallbackName: '红队',
+  );
+
+  CompetitionTeam get _blueTeam => _toCompetitionTeam(
+    _blueRawTeam,
+    fallbackId: 'blue-team',
+    fallbackName: '蓝队',
+  );
+
+  List<EventTeamMember> get _redMembers =>
+      _toEventMembers(_redRawTeam?.players);
+
+  List<EventTeamMember> get _blueMembers =>
+      _toEventMembers(_blueRawTeam?.players);
+
+  CompetitionTeam _toCompetitionTeam(
+    Team? team, {
+    required String fallbackId,
+    required String fallbackName,
+  }) {
+    final id = team?.leaderUserId ?? '';
+    final name = team?.teamName?.trim() ?? '';
+    final players = (team?.players ?? const <Player>[])
+        .map(
+          (player) => CompetitionPlayer(
+            id: player.id?.trim() ?? '',
+            name: player.name?.trim() ?? '',
+          ),
+        )
+        .toList(growable: false);
+    return CompetitionTeam(
+      id: id.isNotEmpty ? id : fallbackId,
+      name: name.isNotEmpty ? name : fallbackName,
+      players: players,
+    );
+  }
+
+  List<EventTeamMember> _toEventMembers(List<Player>? players) {
+    if (players == null || players.isEmpty) return const [];
+    return players
+        .map(
+          (player) => EventTeamMember(
+            userId: player.id?.trim() ?? '',
+            name: player.name?.trim() ?? '',
+            isLeader: player.isLeader ?? false,
+          ),
+        )
+        .toList(growable: false);
+  }
+
+  @override
+  void initState() {
+    super.initState();
+    final initialPlayerId = widget.playerId.trim();
+    if (_isKnownMember(initialPlayerId)) {
+      _verifiedUserIds.add(initialPlayerId);
+    }
+  }
+
+  bool _isKnownMember(String userId) {
+    if (userId.isEmpty) return false;
+    return _redMembers.any((member) => member.userId == userId) ||
+        _blueMembers.any((member) => member.userId == userId);
+  }
+
+  String _memberNameOf(String userId) {
+    for (final member in [..._redMembers, ..._blueMembers]) {
+      if (member.userId == userId) {
+        return member.name.isEmpty ? '参赛成员' : member.name;
+      }
+    }
+    return '';
+  }
+
+  Future<void> _continueScan() async {
+    final scan = widget.qrScanner ?? AppQrScannerDialog.show;
+    final result = (await scan(context))?.trim();
+    if (!mounted || result == null || result.isEmpty) return;
+    if (!_isKnownMember(result)) {
+      AppToast.show('未找到对应参赛成员');
+      return;
+    }
+    if (_verifiedUserIds.contains(result)) {
+      AppToast.show('${_memberNameOf(result)}已完成核验');
+      return;
+    }
+    setState(() => _verifiedUserIds.add(result));
+    AppToast.show('${_memberNameOf(result)}核验成功');
+  }
+
+  Future<void> _manualProcess() async {
+    final matchup = _firstMatchup;
+    if (matchup == null) {
+      AppToast.show('暂无对阵信息');
+      return;
+    }
+
+    final winnerSide = await ManualWinnerDialog.show(
+      context,
+      matchup: matchup,
+      initialWinnerSideIndex: _winnerSideIndex,
+    );
+    if (!mounted || winnerSide == null) return;
+
+    final winnerTeam = winnerSide == 0 ? _redRawTeam : _blueRawTeam;
+    final loserTeam = winnerSide == 0 ? _blueRawTeam : _redRawTeam;
+
+    final winnerLeaderId = winnerTeam?.leaderUserId;
+    final loserLeaderId = loserTeam?.leaderUserId;
+    if (winnerLeaderId == null ||
+        winnerLeaderId.isEmpty ||
+        loserLeaderId == null ||
+        loserLeaderId.isEmpty) {
+      AppToast.show('无法识别双方队长');
+      return;
+    }
+
+    try {
+      await ref
+          .read(eventsServerProvider)
+          .setTeamStatus(
+            req: SetTeamStatusReq(
+              scheduleId: _detail.scheduleId ?? '',
+              opponentId: widget.item.opponentId,
+              teamScore: [
+                TeamScore(
+                  userId: winnerLeaderId,
+                  firstHalfScore: 0,
+                  secondHalfScore: 0,
+                  decisiveScore: 0,
+                  ifWithdraw: true,
+                ),
+                TeamScore(
+                  userId: loserLeaderId,
+                  firstHalfScore: 0,
+                  secondHalfScore: 0,
+                  decisiveScore: 0,
+                  ifWithdraw: false,
+                ),
+              ],
+            ),
+          );
+      if (!mounted) return;
+      setState(() => _winnerSideIndex = winnerSide);
+      final winnerName = winnerTeam?.teamName?.trim().isNotEmpty == true
+          ? winnerTeam!.teamName!
+          : (winnerSide == 0 ? _redTeam.name : _blueTeam.name);
+      AppToast.show('已设置$winnerName直接获胜');
+    } catch (error) {
+      if (!mounted) return;
+      final message = error is ApiException && error.message.isNotEmpty
+          ? error.message
+          : '设置失败，请重试';
+      AppToast.show(message);
+    }
+  }
+
+  void _startDirectly() {
+    AppNavigator.push(
+      buildTeamScorePage(item: widget.item, playerId: widget.playerId),
+      context: context,
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final redTeam = _redTeam;
+    final blueTeam = _blueTeam;
+    return Scaffold(
+      backgroundColor: const Color(0xFFF6F7F9),
+      appBar: myAppBar(
+        context: context,
+        titleWidget: Text(
+          '选手检录',
+          style: TextStyle(
+            fontSize: 14.sp,
+            fontWeight: FontWeight.w500,
+            color: Colors.white,
+            fontFamily: 'PingFang SC',
+          ),
+        ),
+        actions: [
+          TextButton(
+            key: const ValueKey('event-team-manual-process'),
+            onPressed: _manualProcess,
+            style: TextButton.styleFrom(
+              foregroundColor: Colors.white,
+              padding: EdgeInsets.symmetric(horizontal: 14.w),
+              minimumSize: Size(72.w, kToolbarHeight),
+              tapTargetSize: MaterialTapTargetSize.shrinkWrap,
+            ),
+            child: Text(
+              '人工处理',
+              style: TextStyle(
+                fontSize: 14.sp,
+                fontWeight: FontWeight.w500,
+                color: Colors.white.withValues(alpha: 0.8),
+                fontFamily: 'PingFang SC',
+              ),
+            ),
+          ),
+        ],
+      ),
+      body: SafeArea(
+        top: false,
+        child: Column(
+          children: [
+            // SizedBox(height: 10.h),
+            _MatchMetadata(detail: _detail),
+            // SizedBox(height: 12.h),
+            Expanded(
+              child: SingleChildScrollView(
+                padding: EdgeInsets.symmetric(horizontal: 0.w, vertical: 20.h),
+                child: Column(
+                  crossAxisAlignment: CrossAxisAlignment.start,
+                  children: [
+                    _TeamCard(
+                      sideLabel: '红方',
+                      team: redTeam,
+                      members: _redMembers,
+                      backgroundImage: Assets.images.imageRedTeam.path,
+                      accentColor: const Color(0xFFE84B5B),
+                      verifiedUserIds: _verifiedUserIds,
+                      winner: _winnerSideIndex == 0,
+                    ),
+                    SizedBox(height: 8.h),
+                    _TeamCard(
+                      sideLabel: '蓝方',
+                      team: blueTeam,
+                      members: _blueMembers,
+                      backgroundImage: Assets.images.imageBlueTeam.path,
+                      accentColor: const Color(0xFF287FDD),
+                      verifiedUserIds: _verifiedUserIds,
+                      winner: _winnerSideIndex == 1,
+                      emptyMessage: '暂无蓝队成员数据',
+                    ),
+                  ],
+                ),
+              ),
+            ),
+            Padding(
+              padding: EdgeInsets.fromLTRB(16.w, 16.h, 16.w, 24.h),
+              child: Column(
+                children: [
+                  _TeamActionButton(
+                    label: '继续扫码',
+                    iconPath: Assets.images.imageScan.path,
+                    onPressed: _continueScan,
+                    filled: true,
+                  ),
+                  SizedBox(height: 12.h),
+                  _TeamActionButton(
+                    label: '直接开赛',
+                    iconPath: 'assets/images/image_start.png',
+                    onPressed: _startDirectly,
+                  ),
+                ],
+              ),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}
+
+WebviewPage buildTeamScorePage({
+  required EventRegistrationItem item,
+  required String playerId,
+}) {
+  return WebviewPage(
+    url: AppConfig.current.mainRefereeScoreH5Url,
+    eventRegistrationItem: item,
+    playerId: playerId,
+  );
+}
+
+class _MatchMetadata extends StatelessWidget {
+  const _MatchMetadata({required this.detail});
+
+  final CompetitionTeamDetail detail;
+
+  @override
+  Widget build(BuildContext context) {
+    final itemName = detail.itemName?.trim() ?? '';
+    final matchPlace = detail.matchPlace?.trim() ?? '';
+    final groupName = detail.groupName?.trim() ?? '';
+    return Container(
+      width: double.infinity,
+      padding: EdgeInsets.symmetric(horizontal: 8.w, vertical: 12.h),
+      decoration: BoxDecoration(
+        color: Colors.white,
+        boxShadow: [
+          BoxShadow(
+            color: Colors.black.withValues(alpha: 0.04),
+            blurRadius: 12.r,
+            offset: Offset(0, 4.h),
+          ),
+        ],
+      ),
+      child: Row(
+        children: [
+          Expanded(
+            child: _MetadataText(label: '场地', value: matchPlace),
+          ),
+          SizedBox(width: 6.w),
+          Expanded(
+            child: _MetadataText(label: '赛项', value: itemName),
+          ),
+          SizedBox(width: 6.w),
+          Expanded(
+            child: _MetadataText(label: '组别', value: groupName),
+          ),
+        ],
+      ),
+    );
+  }
+}
+
+class _MetadataText extends StatelessWidget {
+  const _MetadataText({required this.label, required this.value});
+
+  final String label;
+  final String value;
+
+  @override
+  Widget build(BuildContext context) {
+    return Text(
+      '$label：${value.isEmpty ? '暂无' : value}',
+      maxLines: 1,
+      overflow: TextOverflow.ellipsis,
+      style: TextStyle(
+        fontSize: 13.sp,
+        height: 1.35,
+        color: const Color(0xFF858B95),
+        fontWeight: FontWeight.w600,
+        fontFamily: 'PingFang SC',
+      ),
+    );
+  }
+}
+
+class _TeamCard extends StatelessWidget {
+  const _TeamCard({
+    required this.sideLabel,
+    required this.team,
+    required this.members,
+    required this.backgroundImage,
+    required this.accentColor,
+    required this.verifiedUserIds,
+    required this.winner,
+    this.emptyMessage = '暂无成员数据',
+  });
+
+  final String sideLabel;
+  final CompetitionTeam team;
+  final List<EventTeamMember> members;
+  final String backgroundImage;
+  final Color accentColor;
+  final Set<String> verifiedUserIds;
+  final bool winner;
+  final String emptyMessage;
+
+  @override
+  Widget build(BuildContext context) {
+    final visibleMembers = members
+        .where((member) => member.userId.isNotEmpty || member.name.isNotEmpty)
+        .toList(growable: false);
+    final leader = _leaderOf(visibleMembers);
+    final players = visibleMembers
+        .where((member) => !identical(member, leader))
+        .toList(growable: false);
+    final leaderVerified =
+        leader != null && verifiedUserIds.contains(leader.userId);
+    return Container(
+      width: double.infinity,
+      constraints: BoxConstraints(minHeight: 106.h),
+      padding: EdgeInsets.fromLTRB(12.w, 16.h, 16.w, 12.h),
+      decoration: BoxDecoration(
+        image: DecorationImage(
+          image: AssetImage(backgroundImage),
+          fit: BoxFit.fill,
+        ),
+        color: Colors.white,
+      ),
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          Row(
+            crossAxisAlignment: CrossAxisAlignment.center,
+            children: [
+              Expanded(
+                child: Text(
+                  '$sideLabel队伍名称：${team.name}队伍',
+                  maxLines: 1,
+                  overflow: TextOverflow.ellipsis,
+                  style: TextStyle(
+                    fontSize: 16.sp,
+                    fontWeight: FontWeight.w700,
+                    color: const Color(0xFF30343B),
+                    fontFamily: 'PingFang SC',
+                  ),
+                ),
+              ),
+              if (winner)
+                Container(
+                  key: ValueKey('event-team-winner-${team.id}'),
+                  padding: EdgeInsets.symmetric(
+                    horizontal: 10.w,
+                    vertical: 4.h,
+                  ),
+                  decoration: BoxDecoration(
+                    color: accentColor,
+                    borderRadius: BorderRadius.circular(12.r),
+                  ),
+                  child: Text(
+                    '胜方',
+                    style: TextStyle(
+                      color: Colors.white,
+                      fontSize: 11.sp,
+                      fontWeight: FontWeight.w700,
+                      fontFamily: 'PingFang SC',
+                    ),
+                  ),
+                ),
+            ],
+          ),
+          SizedBox(height: 6.h),
+          if (visibleMembers.isEmpty)
+            Text(
+              emptyMessage,
+              style: TextStyle(
+                fontSize: 13.sp,
+                color: const Color(0xFF747D89),
+                fontFamily: 'PingFang SC',
+              ),
+            )
+          else ...[
+            if (leader != null)
+              _TeamTextLine(
+                label: '队长',
+                text: _formatMember(leader),
+                showOk: verifiedUserIds.contains(leader.userId),
+              ),
+            if (players.isNotEmpty)
+              Row(
+                children: [
+                  Text(
+                    '选手：',
+                    style: TextStyle(
+                      fontSize: 13.sp,
+                      height: 1.35,
+                      color: const Color(0xFF747B86),
+                      fontWeight: FontWeight.w500,
+                      fontFamily: 'PingFang SC',
+                    ),
+                  ),
+                  ...players.map(
+                    (member) => Row(
+                      children: [
+                        Text(
+                          _formatMember(member),
+
+                          style: TextStyle(
+                            fontSize: 13.sp,
+                            height: 1.35,
+                            color: const Color(0xFF4D545F),
+                          ),
+                        ),
+                        if (verifiedUserIds.contains(member.userId))
+                          Padding(
+                            padding: EdgeInsets.only(left: 6.w),
+                            child: Image.asset(
+                              Assets.images.imageOk.path,
+                              width: 18.w,
+                              height: 14.h,
+                              fit: BoxFit.contain,
+                            ),
+                          ),
+                        Text(
+                          (member != players.last ? '、' : ''),
+                          style: TextStyle(
+                            fontSize: 13.sp,
+                            height: 1.35,
+                            color: const Color(0xFF4D545F),
+                          ),
+                        ),
+                      ],
+                    ),
+                  ),
+                ],
+              ),
+          ],
+        ],
+      ),
+    );
+  }
+
+  EventTeamMember? _leaderOf(List<EventTeamMember> members) {
+    for (final member in members) {
+      if (member.isLeader) return member;
+    }
+    return members.isEmpty ? null : members.first;
+  }
+
+  String _formatMember(EventTeamMember member) {
+    final name = member.name.trim().isEmpty ? '暂无' : member.name.trim();
+    // final id = member.userId.trim();
+    // return id.isEmpty ? name : '$name（$id）';
+    return name;
+  }
+}
+
+class _TeamTextLine extends StatelessWidget {
+  const _TeamTextLine({
+    required this.label,
+    required this.text,
+    required this.showOk,
+  });
+
+  final String label;
+  final String text;
+  final bool showOk;
+
+  @override
+  Widget build(BuildContext context) {
+    return Padding(
+      padding: EdgeInsets.only(top: 4.h),
+      child: Row(
+        crossAxisAlignment: CrossAxisAlignment.center,
+        children: [
+          Text(
+            '$label：',
+            style: TextStyle(
+              fontSize: 13.sp,
+              height: 1.35,
+              color: const Color(0xFF747B86),
+              fontWeight: FontWeight.w500,
+              fontFamily: 'PingFang SC',
+            ),
+          ),
+          Flexible(
+            child: Text(
+              text.isEmpty ? '暂无' : text,
+              maxLines: 1,
+              overflow: TextOverflow.ellipsis,
+              style: TextStyle(
+                fontSize: 13.sp,
+                height: 1.35,
+                color: const Color(0xFF4D545F),
+                fontWeight: FontWeight.w500,
+                fontFamily: 'PingFang SC',
+              ),
+            ),
+          ),
+          if (showOk)
+            Padding(
+              padding: EdgeInsets.only(left: 6.w),
+              child: Image.asset(
+                Assets.images.imageOk.path,
+                width: 18.w,
+                height: 14.h,
+                fit: BoxFit.contain,
+              ),
+            ),
+        ],
+      ),
+    );
+  }
+}
+
+class _TeamActionButton extends StatelessWidget {
+  const _TeamActionButton({
+    required this.label,
+    required this.iconPath,
+    required this.onPressed,
+    this.filled = false,
+  });
+
+  final String label;
+  final String iconPath;
+  final VoidCallback onPressed;
+  final bool filled;
+
+  @override
+  Widget build(BuildContext context) {
+    final radius = BorderRadius.circular(28.r);
+    final content = Row(
+      mainAxisAlignment: MainAxisAlignment.center,
+      mainAxisSize: MainAxisSize.min,
+      children: [
+        Image.asset(
+          iconPath,
+          width: filled ? 18.w : 18.w,
+          height: filled ? 18.h : 18.h,
+          fit: BoxFit.contain,
+        ),
+        SizedBox(width: 4.w),
+        Text(
+          label,
+          style: TextStyle(
+            color: filled ? Colors.white : const Color(0xFF359FED),
+            fontSize: 16.sp,
+            fontWeight: FontWeight.w700,
+            fontFamily: 'PingFang SC',
+          ),
+        ),
+      ],
+    );
+
+    return SizedBox(
+      width: double.infinity,
+      height: 45.h,
+      child: DecoratedBox(
+        decoration: BoxDecoration(
+          gradient: filled
+              ? const LinearGradient(
+                  colors: [Color(0xFF2F8DFF), Color(0xFF57D2EE)],
+                )
+              : null,
+          color: filled ? null : Colors.white,
+          borderRadius: radius,
+          border: filled
+              ? null
+              : Border.all(color: const Color(0xFF9FD0F5), width: 1.w),
+          boxShadow: filled
+              ? [
+                  BoxShadow(
+                    color: const Color(0xFF2F8DFF).withValues(alpha: 0.24),
+                    blurRadius: 10.r,
+                    offset: Offset(0, 5.h),
+                  ),
+                ]
+              : null,
+        ),
+        child: Material(
+          color: Colors.transparent,
+          child: InkWell(
+            onTap: onPressed,
+            borderRadius: radius,
+            child: Center(child: content),
+          ),
+        ),
+      ),
+    );
+  }
+}

lib/features/competition_teams/server/server_competition_teams.dart

@@ -0,0 +1,49 @@
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:recording_tool/app/config/api_common.dart';
+import 'package:recording_tool/core/network/api_client.dart';
+import 'package:recording_tool/core/network/providers/dio_providers.dart';
+import 'package:recording_tool/features/competition_teams/model/model_competition_team.dart';
+import 'package:recording_tool/features/competition_teams/model/model_competition_team_detail.dart';
+
+final competitionTeamsServerProvider = Provider<CompetitionTeamsServer>((ref) {
+  return CompetitionTeamsServer(ref.watch(apiClientProvider));
+});
+
+class CompetitionTeamsServer {
+  CompetitionTeamsServer(this._apiClient);
+
+  final ApiClient _apiClient;
+
+  Future<CompetitionTeamPageResult> fetchPage({
+    required int page,
+    required int pageSize,
+  }) {
+    return _apiClient.get(
+      AuthApi.getTeamList.path,
+      queryParameters: {'page': page, 'pageSize': pageSize},
+      parser: (json) => CompetitionTeamPageResult.fromJson(
+        json,
+        page: page,
+        pageSize: pageSize,
+      ),
+    );
+  }
+
+  Future<CompetitionTeamDetail> fetchTeamDetail({
+    required String itemId,
+    required String eventId,
+    String? scheduleId,
+    String? opponentId,
+  }) {
+    return _apiClient.post(
+      AuthApi.getTeamDetail.path,
+      data: {
+        'itemId': itemId,
+        'eventId': eventId,
+        'scheduleId': scheduleId,
+        'opponentId': opponentId,
+      },
+      parser: (json) => CompetitionTeamDetail.fromResponse(json),
+    );
+  }
+}

lib/features/competition_teams/state/state_competition_teams.dart

@@ -0,0 +1,42 @@
+import 'package:recording_tool/features/competition_teams/model/model_competition_team.dart';
+
+class CompetitionTeamsState {
+  const CompetitionTeamsState({
+    this.items = const [],
+    this.page = 0,
+    this.hasMore = true,
+    this.isInitialLoading = false,
+    this.isRefreshing = false,
+    this.isLoadingMore = false,
+    this.errorMessage,
+  });
+
+  final List<CompetitionTeamListItem> items;
+  final int page;
+  final bool hasMore;
+  final bool isInitialLoading;
+  final bool isRefreshing;
+  final bool isLoadingMore;
+  final String? errorMessage;
+
+  CompetitionTeamsState copyWith({
+    List<CompetitionTeamListItem>? items,
+    int? page,
+    bool? hasMore,
+    bool? isInitialLoading,
+    bool? isRefreshing,
+    bool? isLoadingMore,
+    String? errorMessage,
+    bool clearError = false,
+  }) {
+    return CompetitionTeamsState(
+      items: items ?? this.items,
+      page: page ?? this.page,
+      hasMore: hasMore ?? this.hasMore,
+      isInitialLoading: isInitialLoading ?? this.isInitialLoading,
+      isRefreshing: isRefreshing ?? this.isRefreshing,
+      isLoadingMore: isLoadingMore ?? this.isLoadingMore,
+      errorMessage: clearError ? null : errorMessage ?? this.errorMessage,
+    );
+  }
+}

lib/features/competition_teams/view_model/view_model_competition_teams.dart

@@ -0,0 +1,98 @@
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:flutter_riverpod/legacy.dart';
+import 'package:recording_tool/features/competition_teams/model/model_competition_team.dart';
+import 'package:recording_tool/features/competition_teams/server/server_competition_teams.dart';
+import 'package:recording_tool/features/competition_teams/state/state_competition_teams.dart';
+
+final competitionTeamsProvider =
+    StateNotifierProvider<CompetitionTeamsViewModel, CompetitionTeamsState>((
+      ref,
+    ) {
+      return CompetitionTeamsViewModel(ref);
+    });
+
+class CompetitionTeamsViewModel extends StateNotifier<CompetitionTeamsState> {
+  CompetitionTeamsViewModel(this._ref) : super(const CompetitionTeamsState());
+
+  static const pageSize = 5;
+
+  final Ref _ref;
+
+  Future<void> loadInitial() async {
+    state = state.copyWith(
+      isInitialLoading: true,
+      isLoadingMore: false,
+      isRefreshing: false,
+      clearError: true,
+    );
+    await _loadPage(page: 1, replace: true);
+  }
+
+  Future<void> refresh() async {
+    if (state.isRefreshing) return;
+    state = state.copyWith(isRefreshing: true, clearError: true);
+    await _loadPage(page: 1, replace: true);
+  }
+
+  Future<void> loadMore() async {
+    if (!state.hasMore || state.isLoadingMore || state.isInitialLoading) return;
+    state = state.copyWith(isLoadingMore: true, clearError: true);
+    await _loadPage(page: state.page + 1, replace: false);
+  }
+
+  void selectWinner({
+    required String itemId,
+    required String matchupId,
+    required String winnerTeamId,
+  }) {
+    final updatedItems = state.items
+        .map((item) {
+          if (item.itemId != itemId) return item;
+          final updatedMatchups = item.matchups
+              .map((matchup) {
+                if (matchup.id != matchupId) return matchup;
+                final validWinner =
+                    winnerTeamId == matchup.teamA.id ||
+                    winnerTeamId == matchup.teamB.id;
+                return validWinner
+                    ? matchup.copyWith(winnerTeamId: winnerTeamId)
+                    : matchup;
+              })
+              .toList(growable: false);
+          return item.copyWith(matchups: updatedMatchups);
+        })
+        .toList(growable: false);
+    state = state.copyWith(items: updatedItems);
+  }
+
+  CompetitionTeamListItem? findItem(String itemId) {
+    for (final item in state.items) {
+      if (item.itemId == itemId) return item;
+    }
+    return null;
+  }
+
+  Future<void> _loadPage({required int page, required bool replace}) async {
+    try {
+      final result = await _ref
+          .read(competitionTeamsServerProvider)
+          .fetchPage(page: page, pageSize: pageSize);
+      state = state.copyWith(
+        items: replace ? result.items : [...state.items, ...result.items],
+        page: result.page,
+        hasMore: result.hasMore,
+        isInitialLoading: false,
+        isRefreshing: false,
+        isLoadingMore: false,
+        clearError: true,
+      );
+    } catch (error) {
+      state = state.copyWith(
+        isInitialLoading: false,
+        isRefreshing: false,
+        isLoadingMore: false,
+        errorMessage: '参赛队伍加载失败，请重试',
+      );
+    }
+  }
+}

lib/features/competition_teams/widgets/widget_manual_winner_dialog.dart

@@ -0,0 +1,353 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+import 'package:recording_tool/features/competition_teams/model/model_competition_team_detail.dart';
+import 'package:recording_tool/gen/assets.gen.dart';
+
+/// 弹窗回传选中侧索引：0 = teamA（红队），1 = teamB（蓝队）
+class ManualWinnerDialog extends StatefulWidget {
+  const ManualWinnerDialog({
+    super.key,
+    required this.matchup,
+    this.initialWinnerSideIndex,
+  });
+
+  final Matchup matchup;
+  final int? initialWinnerSideIndex;
+
+  static Future<int?> show(
+    BuildContext context, {
+    required Matchup matchup,
+    int? initialWinnerSideIndex,
+  }) {
+    return showDialog<int>(
+      context: context,
+      barrierDismissible: false,
+      builder: (_) => ManualWinnerDialog(
+        matchup: matchup,
+        initialWinnerSideIndex: initialWinnerSideIndex,
+      ),
+    );
+  }
+
+  @override
+  State<ManualWinnerDialog> createState() => _ManualWinnerDialogState();
+}
+
+class _ManualWinnerDialogState extends State<ManualWinnerDialog> {
+  /// 0 = teamA，1 = teamB
+  int? _selectedSideIndex;
+
+  Team? get _teamA {
+    final teams = widget.matchup.teamA;
+    if (teams == null || teams.isEmpty) return null;
+    return teams.first;
+  }
+
+  Team? get _teamB {
+    final teams = widget.matchup.teamB;
+    if (teams == null || teams.isEmpty) return null;
+    return teams.first;
+  }
+
+  @override
+  void initState() {
+    super.initState();
+    final initial = widget.initialWinnerSideIndex;
+    if (initial == 0 || initial == 1) {
+      _selectedSideIndex = initial;
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final teamA = _teamA;
+    final teamB = _teamB;
+    final maxHeight = MediaQuery.sizeOf(context).height * 0.78;
+
+    return Dialog(
+      insetPadding: EdgeInsets.symmetric(horizontal: 48.w),
+      backgroundColor: Colors.transparent,
+      elevation: 0,
+      child: ConstrainedBox(
+        constraints: BoxConstraints(maxWidth: 380.w, maxHeight: maxHeight),
+        child: Stack(
+          clipBehavior: Clip.none,
+          children: [
+            ClipRRect(
+              borderRadius: BorderRadius.circular(16.r),
+              child: Material(
+                color: Colors.white,
+                child: SingleChildScrollView(
+                  child: Column(
+                    mainAxisSize: MainAxisSize.min,
+                    children: [
+                      Padding(
+                        padding: EdgeInsets.fromLTRB(18.w, 18.h, 18.w, 18.h),
+                        child: Column(
+                          mainAxisSize: MainAxisSize.min,
+                          children: [
+                            SizedBox(height: 26.h),
+                            Text(
+                              '请在比赛结束前处理',
+                              key: const ValueKey('manual-winner-dialog-title'),
+                              textAlign: TextAlign.center,
+                              style: TextStyle(
+                                fontSize: 18.sp,
+                                height: 1.3,
+                                fontWeight: FontWeight.w700,
+                                color: const Color(0xFF20242B),
+                                fontFamily: 'PingFang SC',
+                              ),
+                            ),
+                            SizedBox(height: 16.h),
+                            if (teamA != null) ...[
+                              _TeamChoice(
+                                team: teamA,
+                                sideIndex: 0,
+                                color: const Color(0xFFFF6575),
+                                selected: _selectedSideIndex == 0,
+                                onTap: () =>
+                                    setState(() => _selectedSideIndex = 0),
+                              ),
+                              SizedBox(height: 10.h),
+                            ],
+                            if (teamB != null)
+                              _TeamChoice(
+                                team: teamB,
+                                sideIndex: 1,
+                                color: const Color(0xFF21C5AC),
+                                selected: _selectedSideIndex == 1,
+                                onTap: () =>
+                                    setState(() => _selectedSideIndex = 1),
+                              ),
+                            SizedBox(height: 18.h),
+                            Row(
+                              children: [
+                                Expanded(
+                                  child: _DialogActionButton(
+                                    label: '取消',
+                                    onPressed: () =>
+                                        Navigator.of(context).pop(),
+                                  ),
+                                ),
+                                SizedBox(width: 14.w),
+                                Expanded(
+                                  child: _DialogActionButton(
+                                    label: '确定',
+                                    filled: true,
+                                    onPressed: _selectedSideIndex == null
+                                        ? null
+                                        : () => Navigator.of(
+                                            context,
+                                          ).pop(_selectedSideIndex),
+                                  ),
+                                ),
+                              ],
+                            ),
+                          ],
+                        ),
+                      ),
+                    ],
+                  ),
+                ),
+              ),
+            ),
+            Positioned(
+              top: -90.h,
+              left: 0,
+              right: 0,
+              child: Image.asset(
+                Assets.images.imageDialogBg.path,
+                width: double.infinity,
+                height: 112.h,
+                fit: BoxFit.cover,
+                alignment: Alignment.topCenter,
+              ),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}
+
+class _TeamChoice extends StatelessWidget {
+  const _TeamChoice({
+    required this.team,
+    required this.sideIndex,
+    required this.color,
+    required this.selected,
+    required this.onTap,
+  });
+
+  final Team team;
+  final int sideIndex;
+  final Color color;
+  final bool selected;
+  final VoidCallback onTap;
+
+  @override
+  Widget build(BuildContext context) {
+    final name = team.teamName?.trim().isNotEmpty == true
+        ? team.teamName!
+        : '未命名队伍';
+    final players = team.playerNames;
+    final backgroundColor = selected
+        ? color.withValues(alpha: 0.13)
+        : color.withValues(alpha: 0.07);
+    return Semantics(
+      selected: selected,
+      button: true,
+      label: '选择$name直接获胜',
+      child: Material(
+        color: backgroundColor,
+        borderRadius: BorderRadius.circular(12.r),
+        child: InkWell(
+          key: ValueKey('winner-choice-side-$sideIndex'),
+          onTap: onTap,
+          borderRadius: BorderRadius.circular(12.r),
+          child: Container(
+            width: double.infinity,
+            padding: EdgeInsets.symmetric(horizontal: 12.w, vertical: 12.h),
+            decoration: BoxDecoration(
+              borderRadius: BorderRadius.circular(12.r),
+              border: Border.all(
+                color: selected ? color : color.withValues(alpha: 0.32),
+                width: 1,
+              ),
+            ),
+            child: Row(
+              children: [
+                AnimatedContainer(
+                  duration: const Duration(milliseconds: 160),
+                  width: 22.r,
+                  height: 22.r,
+                  decoration: BoxDecoration(
+                    shape: BoxShape.circle,
+                    border: Border.all(
+                      color: selected ? color : const Color(0xFFB0B4BB),
+                      width: 1.2.r,
+                    ),
+                    color: Colors.transparent,
+                  ),
+                  child: selected
+                      ? Center(
+                          child: Container(
+                            width: 10.r,
+                            height: 10.r,
+                            decoration: BoxDecoration(
+                              color: color,
+                              shape: BoxShape.circle,
+                            ),
+                          ),
+                        )
+                      : null,
+                ),
+                SizedBox(width: 12.w),
+                Expanded(
+                  child: Column(
+                    crossAxisAlignment: CrossAxisAlignment.start,
+                    children: [
+                      Text(
+                        name,
+                        maxLines: 1,
+                        overflow: TextOverflow.ellipsis,
+                        style: TextStyle(
+                          fontSize: 17.sp,
+                          height: 1.25,
+                          fontWeight: FontWeight.w700,
+                          color: const Color(0xFF20242B),
+                          fontFamily: 'PingFang SC',
+                        ),
+                      ),
+                      if (players.isNotEmpty) ...[
+                        SizedBox(height: 4.h),
+                        Text(
+                          players,
+                          maxLines: 1,
+                          overflow: TextOverflow.ellipsis,
+                          style: TextStyle(
+                            fontSize: 15.sp,
+                            height: 1.25,
+                            color: const Color(0xFF69717E),
+                            fontFamily: 'PingFang SC',
+                          ),
+                        ),
+                      ],
+                    ],
+                  ),
+                ),
+                SizedBox(width: 8.w),
+                Text(
+                  '直接获胜',
+                  maxLines: 1,
+                  style: TextStyle(
+                    fontSize: 15.sp,
+                    fontWeight: FontWeight.w700,
+                    color: color,
+                    fontFamily: 'PingFang SC',
+                  ),
+                ),
+              ],
+            ),
+          ),
+        ),
+      ),
+    );
+  }
+}
+
+class _DialogActionButton extends StatelessWidget {
+  const _DialogActionButton({
+    required this.label,
+    required this.onPressed,
+    this.filled = false,
+  });
+
+  final String label;
+  final VoidCallback? onPressed;
+  final bool filled;
+
+  @override
+  Widget build(BuildContext context) {
+    final enabled = onPressed != null;
+    final radius = BorderRadius.circular(24.r);
+    final backgroundColor = filled
+        ? (enabled ? null : const Color(0xFFD2D3D8))
+        : const Color(0xFFF1F1F1);
+    final gradient = filled && enabled
+        ? const LinearGradient(colors: [Color(0xFF2F8DFF), Color(0xFF58D1EE)])
+        : null;
+
+    return SizedBox(
+      height: 40.h,
+      child: DecoratedBox(
+        decoration: BoxDecoration(
+          color: backgroundColor,
+          gradient: gradient,
+          borderRadius: radius,
+        ),
+        child: Material(
+          color: Colors.transparent,
+          child: InkWell(
+            onTap: onPressed,
+            borderRadius: radius,
+            child: Center(
+              child: Text(
+                label,
+                style: TextStyle(
+                  fontSize: 15.sp,
+                  fontWeight: FontWeight.w500,
+                  color: filled
+                      ? (enabled ? Colors.white : const Color(0xFF8D9098))
+                      : const Color(0xFF343941),
+                  fontFamily: 'PingFang SC',
+                ),
+              ),
+            ),
+          ),
+        ),
+      ),
+    );
+  }
+}

lib/features/events/model/model_event_info.dart

@@ -50,6 +50,27 @@ class EventProfile {
   final String avatarLabel;
 }
 
+class EventTeamMember {
+  const EventTeamMember({
+    required this.userId,
+    required this.name,
+    required this.isLeader,
+  });
+
+  final String userId;
+  final String name;
+  final bool isLeader;
+
+  factory EventTeamMember.fromJson(Map<dynamic, dynamic> json) {
+    final map = Map<String, dynamic>.from(json);
+    return EventTeamMember(
+      userId: _readString(map, const ['userId']),
+      name: _readString(map, const ['name']),
+      isLeader: _readBool(map, const ['isLeader']),
+    );
+  }
+}
+
 class EventRegistrationList {
   const EventRegistrationList({
     required this.userId,
@@ -118,7 +139,7 @@ class EventRegistrationItem {
     this.completed = false,
     this.opponentId = '',
     this.opponentName = '',
-    this.teamMembers,
+    this.teamMembers = const [],
     this.userId = '',
     this.playerName = '',
     this.playerPhone = '',
@@ -136,7 +157,7 @@ class EventRegistrationItem {
   final bool completed;
   final String opponentId;
   final String opponentName;
-  final List<dynamic>? teamMembers;
+  final List<EventTeamMember> teamMembers;
 
   /// 来自报名列表父级，不在 item JSON 内
   final String userId;
@@ -147,6 +168,13 @@ class EventRegistrationItem {
 
   String? get statusLabel => completed ? '已完成' : null;
 
+  EventTeamMember? get teamLeader {
+    for (final member in teamMembers) {
+      if (member.isLeader) return member;
+    }
+    return teamMembers.isEmpty ? null : teamMembers.first;
+  }
+
   factory EventRegistrationItem.fromJson(
     Map<dynamic, dynamic> json, {
     String userId = '',
@@ -170,8 +198,11 @@ class EventRegistrationItem {
       opponentId: _readString(map, const ['opponentId']),
       opponentName: _readString(map, const ['opponentName']),
       teamMembers: teamMembersRaw is List
-          ? List<dynamic>.from(teamMembersRaw)
+          ? teamMembersRaw
-          : null,
+                .whereType<Map>()
+                .map(EventTeamMember.fromJson)
+                .toList(growable: false)
+          : const [],
       userId: userId,
       playerName: playerName,
     );

lib/features/events/pages/page_event_info.dart

@@ -1,6 +1,8 @@
 import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:flutter_screenutil/flutter_screenutil.dart';
+import 'package:recording_tool/app/config/app_config.dart';
 import 'package:recording_tool/app/router/app_navigator.dart';
 import 'package:recording_tool/core/utils/util_search_nasIp.dart';
 import 'package:recording_tool/features/events/model/model_event_info.dart';
@@ -8,6 +10,7 @@ import 'package:recording_tool/features/events/state/state_event_info.dart';
 import 'package:recording_tool/features/events/view_model/view_model_event_info.dart';
 import 'package:recording_tool/features/recording/model/model_recording_context.dart';
 import 'package:recording_tool/features/recording/pages/page_record.dart';
+import 'package:recording_tool/gen/assets.gen.dart';
 import 'package:recording_tool/shared/widgets/widgets.dart';
 
 class EventInfoPage extends ConsumerStatefulWidget {
@@ -54,6 +57,7 @@ class _EventInfoPageState extends ConsumerState<EventInfoPage> {
         ),
         streamUrl: streamUrl,
       ),
+      context: context,
     );
   }
 
@@ -62,42 +66,41 @@ class _EventInfoPageState extends ConsumerState<EventInfoPage> {
     final state = ref.watch(eventInfoProvider);
     final profile = state.profile;
 
-    return Scaffold(
+    return AnnotatedRegion<SystemUiOverlayStyle>(
-      backgroundColor: Colors.white,
+      value: SystemUiOverlayStyle.light.copyWith(
-      body: SafeArea(
+        statusBarColor: Colors.transparent,
-        child: Column(
+        systemNavigationBarColor: const Color(0xFFF5F6F8),
-          crossAxisAlignment: CrossAxisAlignment.start,
+      ),
+      child: Scaffold(
+        backgroundColor: const Color(0xFFF5F6F8),
+        appBar: myAppBar(context: context),
+        body: Stack(
           children: [
-            _Header(onBack: () => AppNavigator.pop(context: context)),
+            const _TopGradientHeader(),
-            Expanded(
+            SafeArea(
-              child: SingleChildScrollView(
+              bottom: false,
-                padding: EdgeInsets.fromLTRB(62.w, 8.h, 62.w, 40.h),
+              child: Column(
-                child: Column(
+                children: [
-                  children: [
+                  // _Header(onBack: () => AppNavigator.pop(context: context)),
-                    _ProfileSection(profile: profile),
+                  SizedBox(height: 10.h),
-                    SizedBox(height: 20.h),
+                  Padding(
-                    Text(
+                    padding: EdgeInsets.symmetric(horizontal: 10.w),
-                      state.eventTitle,
+                    child: _ProfileSection(
-                      style: TextStyle(
+                      profile: profile,
-                        fontSize: 20.sp,
+                      eventTitle: state.eventTitle,
-                        height: 1.2,
-                        color: const Color(0xFF2F2F2F),
-                        fontWeight: FontWeight.w500,
-                      ),
                     ),
-                    SizedBox(height: 24.h),
+                  ),
-                    SizedBox(
+                  SizedBox(height: 8.h),
-                      height: 400.h,
+                  Expanded(
-                      child: _ScheduleList(
+                    child: _ScheduleList(
-                        state: state,
+                      state: state,
-                        onRetry: () => ref
+                      onRetry: () => ref
-                            .read(eventInfoProvider.notifier)
+                          .read(eventInfoProvider.notifier)
-                            .loadRegistrationList(),
+                          .loadRegistrationList(),
-                        onItemTap: onItemTap,
+                      onItemTap: onItemTap,
-                      ),
                     ),
-                  ],
+                  ),
-                ),
+                ],
               ),
             ),
           ],
@@ -107,6 +110,39 @@ class _EventInfoPageState extends ConsumerState<EventInfoPage> {
   }
 }
 
+class _TopGradientHeader extends StatelessWidget {
+  const _TopGradientHeader();
+
+  @override
+  Widget build(BuildContext context) {
+    return Positioned(
+      top: -10.h,
+      left: 0,
+      right: 0,
+      child: SizedBox(
+        height: 219.h,
+        width: double.infinity,
+        child: Image.asset(Assets.images.imageEventInfoBarBg.path),
+      ),
+    );
+  }
+}
+
+// Widget buildEventRegistrationDestination({
+//   required EventRegistrationItem item,
+//   required String playerId,
+//   required CompetitionTeamDetail? detail,
+// }) {
+//   if (detail != null) {
+//     return EventTeamMatchPage(playerId: playerId, detail: detail, item: item);
+//   }
+//   return WebviewPage(
+//     url: AppConfig.current.mainRefereeScoreH5Url,
+//     eventRegistrationItem: item,
+//     playerId: playerId,
+//   );
+// }
+
 class _Header extends StatelessWidget {
   const _Header({required this.onBack});
 
@@ -115,16 +151,16 @@ class _Header extends StatelessWidget {
   @override
   Widget build(BuildContext context) {
     return SizedBox(
-      height: 52.h,
+      height: 44.h,
       child: Align(
         alignment: Alignment.centerLeft,
         child: IconButton(
           onPressed: onBack,
-          icon: Icon(Icons.arrow_back_ios_new, size: 32.r),
+          icon: Icon(Icons.chevron_left_rounded, size: 28.r),
-          color: Colors.black,
+          color: Colors.white,
           tooltip: '返回',
-          padding: EdgeInsets.only(left: 16.w),
+          padding: EdgeInsets.only(left: 10.w),
-          constraints: BoxConstraints(minWidth: 56.w, minHeight: 52.h),
+          constraints: BoxConstraints(minWidth: 44.w, minHeight: 44.h),
         ),
       ),
     );
@@ -132,52 +168,122 @@ class _Header extends StatelessWidget {
 }
 
 class _ProfileSection extends StatelessWidget {
-  const _ProfileSection({required this.profile});
+  const _ProfileSection({required this.profile, required this.eventTitle});
 
   final EventProfile profile;
+  final String eventTitle;
 
   @override
   Widget build(BuildContext context) {
-    return Row(
+    final title = eventTitle.trim().isEmpty ? '赛事信息' : eventTitle.trim();
-      crossAxisAlignment: CrossAxisAlignment.start,
+    return Container(
-      children: [
+      clipBehavior: Clip.antiAlias,
-        profile.avatarUrl.isEmpty
+      padding: EdgeInsets.fromLTRB(12.w, 10.h, 12.w, 12.h),
-            ? AppAvatar(size: 50.r)
+      decoration: BoxDecoration(
-            : AppAvatar(size: 50.r, imageUrl: profile.avatarUrl),
+        color: Colors.white,
-
+        borderRadius: BorderRadius.circular(6.r),
-        SizedBox(width: 28.w),
+      ),
-        Expanded(
+      child: Stack(
-          child: Padding(
+        children: [
-            padding: EdgeInsets.only(top: 30.h),
+          Column(
-            child: Column(
+            crossAxisAlignment: CrossAxisAlignment.start,
-              crossAxisAlignment: CrossAxisAlignment.start,
+            children: [
-              children: [
+              Row(
-                Text(
+                children: [
-                  profile.name,
+                  profile.avatarUrl.isEmpty
-                  maxLines: 1,
+                      ? AppAvatar(
-                  overflow: TextOverflow.ellipsis,
+                          size: 52.r,
-                  style: TextStyle(
+                          initials: profile.name.isEmpty ? 'S' : profile.name,
-                    fontSize: 22.sp,
+                        )
-                    height: 1.2,
+                      : AppAvatar(size: 52.r, imageUrl: profile.avatarUrl),
-                    color: const Color(0xFF2F2F2F),
+                  SizedBox(width: 12.w),
+                  Expanded(
+                    child: Column(
+                      mainAxisAlignment: MainAxisAlignment.center,
+                      crossAxisAlignment: CrossAxisAlignment.start,
+                      children: [
+                        Text(
+                          profile.name.isEmpty ? '参赛选手' : profile.name,
+                          maxLines: 1,
+                          overflow: TextOverflow.ellipsis,
+                          style: TextStyle(
+                            fontSize: 18.sp,
+                            height: 1.2,
+                            color: const Color(0xFF33363B),
+                            fontWeight: FontWeight.w700,
+                          ),
+                        ),
+                        SizedBox(height: 5.h),
+                        Text(
+                          profile.phone,
+                          maxLines: 1,
+                          overflow: TextOverflow.ellipsis,
+                          style: TextStyle(
+                            fontSize: 10.sp,
+                            height: 1.2,
+                            color: const Color(0xFF969CA6),
+                          ),
+                        ),
+                      ],
+                    ),
                   ),
-                ),
+                ],
-                SizedBox(height: 36.h),
+              ),
-                Text(
+              SizedBox(height: 10.h),
-                  profile.phone,
+              Divider(
-                  maxLines: 1,
+                height: 1.h,
-                  overflow: TextOverflow.ellipsis,
+                thickness: 1.h,
-                  style: TextStyle(
+                color: const Color(0xFFE8EAED),
-                    fontSize: 22.sp,
+              ),
-                    height: 1.2,
+              SizedBox(height: 10.h),
-                    color: const Color(0xFF2F2F2F),
+              _EventTitleHighlight(title: title),
-                  ),
+            ],
-                ),
-              ],
-            ),
           ),
+        ],
+      ),
+    );
+  }
+}
+
+class _EventTitleHighlight extends StatelessWidget {
+  const _EventTitleHighlight({required this.title});
+
+  final String title;
+
+  @override
+  Widget build(BuildContext context) {
+    return Align(
+      alignment: Alignment.centerLeft,
+      child: IntrinsicWidth(
+        child: Stack(
+          alignment: Alignment.bottomLeft,
+          children: [
+            Positioned(
+              left: 0,
+              right: 0,
+              bottom: 2.h,
+              child: Container(
+                height: 8.h,
+                decoration: BoxDecoration(
+                  color: const Color(0xFFB8F5E8),
+                  borderRadius: BorderRadius.circular(4.r),
+                ),
+              ),
+            ),
+            Text(
+              title,
+              maxLines: 2,
+              overflow: TextOverflow.ellipsis,
+              style: TextStyle(
+                fontSize: 16.sp,
+                height: 1.25,
+                color: const Color(0xFF33363B),
+                fontWeight: FontWeight.w600,
+              ),
+            ),
+          ],
         ),
-      ],
+      ),
     );
   }
 }
@@ -203,97 +309,68 @@ class _ScheduleList extends StatelessWidget {
             Text(
               '暂无赛事报名信息',
               textAlign: TextAlign.center,
-              style: TextStyle(fontSize: 18.sp, color: const Color(0xFF2F2F2F)),
+              style: TextStyle(fontSize: 16.sp, color: const Color(0xFF3A3D42)),
             ),
-            SizedBox(height: 18.h),
+            SizedBox(height: 14.h),
             TextButton(onPressed: onRetry, child: const Text('重新加载')),
           ],
         ),
       );
     }
 
-    return ListView.builder(
+    return ListView.separated(
+      padding: EdgeInsets.fromLTRB(10.w, 0, 10.w, 24.h),
       itemCount: state.items.length,
+      separatorBuilder: (_, _) => SizedBox(height: 8.h),
       itemBuilder: (context, index) {
         final item = state.items[index];
-        return _ScheduleCard(item: item, onTap: () => onItemTap(item));
+        return _ScheduleCard(
+          item: item,
+          scheduleIndex: index + 1,
+          onTap: () => onItemTap(item),
+        );
       },
     );
   }
 }
 
 class _ScheduleCard extends StatelessWidget {
-  const _ScheduleCard({required this.item, required this.onTap});
+  const _ScheduleCard({
+    required this.item,
+    required this.scheduleIndex,
+    required this.onTap,
+  });
 
   final EventRegistrationItem item;
+  final int scheduleIndex;
   final VoidCallback onTap;
 
   @override
   Widget build(BuildContext context) {
     return Material(
       color: Colors.white,
+      borderRadius: BorderRadius.circular(6.r),
       child: InkWell(
         onTap: onTap,
+        borderRadius: BorderRadius.circular(6.r),
         child: Container(
-          constraints: BoxConstraints(minHeight: 138.h),
+          constraints: BoxConstraints(minHeight: 86.h),
-          padding: EdgeInsets.fromLTRB(10.w, 14.h, 14.w, 0),
+          padding: EdgeInsets.fromLTRB(12.w, 10.h, 14.w, 10.h),
           decoration: BoxDecoration(
-            border: Border.all(color: const Color(0xFF7A7A7A)),
+            color: Colors.white,
+            borderRadius: BorderRadius.circular(6.r),
           ),
           child: Row(
-            crossAxisAlignment: CrossAxisAlignment.start,
+            crossAxisAlignment: CrossAxisAlignment.center,
             children: [
               Expanded(
-                child: Column(
+                child: _ScheduleDetails(
-                  crossAxisAlignment: CrossAxisAlignment.start,
+                  item: item,
-                  children: [
+                  scheduleIndex: scheduleIndex,
-                    Text(
-                      item.groupName.isEmpty
-                          ? item.itemName
-                          : '${item.itemName} （${item.groupName}）',
-                      maxLines: 1,
-                      overflow: TextOverflow.ellipsis,
-                      style: TextStyle(
-                        fontSize: 20.sp,
-                        height: 1.2,
-                        color: const Color(0xFF2F2F2F),
-                        fontWeight: FontWeight.w500,
-                      ),
-                    ),
-                    SizedBox(height: 26.h),
-                    Text(
-                      item.matchPlace,
-                      maxLines: 1,
-                      overflow: TextOverflow.ellipsis,
-                      style: TextStyle(
-                        fontSize: 20.sp,
-                        height: 1.2,
-                        color: const Color(0xFF2F2F2F),
-                      ),
-                    ),
-                    SizedBox(height: 26.h),
-                    Text(
-                      item.scheduleTime,
-                      maxLines: 1,
-                      overflow: TextOverflow.ellipsis,
-                      style: TextStyle(
-                        fontSize: 20.sp,
-                        height: 1.2,
-                        color: const Color(0xFF2F2F2F),
-                      ),
-                    ),
-                  ],
                 ),
               ),
               SizedBox(width: 12.w),
-              SizedBox(
+              _ScheduleStatus(item: item),
-                width: 148.w,
-                height: 120.h,
-                child: Align(
-                  alignment: Alignment.center,
-                  child: _ScheduleBadge(item: item),
-                ),
-              ),
             ],
           ),
         ),
@@ -302,72 +379,148 @@ class _ScheduleCard extends StatelessWidget {
   }
 }
 
-class _ScheduleBadge extends StatelessWidget {
+class _ScheduleDetails extends StatelessWidget {
-  const _ScheduleBadge({required this.item});
+  const _ScheduleDetails({required this.item, required this.scheduleIndex});
+
+  final EventRegistrationItem item;
+  final int scheduleIndex;
+
+  @override
+  Widget build(BuildContext context) {
+    final memberLine = _formatMemberLine(item);
+    final opponentLine = _formatOpponentLine(item);
+
+    return Column(
+      mainAxisAlignment: MainAxisAlignment.center,
+      crossAxisAlignment: CrossAxisAlignment.start,
+      children: [
+        Text(
+          _formatTitle(item),
+          maxLines: 1,
+          overflow: TextOverflow.ellipsis,
+          style: TextStyle(
+            fontSize: 13.sp,
+            height: 1.2,
+            color: const Color(0xFF30343A),
+            fontWeight: FontWeight.w700,
+          ),
+        ),
+        SizedBox(height: 6.h),
+        _MetaText(_formatVenue(item, scheduleIndex)),
+        SizedBox(height: 3.h),
+        _MetaText(_formatScheduleTime(item)),
+        if (memberLine.isNotEmpty) ...[
+          SizedBox(height: 3.h),
+          _MetaText(memberLine),
+        ],
+        if (opponentLine.isNotEmpty) ...[
+          SizedBox(height: 3.h),
+          _MetaText(opponentLine),
+        ],
+      ],
+    );
+  }
+}
+
+class _MetaText extends StatelessWidget {
+  const _MetaText(this.text);
+
+  final String text;
+
+  @override
+  Widget build(BuildContext context) {
+    return Text(
+      text,
+      maxLines: 1,
+      overflow: TextOverflow.ellipsis,
+      style: TextStyle(
+        fontSize: 10.sp,
+        height: 1.2,
+        color: const Color(0xFF6E747D),
+        fontWeight: FontWeight.w400,
+      ),
+    );
+  }
+}
+
+class _ScheduleStatus extends StatelessWidget {
+  const _ScheduleStatus({required this.item});
 
   final EventRegistrationItem item;
 
   @override
   Widget build(BuildContext context) {
-    if (item.statusLabel != null) {
+    final status = item.statusLabel;
-      return CustomPaint(
+    if (status != null) {
-        painter: _CutCornerBorderPainter(color: const Color(0xFF7A7A7A)),
+      return Text(
-        child: SizedBox(
+        status,
-          width: 148.w,
+        style: TextStyle(
-          height: 90.h,
+          fontSize: 10.sp,
-          child: Center(
+          height: 1.2,
-            child: Text(
+          color: const Color(0xFF1DBF73),
-              item.statusLabel!,
+          fontWeight: FontWeight.w500,
-              maxLines: 1,
-              overflow: TextOverflow.ellipsis,
-              style: TextStyle(fontSize: 20.sp, color: const Color(0xFF2F2F2F)),
-            ),
-          ),
         ),
       );
     }
 
     return Text(
-      item.matchPlace,
+      _formatNumberBadge(item),
       maxLines: 1,
       overflow: TextOverflow.ellipsis,
       style: TextStyle(
-        fontSize: 34.sp,
+        fontSize: 20.sp,
         height: 1,
-        color: const Color(0xFF2F2F2F),
+        color: const Color(0xFFF27D69),
         fontWeight: FontWeight.w700,
       ),
     );
   }
 }
 
-class _CutCornerBorderPainter extends CustomPainter {
+String _formatTitle(EventRegistrationItem item) {
-  const _CutCornerBorderPainter({required this.color});
+  if (item.groupName.isEmpty) return item.itemName;
+  return '${item.itemName} （${item.groupName}）';
+}
 
-  final Color color;
+String _formatVenue(EventRegistrationItem item, int scheduleIndex) {
+  final place = item.matchPlace.trim();
+  if (place.isEmpty) return '$scheduleIndex号场馆$scheduleIndex区';
+  return '$place号场馆$scheduleIndex区';
+}
 
-  @override
+String _formatScheduleTime(EventRegistrationItem item) {
-  void paint(Canvas canvas, Size size) {
+  final start = DateTime.tryParse(item.matchStartTime);
-    final side = 12.r;
+  final end = DateTime.tryParse(item.matchEndTime);
-    final path = Path()
+  if (start == null && end == null) return item.scheduleTime;
-      ..moveTo(side, 0)
+  if (start != null && end != null) {
-      ..lineTo(size.width - side, 0)
+    return '${start.month}月${start.day}日 ${_formatClock(start)}-${_formatClock(end)}';
-      ..lineTo(size.width, side)
-      ..lineTo(size.width, size.height - side)
-      ..lineTo(size.width - side, size.height)
-      ..lineTo(side, size.height)
-      ..lineTo(0, size.height - side)
-      ..lineTo(0, side)
-      ..close();
-    final paint = Paint()
-      ..style = PaintingStyle.stroke
-      ..strokeWidth = 1
-      ..color = color;
-    canvas.drawPath(path, paint);
   }
+  final value = start ?? end!;
+  return '${value.month}月${value.day}日 ${_formatClock(value)}';
+}
 
-  @override
+String _formatClock(DateTime value) {
-  bool shouldRepaint(covariant _CutCornerBorderPainter oldDelegate) {
+  return '${value.hour}:${value.minute.toString().padLeft(2, '0')}';
-    return oldDelegate.color != color;
+}
-  }
+
+String _formatMemberLine(EventRegistrationItem item) {
+  final names = item.teamMembers
+      .map((member) => member.name.trim())
+      .where((name) => name.isNotEmpty)
+      .toList(growable: false);
+  return names.join('、');
+}
+
+String _formatOpponentLine(EventRegistrationItem item) {
+  final opponent = item.opponentName.trim();
+  if (opponent.isEmpty) return '';
+  return '对手：$opponent';
+}
+
+String _formatNumberBadge(EventRegistrationItem item) {
+  final place = item.matchPlace.trim();
+  if (place.isEmpty) return '';
+  final match = RegExp(r'\d+').firstMatch(place);
+  if (match != null) return '${match.group(0)}号';
+  return place;
 }

lib/features/events/request_model/request_model_event.dart

@@ -0,0 +1,58 @@
+class SetTeamStatusReq {
+  final String scheduleId;
+  final String opponentId;
+  final List<TeamScore> teamScore;
+
+  SetTeamStatusReq({
+    required this.scheduleId,
+    required this.opponentId,
+    required this.teamScore,
+  });
+
+  factory SetTeamStatusReq.fromJson(Map<String, dynamic> json) =>
+      SetTeamStatusReq(
+        scheduleId: json['scheduleId'],
+        opponentId: json['opponentId'],
+        teamScore: List<TeamScore>.from(
+          json['teamScore'].map((x) => TeamScore.fromJson(x)),
+        ),
+      );
+
+  Map<String, dynamic> toJson() => {
+    'scheduleId': scheduleId,
+    'opponentId': opponentId,
+    'teamScore': List<dynamic>.from(teamScore.map((x) => x.toJson())),
+  };
+}
+
+class TeamScore {
+  final String userId;
+  final int firstHalfScore;
+  final int secondHalfScore;
+  final int decisiveScore;
+  final bool ifWithdraw;
+
+  TeamScore({
+    required this.userId,
+    required this.firstHalfScore,
+    required this.secondHalfScore,
+    required this.decisiveScore,
+    required this.ifWithdraw,
+  });
+
+  factory TeamScore.fromJson(Map<String, dynamic> json) => TeamScore(
+    userId: json['userId'],
+    firstHalfScore: json['firstHalfScore'],
+    secondHalfScore: json['secondHalfScore'],
+    decisiveScore: json['decisiveScore'],
+    ifWithdraw: json['ifWithdraw'],
+  );
+
+  Map<String, dynamic> toJson() => {
+    'userId': userId,
+    'firstHalfScore': firstHalfScore,
+    'secondHalfScore': secondHalfScore,
+    'decisiveScore': decisiveScore,
+    'ifWithdraw': ifWithdraw,
+  };
+}

lib/features/events/server/server_events.dart

@@ -5,6 +5,7 @@ import 'package:recording_tool/core/network/api_client.dart';
 import 'package:recording_tool/core/network/http_method.dart';
 import 'package:recording_tool/core/network/providers/dio_providers.dart';
 import 'package:recording_tool/features/events/model/model_event_info.dart';
+import 'package:recording_tool/features/events/request_model/request_model_event.dart';
 
 final eventsServerProvider = Provider<EventsServer>((ref) {
   return EventsServer(ref.watch(apiClientProvider));
@@ -34,4 +35,14 @@ class EventsServer {
       parser: StreamKeyResponse.fromJson,
     );
   }
+
+  /// 人工设置晋级/淘汰
+  Future<void> setTeamStatus({required SetTeamStatusReq req}) {
+    print('req: ${req.toJson()}');
+    return _apiClient.post(
+      AuthApi.setTeamStatus.path,
+      data: req.toJson(),
+      parser: (json) => json,
+    );
+  }
 }

lib/features/scan_qrcode/pages/page_scan_qrcode.dart

@@ -1,18 +1,17 @@
 import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
 import 'package:flutter_easyloading/flutter_easyloading.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:flutter_screenutil/flutter_screenutil.dart';
 import 'package:recording_tool/app/router/app_navigator.dart';
 import 'package:recording_tool/core/cache/app_storage.dart';
 import 'package:recording_tool/core/cache/storage_keys.dart';
-import 'package:recording_tool/features/auth/pages/page_auth.dart';
 import 'package:recording_tool/features/auth/view_model_auth/view_model_auth.dart';
+import 'package:recording_tool/features/competition_teams/pages/page_competition_team_list.dart';
 import 'package:recording_tool/features/events/model/model_event_info.dart';
 import 'package:recording_tool/features/events/pages/page_event_info.dart';
 import 'package:recording_tool/features/events/view_model/view_model_event_info.dart';
 import 'package:recording_tool/features/recording/model/model_recording_context.dart';
-import 'package:recording_tool/shared/widgets/app_bar.dart';
-import 'package:recording_tool/shared/widgets/app_button.dart';
 import 'package:recording_tool/shared/widgets/app_qr_scanner_dialog.dart';
 import 'package:recording_tool/shared/widgets/app_toast.dart';
 
@@ -33,128 +32,130 @@ class ScanQrCodePage extends ConsumerStatefulWidget {
   );
 
   @override
-  ConsumerState<ScanQrCodePage> createState() => _AuthPageWidgetState();
+  ConsumerState<ScanQrCodePage> createState() => _ScanQrCodePageState();
 }
 
-class _AuthPageWidgetState extends ConsumerState<ScanQrCodePage> {
+class _ScanQrCodePageState extends ConsumerState<ScanQrCodePage> {
   @override
   void initState() {
     super.initState();
     WidgetsBinding.instance.addPostFrameCallback((_) async {
       final token = AppStorage.getString(StorageKeys.authToken);
       if (token?.isNotEmpty ?? false) {
-        final success = await ref
+        // final success = await ref
-            .read(authProvider.notifier)
+        //     .read(authProvider.notifier)
-            .parseTokenSetState(token!);
+        //     .parseTokenSetState(token!);
-        if (!success) {
+        // if (!success) {
-          AppToast.show('请重新鉴权');
+        //   AppToast.show('请重新鉴权');
-          AppNavigator.pushAndRemoveUntil(const AuthPageWidget());
+        //   AppNavigator.pushAndRemoveUntil(const AuthPageWidget());
-          return;
+        //   return;
-        }
+        // }
       }
     });
   }
 
   @override
   Widget build(BuildContext context) {
+    final eventName = ref.watch(
+      authProvider.select(
+        (state) => state.jwtDecodedData?.eventName?.trim() ?? '',
+      ),
+    );
+
     return PopScope(
       canPop: true,
       onPopInvokedWithResult: (didPop, result) async {
         if (!didPop) return;
         await ref.read(authProvider.notifier).clearAuth();
       },
-      child: Scaffold(
+      child: AnnotatedRegion<SystemUiOverlayStyle>(
-        appBar: myAppBar(context: context, title: '扫码'),
+        value: SystemUiOverlayStyle.dark.copyWith(
-        body: Center(
+          statusBarColor: Colors.transparent,
-          child: Column(
+          systemNavigationBarColor: Colors.white,
+        ),
+        child: Scaffold(
+          backgroundColor: Colors.white,
+          body: Stack(
             children: [
-              SizedBox(height: 100.h),
+              Positioned(
-              Text(
+                top: 0,
-                '裁判工作台',
+                left: 0,
-                style: TextStyle(fontSize: 30, color: Colors.black),
+                right: 0,
+                child: Image.asset(
+                  _ScanAssets.pageBg,
+                  width: double.infinity,
+                  fit: BoxFit.fitWidth,
+                ),
               ),
-              SizedBox(height: 100.h),
+              SafeArea(
-              Text(
+                child: Padding(
-                '扫描选手参赛凭证进行执裁',
+                  padding: EdgeInsets.fromLTRB(16.w, 12.h, 16.w, 32.h),
-                style: TextStyle(fontSize: 30, color: Colors.black),
+                  child: Column(
-              ),
+                    crossAxisAlignment: CrossAxisAlignment.start,
-              SizedBox(height: 20.h),
+                    children: [
-
+                      const _BrandHeader(),
-              Consumer(
+                      SizedBox(height: 26.h),
-                builder: (context, ref, child) {
+                      Text(
-                  return SizedBox(
+                        eventName.isEmpty ? '赛事信息' : eventName,
-                    width: 280.w,
+                        maxLines: 2,
-                    height: 80.h,
+                        overflow: TextOverflow.ellipsis,
-                    child: AppButton(
+                        style: TextStyle(
-                      label: '查看录像',
+                          color: const Color(0xFF3C3F44),
-                      onPressed: () async {
+                          fontSize: 24.sp,
-                        final data = ref.watch(
+                          fontWeight: FontWeight.w700,
-                          authProvider.select((state) => state.jwtDecodedData),
+                          height: 1.25,
-                        );
+                        ),
-                        if (data == null) return;
+                      ),
-                        debugPrint('赛事名字： ${data.eventName}');
+                      const Spacer(flex: 134),
-                        final eventName = data.eventName ?? '';
+                      Center(
-                        await ref
+                        child: GestureDetector(
-                            .read(authProvider.notifier)
+                          behavior: HitTestBehavior.opaque,
-                            .getRecordList(eventName);
+                          onTap: _handleScan,
-                      },
+                          child: Image.asset(
-                      variant: AppButtonVariant.secondary,
+                            _ScanAssets.scanQrcode,
-                    ),
+                            width: 166.w,
-                  );
+                            height: 165.w,
-                },
+                            fit: BoxFit.contain,
-              ),
+                          ),
-              SizedBox(height: 16.h),
+                        ),
-
+                      ),
-              Consumer(
+                      SizedBox(height: 28.h),
-                builder: (context, ref, child) {
+                      Center(
-                  return SizedBox(
+                        child: Text(
-                    width: 280.w,
+                          '扫描选手参赛凭证进行执裁',
-                    height: 80.h,
+                          style: TextStyle(
-                    child: AppButton(
+                            color: const Color(0xFFABAFB6),
-                      label: '参赛队伍',
+                            fontSize: 16.sp,
-                      onPressed: () async {},
+                            fontWeight: FontWeight.w400,
-                      variant: AppButtonVariant.secondary,
+                            height: 1.2,
-                    ),
+                          ),
-                  );
+                        ),
-                },
+                      ),
-              ),
+                      const Spacer(flex: 211),
-              SizedBox(height: 16.h),
+                      Row(
-              SizedBox(
+                        children: [
-                width: 280.w,
+                          Expanded(
-                height: 80.h,
+                            child: _BottomOutlineButton(
-                child: AppButton(
+                              label: '查看录像',
-                  label: '扫码',
+                              onPressed: _handleViewRecords,
-                  onPressed: () async {
-                    final String? playerId = await AppQrScannerDialog.show(
-                      context,
-                    );
-                    if (playerId == null || playerId.isEmpty) {
-                      AppToast.show('查询选手信息失败');
-                      return;
-                    }
-                    EasyLoading.show(status: '查询选手信息...');
-                    try {
-                      final success = await ref
-                          .read(eventInfoProvider.notifier)
-                          .loadRegistrationList(
-                            request: PlayerRegistrationListReq(
-                              userId: playerId,
                             ),
-                          );
+                          ),
-                      EasyLoading.dismiss();
+                          SizedBox(width: 12.w),
-                      if (!success) {
+                          Expanded(
-                        AppToast.show('查询选手信息失败');
+                            child: _BottomOutlineButton(
-                        return;
+                              label: '参赛队伍',
-                      }
+                              onPressed: () async {
-                      if (!mounted) return;
+                                await AppNavigator.push(
-
+                                  const CompetitionTeamListPage(),
-                      AppNavigator.push(EventInfoPage(playerId: playerId));
+                                  context: context,
-                    } catch (error) {
+                                );
-                      AppToast.show('查询选手信息失败');
+                              },
-                      EasyLoading.dismiss();
+                            ),
-                    }
+                          ),
-                  },
+                        ],
-                  variant: AppButtonVariant.secondary,
+                      ),
+                    ],
+                  ),
                 ),
               ),
             ],
@@ -163,4 +164,125 @@ class _AuthPageWidgetState extends ConsumerState<ScanQrCodePage> {
       ),
     );
   }
+
+  Future<void> _handleScan() async {
+    final String? playerId = await AppQrScannerDialog.show(context);
+    if (playerId == null || playerId.isEmpty) {
+      AppToast.show('查询选手信息失败');
+      return;
+    }
+    EasyLoading.show(status: '查询选手信息...');
+    try {
+      final success = await ref
+          .read(eventInfoProvider.notifier)
+          .loadRegistrationList(
+            request: PlayerRegistrationListReq(userId: playerId),
+          );
+      EasyLoading.dismiss();
+      if (!success) {
+        AppToast.show('查询选手信息失败');
+        return;
+      }
+      if (!mounted) return;
+
+      AppNavigator.push(EventInfoPage(playerId: playerId));
+    } catch (error) {
+      EasyLoading.dismiss();
+      AppToast.show('查询选手信息失败');
+    }
+  }
+
+  Future<void> _handleViewRecords() async {
+    final eventName = ref.read(authProvider).jwtDecodedData?.eventName ?? '';
+    if (eventName.trim().isEmpty) {
+      AppToast.show('暂无赛事信息');
+      return;
+    }
+
+    EasyLoading.show(status: '查询录像...');
+    try {
+      final success = await ref
+          .read(authProvider.notifier)
+          .getRecordList(eventName);
+      EasyLoading.dismiss();
+      if (!success) {
+        AppToast.show('暂无录像');
+        return;
+      }
+      AppToast.show('录像列表已更新');
+    } catch (error) {
+      EasyLoading.dismiss();
+      AppToast.show('查询录像失败');
+    }
+  }
+}
+
+class _BrandHeader extends StatelessWidget {
+  const _BrandHeader();
+
+  @override
+  Widget build(BuildContext context) {
+    return Row(
+      mainAxisSize: MainAxisSize.min,
+      children: [
+        Image.asset(
+          _ScanAssets.appIcon,
+          width: 34.w,
+          height: 34.w,
+          fit: BoxFit.cover,
+        ),
+        SizedBox(width: 8.w),
+        Image.asset(
+          _ScanAssets.appNameText,
+          width: 117.w,
+          height: 29.w,
+          fit: BoxFit.contain,
+        ),
+      ],
+    );
+  }
+}
+
+class _BottomOutlineButton extends StatelessWidget {
+  const _BottomOutlineButton({required this.label, required this.onPressed});
+
+  final String label;
+  final VoidCallback onPressed;
+
+  @override
+  Widget build(BuildContext context) {
+    return SizedBox(
+      height: 38.h,
+      child: Material(
+        color: Colors.white.withValues(alpha: 0.08),
+        shape: StadiumBorder(
+          side: BorderSide(color: const Color(0xFF9CCEFF), width: 1.r),
+        ),
+        child: InkWell(
+          onTap: onPressed,
+          customBorder: const StadiumBorder(),
+          child: Center(
+            child: Text(
+              label,
+              style: TextStyle(
+                color: const Color(0xFF53A7F3),
+                fontSize: 14.sp,
+                fontWeight: FontWeight.w500,
+                height: 1.2,
+              ),
+            ),
+          ),
+        ),
+      ),
+    );
+  }
+}
+
+class _ScanAssets {
+  const _ScanAssets._();
+
+  static const pageBg = 'assets/images/image_page_bg.png';
+  static const appIcon = 'assets/images/image_app_icon.png';
+  static const appNameText = 'assets/images/image_app_name_text.png';
+  static const scanQrcode = 'assets/images/image_scan_qrcode.png';
 }

lib/gen/assets.gen.dart

@@ -24,32 +24,77 @@ class $AssetsHtmlGen {
 class $AssetsImagesGen {
   const $AssetsImagesGen();
 
-  /// File path: assets/images/image_copy.png
+  /// File path: assets/images/image_app_bar_bg.png
-  AssetGenImage get imageCopy =>
+  AssetGenImage get imageAppBarBg =>
-      const AssetGenImage('assets/images/image_copy.png');
+      const AssetGenImage('assets/images/image_app_bar_bg.png');
 
-  /// File path: assets/images/image_delete.png
+  /// File path: assets/images/image_app_icon.png
-  AssetGenImage get imageDelete =>
+  AssetGenImage get imageAppIcon =>
-      const AssetGenImage('assets/images/image_delete.png');
+      const AssetGenImage('assets/images/image_app_icon.png');
+
+  /// File path: assets/images/image_app_name_text.png
+  AssetGenImage get imageAppNameText =>
+      const AssetGenImage('assets/images/image_app_name_text.png');
+
+  /// File path: assets/images/image_blue_team.png
+  AssetGenImage get imageBlueTeam =>
+      const AssetGenImage('assets/images/image_blue_team.png');
 
   /// File path: assets/images/image_dialog_bg.png
   AssetGenImage get imageDialogBg =>
       const AssetGenImage('assets/images/image_dialog_bg.png');
 
+  /// File path: assets/images/image_event_info_bar_bg.png
+  AssetGenImage get imageEventInfoBarBg =>
+      const AssetGenImage('assets/images/image_event_info_bar_bg.png');
+
   /// File path: assets/images/image_logo.png
   AssetGenImage get imageLogo =>
       const AssetGenImage('assets/images/image_logo.png');
 
+  /// File path: assets/images/image_ok.png
+  AssetGenImage get imageOk =>
+      const AssetGenImage('assets/images/image_ok.png');
+
+  /// File path: assets/images/image_page_bg.png
+  AssetGenImage get imagePageBg =>
+      const AssetGenImage('assets/images/image_page_bg.png');
+
+  /// File path: assets/images/image_red_team.png
+  AssetGenImage get imageRedTeam =>
+      const AssetGenImage('assets/images/image_red_team.png');
+
+  /// File path: assets/images/image_scan.png
+  AssetGenImage get imageScan =>
+      const AssetGenImage('assets/images/image_scan.png');
+
+  /// File path: assets/images/image_scan_qrcode.png
+  AssetGenImage get imageScanQrcode =>
+      const AssetGenImage('assets/images/image_scan_qrcode.png');
+
+  /// File path: assets/images/image_start.png
+  AssetGenImage get imageStart =>
+      const AssetGenImage('assets/images/image_start.png');
+
   /// File path: assets/images/image_vs.png
   AssetGenImage get imageVs =>
       const AssetGenImage('assets/images/image_vs.png');
 
   /// List of all assets
   List<AssetGenImage> get values => [
-    imageCopy,
+    imageAppBarBg,
-    imageDelete,
+    imageAppIcon,
+    imageAppNameText,
+    imageBlueTeam,
     imageDialogBg,
+    imageEventInfoBarBg,
     imageLogo,
+    imageOk,
+    imagePageBg,
+    imageRedTeam,
+    imageScan,
+    imageScanQrcode,
+    imageStart,
     imageVs,
   ];
 }

lib/shared/widgets/app_bar.dart

@@ -1,31 +1,77 @@
 import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
 import 'package:flutter_screenutil/flutter_screenutil.dart';
+import 'package:recording_tool/app/router/app_navigator.dart';
+import 'package:recording_tool/gen/assets.gen.dart';
 
-AppBar myAppBar({
+/// 全局页面标题栏：背景图撑满 + 居中标题 + 返回按钮。
+/// 可直接赋给 [Scaffold.appBar]。
+class AppPageBar extends StatelessWidget implements PreferredSizeWidget {
+  const AppPageBar({
+    super.key,
+    this.title = '',
+    this.titleWidget,
+    this.backgroundImage,
+    this.onBack,
+    this.actions,
+  });
+
+  final String title;
+  final Widget? titleWidget;
+  final String? backgroundImage;
+  final VoidCallback? onBack;
+  final List<Widget>? actions;
+
+  @override
+  Size get preferredSize => const Size.fromHeight(kToolbarHeight);
+
+  @override
+  Widget build(BuildContext context) {
+    final imagePath = backgroundImage ?? Assets.images.imageAppBarBg.path;
+
+    return AppBar(
+      backgroundColor: Colors.transparent,
+      elevation: 0,
+      scrolledUnderElevation: 0,
+      centerTitle: true,
+      systemOverlayStyle: SystemUiOverlayStyle.light,
+      flexibleSpace: SizedBox.expand(
+        child: Image.asset(
+          imagePath,
+          fit: BoxFit.cover,
+          alignment: Alignment.center,
+        ),
+      ),
+      leading: IconButton(
+        icon: Icon(
+          Icons.chevron_left_rounded,
+          color: Colors.white,
+          size: 28.sp,
+        ),
+        onPressed: onBack ?? () => AppNavigator.pop(context: context),
+      ),
+      title:
+          titleWidget ??
+          Text(
+            title,
+            style: TextStyle(
+              color: Colors.white,
+              fontSize: 20.sp,
+              fontWeight: FontWeight.w600,
+              fontFamily: 'PingFang SC',
+            ),
+          ),
+      actions: actions,
+    );
+  }
+}
+
+/// 兼容旧调用；内部委托 [AppPageBar]。
+PreferredSizeWidget myAppBar({
   required BuildContext context,
   String title = '',
   Widget? titleWidget,
-}) => AppBar(
+  List<Widget>? actions,
-  leadingWidth: 56.w,
+}) {
-  leading: IconButton(
+  return AppPageBar(title: title, titleWidget: titleWidget, actions: actions);
-    icon: const Icon(Icons.arrow_back),
+}
-    onPressed: () {
-      Navigator.of(context).maybePop();
-    },
-  ),
-  title:
-      titleWidget ??
-      Text(
-        title,
-        textAlign: TextAlign.center,
-        style: TextStyle(
-          color: Colors.white,
-          fontSize: 20.sp,
-          fontFamily: 'PingFang SC',
-          fontWeight: FontWeight.w400,
-        ),
-      ),
-  centerTitle: true,
-  backgroundColor: Colors.transparent,
-  elevation: 0,
-);

lib/shared/widgets/widgets.dart

@@ -1,4 +1,5 @@
 export 'app_avatar.dart';
+export 'app_bar.dart';
 export 'app_button.dart';
 export 'app_card.dart';
 export 'app_dialog.dart';

packages/flutter_ume/.gitignore

@@ -0,0 +1,79 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+**/doc/api/
+.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+.pub-cache/
+.pub/
+build/
+*pubspec.lock
+
+# Android related
+**/android/**/gradle-wrapper.jar
+**/android/.gradle
+**/android/captures/
+**/android/gradlew
+**/android/gradlew.bat
+**/android/local.properties
+**/android/**/GeneratedPluginRegistrant.java
+
+# iOS/XCode related
+**/ios/**/*.mode1v3
+**/ios/**/*.mode2v3
+**/ios/**/*.moved-aside
+**/ios/**/*.pbxuser
+**/ios/**/*.perspectivev3
+**/ios/**/*sync/
+**/ios/**/.sconsign.dblite
+**/ios/**/.tags*
+**/ios/**/.vagrant/
+**/ios/**/DerivedData/
+**/ios/**/Icon?
+**/ios/**/Pods/
+**/ios/**/.symlinks/
+**/ios/**/profile
+**/ios/**/xcuserdata
+**/ios/.generated/
+**/ios/Flutter/App.framework
+**/ios/Flutter/Flutter.framework
+**/ios/Flutter/Flutter.podspec
+**/ios/Flutter/Generated.xcconfig
+**/ios/Flutter/app.flx
+**/ios/Flutter/app.zip
+**/ios/Flutter/flutter_assets/
+**/ios/Flutter/flutter_export_environment.sh
+**/ios/ServiceDefinitions.json
+**/ios/Runner/GeneratedPluginRegistrant.*
+
+# Exceptions to above rules.
+!**/ios/**/default.mode1v3
+!**/ios/**/default.mode2v3
+!**/ios/**/default.pbxuser
+!**/ios/**/default.perspectivev3
+!/packages/flutter_tools/test/data/dart_dependencies_test/**/.packages
+
+# Coverage
+**/coverage/output/
+**/coverage/new_lcov.info

packages/flutter_ume/.metadata

@@ -0,0 +1,10 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: 02c026b03cd31dd3f867e5faeb7e104cce174c5f
+  channel: unknown
+
+project_type: package

packages/flutter_ume/CHANGELOG.md

@@ -0,0 +1,84 @@
+# Changelog
+
+[简体中文](./CHANGELOG_cn.md)
+
+## [1.1.2]
+
+* #82 Fix flutter_logo.dart error in Flutter 3.0.5 
+
+## [1.1.1+1]
+
+* Update latest dependencies.
+
+## [1.1.1]
+
+* #66 [fix] toolbar initial position is incorrect
+
+## [1.1.0+3]
+
+* Fix static analyze issues.
+
+## [1.1.0+2]
+
+* Fix static analyze issues.
+
+## [1.1.0]
+
+* #76 Introduce `UMEWidget.closeActivatedPlugin()`. Issue #35
+* #75 Remove overlay entry only when it's been inserted. Issue #65
+* #72 [Android] Migrate the example to the v2 embedding
+
+## [1.0.2+1]
+
+* Dart format.
+
+## [1.0.2]
+
+* Fix error in code static analysis.
+
+## [1.0.1]
+
+* Fix error in pubspec.yaml in example
+
+## [1.0.0]
+
+* Normal version with adaption of Flutter 3.
+* Feature: Anywhere door (Route)
+
+## [1.0.0-dev.0]
+
+* Adapt Flutter 3.
+
+## [0.3.0+1]
+
+* Fix the version error
+
+## [0.3.0]
+
+* Remove static function. Use the `UMEWidget`.
+* Allow insert `Widget` into Widget tree, in order to access new plugin easily.
+* Fix the issue of multiple instances of FloatingWidget caused by the refresh state.
+* Fix the isseue that the plugin is not displayed due to the first layout exception in AOT mode
+
+## [0.3.0]
+
+* 移除静态方法，更换为壳 Widget
+* 允许在 Widget tree 增加自定义嵌套结构组件，从而快速接入新插件
+* 修复刷新状态引发的浮窗组件出现多实例的问题
+* 修复在 AOT 模式下首次布局异常导致插件不展示的问题
+
+## [0.2.1]
+
+* Remove the extra MaterialApp Widget
+
+## [0.2.0-dev.0]
+
+* Adapted Null-Safety.
+
+## [0.1.0+1]
+
+* Add some docs comments, modify description in pubspec.yaml.
+
+## [0.1.0]
+
+* Open source.

packages/flutter_ume/CHANGELOG_cn.md

@@ -0,0 +1,77 @@
+# Changelog
+
+[English](./CHANGELOG.md)
+
+## [1.1.2]
+
+* #82 修复 flutter_logo.dart 在 Flutter 3.0.5 上的错误
+
+## [1.1.1+1]
+
+* 更新依赖版本
+
+## [1.1.1]
+
+* #66 [fix] toolbar initial position is incorrect
+
+## [1.1.0+3]
+
+* 修复静态分析问题
+
+## [1.1.0+2]
+
+* 修复静态分析问题
+
+## [1.1.0]
+
+* #76 新增 `UMEWidget.closeActivatedPlugin()`。 Issue #35
+* #75 修复重复插入 Overlay 的问题。 Issue #65
+* #72 [Android] 迁移 example 到 v2 embedding。
+
+## [1.0.2+1]
+
+* Dart format
+
+## [1.0.2]
+
+* 修复静态分析错误
+
+## [1.0.1]
+
+* 修复 example 工程的 pubspec.yaml 错误
+
+## [1.0.0]
+
+* 适配 Flutter 3 正式版
+* 新功能：任意门（Route）
+
+## [1.0.0-dev.0]
+
+* 适配 Flutter 3
+
+## [0.3.0+1]
+
+* 修复版本号错误
+
+## [0.3.0]
+
+* 移除静态方法，更换为壳 Widget
+* 允许在 Widget tree 增加自定义嵌套结构组件，从而快速接入新插件
+* 修复刷新状态引发的浮窗组件出现多实例的问题
+* 修复在 AOT 模式下首次布局异常导致插件不展示的问题
+
+## [0.2.1]
+
+* 移除独立的 MaterialApp Widget
+
+## [0.2.0-dev.0]
+
+* 适配 null-safety
+
+## [0.1.0+1]
+
+* 增加一些 docs comment，修改 pubspec.yaml 的描述信息
+
+## [0.1.0]
+
+* 开源

packages/flutter_ume/CHANGELOG_en.md

@@ -0,0 +1,26 @@
+# Changelog
+
+[简体中文](./CHANGELOG.md)
+
+## [0.3.0]
+
+* Remove static function. Use the `UMEWidget`.
+* Allow insert `Widget` into Widget tree, in order to access new plugin easily.
+* Fix the issue of multiple instances of FloatingWidget caused by the refresh state.
+* Fix the isseue that the plugin is not displayed due to the first layout exception in AOT mode
+
+## [0.2.1]
+
+* Remove the extra MaterialApp Widget
+
+## [0.2.0-dev.0]
+
+* Adapted Null-Safety.
+
+## [0.1.0+1]
+
+* Add some docs comments, modify description in pubspec.yaml.
+
+## [0.1.0]
+
+* Open source.

packages/flutter_ume/CONTRIBUTING.md

@@ -0,0 +1,79 @@
+# Contributing
+
+[简体中文](./CONTRIBUTING_cn.md)
+
+Thank you for your interest in open source contributions.
+Not only the code, but also contributions such as issues and rich documents are also welcome.
+
+Please follow the guidelines in this article to make open source contributions to the UME project.
+
+- [Contributing](#contributing)
+  - [How to contact author](#how-to-contact-author)
+  - [How to raise an Issue](#how-to-raise-an-issue)
+  - [How to raise a Pull Request](#how-to-raise-a-pull-request)
+  - [Commit Message specification](#commit-message-specification)
+
+## How to contact author
+
+**Maybe...**
+
+- Found a bug in the code, or an error in the documentation
+- Produces an exception when you use the UME
+- UME is not compatible with the new version Flutter
+- Have a good idea or suggestion
+
+You can [submit an issue](#how-to-raise-an-issue) in any of the above situations。
+
+**Maybe...**
+
+- Communicate with the author
+- Communicate with more community developers
+- Cooperate with UME
+
+Welcome to [Join the ByteDance Flutter Exchange Group](https://applink.feishu.cn/client/chat/chatter/add_by_link?link_token=b07u55bb-68f0-4a4b-871d-687637766a68).
+
+Or contact [author](mailto:sunkai.dev@bytedance.com).
+
+## How to raise an Issue
+
+1. Go to [Issues](https://github.com/bytedance/flutter_ume/issues).
+2. Search for similar situations, if there is a match, directly feedback in it.
+3. If there is not, press [New issue](https://github.com/bytedance/flutter_ume/issues/new/choose) to raise a new one.
+4. Select a template.
+5. Describe your situation, and fill in the template.
+6. It is better to attach a demo that can reproduce the problem.
+
+## How to raise a Pull Request
+
+1. Fork the repository.
+2. Clone your fork repository.
+3. Checkout to the correct develop branch, and then create a new brnach based on the develop branch.
+4. Edit code.
+5. Edit test code in example project, and test it manually.
+6. Edit unit test in test directory.
+7. Commit your changes and push it. Please follow the [Commit Message specification](#commit-message-specification) to write the commit message.
+8. Create Pull Request in GitHub, and fill in the template.
+
+> Now, UME support null-safety and non-null-safety.
+> Null-safety version corresponds to `develop_nullsafety` branch, non-null-safety version corresponds to `develop` branch.
+> PR should be merged into the corresponding branch.
+
+## Commit Message specification
+
+1. Please use english.
+2. If you have references, please attach a link.
+3. Format: `[tags] description`
+   1. `tags` is the type of PR, such as `fix`, `feat`, `improve`.
+   2. `description` is used to describe changes.
+
+The following is a standard Commit message example:
+
+``` plaintext
+[fix] README.md document syntax error
+```
+
+``` plaintext
+[feat] New feature description
+
+[https://flutter.dev/dash](https://flutter.dev/dash)
+```

packages/flutter_ume/CONTRIBUTING_cn.md

@@ -0,0 +1,79 @@
+# Contributing
+
+[English](./CONTRIBUTING.md)
+
+感谢你对开源贡献感兴趣。
+不止是代码，提 issue、补充和扩展文档等贡献也都欢迎。
+
+请根据本文的指引，对 UME 项目进行开源贡献。
+
+- [Contributing](#contributing)
+  - [如何联系开发者](#如何联系开发者)
+  - [如何提 Issue](#如何提-issue)
+  - [如何提 Pull Request](#如何提-pull-request)
+  - [Commit Message 规范](#commit-message-规范)
+
+## 如何联系开发者
+
+**可能你：**
+
+- 发现文档错误、代码有 bug
+- 使用 UME 后应用运行产生异常
+- 发现新版本 Flutter 无法兼容
+- 有好的点子或产品建议
+
+上述情况均可以[提一个 issue](#how-to-issue)。
+
+**可能你：**
+
+- 想与开发者交流
+- 想与更多 Flutter 开发者交流
+- 想与 UME 开展交流或合作
+
+欢迎[加入字节跳动 Flutter 交流群](https://applink.feishu.cn/client/chat/chatter/add_by_link?link_token=b07u55bb-68f0-4a4b-871d-687637766a68)
+
+或随时[联系开发者](mailto:sunkai.dev@bytedance.com)
+
+## 如何提 Issue
+
+1. 点击本仓库的 [Issue 页面](https://github.com/bytedance/flutter_ume/issues)
+2. 先搜索是否有和你类似情况的 issue，若有请直接在该 issue 中反馈问题
+3. 若没有类似情况 issue，点击 [New issue 按钮](https://github.com/bytedance/flutter_ume/issues/new/choose)
+4. 选择一个适合你的 issue 模板
+5. 在模板中填写对应信息
+6. 如果有能复现问题的最简 Demo 就再好不过了
+
+## 如何提 Pull Request
+
+1. Fork 本仓库
+2. 将你 fork 的仓库 clone 到本地
+3. 切换到对应开发分支，并 checkout 出新分支
+4. 在本地修改代码
+5. 修改 example 工程的测试代码，并进行手工测试
+6. 在 test 目录下，修改单元测试
+7. 在本地提交改动并推送到你 fork 的仓库，commit message 格式请遵循本文 [Commit Message 规范](#commit-message) 部分
+8. 在 GitHub 上创建 Pull Request，在模板中填写对应信息
+
+> 目前，UME 同时支持 null-safety 版本与非 null-safety 版本。
+> null-safety 版本开发分支为 `develop_nullsafety`，非 null-safety 版本开发分支为 `develop`。
+> PR 需要合入对应的开发分支中。
+
+## Commit Message 规范
+
+1. 原则上请尽量使用英文
+2. 涉及到参考资料的，请附链接
+3. 格式：`[tags] description`
+   1. `tags` 为 PR 的类型，如 `fix` 修复错误、`feat` 新增功能、`improve` 改进代码或文档
+   2. `description` 为具体的改动描述
+
+以下为标准的 Commit message 示例：
+
+``` plaintext
+[fix] README.md document syntax error
+```
+
+``` plaintext
+[feat] New feature description
+
+[https://flutter.dev/dash](https://flutter.dev/dash)
+```

packages/flutter_ume/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 ByteDance Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

packages/flutter_ume/README.md

@@ -0,0 +1,471 @@
+# flutter_ume
+
+[简体中文](./README_cn.md)
+
+UME is an in-app debug kits platform for Flutter apps.
+
+[![platforms](https://img.shields.io/badge/platforms-ios%20%7C%20android%20%7C%20web%20%7C%20macos%20%7C%20windows%20%7C%20linux-lightgrey)](https://pub.dev/packages/flutter_ume) [![license](https://img.shields.io/github/license/bytedance/flutter_ume.svg)](https://github.com/bytedance/flutter_ume/blob/master/LICENSE)
+
+[![pub package](https://img.shields.io/pub/v/flutter_ume.svg)](https://pub.dev/packages/flutter_ume)
+[![pub package](https://img.shields.io/pub/likes/flutter_ume.svg)](https://pub.dev/packages/flutter_ume)
+[![pub package](https://img.shields.io/pub/points/flutter_ume.svg)](https://pub.dev/packages/flutter_ume)
+[![pub package](https://img.shields.io/pub/popularity/flutter_ume.svg)](https://pub.dev/packages/flutter_ume)
+[![pub package](https://img.shields.io/pub/publisher/flutter_ume.svg)](https://pub.dev/packages/flutter_ume)
+
+**Since `^1.0.0`, flutter_ume starts adapting to the Flutter 3. See [Quick Start] to learn more.**
+
+<img src="https://github.com/bytedance/flutter_ume/raw/master/apk_qrcode.png" width = "128" height = "128" alt="banner" />
+
+Scan QR code or click link to download apk. Try it now!
+https://github.com/bytedance/flutter_ume/releases/download/v0.2.1.0/app-debug.apk
+
+There are 13 plugin kits built in the latest open source version of UME.
+Developer could create custom plugin kits, and integrate them into UME.
+Visit [Develop plugin kits for UME](#develop-plugin-kits-for-ume) for more details.
+
+**Please see [Plugins from community](#plugins-from-community) to make your flutter_ume stronger.**
+
+- [flutter_ume](#flutter_ume)
+  - [Quick Start](#quick-start)
+  - [IMPORTANT](#important)
+  - [Features](#features)
+  - [Develop plugin kits for UME](#develop-plugin-kits-for-ume)
+    - [Access the nested widget debug kits quickly](#access-the-nested-widget-debug-kits-quickly)
+  - [How to use UME in Release/Profile mode](#how-to-use-ume-in-releaseprofile-mode)
+  - [About version](#about-version)
+    - [Compatibility](#compatibility)
+    - [Coverage](#coverage)
+    - [Version upgrade rules](#version-upgrade-rules)
+    - [Null-safety](#null-safety)
+    - [Change log](#change-log)
+  - [Contributing](#contributing)
+    - [Contributors](#contributors)
+    - [Plugins from community](#plugins-from-community)
+    - [About the third-party open-source project dependencies](#about-the-third-party-open-source-project-dependencies)
+  - [LICENSE](#license)
+  - [Contact the author](#contact-the-author)
+
+## Quick Start
+
+**All packages whose names are prefixed with `flutter_ume_kit_` are function**
+**plug-ins of UME, and users can access them according to demand**
+
+1. Edit `pubspec.yaml`, and add dependencies.
+
+    **Compatible with Flutter 3 since version `1.0.0`.**
+
+    ``` yaml
+    dev_dependencies:
+      flutter_ume: ^1.0.1
+      flutter_ume_kit_ui: ^1.0.0
+      flutter_ume_kit_device: ^1.0.0
+      flutter_ume_kit_perf: ^1.0.0
+      flutter_ume_kit_show_code: ^1.0.0
+      flutter_ume_kit_console: ^1.0.0
+      flutter_ume_kit_dio: ^1.0.0
+    ```
+
+
+    **↓ Null-safety version, compatible with Flutter 2.x**
+
+    ``` yaml
+    dev_dependencies: # Don't use UME in release mode
+      flutter_ume: ^0.3.0+1
+      flutter_ume_kit_ui: ^0.3.0+1
+      flutter_ume_kit_device: ^0.3.0
+      flutter_ume_kit_perf: ^0.3.0
+      flutter_ume_kit_show_code: ^0.3.0
+      flutter_ume_kit_console: ^0.3.0
+      flutter_ume_kit_dio: ^0.3.0
+    ```
+
+    **↓ Non-null-safety version, compatible with Flutter 1.x**
+
+    ``` yaml
+    dev_dependencies: # Don't use UME in release mode
+      flutter_ume: ^0.1.1
+      flutter_ume_kit_ui: ^0.1.1
+      flutter_ume_kit_device: ^0.1.1
+      flutter_ume_kit_perf: ^0.1.1
+      flutter_ume_kit_show_code: ^0.1.1
+      flutter_ume_kit_console: ^0.1.1 
+    ```
+
+2. Run `flutter pub get`
+3. Import packages
+
+    ``` dart
+    import 'package:flutter_ume/flutter_ume.dart'; // UME framework
+    import 'package:flutter_ume_kit_ui/flutter_ume_kit_ui.dart'; // UI kits
+    import 'package:flutter_ume_kit_perf/flutter_ume_kit_perf.dart'; // Performance kits
+    import 'package:flutter_ume_kit_show_code/flutter_ume_kit_show_code.dart'; // Show Code
+    import 'package:flutter_ume_kit_device/flutter_ume_kit_device.dart'; // Device info
+    import 'package:flutter_ume_kit_console/flutter_ume_kit_console.dart'; // Show debugPrint
+    import 'package:flutter_ume_kit_dio/flutter_ume_kit_dio.dart'; // Dio Inspector
+    ```
+
+4. Edit main method of your app, register plugin kits and initial UME
+
+    ``` dart
+    void main() {
+      if (kDebugMode) {
+        PluginManager.instance                                 // Register plugin kits
+          ..register(WidgetInfoInspector())
+          ..register(WidgetDetailInspector())
+          ..register(ColorSucker())
+          ..register(AlignRuler())
+          ..register(ColorPicker())                            // New feature
+          ..register(TouchIndicator())                         // New feature
+          ..register(Performance())
+          ..register(ShowCode())
+          ..register(MemoryInfoPage())
+          ..register(CpuInfoPage())
+          ..register(DeviceInfoPanel())
+          ..register(Console())
+          ..register(DioInspector(dio: dio));                  // Pass in your Dio instance
+        // After flutter_ume 0.3.0
+        runApp(UMEWidget(child: MyApp(), enable: true));
+        // Before flutter_ume 0.3.0
+        runApp(injectUMEWidget(child: MyApp(), enable: true));
+      } else {
+        runApp(MyApp());
+      }
+    }
+    ```
+
+5. `flutter run` for running
+   or `flutter build apk --debug`、`flutter build ios --debug` for building productions.
+
+  > Some functions rely on VM Service, and additional parameters need to be added for local operation to ensure that it can connect to the VM Service.
+  >
+  > Flutter 2.0.x, 2.2.x and other versions run on real devices, `flutter run` needs to add the `--disable-dds` parameter.
+  > After [Pull Request #80900](https://github.com/flutter/flutter/pull/80900) merging, `--disable-dds` was renamed to `--no-dds`.
+
+## IMPORTANT
+
+**From `0.1.1`/`0.2.1` version，we don't need set `useRootNavigator: false`.**
+The following section only applies to versions before version `0.1.1`/`0.2.1` .
+
+<s>
+
+Since UME manages the routing stack at the top level, methods such as `showDialog` use `rootNavigator` to pop up by default,
+therefore **must** pass in the parameter `useRootNavigator: false` in `showDialog`, `showGeneralDialog` and other 'show dialog' methods to avoid navigator errors.
+
+``` dart
+showDialog(
+  context: context,
+  builder: (ctx) => AlertDialog(
+        title: const Text('Dialog'),
+        actions: <Widget>[
+          TextButton(
+              onPressed: () => Navigator.pop(context),
+              child: const Text('OK'))
+        ],
+      ),
+  useRootNavigator: false); // <===== It's very IMPORTANT!
+```
+
+</s>
+
+## Features
+
+There are 13 plugin kits built in the current open source version of UME.
+
+<table border="1" width="100%">
+    <tr>
+        <td width="33.33%" align="center"><p>UI kits</p></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/widget_info.png" width="100%" alt="Widget Info" /></br>Widget Info</td>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/widget_detail.png" width="100%" alt="Widget Detail" /></br>Widget Detail</td>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/align_ruler.png" width="100%" alt="Align Ruler" /></br>Align Ruler</td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/color_picker.png" width="100%" alt="Color Picker" /></br>Color Picker</td>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/color_sucker.png" width="100%" alt="Color Sucker" /></br>Color Sucker</td>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/touch_indicator.png" width="100%" alt="Touch Indicator" /></br>Touch Indicator</td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><p>Performance Kits</p></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/memory_info.png" width="100%" alt="Memory Info" /></br>Memory Info</td>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/perf_overlay.png" width="100%" alt="Perf Overlay" /></br>Perf Overlay</td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><p>Device Info Kits</p></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/cpu_info.png" width="100%" alt="CPU Info" /></br>CPU Info</td>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/device_info.png" width="100%" alt="Device Info" /></br>Device Info</td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><p>Show Code</p></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/show_code.png" width="100%" alt="Show Code" /></br>Show Code</td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><p>Console</p></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/console.png" width="100%" alt="Console" /></br>Console</td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><p>Dio Inspector</p></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/dio_inspector.png" width="100%" alt="Dio Inspector" /></br>Dio Inspector</td>
+    </tr>
+</table>
+
+## Develop plugin kits for UME
+
+> UME plugins are located in the `./kits` directory, and each one is a `package`.
+> You can refer to the example in [`./custom_plugin_example`](./custom_plugin_example/) about this chapter.
+
+1. Run `flutter create -t package custom_plugin` to create your custom plugin kit, it could be `package` or `plugin`.
+2. Edit `pubspec.yaml` of the custom plugin kit to add UME framework dependency.
+
+    ``` yaml
+    dependencies:
+      flutter_ume: '>=0.3.0 <0.4.0'
+    ```
+
+3. Create the class of the plugin kit which should implement `Pluggable`.
+
+    ``` dart
+    import 'package:flutter_ume/flutter_ume.dart';
+
+    class CustomPlugin implements Pluggable {
+      CustomPlugin({Key key});
+
+      @override
+      Widget buildWidget(BuildContext context) => Container(
+        color: Colors.white
+        width: 100,
+        height: 100,
+        child: Center(
+          child: Text('Custom Plugin')
+        ),
+      ); // The panel of the plugin kit
+
+      @override
+      String get name => 'CustomPlugin'; // The name of the plugin kit
+
+      @override
+      String get displayName => 'CustomPlugin';
+
+      @override
+      void onTrigger() {} // Call when tap the icon of plugin kit
+
+      @override
+      ImageProvider<Object> get iconImageProvider => NetworkImage('url'); // The icon image of the plugin kit
+    }
+    ```
+
+4. Use your custom plugin kit in project
+
+    1. Edit `pubspec.yaml` of host app project to add `custom_plugin` dependency.
+
+        ``` yaml
+        dev_dependencies:
+          custom_plugin:
+            path: path/to/custom_plugin
+        ```
+
+    2. Run `flutter pub get`
+
+    3. Import package
+
+        ``` dart
+        import 'package:custom_plugin/custom_plugin.dart';
+        ```
+
+5. Edit main method of your app, register your custom_plugin plugin kit
+
+    ``` dart
+    if (kDebugMode) {
+      PluginManager.instance
+        ..register(CustomPlugin());
+      runApp(
+        UMEWidget(
+          child: MyApp(), 
+          enable: true
+        )
+      );
+    } else {
+      runApp(MyApp());
+    }
+    ```
+
+6. Run your app
+
+### Access the nested widget debug kits quickly
+
+We introduce the `PluggableWithNestedWidget` from `0.3.0`. It is used to insert nested Widgets in the Widget tree and quickly access embedded kits with nested widget.
+
+For more details, see [./kits/flutter_ume_kit_ui/lib/components/color_picker/color_picker.dart](https://github.com/bytedance/flutter_ume/blob/master/kits/flutter_ume_kit_ui/lib/components/color_picker/color_picker.dart) and [./kits/flutter_ume_kit_ui/lib/components/touch_indicator/touch_indicator.dart](https://github.com/bytedance/flutter_ume/blob/master/kits/flutter_ume_kit_ui/lib/components/touch_indicator/touch_indicator.dart).
+
+The key steps are as follows:
+
+1. The class of your plugin should implement `PluggableWithNestedWidget`.
+2. Implements `Widget buildNestedWidget(Widget child)`. Handling the nested widgets and returning the new Widget.
+
+## How to use UME in Release/Profile mode
+
+**Once you use flutter_ume in Release/Profile mode, you agree that you will**
+**bear the relevant risks by yourself.**
+
+**The maintainer of flutter_ume does not assume any responsibility for the accident**
+**caused by this.**
+
+**We recommend not to use it in Release/Profile mode for the following reasons:**
+
+1. VM Service is not available in these environments, so some functions are not available
+2. In this environment, developers need to isolate the app distribution channels by themselves to avoid submitting relevant debugging code to the production environment
+
+In order to use in Release/Profile mode, the details that need to be adjusted in the normal access process:
+
+1. In `pubspec.yaml`, `flutter_ume` and plugins should be write below `dependencies` rather than `dev_dependencies`.
+2. Don't put the code which call `PluginManager.instance.register()` and `UMEWidget(child: App())` into conditionals which represent debug mode. (Such as `kDebugMode`)
+3. Ensure the above details, run `flutter clean` and `flutter pub get`, then build your app.
+
+## About version
+
+### Compatibility
+
+| UME version | 1.12.13 | 1.22.3 | 2.0.1 | 2.2.3 | 2.5.3 | 2.8.0 | 3.0.5 | 3.3.1
+| ---- | ---- | ---- | ---- | ---- | ---- | ---- | ---- | ---- |
+| 0.1.x | ✅ | ✅ | ✅ | ✅ | ⚠️ | ⚠️ | ❌ | ❌ |
+| 0.2.x | ❌ | ❌ | ✅ | ✅ | ✅ | ⚠️ | ❌ | ❌ |
+| 0.3.x | ❌ | ❌ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
+| 1.0.x | ❌ | ❌ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ✅ | ✅ |
+| 1.1.x | ❌ | ❌ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ✅ | ✅ |
+
+⚠️ means the version has not been fully tested for compatibility.
+
+### Special case
+
+- Please use `flutter_ume_kit_ui: ^1.1.0` and above version when you are using Flutter 3.7 and above.
+
+### Coverage
+
+| Package | master | develop | develop_nullsafety |
+| ---- | ---- | ---- | ---- |
+| flutter_ume | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/coverage_badge.svg) |
+| flutter_ume_kit_device | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/kits/flutter_ume_kit_device/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop/kits/flutter_ume_kit_device/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/kits/flutter_ume_kit_device/coverage_badge.svg) |
+| flutter_ume_kit_perf | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/kits/flutter_ume_kit_perf/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop/kits/flutter_ume_kit_perf/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/kits/flutter_ume_kit_perf/coverage_badge.svg) |
+| flutter_ume_kit_show_code | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/kits/flutter_ume_kit_show_code/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop/kits/flutter_ume_kit_show_code/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/kits/flutter_ume_kit_show_code/coverage_badge.svg) |
+| flutter_ume_kit_ui | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/kits/flutter_ume_kit_ui/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop/kits/flutter_ume_kit_ui/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/kits/flutter_ume_kit_ui/coverage_badge.svg) |
+| flutter_ume_kit_console | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/kits/flutter_ume_kit_console/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop/kits/flutter_ume_kit_console/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/kits/flutter_ume_kit_console/coverage_badge.svg) |
+| flutter_ume_kit_dio | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/kits/flutter_ume_kit_dio/coverage_badge.svg) | N/A | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/kits/flutter_ume_kit_dio/coverage_badge.svg) |
+
+### Version upgrade rules
+
+Please refer to [Semantic versions](https://dart.dev/tools/pub/versioning#semantic-versions) for details.
+
+### Change log
+
+[Changelog](./CHANGELOG.md)
+
+## Contributing
+
+Contributing rules: [Contributing](./CONTRIBUTING_en.md)
+
+### Contributors
+
+Thanks to the following contributors (names not listed in order)：
+
+|  |  |
+| ---- | ---- |
+| ![ShirelyC](https://avatars.githubusercontent.com/u/11439167?s=64&v=4) | [ShirelyC](https://github.com/smileShirely) |
+| ![lpylpyleo](https://avatars.githubusercontent.com/u/15264428?s=64&v=4) | [lpylpyleo](https://github.com/lpylpyleo) |
+| ![Alex Li](https://avatars.githubusercontent.com/u/15884415?s=64&v=4) | [Alex Li](https://github.com/AlexV525) |
+| ![Swain](https://avatars.githubusercontent.com/u/7621572?s=64&v=4) | [Swain](https://github.com/talisk) |
+| ![mengdouer](https://avatars.githubusercontent.com/u/58758250?s=64&v=4) | [mengdouer](https://github.com/mengdouer) |
+| ![LAIIIHZ](https://avatars.githubusercontent.com/u/35956195?s=64&v=4) | [LAIIIHZ](https://github.com/laiiihz) |
+| ![XinLei](https://avatars.githubusercontent.com/u/23734225?s=64&v=4) | [XinLei](https://github.com/Vadaski) |
+| ![suli](https://avatars.githubusercontent.com/u/5837645?s=64&v=4) | [suli](https://github.com/suli1) |
+| ![wei-spring](https://avatars.githubusercontent.com/u/8155092?s=64&v=4) | [wei-spring](https://github.com/wei-spring) |
+
+### Plugins from community
+
+- [flutter_ume_kit_channel_monitor](https://pub.dev/packages/flutter_ume_kit_channel_monitor)
+  - Channel communication monitor
+  - Cource code: https://github.com/bytedance/flutter_ume/tree/master/kits/flutter_ume_kit_channel_monitor
+- [flutter_ume_kit_slow_animation](https://pub.dev/packages/flutter_ume_kit_slow_animation)
+  - Animation speed control
+  - Cource code: https://github.com/cfug/flutter_ume_kits
+- [flutter_ume_kit_shared_preferences](https://pub.dev/packages/flutter_ume_kit_shared_preferences)
+  - shared_preferences tool
+  - Cource code: https://github.com/cfug/flutter_ume_kits
+- [flutter_ume_kit_designer_check](https://pub.dev/packages/)
+  - Comparing tool for Design UI and real UI
+  - Cource code: https://github.com/cfug/flutter_ume_kits
+- [flutter_ume_kit_clean_local_data](https://pub.dev/packages/flutter_ume_kit_clean_local_data)
+  - Clean local data
+  - Cource code: https://github.com/cfug/flutter_ume_kits 。
+- [flutter_ume_kit_database_kit](https://pub.dev/packages/flutter_ume_kit_database_kit)
+  - DB tool
+  - Cource code: https://github.com/cfug/flutter_ume_kits 。
+- [ume_kit_monitor](https://pub.dev/packages/ume_kit_monitor)
+  - Parameters monitor tools
+  - Cource code: https://github.com/fastcode555/ume_kit_monitor 。
+- [json2dart_viewerffi](https://pub.dev/packages/json2dart_viewerffi)
+  - DB tool
+  - Cource code: https://github.com/fastcode555/Json2Dart_Null_Safety 。
+- [json2dart_viewer](https://pub.dev/packages/json2dart_viewer)
+  - DB tool
+  - Cource code: https://github.com/fastcode555/Json2Dart_Null_Safety 。
+- [memory_detector_of_kit](https://github.com/bladeofgod/memory_detector_of_kit)
+  - Leaks tool
+- [channel_observer_of_kit](https://github.com/bladeofgod/channel_observer_of_kit)
+  - Channel communication monitor
+- [flutter-ume-kit-dio-enhance](https://github.com/linversion/flutter-ume-kit-dio-enhance)
+  - Plugin base on flutter_ume_kit_dio
+
+### About the third-party open-source project dependencies
+
+- The TouchIndicator use the pub [touch_indicator](https://pub.dev/packages/touch_indicator), the ColorPicker use the pub [cyclop](https://pub.dev/packages/cyclop).
+- We [fork](https://github.com/talisk/cyclop) the package [cyclop](https://pub.dev/packages/cyclop) and modify some code meet our functional needs. We should depend cyclop by pub version after the [PR](https://github.com/rxlabz/cyclop/pull/11) being merged.
+
+## LICENSE
+
+This project is licensed under the MIT License - visit the [LICENSE](./LICENSE) for details.
+
+## Contact the author
+
+**Maybe...**
+
+- Found a bug in the code, or an error in the documentation
+- Produces an exception when you use the UME
+- UME is not compatible with the new version Flutter
+- Have a good idea or suggestion
+
+You can [submit an issue](./CONTRIBUTING_en.md#how-to-raise-an-issue) in any of the above situations.
+
+**Maybe...**
+
+- Communicate with the author
+- Communicate with more community developers
+- Cooperate with UME
+
+Welcome to [Join the ByteDance Flutter Exchange Group](https://applink.feishu.cn/client/chat/chatter/add_by_link?link_token=67au2f75-3783-41b0-8868-0fc0178f1fd8).
+
+Or contact [author](mailto:sunkai.dev@bytedance.com).

packages/flutter_ume/README_cn.md

@@ -0,0 +1,470 @@
+# flutter_ume
+
+[English](./README.md)
+
+Flutter 应用内调试工具平台
+
+[![platforms](https://img.shields.io/badge/platforms-ios%20%7C%20android%20%7C%20web%20%7C%20macos%20%7C%20windows%20%7C%20linux-lightgrey)](https://pub.dev/packages/flutter_ume) [![license](https://img.shields.io/github/license/bytedance/flutter_ume.svg)](https://github.com/bytedance/flutter_ume/blob/master/LICENSE)
+
+[![pub package](https://img.shields.io/pub/v/flutter_ume.svg)](https://pub.dev/packages/flutter_ume)
+[![pub package](https://img.shields.io/pub/likes/flutter_ume.svg)](https://pub.dev/packages/flutter_ume)
+[![pub package](https://img.shields.io/pub/points/flutter_ume.svg)](https://pub.dev/packages/flutter_ume)
+[![pub package](https://img.shields.io/pub/popularity/flutter_ume.svg)](https://pub.dev/packages/flutter_ume)
+[![pub package](https://img.shields.io/pub/publisher/flutter_ume.svg)](https://pub.dev/packages/flutter_ume)
+
+**Since `^1.0.0`, flutter_ume starts adapting to the Flutter 3. See [Quick Start] to learn more.**
+
+<img src="https://github.com/bytedance/flutter_ume/raw/master/apk_qrcode.png" width = "128" height = "128" alt="banner" />
+
+扫码或点击链接下载 apk，快速体验 UME。
+https://github.com/bytedance/flutter_ume/releases/download/v0.2.1.0/app-debug.apk
+
+最新版本(1.0.1)内置 13 个插件，
+开发者可以创建自己的插件，并集成进 UME 平台。
+详见本文[为 UME 开发插件](#为-ume-开发插件)部分。
+
+**更多开源社区贡献的调试插件，请见[社区插件](#社区插件)部分。**
+
+- [flutter_ume](#flutter_ume)
+  - [快速接入](#快速接入)
+  - [特别说明](#特别说明)
+  - [功能介绍](#功能介绍)
+  - [为 UME 开发插件](#为-ume-开发插件)
+    - [快速集成嵌入式插件](#快速集成嵌入式插件)
+  - [如何在 Release/Profile mode 下使用 UME](#如何在-releaseprofile-mode-下使用-ume)
+  - [版本说明](#版本说明)
+    - [兼容性](#兼容性)
+    - [单测覆盖率](#单测覆盖率)
+    - [版本号规则](#版本号规则)
+    - [Null-safety 版本](#null-safety-版本)
+    - [更新日志](#更新日志)
+  - [开源贡献](#开源贡献)
+    - [贡献者](#贡献者)
+    - [社区插件](#社区插件)
+    - [第三方开源项目说明](#第三方开源项目说明)
+  - [开源协议](#开源协议)
+  - [联系开发者](#联系开发者)
+
+## 快速接入
+
+**所有名称前缀为 `flutter_ume_kit_` 的 package 都是 UME 的功能插件，**
+**用户可按需接入。**
+
+1. 修改 `pubspec.yaml`，添加依赖
+
+    **自 `1.0.0` 版本开始适配 Flutter 3。**
+
+    ``` yaml
+    dev_dependencies:
+      flutter_ume: ^1.0.1
+      flutter_ume_kit_ui: ^1.0.0
+      flutter_ume_kit_device: ^1.0.0
+      flutter_ume_kit_perf: ^1.0.0
+      flutter_ume_kit_show_code: ^1.0.0
+      flutter_ume_kit_console: ^1.0.0
+      flutter_ume_kit_dio: ^1.0.0
+    ```
+
+    **↓ Null-safety 版本，适用于 Flutter 2.x**
+
+    ``` yaml
+    dev_dependencies:
+      flutter_ume: ^0.3.0+1
+      flutter_ume_kit_ui: ^0.3.0+1
+      flutter_ume_kit_device: ^0.3.0
+      flutter_ume_kit_perf: ^0.3.0
+      flutter_ume_kit_show_code: ^0.3.0
+      flutter_ume_kit_console: ^0.3.0
+      flutter_ume_kit_dio: ^0.3.0
+    ```
+
+    **↓ 非 Null-safety 版本，适用于 Flutter 1.x**
+
+    ``` yaml
+    dev_dependencies:
+      flutter_ume: ^0.1.1
+      flutter_ume_kit_ui: ^0.1.1
+      flutter_ume_kit_device: ^0.1.1
+      flutter_ume_kit_perf: ^0.1.1
+      flutter_ume_kit_show_code: ^0.1.1
+      flutter_ume_kit_console: ^0.1.1
+    ```
+
+2. 执行 `flutter pub get`
+3. 引入包
+
+    ``` dart
+    import 'package:flutter_ume/flutter_ume.dart'; // UME 框架
+    import 'package:flutter_ume_kit_ui/flutter_ume_kit_ui.dart'; // UI 插件包
+    import 'package:flutter_ume_kit_perf/flutter_ume_kit_perf.dart'; // 性能插件包
+    import 'package:flutter_ume_kit_show_code/flutter_ume_kit_show_code.dart'; // 代码查看插件包
+    import 'package:flutter_ume_kit_device/flutter_ume_kit_device.dart'; // 设备信息插件包
+    import 'package:flutter_ume_kit_console/flutter_ume_kit_console.dart'; // debugPrint 插件包
+    import 'package:flutter_ume_kit_dio/flutter_ume_kit_dio.dart'; // Dio 网络请求调试工具
+    ```
+
+4. 修改程序入口，增加初始化方法及注册插件代码
+
+    ``` dart
+    void main() {
+      if (kDebugMode) {
+        PluginManager.instance                                 // 注册插件
+          ..register(WidgetInfoInspector())
+          ..register(WidgetDetailInspector())
+          ..register(ColorSucker())
+          ..register(AlignRuler())
+          ..register(ColorPicker())                            // 新插件
+          ..register(TouchIndicator())                         // 新插件
+          ..register(Performance())
+          ..register(ShowCode())
+          ..register(MemoryInfoPage())
+          ..register(CpuInfoPage())
+          ..register(DeviceInfoPanel())
+          ..register(Console())
+          ..register(DioInspector(dio: dio));                  // 传入你的 Dio 实例
+        // flutter_ume 0.3.0 版本之后
+        runApp(UMEWidget(child: MyApp(), enable: true)); // 初始化
+        // flutter_ume 0.3.0 版本之前
+        runApp(injectUMEWidget(child: MyApp(), enable: true)); // 初始化
+      } else {
+        runApp(MyApp());
+      }
+    }
+    ```
+
+5. `flutter run` 运行代码
+   或 `flutter build apk --debug`、`flutter build ios --debug` 构建产物
+
+  > 部分功能依赖 VM Service，本地运行需要添加额外参数，以确保能够连接到 VM Service。
+  >
+  > Flutter 2.0.x、2.2.x 等版本在真机上运行，`flutter run` 需要添加 `--disable-dds` 参数。
+  > 在 [Pull Request #80900](https://github.com/flutter/flutter/pull/80900) 合入之后，`--disable-dds` 参数被更名为 `--no-dds`。
+
+## 特别说明
+
+**自 `0.1.1`/`0.2.1` 版本起，已经不需要设置 `useRootNavigator: false`。**
+以下部分仅适用于 `0.1.1`/`0.2.1` 之前的版本。
+
+<s>
+
+由于 UME 在顶层管理了路由栈，`showDialog` 等方法默认使用 `rootNavigator` 弹出，
+所以**必须**在 `showDialog`、`showGeneralDialog` 等弹窗方法，传入参数 `useRootNavigator: false` 避免路由栈错误。
+
+``` dart
+showDialog(
+  context: context,
+  builder: (ctx) => AlertDialog(
+        title: const Text('Dialog'),
+        actions: <Widget>[
+          TextButton(
+              onPressed: () => Navigator.pop(context),
+              child: const Text('OK'))
+        ],
+      ),
+  useRootNavigator: false); // <===== 非常重要
+```
+
+</s>
+
+## 功能介绍
+
+当前开源版 UME 内置了 13 个插件
+
+<table border="1" width="100%">
+    <tr>
+        <td width="33.33%" align="center"><p>UI 工具包</p></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/widget_info.png" width="100%" alt="Widget 信息" /></br>Widget 信息</td>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/widget_detail.png" width="100%" alt="Widget 详情" /></br>Widget 详情</td>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/align_ruler.png" width="100%" alt="对齐标尺" /></br>对齐标尺</td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/color_picker.png" width="100%" alt="颜色吸管（新）" /></br>颜色吸管（新）</td>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/color_sucker.png" width="100%" alt="颜色吸管" /></br>颜色吸管</td>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/touch_indicator.png" width="100%" alt="触控标记" /></br>触控标记</td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><p>性能工具包</p></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/memory_info.png" width="100%" alt="内存信息" /></br>内存信息</td>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/perf_overlay.png" width="100%" alt="性能浮层" /></br>性能浮层</td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><p>设备信息工具包</p></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/cpu_info.png" width="100%" alt="CPU 信息" /></br>CPU 信息</td>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/device_info.png" width="100%" alt="设备信息" /></br>设备信息</td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><p>代码查看</p></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/show_code.png" width="100%" alt="代码查看" /></br>代码查看</td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><p>日志展示</p></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/console.png" width="100%" alt="日志展示" /></br>日志展示</td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><p>Dio 网络请求调试工具</p></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/dio_inspector.png" width="100%" alt="Dio 网络请求调试工具" /></br>Dio 网络请求调试工具</td>
+    </tr>
+</table>
+
+## 为 UME 开发插件
+
+> UME 插件位于 `./kits` 目录下，每个插件包都是一个 `package`
+> 本小节示例可参考 [`./custom_plugin_example`](./custom_plugin_example/)
+
+1. `flutter create -t package custom_plugin` 创建一个插件包，可以是 `package`，也可以是 `plugin`
+2. 修改插件包的 `pubspec.yaml`，添加依赖
+
+    ``` yaml
+    dependencies:
+      flutter_ume: '>=0.3.0 <0.4.0'
+    ```
+
+3. 创建插件配置，实现 `Pluggable` 虚类
+
+    ``` dart
+    import 'package:flutter_ume/flutter_ume.dart';
+
+    class CustomPlugin implements Pluggable {
+      CustomPlugin({Key key});
+
+      @override
+      Widget buildWidget(BuildContext context) => Container(
+        color: Colors.white
+        width: 100,
+        height: 100,
+        child: Center(
+          child: Text('Custom Plugin')
+        ),
+      ); // 返回插件面板
+
+      @override
+      String get name => 'CustomPlugin'; // 插件名称
+
+      @override
+      String get displayName => 'CustomPlugin';
+
+      @override
+      void onTrigger() {} // 点击插件面板图标时调用
+
+      @override
+      ImageProvider<Object> get iconImageProvider => NetworkImage('url'); // 插件图标
+    }
+    ```
+
+4. 在工程中引入自定义插件
+
+    1. 修改 `pubspec.yaml`，添加依赖
+
+        ``` yaml
+        dev_dependencies:
+          custom_plugin:
+            path: path/to/custom_plugin
+        ```
+
+    2. 执行 `flutter pub get`
+
+    3. 引入包
+
+        ``` dart
+        import 'package:custom_plugin/custom_plugin.dart';
+        ```
+
+5. 在工程中注册插件
+
+    ``` dart
+    if (kDebugMode) {
+      PluginManager.instance
+        ..register(CustomPlugin());
+      runApp(
+        UMEWidget(
+          child: MyApp(), 
+          enable: true
+        )
+      );
+    } else {
+      runApp(MyApp());
+    }
+    ```
+
+6. 运行代码
+
+### 快速集成嵌入式插件
+
+自 `0.3.0` 版本起引入了 `PluggableWithNestedWidget`，用以实现在 Widget tree 中插入嵌套 Widget，快速接入嵌入式插件。
+
+可参考 [./kits/flutter_ume_kit_ui/lib/components/color_picker/color_picker.dart](https://github.com/bytedance/flutter_ume/blob/master/kits/flutter_ume_kit_ui/lib/components/color_picker/color_picker.dart) 与 [./kits/flutter_ume_kit_ui/lib/components/touch_indicator/touch_indicator.dart](https://github.com/bytedance/flutter_ume/blob/master/kits/flutter_ume_kit_ui/lib/components/touch_indicator/touch_indicator.dart)。
+
+集成重点如下：
+
+1. 插件主体类实现 `PluggableWithNestedWidget`
+2. 实现 `Widget buildNestedWidget(Widget child)`，在该方法中处理嵌套结构并返回 Widget
+
+## 如何在 Release/Profile mode 下使用 UME
+
+**开发者一旦在 Release/Profile mode 下使用 flutter_ume，**
+**即认同将自行承担相关风险，**
+
+**对于由此引发的事故，flutter_ume 维护方不承担**
+**任何责任。**
+
+**不建议在 Release/Profile mode 下使用，原因如下：**
+
+1. 在该环境下 VM Service 不可用，因此部分插件功能不可用
+2. 在该环境下开发者需要自行隔离分发渠道，避免将相关调试代码提交到生产环境
+
+为在 Release/Profile mode 下使用，正常接入流程中需要调整的细节：
+
+1. `pubspec.yaml` 中，`flutter_ume` 及相关插件包需要在 `dependencies` 中引入，而不是 `dev_dependencies`
+2. 调用 `PluginManager.instance.register()` 及 `UMEWidget(child: App())` 初始化方法的代码，不得由于 debug 标记剪枝（如 `kDebugMode`）
+3. 确保以上细节后，依次执行 `flutter clean`、`flutter pub get` 后再进行构建
+
+## 版本说明
+
+### 兼容性
+
+| UME 版本 | 1.12.13 | 1.22.3 | 2.0.1 | 2.2.3 | 2.5.3 | 2.8.0 | 3.0.5 | 3.3.1
+| ---- | ---- | ---- | ---- | ---- | ---- | ---- | ---- | ---- |
+| 0.1.x | ✅ | ✅ | ✅ | ✅ | ⚠️ | ⚠️ | ❌ | ❌ |
+| 0.2.x | ❌ | ❌ | ✅ | ✅ | ✅ | ⚠️ | ❌ | ❌ |
+| 0.3.x | ❌ | ❌ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
+| 1.0.x | ❌ | ❌ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ✅ | ✅ |
+| 1.1.x | ❌ | ❌ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ✅ | ✅ |
+
+⚠️ 意为未经过完整的兼容性测试，不建议使用。
+
+### 特例
+
+- Flutter 3.7 及以上版本请使用 `flutter_ume_kit_ui: ^1.1.0` 及以上版本
+
+### 单测覆盖率
+
+| 包 | master | develop | develop_nullsafety |
+| ---- | ---- | ---- | ---- |
+| flutter_ume | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/coverage_badge.svg) |
+| flutter_ume_kit_device | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/kits/flutter_ume_kit_device/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop/kits/flutter_ume_kit_device/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/kits/flutter_ume_kit_device/coverage_badge.svg) |
+| flutter_ume_kit_perf | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/kits/flutter_ume_kit_perf/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop/kits/flutter_ume_kit_perf/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/kits/flutter_ume_kit_perf/coverage_badge.svg) |
+| flutter_ume_kit_show_code | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/kits/flutter_ume_kit_show_code/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop/kits/flutter_ume_kit_show_code/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/kits/flutter_ume_kit_show_code/coverage_badge.svg) |
+| flutter_ume_kit_ui | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/kits/flutter_ume_kit_ui/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop/kits/flutter_ume_kit_ui/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/kits/flutter_ume_kit_ui/coverage_badge.svg) |
+| flutter_ume_kit_console | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/kits/flutter_ume_kit_console/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop/kits/flutter_ume_kit_console/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/kits/flutter_ume_kit_console/coverage_badge.svg) |
+| flutter_ume_kit_dio | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/kits/flutter_ume_kit_dio/coverage_badge.svg) | N/A | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/kits/flutter_ume_kit_dio/coverage_badge.svg) |
+
+### 版本号规则
+
+请参考 [Semantic versions](https://dart.dev/tools/pub/versioning#semantic-versions)
+
+### 更新日志
+
+[Changelog](./CHANGELOG_cn.md)
+
+## 开源贡献
+
+贡献文档：[Contributing](./CONTRIBUTING.md)
+
+### 贡献者
+
+感谢以下贡献者（排名不分先后）：
+
+|  |  |
+| ---- | ---- |
+| ![ShirelyC](https://avatars.githubusercontent.com/u/11439167?s=64&v=4) | [ShirelyC](https://github.com/smileShirely) |
+| ![lpylpyleo](https://avatars.githubusercontent.com/u/15264428?s=64&v=4) | [lpylpyleo](https://github.com/lpylpyleo) |
+| ![Alex Li](https://avatars.githubusercontent.com/u/15884415?s=64&v=4) | [Alex Li](https://github.com/AlexV525) |
+| ![Swain](https://avatars.githubusercontent.com/u/7621572?s=64&v=4) | [Swain](https://github.com/talisk) |
+| ![mengdouer](https://avatars.githubusercontent.com/u/58758250?s=64&v=4) | [mengdouer](https://github.com/mengdouer) |
+| ![LAIIIHZ](https://avatars.githubusercontent.com/u/35956195?s=64&v=4) | [LAIIIHZ](https://github.com/laiiihz) |
+| ![XinLei](https://avatars.githubusercontent.com/u/23734225?s=64&v=4) | [XinLei](https://github.com/Vadaski) |
+| ![suli](https://avatars.githubusercontent.com/u/5837645?s=64&v=4) | [suli](https://github.com/suli1) |
+| ![wei-spring](https://avatars.githubusercontent.com/u/8155092?s=64&v=4) | [wei-spring](https://github.com/wei-spring) |
+
+### 社区插件
+
+- [flutter_ume_kit_channel_monitor](https://pub.dev/packages/flutter_ume_kit_channel_monitor)
+  - channel 通信监控工具
+  - 源代码托管于 https://github.com/bytedance/flutter_ume/tree/master/kits/flutter_ume_kit_channel_monitor
+- [flutter_ume_kit_slow_animation](https://pub.dev/packages/flutter_ume_kit_slow_animation)
+  - 动画速度调节插件
+  - 源代码托管于 https://github.com/cfug/flutter_ume_kits
+- [flutter_ume_kit_shared_preferences](https://pub.dev/packages/flutter_ume_kit_shared_preferences)
+  - shared_preferences 调试工具
+  - 源代码托管于 https://github.com/cfug/flutter_ume_kits
+- [flutter_ume_kit_designer_check](https://pub.dev/packages/)
+  - 设计稿比对工具
+  - 源代码托管于 https://github.com/cfug/flutter_ume_kits
+- [flutter_ume_kit_clean_local_data](https://pub.dev/packages/flutter_ume_kit_clean_local_data)
+  - 清理本地数据插件
+  - 源代码托管于 https://github.com/cfug/flutter_ume_kits 。
+- [flutter_ume_kit_database_kit](https://pub.dev/packages/flutter_ume_kit_database_kit)
+  - 数据库调试插件
+  - 源代码托管于 https://github.com/cfug/flutter_ume_kits 。
+- [ume_kit_monitor](https://pub.dev/packages/ume_kit_monitor)
+  - 参数监控插件
+  - 源代码托管于 https://github.com/fastcode555/ume_kit_monitor 。
+- [json2dart_viewerffi](https://pub.dev/packages/json2dart_viewerffi)
+  - 数据库调试插件
+  - 源代码托管于 https://github.com/fastcode555/Json2Dart_Null_Safety 。
+- [json2dart_viewer](https://pub.dev/packages/json2dart_viewer)
+  - 数据库调试插件
+  - 源代码托管于 https://github.com/fastcode555/Json2Dart_Null_Safety 。
+- [memory_detector_of_kit](https://github.com/bladeofgod/memory_detector_of_kit)
+  - 内存泄漏检测插件
+- [channel_observer_of_kit](https://github.com/bladeofgod/channel_observer_of_kit)
+  - channel 调用记录监控插件
+- [flutter-ume-kit-dio-enhance](https://github.com/linversion/flutter-ume-kit-dio-enhance)
+  - 基于 flutter_ume_kit_dio 扩展了一些功能的插件
+
+### 第三方开源项目说明
+
+- 触控标记使用了 [touch_indicator](https://pub.dev/packages/touch_indicator)，颜色吸管插件使用了 [cyclop](https://pub.dev/packages/cyclop)。
+- 对 [cyclop](https://pub.dev/packages/cyclop) 进行了 [fork](https://github.com/talisk/cyclop) 并修改代码以满足需要。当 [PR](https://github.com/rxlabz/cyclop/pull/11) 合入后，我们将通过 pub 的形式依赖。
+
+## 开源协议
+
+该项目遵循 MIT 协议，详情请见 [LICENSE](./LICENSE)。
+
+## 联系开发者
+
+**可能你：**
+
+- 发现文档错误、代码有 bug
+- 使用 UME 后应用运行产生异常
+- 发现新版本 Flutter 无法兼容
+- 有好的点子或产品建议
+
+上述情况均可以[提一个 issue](./CONTRIBUTING.md#如何提-issue)。
+
+**可能你：**
+
+- 想与开发者交流
+- 想与更多 Flutter 开发者交流
+- 想与 UME 开展交流或合作
+
+欢迎[加入字节跳动 Flutter 交流群](https://applink.feishu.cn/client/chat/chatter/add_by_link?link_token=67au2f75-3783-41b0-8868-0fc0178f1fd8)
+
+或随时[联系开发者](mailto:sunkai.dev@bytedance.com)

packages/flutter_ume/README_en.md

@@ -0,0 +1,419 @@
+# flutter_ume
+
+[简体中文](./README.md)
+
+UME is an in-app debug kits platform for Flutter apps.
+
+[![platforms](https://img.shields.io/badge/platforms-ios%20%7C%20android%20%7C%20web%20%7C%20macos%20%7C%20windows%20%7C%20linux-lightgrey)](https://pub.dev/packages/flutter_ume) [![license](https://img.shields.io/github/license/bytedance/flutter_ume.svg)](https://github.com/bytedance/flutter_ume/blob/master/LICENSE) [![latest](https://img.shields.io/pub/vpre/flutter_ume.svg)](https://pub.dev/packages/flutter_ume) ![![likes](https://badges.bar/flutter_ume/likes)](https://pub.dev/packages/flutter_ume/score) ![![popularity](https://badges.bar/flutter_ume/popularity)](https://pub.dev/packages/flutter_ume/score) ![![pub points](https://badges.bar/flutter_ume/pub%20points)](https://pub.dev/packages/flutter_ume/score)
+
+<img src="https://github.com/bytedance/flutter_ume/raw/master/ume_logo_256.png" width = "128" height = "128" alt="banner" />
+
+**UME Kits competition is in full swing!** Rich prizes are waiting for you.
+
+See https://mp.weixin.qq.com/s/RuwiiQAdrGqI00fDhUO77g for more details.
+
+<img src="https://github.com/bytedance/flutter_ume/raw/master/apk_qrcode.png" width = "256" height = "256" alt="banner" />
+
+Scan QR code or click link to download apk. Try it now!
+https://github.com/bytedance/flutter_ume/releases/download/v0.2.1.0/app-debug.apk
+
+There are 13 plugin kits built in the latest open source version of UME.
+Developer could create custom plugin kits, and integrate them into UME.
+Visit [Develop plugin kits for UME](#develop-plugin-kits-for-ume) for more details.
+
+- [flutter_ume](#flutter_ume)
+  - [Quick Start](#quick-start)
+  - [IMPORTANT](#important)
+  - [Features](#features)
+  - [Develop plugin kits for UME](#develop-plugin-kits-for-ume)
+    - [Access the nested widget debug kits quickly](#access-the-nested-widget-debug-kits-quickly)
+  - [How to use UME in Release/Profile mode](#how-to-use-ume-in-releaseprofile-mode)
+  - [About version](#about-version)
+    - [Compatibility](#compatibility)
+    - [Coverage](#coverage)
+    - [Version upgrade rules](#version-upgrade-rules)
+    - [Null-safety](#null-safety)
+    - [Change log](#change-log)
+  - [Contributing](#contributing)
+    - [Contributors](#contributors)
+    - [About the third-party open-source project dependencies](#about-the-third-party-open-source-project-dependencies)
+  - [LICENSE](#license)
+  - [Contact the author](#contact-the-author)
+
+## Quick Start
+
+**All packages whose names are prefixed with `flutter_ume_kit_` are function**
+**plug-ins of UME, and users can access them according to demand**
+
+1. Edit `pubspec.yaml`, and add dependencies.
+
+    **↓ Null-safety version, compatible with Flutter 2.x**
+
+    ``` yaml
+    dev_dependencies: # Don't use UME in release mode
+      flutter_ume: ^0.3.0+1
+      flutter_ume_kit_ui: ^0.3.0+1
+      flutter_ume_kit_device: ^0.3.0
+      flutter_ume_kit_perf: ^0.3.0
+      flutter_ume_kit_show_code: ^0.3.0
+      flutter_ume_kit_console: ^0.3.0
+      flutter_ume_kit_dio: ^0.3.0
+    ```
+
+    **↓ Non-null-safety version, compatible with Flutter 1.x**
+
+    ``` yaml
+    dev_dependencies: # Don't use UME in release mode
+      flutter_ume: ^0.1.1
+      flutter_ume_kit_ui: ^0.1.1.1
+      flutter_ume_kit_device: ^0.1.1
+      flutter_ume_kit_perf: ^0.1.1
+      flutter_ume_kit_show_code: ^0.1.1
+      flutter_ume_kit_console: ^0.1.1 
+    ```
+
+2. Run `flutter pub get`
+3. Import packages
+
+    ``` dart
+    import 'package:flutter_ume/flutter_ume.dart'; // UME framework
+    import 'package:flutter_ume_kit_ui/flutter_ume_kit_ui.dart'; // UI kits
+    import 'package:flutter_ume_kit_perf/flutter_ume_kit_perf.dart'; // Performance kits
+    import 'package:flutter_ume_kit_show_code/flutter_ume_kit_show_code.dart'; // Show Code
+    import 'package:flutter_ume_kit_device/flutter_ume_kit_device.dart'; // Device info
+    import 'package:flutter_ume_kit_console/flutter_ume_kit_console.dart'; // Show debugPrint
+    import 'package:flutter_ume_kit_dio/flutter_ume_kit_dio.dart'; // Dio Inspector
+    ```
+
+4. Edit main method of your app, register plugin kits and initial UME
+
+    ``` dart
+    void main() {
+      if (kDebugMode) {
+        PluginManager.instance                                 // Register plugin kits
+          ..register(WidgetInfoInspector())
+          ..register(WidgetDetailInspector())
+          ..register(ColorSucker())
+          ..register(AlignRuler())
+          ..register(ColorPicker())                            // New feature
+          ..register(TouchIndicator())                         // New feature
+          ..register(Performance())
+          ..register(ShowCode())
+          ..register(MemoryInfoPage())
+          ..register(CpuInfoPage())
+          ..register(DeviceInfoPanel())
+          ..register(Console())
+          ..register(DioInspector(dio: dio));                  // Pass in your Dio instance
+        // After flutter_ume 0.3.0
+        runApp(UMEWidget(child: MyApp(), enable: true));
+        // Before flutter_ume 0.3.0
+        runApp(injectUMEWidget(child: MyApp(), enable: true));
+      } else {
+        runApp(MyApp());
+      }
+    }
+    ```
+
+5. `flutter run` for running
+   or `flutter build apk --debug`、`flutter build ios --debug` for building productions.
+
+  > Some functions rely on VM Service, and additional parameters need to be added for local operation to ensure that it can connect to the VM Service.
+  >
+  > Flutter 2.0.x, 2.2.x and other versions run on real devices, `flutter run` needs to add the `--disable-dds` parameter.
+  > After [Pull Request #80900](https://github.com/flutter/flutter/pull/80900) merging, `--disable-dds` was renamed to `--no-dds`.
+
+## IMPORTANT
+
+**From `0.1.1`/`0.2.1` version，we don't need set `useRootNavigator: false`.**
+The following section only applies to versions before version `0.1.1`/`0.2.1` .
+
+<s>
+
+Since UME manages the routing stack at the top level, methods such as `showDialog` use `rootNavigator` to pop up by default,
+therefore **must** pass in the parameter `useRootNavigator: false` in `showDialog`, `showGeneralDialog` and other 'show dialog' methods to avoid navigator errors.
+
+``` dart
+showDialog(
+  context: context,
+  builder: (ctx) => AlertDialog(
+        title: const Text('Dialog'),
+        actions: <Widget>[
+          TextButton(
+              onPressed: () => Navigator.pop(context),
+              child: const Text('OK'))
+        ],
+      ),
+  useRootNavigator: false); // <===== It's very IMPORTANT!
+```
+
+</s>
+
+## Features
+
+There are 13 plugin kits built in the current open source version of UME.
+
+<table border="1" width="100%">
+    <tr>
+        <td width="33.33%" align="center"><p>UI kits</p></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/widget_info.png" width="100%" alt="Widget Info" /></br>Widget Info</td>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/widget_detail.png" width="100%" alt="Widget Detail" /></br>Widget Detail</td>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/align_ruler.png" width="100%" alt="Align Ruler" /></br>Align Ruler</td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/color_picker.png" width="100%" alt="Color Picker" /></br>Color Picker</td>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/color_sucker.png" width="100%" alt="Color Sucker" /></br>Color Sucker</td>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/touch_indicator.png" width="100%" alt="Touch Indicator" /></br>Touch Indicator</td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><p>Performance Kits</p></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/memory_info.png" width="100%" alt="Memory Info" /></br>Memory Info</td>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/perf_overlay.png" width="100%" alt="Perf Overlay" /></br>Perf Overlay</td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><p>Device Info Kits</p></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/cpu_info.png" width="100%" alt="CPU Info" /></br>CPU Info</td>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/device_info.png" width="100%" alt="Device Info" /></br>Device Info</td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><p>Show Code</p></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/show_code.png" width="100%" alt="Show Code" /></br>Show Code</td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><p>Console</p></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/console.png" width="100%" alt="Console" /></br>Console</td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><p>Dio Inspector</p></td>
+    </tr>
+    <tr>
+        <td width="33.33%" align="center"><img src="https://github.com/bytedance/flutter_ume/raw/master/screenshots/dio_inspector.png" width="100%" alt="Dio Inspector" /></br>Dio Inspector</td>
+    </tr>
+</table>
+
+## Develop plugin kits for UME
+
+> UME plugins are located in the `./kits` directory, and each one is a `package`.
+> You can refer to the example in [`./custom_plugin_example`](./custom_plugin_example/) about this chapter.
+
+1. Run `flutter create -t package custom_plugin` to create your custom plugin kit, it could be `package` or `plugin`.
+2. Edit `pubspec.yaml` of the custom plugin kit to add UME framework dependency.
+
+    ``` yaml
+    dependencies:
+      flutter_ume: '>=0.3.0 <0.4.0'
+    ```
+
+3. Create the class of the plugin kit which should implement `Pluggable`.
+
+    ``` dart
+    import 'package:flutter_ume/flutter_ume.dart';
+
+    class CustomPlugin implements Pluggable {
+      CustomPlugin({Key key});
+
+      @override
+      Widget buildWidget(BuildContext context) => Container(
+        color: Colors.white
+        width: 100,
+        height: 100,
+        child: Center(
+          child: Text('Custom Plugin')
+        ),
+      ); // The panel of the plugin kit
+
+      @override
+      String get name => 'CustomPlugin'; // The name of the plugin kit
+
+      @override
+      String get displayName => 'CustomPlugin';
+
+      @override
+      void onTrigger() {} // Call when tap the icon of plugin kit
+
+      @override
+      ImageProvider<Object> get iconImageProvider => NetworkImage('url'); // The icon image of the plugin kit
+    }
+    ```
+
+4. Use your custom plugin kit in project
+
+    1. Edit `pubspec.yaml` of host app project to add `custom_plugin` dependency.
+
+        ``` yaml
+        dev_dependencies:
+          custom_plugin:
+            path: path/to/custom_plugin
+        ```
+
+    2. Run `flutter pub get`
+
+    3. Import package
+
+        ``` dart
+        import 'package:custom_plugin/custom_plugin.dart';
+        ```
+
+5. Edit main method of your app, register your custom_plugin plugin kit
+
+    ``` dart
+    if (kDebugMode) {
+      PluginManager.instance
+        ..register(CustomPlugin());
+      runApp(
+        UMEWidget(
+          child: MyApp(), 
+          enable: true
+        )
+      );
+    } else {
+      runApp(MyApp());
+    }
+    ```
+
+6. Run your app
+
+### Access the nested widget debug kits quickly
+
+We introduce the `PluggableWithNestedWidget` from `0.3.0`. It is used to insert nested Widgets in the Widget tree and quickly access embedded kits with nested widget.
+
+For more details, see [./kits/flutter_ume_kit_ui/lib/components/color_picker/color_picker.dart](https://github.com/bytedance/flutter_ume/blob/master/kits/flutter_ume_kit_ui/lib/components/color_picker/color_picker.dart) and [./kits/flutter_ume_kit_ui/lib/components/touch_indicator/touch_indicator.dart](https://github.com/bytedance/flutter_ume/blob/master/kits/flutter_ume_kit_ui/lib/components/touch_indicator/touch_indicator.dart).
+
+The key steps are as follows:
+
+1. The class of your plugin should implement `PluggableWithNestedWidget`.
+2. Implements `Widget buildNestedWidget(Widget child)`. Handling the nested widgets and returning the new Widget.
+
+## How to use UME in Release/Profile mode
+
+**Once you use flutter_ume in Release/Profile mode, you agree that you will**
+**bear the relevant risks by yourself.**
+
+**The maintainer of flutter_ume does not assume any responsibility for the accident**
+**caused by this.**
+
+**We recommend not to use it in Release/Profile mode for the following reasons:**
+
+1. VM Service is not available in these environments, so some functions are not available
+2. In this environment, developers need to isolate the app distribution channels by themselves to avoid submitting relevant debugging code to the production environment
+
+In order to use in Release/Profile mode, the details that need to be adjusted in the normal access process:
+
+1. In `pubspec.yaml`, `flutter_ume` and plugins should be write below `dependencies` rather than `dev_dependencies`.
+2. Don't put the code which call `PluginManager.instance.register()` and `UMEWidget(child: App())` into conditionals which represent debug mode. (Such as `kDebugMode`)
+3. Ensure the above details, run `flutter clean` and `flutter pub get`, then build your app.
+
+## About version
+
+### Compatibility
+
+| UME version | Flutter 1.12.13 | Flutter 1.22.3 | Flutter 2.0.1 | Flutter 2.2.3 | Flutter 2.5.3 |
+| ---- | ---- | ---- | ---- | ---- | ---- |
+| 0.1.x | ✅ | ✅ | ✅ | ✅ | ⚠️ |
+| 0.2.x | ❌ | ❌ | ✅ | ✅ | ✅ |
+| 0.3.x | ❌ | ❌ | ✅ | ✅ | ✅ |
+
+⚠️ means the version has not been fully tested for compatibility.
+
+⚠️ means the version has not been fully tested for compatibility.
+### Coverage
+
+| Package | master | develop | develop_nullsafety |
+| ---- | ---- | ---- | ---- |
+| flutter_ume | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/coverage_badge.svg) |
+| flutter_ume_kit_device | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/kits/flutter_ume_kit_device/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop/kits/flutter_ume_kit_device/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/kits/flutter_ume_kit_device/coverage_badge.svg) |
+| flutter_ume_kit_perf | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/kits/flutter_ume_kit_perf/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop/kits/flutter_ume_kit_perf/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/kits/flutter_ume_kit_perf/coverage_badge.svg) |
+| flutter_ume_kit_show_code | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/kits/flutter_ume_kit_show_code/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop/kits/flutter_ume_kit_show_code/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/kits/flutter_ume_kit_show_code/coverage_badge.svg) |
+| flutter_ume_kit_ui | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/kits/flutter_ume_kit_ui/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop/kits/flutter_ume_kit_ui/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/kits/flutter_ume_kit_ui/coverage_badge.svg) |
+| flutter_ume_kit_console | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/kits/flutter_ume_kit_console/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop/kits/flutter_ume_kit_console/coverage_badge.svg) | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/kits/flutter_ume_kit_console/coverage_badge.svg) |
+| flutter_ume_kit_dio | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/master/kits/flutter_ume_kit_dio/coverage_badge.svg) | N/A | ![Coverage](https://raw.githubusercontent.com/bytedance/flutter_ume/develop_nullsafety/kits/flutter_ume_kit_dio/coverage_badge.svg) |
+
+### Version upgrade rules
+
+Please refer to [Semantic versions](https://dart.dev/tools/pub/versioning#semantic-versions) for details.
+
+### Null-safety
+
+| Package | Suggest version |
+| ---- | ---- |
+| flutter_ume | 0.3.0+1 |
+| flutter_ume_kit_ui | 0.3.0+1 |
+| flutter_ume_kit_device | 0.3.0 |
+| flutter_ume_kit_perf | 0.3.0 |
+| flutter_ume_kit_show_code | 0.3.0 |
+| flutter_ume_kit_console | 0.3.0 |
+| flutter_ume_kit_dio | 0.3.0 |
+
+### Change log
+
+[Changelog](./CHANGELOG.md)
+
+## Contributing
+
+Contributing rules: [Contributing](./CONTRIBUTING_en.md)
+
+### Contributors
+
+Thanks to the following contributors (names not listed in order)：
+
+|  |  |
+| ---- | ---- |
+| ![ShirelyC](https://avatars.githubusercontent.com/u/11439167?s=64&v=4) | [ShirelyC](https://github.com/smileShirely) |
+| ![lpylpyleo](https://avatars.githubusercontent.com/u/15264428?s=64&v=4) | [lpylpyleo](https://github.com/lpylpyleo) |
+| ![Alex Li](https://avatars.githubusercontent.com/u/15884415?s=64&v=4) | [Alex Li](https://github.com/AlexV525) |
+| ![Swain](https://avatars.githubusercontent.com/u/7621572?s=64&v=4) | [Swain](https://github.com/talisk) |
+| ![harbor](https://avatars.githubusercontent.com/u/58758250?v=4) | [harbor](https://github.com/zzm990321) |
+
+### About the third-party open-source project dependencies
+
+- The TouchIndicator use the pub [touch_indicator](https://pub.dev/packages/touch_indicator), the ColorPicker use the pub [cyclop](https://pub.dev/packages/cyclop).
+- We [fork](https://github.com/talisk/cyclop) the package [cyclop](https://pub.dev/packages/cyclop) and modify some code meet our functional needs. We should depend cyclop by pub version after the [PR](https://github.com/rxlabz/cyclop/pull/11) being merged.
+
+## LICENSE
+
+This project is licensed under the MIT License - visit the [LICENSE](./LICENSE) for details.
+
+## Contact the author
+
+**Maybe...**
+
+- Found a bug in the code, or an error in the documentation
+- Produces an exception when you use the UME
+- UME is not compatible with the new version Flutter
+- Have a good idea or suggestion
+
+You can [submit an issue](./CONTRIBUTING_en.md#how-to-raise-an-issue) in any of the above situations.
+
+**Maybe...**
+
+- Communicate with the author
+- Communicate with more community developers
+- Cooperate with UME
+
+Welcome to [Join the ByteDance Flutter Exchange Group](https://applink.feishu.cn/client/chat/chatter/add_by_link?link_token=67au2f75-3783-41b0-8868-0fc0178f1fd8).
+
+Or contact [author](mailto:sunkai.dev@bytedance.com).

packages/flutter_ume/analysis_options.yaml

@@ -0,0 +1 @@
+include: package:lints/core.yaml

packages/flutter_ume/coverage_badge.svg

@@ -0,0 +1,20 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="94" height="20">
+  <linearGradient id="b" x2="0" y2="100%">
+    <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+    <stop offset="1" stop-opacity=".1"/>
+  </linearGradient>
+  <clipPath id="a">
+    <rect width="94" height="20" rx="3" fill="#fff"/>
+  </clipPath>
+  <g clip-path="url(#a)">
+    <path fill="#555" d="M0 0h59v20H0z"/>
+    <path fill="#88ca03" d="M59 0h35v20H59z"/>
+    <path fill="url(#b)" d="M0 0h94v20H0z"/>
+  </g>
+  <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="110">
+    <text x="305" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="490">coverage</text>
+    <text x="305" y="140" transform="scale(.1)" textLength="490">coverage</text>
+    <text x="755" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="250">91%</text>
+    <text x="755" y="140" transform="scale(.1)" textLength="250">91%</text>
+  </g>
+</svg>

packages/flutter_ume/kits/flutter_ume_kit_channel_monitor/CHANGELOG.md

@@ -0,0 +1,3 @@
+## 0.0.1
+
+* First version.

packages/flutter_ume/kits/flutter_ume_kit_channel_monitor/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 ByteDance Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

packages/flutter_ume/kits/flutter_ume_kit_channel_monitor/README.md

@@ -0,0 +1,3 @@
+# flutter_ume_kit_channel_monitor
+
+Used to monitor channel transmissions in Flutter.

packages/flutter_ume/kits/flutter_ume_kit_channel_monitor/analysis_options.yaml

@@ -0,0 +1,4 @@
+include: package:flutter_lints/flutter.yaml
+
+# Additional information about this file can be found at
+# https://dart.dev/guides/language/analysis-options

packages/flutter_ume/kits/flutter_ume_kit_channel_monitor/lib/flutter_ume_kit_channel_monitor.dart

@@ -0,0 +1,3 @@
+library flutter_ume_kit_channel_monitor;
+
+export 'src/channel_plugin.dart';

packages/flutter_ume/kits/flutter_ume_kit_channel_monitor/lib/src/channel_plugin.dart

@@ -0,0 +1,30 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_ume/flutter_ume.dart';
+import 'package:flutter_ume_kit_channel_monitor/src/ui/channel_pages.dart';
+import 'dart:convert';
+import 'core/channel_binding.dart';
+import 'icon.dart' as icon;
+
+class ChannelPlugin extends Pluggable {
+  ChannelPlugin() {
+    ChannelBinding.ensureInitialized();
+  }
+
+  @override
+  Widget buildWidget(BuildContext? context) {
+    return const ChannelPages();
+  }
+
+  @override
+  String get displayName => 'Channel Monitor';
+
+  @override
+  ImageProvider<Object> get iconImageProvider =>
+      MemoryImage(base64Decode(icon.iconData));
+
+  @override
+  String get name => 'Channel Monitor';
+
+  @override
+  void onTrigger() {}
+}

packages/flutter_ume/kits/flutter_ume_kit_channel_monitor/lib/src/core/channel_binding.dart

@@ -0,0 +1,20 @@
+import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
+import 'package:flutter_ume_kit_channel_monitor/src/core/ume_binary_messenger.dart';
+
+class ChannelBinding extends WidgetsFlutterBinding {
+  static WidgetsBinding? ensureInitialized() {
+    if (WidgetsBinding.instance == null) {
+      // make sure init this before WidgetsFlutterBinding ensureInitialized called
+      ChannelBinding();
+    }
+    return WidgetsBinding.instance;
+  }
+
+  @override
+  @protected
+  // 替换 BinaryMessenger
+  BinaryMessenger createBinaryMessenger() {
+    return UmeBinaryMessenger.binaryMessenger;
+  }
+}

packages/flutter_ume/kits/flutter_ume_kit_channel_monitor/lib/src/core/channel_controller.dart

@@ -0,0 +1,40 @@
+import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
+import 'dart:ui' as ui;
+
+import 'package:flutter_ume_kit_channel_monitor/src/core/channel_info_model.dart';
+import 'package:flutter_ume_kit_channel_monitor/src/core/channel_store.dart';
+
+class _ChannelController {
+  final StandardMethodCodec codec = const StandardMethodCodec();
+
+  void trackChannelEvent(String channel, DateTime sendTime, bool send,
+      {ByteData? data,
+      MessageHandler? handler,
+      ui.PlatformMessageResponseCallback? callback}) {
+    MethodCall call = const MethodCall('unknown');
+    try {
+      call = codec.decodeMethodCall(data);
+    } catch (e) {
+      debugPrint('decode data failed, caused by: $e');
+      debugPrint('data: ${data.toString()}');
+    }
+    final ChannelInfoModel model = ChannelInfoModel(
+      type: ChannelType.method,
+      channelName: channel,
+      direction: send
+          ? TransDirection.flutterToNative
+          : TransDirection.nativeToFlutter,
+      methodName: call.method,
+      timestamp: sendTime,
+      duration: DateTime.now().difference(sendTime),
+      sendDataSize: send ? (data?.elementSizeInBytes ?? 0) : 0,
+      sendData: send ? call.arguments : null,
+      receiveData: send ? null : call.arguments,
+      receiveDataSize: send ? 0 : (data?.elementSizeInBytes ?? 0),
+    );
+    channelStore.saveChannelInfo(model);
+  }
+}
+
+_ChannelController channelController = _ChannelController();

packages/flutter_ume/kits/flutter_ume_kit_channel_monitor/lib/src/core/channel_info_model.dart

@@ -0,0 +1,45 @@
+class ChannelInfoModel {
+  // channel 传输方向
+  final TransDirection direction;
+  // channel 名称
+  final String channelName;
+  // 方法名称
+  final String methodName;
+  // channel 类型（Method / Event / Basic）
+  final ChannelType type;
+  // 发送时间
+  final DateTime timestamp;
+  // 发送耗时
+  final Duration duration;
+  // 输入数据大小（可能为空）
+  final int? sendDataSize;
+  // 返回数据大小（可能为空）
+  final int? receiveDataSize;
+  // 是否为系统channel
+  bool get isSystemChannel => methodName.contains('flutter/');
+  // 发送数据内容（可能为空）
+  final dynamic sendData;
+  // 接收的数据内容（可能为空）
+  final dynamic receiveData;
+
+  ChannelInfoModel({
+    required this.channelName,
+    required this.direction,
+    required this.methodName,
+    required this.timestamp,
+    required this.duration,
+    required this.sendDataSize,
+    required this.type,
+    this.receiveDataSize,
+    this.sendData,
+    this.receiveData,
+  });
+
+  @override
+  String toString() {
+    return 'ChannelInfoModel{direction: $direction, channelName: $channelName, methodName: $methodName, type: $type, timestamp: $timestamp, duration: $duration, sendDataSize: $sendDataSize, receiveDataSize: $receiveDataSize, sendData: $sendData, receiveData: $receiveData}';
+  }
+}
+
+enum TransDirection { flutterToNative, nativeToFlutter }
+enum ChannelType { event, method, basic }

packages/flutter_ume/kits/flutter_ume_kit_channel_monitor/lib/src/core/channel_store.dart

@@ -0,0 +1,39 @@
+import 'dart:async';
+
+import 'package:flutter_ume_kit_channel_monitor/src/core/channel_info_model.dart';
+import 'package:rxdart/rxdart.dart';
+
+class _ChannelStore {
+  final BehaviorSubject<List<String>> _orderedChannelNamePublisher =
+      BehaviorSubject();
+
+  final Map<String, List<ChannelInfoModel>> _orderedChannelEvents = {};
+
+  Stream<List<String>> get channelNamePublisher =>
+      _orderedChannelNamePublisher.stream;
+
+  void saveChannelInfo(ChannelInfoModel model) {
+    if (_orderedChannelEvents[model.channelName] == null) {
+      _orderedChannelEvents[model.channelName] = [];
+    }
+    _orderedChannelEvents[model.channelName]!.add(model);
+    refresh();
+  }
+
+  void getChannelByName(String name, Sink sink) {
+    if (name == '') {
+      return;
+    }
+    sink.add(_orderedChannelEvents[name]);
+  }
+
+  void clearChannelRecords() {
+    refresh();
+  }
+
+  void refresh() {
+    _orderedChannelNamePublisher.add(_orderedChannelEvents.keys.toList());
+  }
+}
+
+_ChannelStore channelStore = _ChannelStore();

packages/flutter_ume/kits/flutter_ume_kit_channel_monitor/lib/src/core/ume_binary_messenger.dart

@@ -0,0 +1,88 @@
+import 'dart:async';
+import 'dart:ui' as ui;
+
+import 'package:flutter/foundation.dart';
+import 'package:flutter/services.dart';
+import 'package:flutter_ume_kit_channel_monitor/src/core/channel_controller.dart';
+
+// 在 _DefaultBinaryMessenger 的基础上增加数据监控
+class UmeBinaryMessenger extends BinaryMessenger {
+  static UmeBinaryMessenger binaryMessenger = UmeBinaryMessenger._();
+
+  UmeBinaryMessenger._();
+
+  @override
+  Future<void> handlePlatformMessage(String channel, ByteData? data,
+      ui.PlatformMessageResponseCallback? callback) async {
+    DateTime now = DateTime.now();
+    ui.channelBuffers.push(channel, data, (ByteData? data) {
+      if (callback != null) {
+        callback(data);
+      }
+      channelController.trackChannelEvent(channel, now, false,
+          data: data, callback: callback);
+      // print(
+      //     '\n handlePlatformMessage: channel: $channel \n  data:${data.toString()} \n');
+    });
+  }
+
+  @override
+  Future<ByteData?>? send(String channel, ByteData? message) {
+    DateTime now = DateTime.now();
+    final Completer<ByteData?> completer = Completer<ByteData?>();
+    // ui.PlatformDispatcher.instance is accessed directly instead of using
+    // ServicesBinding.instance.platformDispatcher because this method might be
+    // invoked before any binding is initialized. This issue was reported in
+    // #27541. It is not ideal to statically access
+    // ui.PlatformDispatcher.instance because the PlatformDispatcher may be
+    // dependency injected elsewhere with a different instance. However, static
+    // access at this location seems to be the least bad option.
+    // TODO(ianh): Use ServicesBinding.instance once we have better diagnostics
+    // on that getter.
+    ui.PlatformDispatcher.instance.sendPlatformMessage(channel, message,
+        (ByteData? reply) {
+      try {
+        completer.complete(reply);
+      } catch (exception, stack) {
+        FlutterError.reportError(FlutterErrorDetails(
+          exception: exception,
+          stack: stack,
+          library: 'services library',
+          context:
+              ErrorDescription('during a platform message response callback'),
+        ));
+      }
+    });
+    channelController.trackChannelEvent(channel, now, true, data: message);
+    // print('\n send \n channel: $channel \n message: ${message.toString()} \n}');
+    return completer.future;
+  }
+
+  @override
+  void setMessageHandler(String channel, MessageHandler? handler) {
+    DateTime now = DateTime.now();
+    if (handler == null) {
+      ui.channelBuffers.clearListener(channel);
+    } else {
+      ui.channelBuffers.setListener(channel,
+          (ByteData? data, ui.PlatformMessageResponseCallback callback) async {
+        ByteData? response;
+        try {
+          response = await handler(data);
+        } catch (exception, stack) {
+          FlutterError.reportError(FlutterErrorDetails(
+            exception: exception,
+            stack: stack,
+            library: 'services library',
+            context: ErrorDescription('during a platform message callback'),
+          ));
+        } finally {
+          callback(response);
+        }
+      });
+    }
+    channelController.trackChannelEvent(channel, now, false, handler: handler);
+    // print(
+    //     '\n setMessageHandler \n channel: $channel \n handler: ${handler.toString()} \n');
+  }
+}

packages/flutter_ume/kits/flutter_ume_kit_channel_monitor/lib/src/ui/channel_pages.dart

@@ -0,0 +1,216 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_ume_kit_channel_monitor/src/core/channel_info_model.dart';
+import 'package:flutter_ume_kit_channel_monitor/src/core/channel_store.dart';
+import 'package:flutter_ume_kit_channel_monitor/src/ui/template_ui.dart';
+import 'package:rxdart/rxdart.dart';
+
+class ChannelPages extends StatefulWidget {
+  const ChannelPages({Key? key}) : super(key: key);
+
+  @override
+  State<ChannelPages> createState() => _ChannelPagesState();
+}
+
+class _ChannelPagesState extends State<ChannelPages> {
+  int currentIndex = 0;
+  String currentChannel = '';
+  ChannelInfoModel? currentModel;
+
+  @override
+  Widget build(BuildContext context) {
+    return IndexedStack(
+      index: currentIndex,
+      children: [
+        buildOrderedChannels(context),
+        buildSingleChannelPage(),
+        buildChannelInfoPage(),
+      ],
+    );
+  }
+
+  ChannelInfoPage buildChannelInfoPage() {
+    return ChannelInfoPage(
+      channelInfoModel: currentModel,
+      onBackPressed: () {
+        currentIndex = 1;
+        currentModel = null;
+        setState(() {});
+      },
+    );
+  }
+
+  SingleChannelPage buildSingleChannelPage() {
+    return SingleChannelPage(
+      title: currentChannel,
+      onBackPressed: () {
+        currentIndex = 0;
+        currentChannel = '';
+        setState(() {});
+      },
+      onTap: (model) {
+        currentIndex = 2;
+        currentModel = model;
+        setState(() {});
+      },
+    );
+  }
+
+  Widget buildOrderedChannels(BuildContext context) {
+    return TemplatePageWidget(
+      title: 'Ordered Channels',
+      body: StreamBuilder<List<String>>(
+          stream: channelStore.channelNamePublisher,
+          builder: (context, snapshot) {
+            if (!snapshot.hasData) {
+              return const Center(child: CircularProgressIndicator());
+            }
+            final List<String> channels = snapshot.data as List<String>;
+            return ListView.builder(
+                padding: EdgeInsets.zero,
+                itemCount: channels.length,
+                itemBuilder: (context, index) {
+                  return TemplateItemWidget(
+                      title: channels[index],
+                      onTap: () {
+                        currentChannel = channels[index];
+                        currentIndex = 1;
+                        setState(() {});
+                      });
+                });
+          }),
+    );
+  }
+}
+
+class SingleChannelPage extends StatefulWidget {
+  final String title;
+  final VoidCallback onBackPressed;
+  final OnChannelModelSelected onTap;
+
+  const SingleChannelPage({
+    Key? key,
+    required this.title,
+    required this.onBackPressed,
+    required this.onTap,
+  }) : super(key: key);
+
+  @override
+  State<SingleChannelPage> createState() => _SingleChannelPageState();
+}
+
+class _SingleChannelPageState extends State<SingleChannelPage> {
+  final BehaviorSubject<List<ChannelInfoModel>> _publisher = BehaviorSubject();
+
+  @override
+  void didUpdateWidget(SingleChannelPage oldWidget) {
+    super.didUpdateWidget(oldWidget);
+    channelStore.getChannelByName(widget.title, _publisher.sink);
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return TemplatePageWidget(
+      onBackPressed: widget.onBackPressed,
+      title: widget.title,
+      body: StreamBuilder<List<ChannelInfoModel>>(
+          stream: _publisher,
+          builder: (context, snapshot) {
+            if (!snapshot.hasData) {
+              return const Center(child: CircularProgressIndicator());
+            }
+            final List<ChannelInfoModel> channels =
+                snapshot.data as List<ChannelInfoModel>;
+            return ListView.builder(
+                padding: EdgeInsets.zero,
+                itemCount: channels.length,
+                itemBuilder: (context, index) {
+                  return TemplateItemWidget(
+                    title: channels[index].methodName,
+                    onTap: () => widget.onTap(channels[index]),
+                  );
+                });
+          }),
+    );
+  }
+}
+
+class ChannelInfoPage extends StatelessWidget {
+  final ChannelInfoModel? channelInfoModel;
+  final VoidCallback onBackPressed;
+  const ChannelInfoPage(
+      {Key? key, this.channelInfoModel, required this.onBackPressed})
+      : super(key: key);
+
+  @override
+  Widget build(BuildContext context) {
+    if (channelInfoModel == null) {
+      return Container();
+    }
+    ChannelInfoModel model = channelInfoModel!;
+    bool isFlutterToNative = model.direction == TransDirection.flutterToNative;
+    return TemplatePageWidget(
+      title: 'Method : ${model.methodName}',
+      body: SingleChildScrollView(
+        child: Table(
+          border: TableBorder.all(color: Colors.black),
+          children: [
+            buildCell('Channel Name', model.channelName),
+            buildCell('Channel Type',
+                '${model.type.toString().substring(12)} channel'),
+            buildCell(
+                'Is System Channel', model.isSystemChannel ? 'yes' : 'no'),
+            buildCell(
+                'Trans Direction', model.direction.toString().substring(15)),
+            buildCell('Time Cost \n(millisecond)',
+                model.timestamp.millisecond.toString()),
+            if (isFlutterToNative)
+              buildCell('Send Data Size', model.sendDataSize.toString()),
+            if (isFlutterToNative)
+              ...buildDataTable('Send Data', model.sendData),
+            if (!isFlutterToNative)
+              buildCell('Receive Data Size', model.receiveDataSize.toString()),
+            if (!isFlutterToNative)
+              ...buildDataTable('Receive Data', model.receiveData),
+          ],
+        ),
+      ),
+      onBackPressed: onBackPressed,
+    );
+  }
+
+  List<TableRow> buildDataTable(String title, dynamic data) {
+    if (data is Map) {
+      return (data.keys
+          .map((keyword) => TableRow(children: [
+                Padding(
+                  padding: const EdgeInsets.all(8.0),
+                  child: Align(
+                      alignment: Alignment.centerLeft,
+                      child: Text(keyword.toString())),
+                ),
+                Padding(
+                  padding: const EdgeInsets.all(8.0),
+                  child: Text(data[keyword].toString()),
+                ),
+              ]))
+          .toList())
+        ..insert(0, buildCell(title, ''));
+    }
+    return [buildCell(title, data.toString())];
+  }
+
+  TableRow buildCell(String type, String desc) {
+    return TableRow(children: [
+      Padding(
+        padding: const EdgeInsets.all(8.0),
+        child: Align(alignment: Alignment.centerLeft, child: Text(type)),
+      ),
+      Padding(
+        padding: const EdgeInsets.all(8.0),
+        child: Text(desc.toString()),
+      ),
+    ]);
+  }
+}
+
+typedef OnChannelModelSelected = void Function(ChannelInfoModel model);

packages/flutter_ume/kits/flutter_ume_kit_channel_monitor/lib/src/ui/template_ui.dart

@@ -0,0 +1,98 @@
+import 'package:flutter/material.dart';
+
+class TemplatePageWidget extends StatelessWidget {
+  final String title;
+  final Widget body;
+  final VoidCallback? onBackPressed;
+
+  const TemplatePageWidget({
+    Key? key,
+    required this.title,
+    required this.body,
+    this.onBackPressed,
+  }) : super(key: key);
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      backgroundColor: Colors.white,
+      body: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        children: [
+          SizedBox(height: MediaQuery.of(context).padding.top),
+          if (onBackPressed != null)
+            GestureDetector(
+              behavior: HitTestBehavior.opaque,
+              onTap: onBackPressed,
+              child: const Padding(
+                padding: EdgeInsets.symmetric(horizontal: 4),
+                child: Icon(
+                  Icons.navigate_before_rounded,
+                  size: 42,
+                ),
+              ),
+            ),
+          Expanded(
+              child: Container(
+            width: double.infinity,
+            padding: const EdgeInsets.all(16.0),
+            child: Column(
+              crossAxisAlignment: CrossAxisAlignment.start,
+              children: [
+                buildTitle(),
+                const SizedBox(height: 20),
+                buildBody(),
+              ],
+            ),
+          ))
+        ],
+      ),
+    );
+  }
+
+  Expanded buildBody() {
+    return Expanded(
+      child: DecoratedBox(
+          decoration: BoxDecoration(
+              color: Colors.white.withOpacity(0.95),
+              borderRadius: BorderRadius.circular(12)),
+          child: body),
+    );
+  }
+
+  Text buildTitle() {
+    return Text(title,
+        style: const TextStyle(fontSize: 20, fontWeight: FontWeight.bold));
+  }
+}
+
+class TemplateItemWidget extends StatelessWidget {
+  final String title;
+  final VoidCallback onTap;
+  const TemplateItemWidget({Key? key, required this.title, required this.onTap})
+      : super(key: key);
+
+  @override
+  Widget build(BuildContext context) {
+    return Container(
+      height: 54,
+      decoration: BoxDecoration(
+          border: Border(bottom: BorderSide(color: Colors.grey.shade400))),
+      margin: const EdgeInsets.symmetric(horizontal: 8),
+      child: GestureDetector(
+        behavior: HitTestBehavior.opaque,
+        onTap: () => onTap(),
+        child: Row(
+          mainAxisAlignment: MainAxisAlignment.spaceBetween,
+          children: [
+            Expanded(child: Text(title, overflow: TextOverflow.clip)),
+            const Icon(
+              Icons.navigate_next_rounded,
+              color: Colors.grey,
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}

packages/flutter_ume/kits/flutter_ume_kit_channel_monitor/pubspec.yaml

@@ -0,0 +1,21 @@
+name: flutter_ume_kit_channel_monitor
+description: channel monitor kit for flutter_ume
+version: 0.0.1
+homepage: https://github.com/bytedance/flutter_ume
+
+environment:
+  sdk: ">=2.12.0 <4.0.0"
+  flutter: ">=1.17.0"
+
+dependencies:
+  flutter:
+    sdk: flutter
+  flutter_ume: ^1.0.1
+  rxdart: ^0.27.3
+
+dev_dependencies:
+  flutter_test:
+    sdk: flutter
+  flutter_lints: ">=1.0.0 <3.0.0"
+
+flutter:

packages/flutter_ume/kits/flutter_ume_kit_channel_monitor/pubspec_overrides.yaml

@@ -0,0 +1,4 @@
+# melos_managed_dependency_overrides: flutter_ume
+dependency_overrides:
+  flutter_ume:
+    path: ../..

packages/flutter_ume/kits/flutter_ume_kit_console/.gitignore

@@ -0,0 +1,75 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+**/doc/api/
+.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+.packages
+.pub-cache/
+.pub/
+build/
+
+# Android related
+**/android/**/gradle-wrapper.jar
+**/android/.gradle
+**/android/captures/
+**/android/gradlew
+**/android/gradlew.bat
+**/android/local.properties
+**/android/**/GeneratedPluginRegistrant.java
+
+# iOS/XCode related
+**/ios/**/*.mode1v3
+**/ios/**/*.mode2v3
+**/ios/**/*.moved-aside
+**/ios/**/*.pbxuser
+**/ios/**/*.perspectivev3
+**/ios/**/*sync/
+**/ios/**/.sconsign.dblite
+**/ios/**/.tags*
+**/ios/**/.vagrant/
+**/ios/**/DerivedData/
+**/ios/**/Icon?
+**/ios/**/Pods/
+**/ios/**/.symlinks/
+**/ios/**/profile
+**/ios/**/xcuserdata
+**/ios/.generated/
+**/ios/Flutter/App.framework
+**/ios/Flutter/Flutter.framework
+**/ios/Flutter/Flutter.podspec
+**/ios/Flutter/Generated.xcconfig
+**/ios/Flutter/ephemeral
+**/ios/Flutter/app.flx
+**/ios/Flutter/app.zip
+**/ios/Flutter/flutter_assets/
+**/ios/Flutter/flutter_export_environment.sh
+**/ios/ServiceDefinitions.json
+**/ios/Runner/GeneratedPluginRegistrant.*
+
+# Exceptions to above rules.
+!**/ios/**/default.mode1v3
+!**/ios/**/default.mode2v3
+!**/ios/**/default.pbxuser
+!**/ios/**/default.perspectivev3

packages/flutter_ume/kits/flutter_ume_kit_console/.metadata

@@ -0,0 +1,10 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: 02c026b03cd31dd3f867e5faeb7e104cce174c5f
+  channel: unknown
+
+project_type: package

packages/flutter_ume/kits/flutter_ume_kit_console/CHANGELOG.md

@@ -0,0 +1,43 @@
+# Changelog
+
+## 1.1.0
+
+* 增加 `consolePrint` 方法，用于适配其他日志库。
+
+* Add `consolePrint` method to adapt other log libraries.
+
+## 1.0.0
+
+* 正式版
+
+* Normal version.
+
+## 1.0.0-dev.0
+
+* 适配 Flutter 3
+
+* Adapt Flutter 3
+
+## 0.3.0
+
+* 更新版本号
+
+* Update version
+
+## 0.2.1
+
+* null-safety 正式版本
+
+* Null-Safety formal version.
+
+## 0.2.0-dev.0
+
+* 适配 null-safety
+
+* Adapted Null-Safety.
+
+## 0.1.0
+
+* 发布开源版本。
+
+* Release opensource version.

packages/flutter_ume/kits/flutter_ume_kit_console/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 ByteDance Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

packages/flutter_ume/kits/flutter_ume_kit_console/README.md

@@ -0,0 +1,57 @@
+# flutter_ume_kit_console
+
+[flutter_ume](https://pub.dev/packages/flutter_ume) 是由字节跳动 Flutter Infra 团队出品的应用内调试工具平台。
+
+flutter_ume_kit_console 是 flutter_ume 的日志查看插件包。接入方式请见 [flutter_ume](https://pub.dev/packages/flutter_ume)。
+
+此插件无法直接监听 `print` 或 `developer.log`，需要使用 `debugPrint` 方法打印日志，或者结合 [logging](https://pub.dev/packages/logging)、[logger](https://pub.dev/packages/logger) 等日志库使用。
+
+如果使用其他日志库，可以调用 `consolePrint` 将日志输出到应用内控制台。
+
+```dart
+// logging
+Logger.root.onRecord.listen((record) {
+  consolePrint(record.message);
+});
+```
+
+```dart
+// logger
+class UmeConsoleOutput extends LogOutput {
+  @override
+  void output(OutputEvent event) {
+    for (var line in event.lines) {
+      consolePrint(line);
+    }
+  }
+}
+```
+
+----
+
+[flutter_ume](https://pub.dev/packages/flutter_ume) is an in-app debug kits platform produced for Flutter apps by ByteDance Flutter Infra team.
+
+flutter_ume_kit_console is the Console kits package of flutter_ume. Please visit [flutter_ume](https://pub.dev/packages/flutter_ume) for details.
+
+This plugin cannot listen to `print` or `developer.log` directly. You need to use the `debugPrint` method to print logs, or use it with another log library such as [logging](https://pub.dev/packages/logging) or [logger](https://pub.dev/packages/logger).
+
+If you use another log library, you can call `consolePrint` to print the log to the in-app console.
+
+```dart
+// logging
+Logger.root.onRecord.listen((record) {
+  consolePrint(record.message);
+});
+```
+
+```dart
+// logger
+class UmeConsoleOutput extends LogOutput {
+  @override
+  void output(OutputEvent event) {
+    for (var line in event.lines) {
+      consolePrint(line);
+    }
+  }
+}
+```

packages/flutter_ume/kits/flutter_ume_kit_console/coverage/lcov.info

@@ -0,0 +1,170 @@
+SF:lib/console/show_date_time_style.dart
+DA:1,3
+DA:3,2
+DA:5,2
+DA:7,2
+DA:9,2
+DA:11,2
+DA:18,2
+DA:20,2
+DA:22,2
+DA:24,2
+DA:26,2
+LF:11
+LH:11
+end_of_record
+SF:lib/console/console_manager.dart
+DA:10,6
+DA:14,4
+DA:16,4
+DA:20,2
+DA:22,2
+DA:24,2
+DA:25,2
+DA:26,2
+DA:27,2
+DA:28,4
+DA:30,0
+DA:34,8
+DA:35,6
+DA:36,4
+DA:38,2
+DA:45,2
+DA:47,2
+DA:48,2
+DA:49,6
+DA:51,2
+DA:56,2
+DA:57,4
+DA:58,2
+DA:61,2
+LF:24
+LH:23
+end_of_record
+SF:lib/console/console_panel.dart
+DA:16,1
+DA:17,1
+DA:20,1
+DA:21,1
+DA:23,1
+DA:26,1
+DA:28,2
+DA:30,1
+DA:33,0
+DA:36,1
+DA:39,0
+DA:40,0
+DA:42,0
+DA:43,0
+DA:55,1
+DA:57,2
+DA:58,1
+DA:59,1
+DA:60,1
+DA:61,1
+DA:62,1
+DA:65,1
+DA:67,1
+DA:68,1
+DA:69,3
+DA:70,0
+DA:71,0
+DA:73,1
+DA:74,2
+DA:75,2
+DA:77,2
+DA:79,2
+DA:80,3
+DA:81,5
+DA:82,1
+DA:83,1
+DA:84,0
+DA:85,0
+DA:86,0
+DA:87,0
+DA:89,3
+DA:92,2
+DA:93,2
+DA:94,4
+DA:99,1
+DA:100,1
+DA:101,4
+DA:102,4
+DA:103,3
+DA:104,1
+DA:106,3
+DA:110,1
+DA:112,1
+DA:113,1
+DA:115,10
+DA:117,1
+DA:119,9
+DA:120,2
+DA:122,1
+DA:124,9
+DA:126,1
+DA:135,1
+DA:137,1
+DA:138,1
+DA:140,2
+DA:141,1
+DA:142,1
+DA:143,2
+DA:144,1
+DA:145,1
+DA:148,1
+DA:149,2
+DA:150,1
+DA:151,1
+DA:152,1
+DA:158,1
+DA:160,8
+DA:161,1
+DA:172,1
+DA:173,1
+DA:177,1
+DA:178,1
+DA:179,1
+DA:180,1
+DA:181,2
+DA:183,0
+DA:185,2
+DA:186,1
+DA:188,1
+DA:191,1
+DA:195,1
+DA:196,1
+DA:197,1
+DA:200,1
+DA:204,1
+DA:210,1
+DA:211,1
+DA:213,1
+DA:217,1
+DA:218,1
+DA:220,1
+DA:224,2
+DA:225,1
+DA:227,1
+DA:231,1
+DA:232,1
+DA:234,1
+DA:238,1
+DA:243,1
+DA:244,6
+DA:245,2
+DA:246,2
+DA:247,2
+DA:250,1
+DA:251,2
+DA:252,2
+DA:253,1
+DA:254,1
+DA:257,1
+DA:260,1
+DA:261,2
+DA:264,8
+DA:265,3
+LF:123
+LH:111
+end_of_record

packages/flutter_ume/kits/flutter_ume_kit_console/coverage_badge.svg

@@ -0,0 +1,20 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="94" height="20">
+  <linearGradient id="b" x2="0" y2="100%">
+    <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+    <stop offset="1" stop-opacity=".1"/>
+  </linearGradient>
+  <clipPath id="a">
+    <rect width="94" height="20" rx="3" fill="#fff"/>
+  </clipPath>
+  <g clip-path="url(#a)">
+    <path fill="#555" d="M0 0h59v20H0z"/>
+    <path fill="#88ca03" d="M59 0h35v20H59z"/>
+    <path fill="url(#b)" d="M0 0h94v20H0z"/>
+  </g>
+  <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="110">
+    <text x="305" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="490">coverage</text>
+    <text x="305" y="140" transform="scale(.1)" textLength="490">coverage</text>
+    <text x="755" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="250">91%</text>
+    <text x="755" y="140" transform="scale(.1)" textLength="250">91%</text>
+  </g>
+</svg>

packages/flutter_ume/kits/flutter_ume_kit_console/lib/console/console_manager.dart

@@ -0,0 +1,66 @@
+import 'dart:async';
+import 'dart:collection';
+
+import 'package:flutter/foundation.dart';
+import 'package:tuple/tuple.dart';
+
+const int maxLine = 1000;
+
+class ConsoleManager {
+  static final Queue<Tuple2<DateTime, String>> _logData = Queue();
+  // ignore: close_sinks
+  static StreamController? _logStreamController;
+
+  static Queue<Tuple2<DateTime, String>> get logData => _logData;
+
+  static StreamController? get streamController => _getLogStreamController();
+
+  static DebugPrintCallback? _originalDebugPrint;
+
+  static StreamController? _getLogStreamController() {
+    if (_logStreamController == null) {
+      _logStreamController = StreamController.broadcast();
+      var transformer =
+          StreamTransformer<dynamic, Tuple2<DateTime, String>>.fromHandlers(
+              handleData: (str, sink) {
+        final now = DateTime.now();
+        if (str is String) {
+          sink.add(Tuple2(now, str));
+        } else {
+          sink.add(Tuple2(now, str.toString()));
+        }
+      });
+
+      _logStreamController!.stream.transform(transformer).listen((value) {
+        if (_logData.length < maxLine) {
+          _logData.addFirst(value);
+        } else {
+          _logData.removeLast();
+        }
+      });
+    }
+    return _logStreamController;
+  }
+
+  static redirectDebugPrint() {
+    if (_originalDebugPrint != null) return;
+    _originalDebugPrint = debugPrint;
+    debugPrint = (String? message, {int? wrapWidth}) {
+      ConsoleManager.streamController!.sink.add(message);
+      if (_originalDebugPrint != null) {
+        _originalDebugPrint!(message, wrapWidth: wrapWidth);
+      }
+    };
+  }
+
+  static clearLog() {
+    logData.clear();
+    _logStreamController!.add('UME CONSOLE == ClearLog');
+  }
+
+  @visibleForTesting
+  static clearRedirect() {
+    debugPrint = _originalDebugPrint!;
+    _originalDebugPrint = null;
+  }
+}

packages/flutter_ume/kits/flutter_ume_kit_console/lib/console/console_panel.dart

@@ -0,0 +1,264 @@
+import 'dart:async';
+
+import 'package:flutter/material.dart';
+import 'package:share/share.dart';
+import 'package:tuple/tuple.dart';
+import 'package:flutter_ume/flutter_ume.dart';
+import 'package:flutter_ume_kit_console/console/console_manager.dart';
+import 'package:flutter_ume_kit_console/console/icon.dart' as icon;
+import 'package:flutter_ume/util/floating_widget.dart';
+import 'package:flutter_ume/util/store_mixin.dart';
+import 'package:flutter_ume_kit_console/console/show_date_time_style.dart';
+
+class Console extends StatefulWidget implements PluggableWithStream {
+  Console({Key? key}) {
+    ConsoleManager.redirectDebugPrint();
+  }
+
+  @override
+  ConsoleState createState() => ConsoleState();
+
+  @override
+  Widget buildWidget(BuildContext? context) => this;
+
+  @override
+  ImageProvider<Object> get iconImageProvider => MemoryImage(icon.iconBytes);
+
+  @override
+  String get name => 'Console';
+
+  @override
+  String get displayName => 'Console';
+
+  @override
+  void onTrigger() {}
+
+  @override
+  Stream get stream => ConsoleManager.streamController!.stream;
+
+  @override
+  StreamFilter get streamFilter => (e) => true;
+}
+
+class ConsoleState extends State<Console>
+    with WidgetsBindingObserver, StoreMixin {
+  List<Tuple2<DateTime, String>> _logList = <Tuple2<DateTime, String>>[];
+  StreamSubscription? _subscription;
+  ScrollController? _controller;
+  ShowDateTimeStyle? _showDateTimeStyle;
+  bool _showFilter = false;
+  RegExp? _filterExp;
+
+  @override
+  void dispose() {
+    _subscription?.cancel();
+    _subscription = null;
+    _controller = null;
+    _showDateTimeStyle = ShowDateTimeStyle.datetime;
+    _showFilter = false;
+    super.dispose();
+  }
+
+  @override
+  void initState() {
+    super.initState();
+    _showDateTimeStyle = ShowDateTimeStyle.none;
+    fetchWithKey('console_panel_datetime_style').then((value) async {
+      if (value != null && value is int) {
+        _showDateTimeStyle = styleById(value);
+      } else {
+        _showDateTimeStyle = ShowDateTimeStyle.datetime;
+        await storeWithKey(
+            'console_panel_datetime_style', idByStyle(_showDateTimeStyle!));
+      }
+      setState(() {});
+    });
+    _controller = ScrollController();
+    _logList = ConsoleManager.logData.toList();
+    _subscription = ConsoleManager.streamController!.stream.listen((onData) {
+      if (mounted) {
+        if (_filterExp != null) {
+          _logList = ConsoleManager.logData.where((e) {
+            return _filterExp!.hasMatch(e.item1.toString()) ||
+                _filterExp!.hasMatch(e.item2);
+          }).toList();
+        } else {
+          _logList = ConsoleManager.logData.toList();
+        }
+
+        setState(() {});
+        _controller!.jumpTo(
+            _controller!.position.maxScrollExtent + 22); // 22 is a magic number
+      }
+    });
+  }
+
+  void _refreshConsole() {
+    if (_filterExp != null) {
+      _logList = ConsoleManager.logData.where((e) {
+        return _filterExp!.hasMatch(e.item1.toString()) ||
+            _filterExp!.hasMatch(e.item2);
+      }).toList();
+    } else {
+      _logList = ConsoleManager.logData.toList();
+    }
+  }
+
+  String _dateTimeString(int logIndex) {
+    String result = '';
+    switch (_showDateTimeStyle) {
+      case ShowDateTimeStyle.datetime:
+        result =
+            '${_logList[_logList.length - logIndex - 1].item1.toString().padRight(26, '0')}';
+        break;
+      case ShowDateTimeStyle.time:
+        result =
+            '${_logList[_logList.length - logIndex - 1].item1.toString().padRight(26, '0')}'
+                .substring(11);
+        break;
+      case ShowDateTimeStyle.timestamp:
+        result =
+            '${_logList[_logList.length - logIndex - 1].item1.millisecondsSinceEpoch}';
+        break;
+      case ShowDateTimeStyle.none:
+        result = '';
+        break;
+      default:
+        break;
+    }
+    return result;
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return FloatingWidget(
+      contentWidget: Container(
+          color: Colors.black,
+          child: Stack(children: [
+            ListView.builder(
+              controller: _controller,
+              itemCount: _logList.length,
+              itemBuilder: (BuildContext context, int index) {
+                return Padding(
+                  padding: const EdgeInsets.only(
+                      left: 8, right: 8, top: 3, bottom: 3),
+                  child: RichText(
+                    text: TextSpan(children: [
+                      TextSpan(
+                          text: _dateTimeString(index),
+                          style: TextStyle(
+                            color: Colors.white60,
+                            fontFamily: 'Courier',
+                            fontSize: 16,
+                            fontWeight: FontWeight.w400,
+                          )),
+                      TextSpan(
+                          text:
+                              '${_logList[_logList.length - index - 1].item2}',
+                          style: TextStyle(
+                            color: Colors.white,
+                            fontFamily: 'Courier',
+                            fontSize: 16,
+                            fontWeight: FontWeight.w400,
+                          )),
+                    ]),
+                  ),
+                );
+              },
+            ),
+            if (_showFilter)
+              Positioned(
+                left: 0,
+                right: 0,
+                top: 0,
+                child: Container(
+                  child: TextField(
+                    onChanged: (value) {
+                      if (value.isNotEmpty) {
+                        _filterExp = RegExp(value);
+                      } else {
+                        _filterExp = null;
+                      }
+                      setState(() {});
+                      _refreshConsole();
+                    },
+                    style: TextStyle(
+                      fontSize: 16,
+                    ),
+                    decoration: InputDecoration(
+                      fillColor: Colors.white,
+                      filled: true,
+                      hintText: 'RegExp',
+                      border: OutlineInputBorder(
+                        borderRadius: BorderRadius.all(
+                          Radius.circular(50),
+                        ),
+                      ),
+                      contentPadding: EdgeInsets.only(
+                        top: 0,
+                        bottom: 0,
+                      ),
+                      prefixIcon: Icon(Icons.search),
+                    ),
+                  ),
+                ),
+              ),
+          ])),
+      toolbarActions: [
+        Tuple3(
+            'Style',
+            Icon(
+              Icons.access_time,
+              size: 20,
+            ),
+            _triggerShowDate),
+        Tuple3(
+            'Clear',
+            Icon(
+              Icons.do_not_disturb,
+              size: 20,
+            ),
+            () => ConsoleManager.clearLog()),
+        Tuple3(
+            'Filter',
+            Icon(
+              Icons.search,
+              size: 20,
+            ),
+            _triggerFilter),
+        Tuple3(
+            'Share',
+            Icon(
+              Icons.share,
+              size: 20,
+            ),
+            _share),
+      ],
+    );
+  }
+
+  void _triggerShowDate() async {
+    _showDateTimeStyle = styleById((idByStyle(_showDateTimeStyle!) + 1) % 4);
+    await storeWithKey(
+        'console_panel_datetime_style', idByStyle(_showDateTimeStyle!));
+    setState(() {});
+  }
+
+  void _triggerFilter() {
+    setState(() {
+      _showFilter = !_showFilter;
+      if (!_showFilter) {
+        _filterExp = null;
+      }
+    });
+    _refreshConsole();
+  }
+
+  Future<void> _share() async {
+    if (_logList.isEmpty) {
+      return;
+    }
+    final l = _logList.map((e) => '${e.item1.toString()} ${e.item2}').toList();
+    return Share.share("${l.join('\n')}");
+  }
+}

packages/flutter_ume/kits/flutter_ume_kit_console/lib/console/console_print.dart

@@ -0,0 +1,6 @@
+import 'console_manager.dart';
+
+/// Print the message to the console.
+void consolePrint(String message) {
+  ConsoleManager.streamController!.add(message);
+}

packages/flutter_ume/kits/flutter_ume_kit_console/lib/console/show_date_time_style.dart

@@ -0,0 +1,29 @@
+enum ShowDateTimeStyle { datetime, time, timestamp, none }
+
+ShowDateTimeStyle styleById(int id) {
+  switch (id) {
+    case 0:
+      return ShowDateTimeStyle.datetime;
+    case 1:
+      return ShowDateTimeStyle.time;
+    case 2:
+      return ShowDateTimeStyle.timestamp;
+    case 3:
+      return ShowDateTimeStyle.none;
+    default:
+      return ShowDateTimeStyle.datetime;
+  }
+}
+
+int idByStyle(ShowDateTimeStyle style) {
+  switch (style) {
+    case ShowDateTimeStyle.datetime:
+      return 0;
+    case ShowDateTimeStyle.time:
+      return 1;
+    case ShowDateTimeStyle.timestamp:
+      return 2;
+    case ShowDateTimeStyle.none:
+      return 3;
+  }
+}

packages/flutter_ume/kits/flutter_ume_kit_console/lib/flutter_ume_kit_console.dart

@@ -0,0 +1,4 @@
+library flutter_ume_kit_console;
+
+export 'console/console_panel.dart';
+export 'console/console_print.dart';

packages/flutter_ume/kits/flutter_ume_kit_console/pubspec.yaml

@@ -0,0 +1,27 @@
+name: flutter_ume_kit_console
+description: Show debugPrint kit for flutter_ume.
+version: 1.1.0
+homepage: https://github.com/bytedance/flutter_ume
+
+environment:
+  sdk: ">=2.12.0 <4.0.0"
+  flutter: ">=2.0.0"
+
+dependencies:
+  flutter:
+    sdk: flutter
+  tuple: ^2.0.0
+  share: ^2.0.4
+  shared_preferences: ^2.0.6
+  flutter_ume: ">=1.0.0 <2.0.0"
+
+dev_dependencies:
+  flutter_test:
+    sdk: flutter
+  mockito: ^5.0.12
+  flutter_coverage_badge:
+    git:
+      url: https://github.com/smileShirely/flutter_coverage_badge.git
+      ref: 59b7580f406bb712e9d9049c8c99212946e34f65
+
+flutter:

packages/flutter_ume/kits/flutter_ume_kit_console/pubspec_overrides.yaml

@@ -0,0 +1,4 @@
+# melos_managed_dependency_overrides: flutter_ume
+dependency_overrides:
+  flutter_ume:
+    path: ../..

packages/flutter_ume/kits/flutter_ume_kit_device/.gitignore

@@ -0,0 +1,75 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+**/doc/api/
+.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+.packages
+.pub-cache/
+.pub/
+build/
+
+# Android related
+**/android/**/gradle-wrapper.jar
+**/android/.gradle
+**/android/captures/
+**/android/gradlew
+**/android/gradlew.bat
+**/android/local.properties
+**/android/**/GeneratedPluginRegistrant.java
+
+# iOS/XCode related
+**/ios/**/*.mode1v3
+**/ios/**/*.mode2v3
+**/ios/**/*.moved-aside
+**/ios/**/*.pbxuser
+**/ios/**/*.perspectivev3
+**/ios/**/*sync/
+**/ios/**/.sconsign.dblite
+**/ios/**/.tags*
+**/ios/**/.vagrant/
+**/ios/**/DerivedData/
+**/ios/**/Icon?
+**/ios/**/Pods/
+**/ios/**/.symlinks/
+**/ios/**/profile
+**/ios/**/xcuserdata
+**/ios/.generated/
+**/ios/Flutter/App.framework
+**/ios/Flutter/Flutter.framework
+**/ios/Flutter/Flutter.podspec
+**/ios/Flutter/Generated.xcconfig
+**/ios/Flutter/ephemeral
+**/ios/Flutter/app.flx
+**/ios/Flutter/app.zip
+**/ios/Flutter/flutter_assets/
+**/ios/Flutter/flutter_export_environment.sh
+**/ios/ServiceDefinitions.json
+**/ios/Runner/GeneratedPluginRegistrant.*
+
+# Exceptions to above rules.
+!**/ios/**/default.mode1v3
+!**/ios/**/default.mode2v3
+!**/ios/**/default.pbxuser
+!**/ios/**/default.perspectivev3

packages/flutter_ume/kits/flutter_ume_kit_device/.metadata

@@ -0,0 +1,10 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: 02c026b03cd31dd3f867e5faeb7e104cce174c5f
+  channel: unknown
+
+project_type: package