feat: phase1 UI prep — 设备ID系统传递 + 国家本地化展示 + 继续观看直进播放页

设备标识: Android SSAID/ iOS IDFV 原生通道 → Dart DeviceIdProvider
国家解析: 注册/登录从后端 IP → 国家/语言/时区/币种 自动落库
账号资料: 全部本地化展示 (account_display.dart)
我的页: 继续观看卡片点击直接进播放页

android/app/src/main/kotlin/com/stormg/lumadrama/MainActivity.kt

@@ -4,6 +4,7 @@ package com.stormg.lumadrama
 
 import android.content.Intent
 import android.app.PictureInPictureParams
+import android.content.Context
 import android.content.res.Configuration
 import android.graphics.Bitmap
 import android.media.MediaMetadataRetriever
@@ -12,6 +13,8 @@ import android.os.Build
 import android.os.Bundle
 import android.os.Handler
 import android.os.Looper
+import android.provider.Settings
+import android.telephony.TelephonyManager
 import android.util.Rational
 import android.content.pm.PackageManager
 import android.view.WindowManager
@@ -21,6 +24,7 @@ import io.flutter.embedding.android.FlutterActivity
 import io.flutter.embedding.engine.FlutterEngine
 import io.flutter.plugin.common.MethodChannel
 import java.io.ByteArrayOutputStream
+import java.util.Locale
 import java.util.concurrent.ExecutorService
 import java.util.concurrent.Executors
 import java.util.concurrent.atomic.AtomicBoolean
@@ -65,6 +69,23 @@ class MainActivity : FlutterActivity() {
                 result.success(false)
             }
         }
+        // 设备标识：SSAID 免权限，卸载重装不变，避免客户端自己生成的 id 每次重装都变
+        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, "com.stormg.lumadrama/device")
+            .setMethodCallHandler { call, result ->
+                when (call.method) {
+                    "ssaid" -> {
+                        val value = try {
+                            Settings.Secure.getString(contentResolver, Settings.Secure.ANDROID_ID)
+                        } catch (_: Exception) {
+                            null
+                        }
+                        result.success(value)
+                    }
+                    // 设备区域：注册时作为服务端 IP 解析失败后的兜底
+                    "region" -> result.success(currentRegion())
+                    else -> result.notImplemented()
+                }
+            }
         MethodChannel(flutterEngine.dartExecutor.binaryMessenger, "com.stormg.lumadrama/share")
             .setMethodCallHandler { call, result ->
                 if (call.method != "shareText") {
@@ -156,6 +177,28 @@ class MainActivity : FlutterActivity() {
             ?.bottom
             ?: 0
 
+    /** 网络运营商国家优先，其次 SIM 卡，最后系统语言；都拿不到返回空串。 */
+    private fun currentRegion(): String {
+        return try {
+            val telephony = getSystemService(Context.TELEPHONY_SERVICE) as? TelephonyManager
+            val localeCountry = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
+                resources.configuration.locales.get(0).country
+            } else {
+                @Suppress("DEPRECATION")
+                resources.configuration.locale.country
+            }
+            val candidates = listOfNotNull(
+                telephony?.networkCountryIso,
+                telephony?.simCountryIso,
+                localeCountry
+            )
+            candidates.firstOrNull { it.isNotBlank() }?.uppercase(Locale.ROOT) ?: ""
+        } catch (_: Exception) {
+            // 个别 ROM 读运营商信息会抛 SecurityException，别让注册流程卡住
+            ""
+        }
+    }
+
     private fun emitImeInset(value: Int) {
         if (value == imeInset) return
         imeInset = value

ios/Runner/AppDelegate.swift

@@ -63,6 +63,7 @@ final class RunnerFlutterViewController: FlutterViewController {
   func didInitializeImplicitFlutterEngine(_ engineBridge: FlutterImplicitEngineBridge) {
     GeneratedPluginRegistrant.register(with: engineBridge.pluginRegistry)
     registerWirelessDataChannel(engineBridge)
+    registerDeviceIdChannel(engineBridge)
     let channel = FlutterMethodChannel(
       name: "com.stormg.lumadrama/share",
       binaryMessenger: engineBridge.applicationRegistrar.messenger()
@@ -144,6 +145,29 @@ final class RunnerFlutterViewController: FlutterViewController {
     }
   }
 
+  /// 设备标识：IDFV 免权限，卸载本 App 不变，避免客户端自生成的 id 每次重装都变。
+  /// 同通道顺带提供设备区域（ISO-2），注册时作为服务端 IP 解析失败后的兜底。
+  private func registerDeviceIdChannel(_ engineBridge: FlutterImplicitEngineBridge) {
+    let channel = FlutterMethodChannel(
+      name: "com.stormg.lumadrama/device",
+      binaryMessenger: engineBridge.applicationRegistrar.messenger()
+    )
+    channel.setMethodCallHandler { call, result in
+      switch call.method {
+      case "idfv":
+        result(UIDevice.current.identifierForVendor?.uuidString)
+      case "region":
+        if #available(iOS 16.0, *) {
+          result(Locale.current.region?.identifier)
+        } else {
+          result(Locale.current.regionCode)
+        }
+      default:
+        result(FlutterMethodNotImplemented)
+      }
+    }
+  }
+
   private func registerWirelessDataChannel(_ engineBridge: FlutterImplicitEngineBridge) {
     let channel = FlutterMethodChannel(
       name: WirelessDataPrompt.channelName,

ios/Runner/Info.plist

@@ -48,7 +48,7 @@
 					<key>NSIncludesSubdomains</key>
 					<true/>
 				</dict>
-				<key>10.43.47.1</key>
+				<key>192.168.31.243</key>
 				<dict>
 					<key>NSExceptionAllowsInsecureHTTPLoads</key>
 					<true/>

lib/app.dart

@@ -14,6 +14,7 @@ import 'core/data/remote/catalog_api.dart';
 import 'core/data/remote/category_api.dart';
 import 'core/data/remote/comment_api.dart';
 import 'core/data/remote/commerce_api.dart';
+import 'core/data/remote/device_profile.dart';
 import 'core/data/remote/download_api.dart';
 import 'core/data/remote/interaction_api.dart';
 import 'core/data/remote/library_api.dart';
@@ -117,12 +118,13 @@ class _LumaDramaAppState extends State<LumaDramaApp> {
   late final AuthSessionStore _sessionStore = AuthSessionStore();
 
   /// 全 App 共用一个 ApiClient：这样目录、账号、后续的互动/进度请求
-  /// 都自动带 `Authorization` 与 `X-Device-Id`，401 的刷新重试也只有一处实现。
+  /// 都自动带 `Authorization`、`X-Device-Id` 与平台头，401 的刷新重试也只有一处实现。
   late final ApiClient _apiClient = ApiClient(
     accessTokenReader: () => _auth.accessToken,
     tokenRefresher: () => _auth.refresh(),
     onUnauthorized: () => _auth.clear(),
     deviceIdReader: _sessionStore.deviceId,
+    platformReader: clientPlatform,
   );
 
   late final AuthController _auth = AuthController(

lib/core/config/app_config.dart

@@ -14,7 +14,7 @@ class AppConfig {
   /// 开发调试默认服务地址，当前指向本机局域网 IP。
   ///
   /// 换网络时只改这一行，地址不要带结尾斜杠。
-  static const String devHostBaseUrl = 'http://10.43.47.1:8081';
+  static const String devHostBaseUrl = 'http://192.168.31.243:8081';
 
   /// 本机后端地址：通过 `adb reverse tcp:8081 tcp:8081` 映射到开发机，
   /// 探测可达时 App 直连本机服务；不可达时回落到公网地址。

lib/core/data/remote/api_client.dart

@@ -24,6 +24,7 @@ class ApiClient {
     this.tokenRefresher,
     this.onUnauthorized,
     this.deviceIdReader,
+    this.platformReader,
   }) : _fixedBaseUrl = baseUrl {
     _dio = Dio(
       BaseOptions(
@@ -40,6 +41,7 @@ class ApiClient {
       AuthHeaderInterceptor(
         accessTokenReader: accessTokenReader,
         deviceIdReader: deviceIdReader,
+        platformReader: platformReader,
       ),
       const EnvelopeInterceptor(),
       NetworkLogInterceptor(),
@@ -67,6 +69,9 @@ class ApiClient {
   /// 设备号（`X-Device-Id`）：注册风控、后续下载绑定都要用
   final Future<String> Function()? deviceIdReader;
 
+  /// 客户端平台（`X-Client-Platform`）：后台区分 iOS / Android
+  final String Function()? platformReader;
+
   Future<Object?> get(String path, {Map<String, String>? query}) {
     return _request('GET', path, query: query);
   }

lib/core/data/remote/api_interceptors.dart

@@ -32,7 +32,11 @@ class TokenExpiredException implements Exception {
 ///
 /// 每个请求都重新取一次令牌，所以刷新成功后重发的那次会自动带上新令牌。
 class AuthHeaderInterceptor extends Interceptor {
-  AuthHeaderInterceptor({this.accessTokenReader, this.deviceIdReader});
+  AuthHeaderInterceptor({
+    this.accessTokenReader,
+    this.deviceIdReader,
+    this.platformReader,
+  });
 
   /// 当前 access token；未登录返回 null 或空串。
   final String? Function()? accessTokenReader;
@@ -40,6 +44,9 @@ class AuthHeaderInterceptor extends Interceptor {
   /// 设备号（`X-Device-Id`）：注册风控、下载绑定都用它。
   final Future<String> Function()? deviceIdReader;
 
+  /// 客户端平台（`X-Client-Platform`）：后台区分 iOS / Android，匿名请求同样要带。
+  final String Function()? platformReader;
+
   @override
   Future<void> onRequest(
     RequestOptions options,
@@ -54,6 +61,10 @@ class AuthHeaderInterceptor extends Interceptor {
     if (deviceId != null && deviceId.isNotEmpty) {
       options.headers['X-Device-Id'] = deviceId;
     }
+    final platform = platformReader?.call() ?? '';
+    if (platform.isNotEmpty) {
+      options.headers['X-Client-Platform'] = platform;
+    }
     handler.next(options);
   }
 }

lib/core/data/remote/auth_api.dart

@@ -56,6 +56,7 @@ class AuthApi {
     required String target,
     required String code,
     required String deviceId,
+    String countryCode = '',
     String platform = '',
     String osVersion = '',
     String appVersion = '',
@@ -66,6 +67,7 @@ class AuthApi {
         'targetType': 'PHONE',
         'target': target,
         'code': code,
+        'countryCode': countryCode,
         'deviceId': deviceId,
         'platform': platform,
         'osVersion': osVersion,
@@ -79,6 +81,7 @@ class AuthApi {
     required String email,
     required String password,
     required String deviceId,
+    String countryCode = '',
     String platform = '',
     String osVersion = '',
     String appVersion = '',
@@ -89,7 +92,7 @@ class AuthApi {
         'targetType': 'EMAIL',
         'target': email,
         'password': password,
-        'countryCode': 'ID',
+        'countryCode': countryCode,
         'deviceId': deviceId,
         'platform': platform,
         'osVersion': osVersion,

lib/core/data/remote/device_profile.dart

@@ -0,0 +1,15 @@
+// Author: fruit.com.cn
+
+import 'dart:io' show Platform;
+
+import 'package:flutter/foundation.dart';
+
+/// 客户端平台，后台只用来区分 iOS / Android。
+///
+/// 系统版本、机型一律不上报：后台列表需要的只是「这台设备是安卓还是苹果」。
+String clientPlatform() {
+  if (kIsWeb) return 'WEB';
+  if (Platform.isAndroid) return 'ANDROID';
+  if (Platform.isIOS) return 'IOS';
+  return '';
+}

lib/core/data/services/auth_controller.dart

@@ -48,6 +48,7 @@ class AuthController extends ChangeNotifier {
       email: email,
       password: password,
       deviceId: await _store.deviceId(),
+      countryCode: await _store.deviceRegion(),
       platform: _platform,
       osVersion: _osVersion,
     );
@@ -95,6 +96,7 @@ class AuthController extends ChangeNotifier {
       target: target,
       code: code,
       deviceId: await _store.deviceId(),
+      countryCode: await _store.deviceRegion(),
       platform: _platform,
       osVersion: _osVersion,
     );

lib/core/data/services/auth_session_store.dart

@@ -4,6 +4,7 @@ import 'dart:math';
 import 'package:shared_preferences/shared_preferences.dart';
 
 import '../models/auth_session.dart';
+import 'device_id_provider.dart';
 
 /// 令牌与设备号的本地持久化。
 ///
@@ -11,13 +12,17 @@ import '../models/auth_session.dart';
 /// `SharedPreferences.getInstance()` 在新版本里已标注弃用，两套混用还会让
 /// widget 测试只 mock 到其中一套。
 ///
-/// 设备号是后端注册风控与后续"下载设备绑定"的依据，所以**首次生成后就固定下来**；
+/// 设备号优先取系统标识（Android SSAID / iOS IDFV），这样卸载重装后还是同一台设备；
-/// 不引 UUID 库（保持极简依赖），用「时间戳 + 随机数」拼一个够用的 id。
+/// 系统标识不可用时才回退到本地生成并持久化的 UUID，保证任何环境都能跑。
 class AuthSessionStore {
-  AuthSessionStore({SharedPreferencesAsync? preferences})
+  AuthSessionStore({
-    : _preferences = preferences ?? SharedPreferencesAsync();
+    SharedPreferencesAsync? preferences,
+    DeviceIdProvider? deviceIdProvider,
+  }) : _preferences = preferences ?? SharedPreferencesAsync(),
+       _deviceIdProvider = deviceIdProvider ?? DeviceIdProvider();
 
   final SharedPreferencesAsync _preferences;
+  final DeviceIdProvider _deviceIdProvider;
 
   static const _kAccessToken = 'auth.accessToken';
   static const _kRefreshToken = 'auth.refreshToken';
@@ -25,21 +30,46 @@ class AuthSessionStore {
   static const _kDeviceId = 'device.id';
 
   String? _cachedDeviceId;
+  String? _cachedRegion;
 
   Future<String> deviceId() async {
     if (_cachedDeviceId != null) return _cachedDeviceId!;
-    var value = await _preferences.getString(_kDeviceId) ?? '';
+    final systemId = await _deviceIdProvider.systemDeviceId();
-    if (value.isEmpty) {
+    final value = systemId ?? await _localDeviceId();
-      final random = Random();
-      value =
-          'd-${DateTime.now().millisecondsSinceEpoch.toRadixString(36)}-'
-          '${random.nextInt(1 << 32).toRadixString(36)}';
-      await _preferences.setString(_kDeviceId, value);
-    }
     _cachedDeviceId = value;
     return value;
   }
 
+  /// 设备区域（ISO-2），取不到返回空串；只在注册时作为服务端 IP 解析失败后的兜底。
+  Future<String> deviceRegion() async {
+    if (_cachedRegion != null) return _cachedRegion!;
+    final value = await _deviceIdProvider.deviceRegion() ?? '';
+    _cachedRegion = value;
+    return value;
+  }
+
+  /// 系统标识取不到时的兜底：本地 UUIDv4，生成一次后固定下来。
+  Future<String> _localDeviceId() async {
+    final stored = await _preferences.getString(_kDeviceId) ?? '';
+    if (stored.isNotEmpty) return stored;
+    final generated = 'd-${_uuidV4()}';
+    await _preferences.setString(_kDeviceId, generated);
+    return generated;
+  }
+
+  /// UUIDv4：122 位随机，碰撞概率可忽略，不引第三方依赖。
+  String _uuidV4() {
+    final random = Random.secure();
+    final bytes = List<int>.generate(16, (_) => random.nextInt(256));
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    String hex(int start, int end) => bytes
+        .sublist(start, end)
+        .map((byte) => byte.toRadixString(16).padLeft(2, '0'))
+        .join();
+    return '${hex(0, 4)}-${hex(4, 6)}-${hex(6, 8)}-${hex(8, 10)}-${hex(10, 16)}';
+  }
+
   Future<AuthSession?> read() async {
     final accessToken = await _preferences.getString(_kAccessToken) ?? '';
     final refreshToken = await _preferences.getString(_kRefreshToken) ?? '';

lib/core/data/services/device_id_provider.dart

@@ -0,0 +1,50 @@
+// Author: fruit.com.cn
+
+import 'dart:io' show Platform;
+
+import 'package:flutter/foundation.dart';
+import 'package:flutter/services.dart';
+
+/// 读取系统级设备标识，两端都不需要任何权限。
+///
+/// - Android：SSAID（`Settings.Secure.ANDROID_ID`），卸载重装不变；
+/// - iOS：IDFV（`identifierForVendor`），卸载本 App 不变，同厂商应用全删才会变。
+///
+/// 两端都由原生侧提供，不引插件：项目 iOS 走 SPM，避免混入 CocoaPods。
+/// 取不到（Web、测试环境、通道异常）时返回 null，由调用方回退到本地生成的 id。
+class DeviceIdProvider {
+  static const MethodChannel _channel = MethodChannel(
+    'com.stormg.lumadrama/device',
+  );
+
+  Future<String?> systemDeviceId() async {
+    if (kIsWeb) return null;
+    try {
+      if (Platform.isAndroid) {
+        final ssaid = await _channel.invokeMethod<String>('ssaid');
+        if (ssaid != null && ssaid.isNotEmpty) return 'a-$ssaid';
+      }
+      if (Platform.isIOS) {
+        final idfv = await _channel.invokeMethod<String>('idfv');
+        if (idfv != null && idfv.isNotEmpty) return 'i-$idfv';
+      }
+    } catch (_) {
+      // 原生通道不可用（widget 测试）时走本地兜底
+    }
+    return null;
+  }
+
+  /// 设备所在区域（ISO-2），仅用于服务端 IP 解析失败时兜底注册国家。
+  /// Android 依次取网络运营商 / SIM 卡 / 系统语言的国家，iOS 取系统 region。
+  Future<String?> deviceRegion() async {
+    if (kIsWeb) return null;
+    try {
+      final region = await _channel.invokeMethod<String>('region');
+      final value = region?.trim().toUpperCase() ?? '';
+      if (value.length == 2) return value;
+    } catch (_) {
+      // 原生通道不可用（widget 测试）时返回 null，由服务端兜底
+    }
+    return null;
+  }
+}

lib/core/data/services/home_feed_controller.dart

@@ -33,6 +33,7 @@ class HomeFeedController extends ChangeNotifier {
   String? get cursor => _state(_channel).cursor;
   bool get hasMore => _state(_channel).hasMore;
   bool get loaded => _state(_channel).loaded;
+  bool get isLoading => _state(_channel).loading;
   bool get loadingMore => _state(_channel).loadingMore;
   bool get loadingFirstPage => !loaded && _state(_channel).loading;
 

lib/core/formatting/account_display.dart

@@ -0,0 +1,239 @@
+// Author: fruit.com.cn
+
+/// 账号资料页只读字段的展示格式化。
+///
+/// 后端存的是 ISO 国家码、BCP-47 语言标签和 IANA 时区（`ID` / `id-ID` / `Asia/Jakarta`），
+/// 直接展示对用户没有意义，这里统一转成当前界面语言的名称。
+/// 国家与城市名只维护中文与英文两套：界面语言为印尼语时回退英文名，
+/// 语言名与账号状态则三种界面语言都有。
+library;
+
+const _countryNamesZh = {
+  'ID': '印度尼西亚',
+  'MY': '马来西亚',
+  'SG': '新加坡',
+  'TH': '泰国',
+  'VN': '越南',
+  'PH': '菲律宾',
+  'KH': '柬埔寨',
+  'MM': '缅甸',
+  'LA': '老挝',
+  'BN': '文莱',
+  'CN': '中国',
+  'TW': '中国台湾',
+  'HK': '中国香港',
+  'MO': '中国澳门',
+  'JP': '日本',
+  'KR': '韩国',
+  'IN': '印度',
+  'PK': '巴基斯坦',
+  'BD': '孟加拉国',
+  'LK': '斯里兰卡',
+  'NP': '尼泊尔',
+  'US': '美国',
+  'CA': '加拿大',
+  'MX': '墨西哥',
+  'BR': '巴西',
+  'AR': '阿根廷',
+  'CL': '智利',
+  'CO': '哥伦比亚',
+  'PE': '秘鲁',
+  'VE': '委内瑞拉',
+  'EC': '厄瓜多尔',
+  'GT': '危地马拉',
+  'DO': '多米尼加',
+  'GB': '英国',
+  'DE': '德国',
+  'FR': '法国',
+  'ES': '西班牙',
+  'IT': '意大利',
+  'NL': '荷兰',
+  'PL': '波兰',
+  'RU': '俄罗斯',
+  'UA': '乌克兰',
+  'TR': '土耳其',
+  'SA': '沙特阿拉伯',
+  'AE': '阿联酋',
+  'IL': '以色列',
+  'EG': '埃及',
+  'NG': '尼日利亚',
+  'ZA': '南非',
+  'KE': '肯尼亚',
+  'MA': '摩洛哥',
+  'AU': '澳大利亚',
+  'NZ': '新西兰',
+};
+
+const _countryNamesEn = {
+  'ID': 'Indonesia',
+  'MY': 'Malaysia',
+  'SG': 'Singapore',
+  'TH': 'Thailand',
+  'VN': 'Vietnam',
+  'PH': 'Philippines',
+  'KH': 'Cambodia',
+  'MM': 'Myanmar',
+  'LA': 'Laos',
+  'BN': 'Brunei',
+  'CN': 'China',
+  'TW': 'Taiwan',
+  'HK': 'Hong Kong',
+  'MO': 'Macau',
+  'JP': 'Japan',
+  'KR': 'South Korea',
+  'IN': 'India',
+  'PK': 'Pakistan',
+  'BD': 'Bangladesh',
+  'LK': 'Sri Lanka',
+  'NP': 'Nepal',
+  'US': 'United States',
+  'CA': 'Canada',
+  'MX': 'Mexico',
+  'BR': 'Brazil',
+  'AR': 'Argentina',
+  'CL': 'Chile',
+  'CO': 'Colombia',
+  'PE': 'Peru',
+  'VE': 'Venezuela',
+  'EC': 'Ecuador',
+  'GT': 'Guatemala',
+  'DO': 'Dominican Republic',
+  'GB': 'United Kingdom',
+  'DE': 'Germany',
+  'FR': 'France',
+  'ES': 'Spain',
+  'IT': 'Italy',
+  'NL': 'Netherlands',
+  'PL': 'Poland',
+  'RU': 'Russia',
+  'UA': 'Ukraine',
+  'TR': 'Turkey',
+  'SA': 'Saudi Arabia',
+  'AE': 'United Arab Emirates',
+  'IL': 'Israel',
+  'EG': 'Egypt',
+  'NG': 'Nigeria',
+  'ZA': 'South Africa',
+  'KE': 'Kenya',
+  'MA': 'Morocco',
+  'AU': 'Australia',
+  'NZ': 'New Zealand',
+};
+
+const _timezoneNamesZh = {
+  'Asia/Jakarta': '雅加达',
+  'Asia/Kuala_Lumpur': '吉隆坡',
+  'Asia/Singapore': '新加坡',
+  'Asia/Bangkok': '曼谷',
+  'Asia/Ho_Chi_Minh': '胡志明市',
+  'Asia/Manila': '马尼拉',
+  'Asia/Phnom_Penh': '金边',
+  'Asia/Yangon': '仰光',
+  'Asia/Vientiane': '万象',
+  'Asia/Brunei': '斯里巴加湾市',
+  'Asia/Shanghai': '上海',
+  'Asia/Taipei': '台北',
+  'Asia/Hong_Kong': '香港',
+  'Asia/Macau': '澳门',
+  'Asia/Tokyo': '东京',
+  'Asia/Seoul': '首尔',
+  'Asia/Kolkata': '加尔各答',
+  'Asia/Karachi': '卡拉奇',
+  'Asia/Dhaka': '达卡',
+  'Asia/Colombo': '科伦坡',
+  'Asia/Kathmandu': '加德满都',
+  'America/New_York': '纽约',
+  'America/Toronto': '多伦多',
+  'America/Mexico_City': '墨西哥城',
+  'America/Sao_Paulo': '圣保罗',
+  'America/Argentina/Buenos_Aires': '布宜诺斯艾利斯',
+  'America/Santiago': '圣地亚哥',
+  'America/Bogota': '波哥大',
+  'America/Lima': '利马',
+  'America/Caracas': '加拉加斯',
+  'America/Guayaquil': '瓜亚基尔',
+  'America/Guatemala': '危地马拉城',
+  'America/Santo_Domingo': '圣多明各',
+  'Europe/London': '伦敦',
+  'Europe/Berlin': '柏林',
+  'Europe/Paris': '巴黎',
+  'Europe/Madrid': '马德里',
+  'Europe/Rome': '罗马',
+  'Europe/Amsterdam': '阿姆斯特丹',
+  'Europe/Warsaw': '华沙',
+  'Europe/Moscow': '莫斯科',
+  'Europe/Kyiv': '基辅',
+  'Europe/Istanbul': '伊斯坦布尔',
+  'Asia/Riyadh': '利雅得',
+  'Asia/Dubai': '迪拜',
+  'Asia/Jerusalem': '耶路撒冷',
+  'Africa/Cairo': '开罗',
+  'Africa/Lagos': '拉各斯',
+  'Africa/Johannesburg': '约翰内斯堡',
+  'Africa/Nairobi': '内罗毕',
+  'Africa/Casablanca': '卡萨布兰卡',
+  'Australia/Sydney': '悉尼',
+  'Pacific/Auckland': '奥克兰',
+};
+
+const _languageNames = {
+  'id': {'zh': '印度尼西亚语', 'en': 'Indonesian', 'id': 'Bahasa Indonesia'},
+  'en': {'zh': '英语', 'en': 'English', 'id': 'Inggris'},
+  'zh': {'zh': '中文', 'en': 'Chinese', 'id': 'Mandarin'},
+};
+
+const _statusNames = {
+  'normal': {'zh': '正常', 'en': 'Active', 'id': 'Aktif'},
+  'limited': {'zh': '受限', 'en': 'Limited', 'id': 'Dibatasi'},
+  'banned': {'zh': '已封禁', 'en': 'Banned', 'id': 'Diblokir'},
+  'deactivated': {'zh': '已注销', 'en': 'Deactivated', 'id': 'Dinonaktifkan'},
+};
+
+String _pick(Map<String, String> names, String localeName) =>
+    names[localeName] ?? names['en']!;
+
+/// 国家码 → 国家名；未收录的码原样返回。
+String countryName(String code, String localeName) {
+  final key = code.trim().toUpperCase();
+  if (key.isEmpty) return '';
+  final names = localeName == 'zh' ? _countryNamesZh : _countryNamesEn;
+  return names[key] ?? key;
+}
+
+/// IANA 时区 → 城市名；中文界面查表，其余语言取时区里的城市段。
+String timezoneName(String timezone, String localeName) {
+  final value = timezone.trim();
+  if (value.isEmpty) return '';
+  if (localeName == 'zh') {
+    final name = _timezoneNamesZh[value];
+    if (name != null) return name;
+  }
+  final city = value.split('/').last.replaceAll('_', ' ');
+  return city.isEmpty ? value : city;
+}
+
+/// BCP-47 语言标签 → 语言名，按主语言归类（`zh-TW` 也算中文）。
+String languageName(String language, String localeName) {
+  final value = language.trim();
+  if (value.isEmpty) return '';
+  final primary = value.split(RegExp('[-_]')).first.toLowerCase();
+  final names = _languageNames[primary];
+  return names == null ? value : _pick(names, localeName);
+}
+
+/// 账号状态 → 展示文案；未知状态原样返回。
+String accountStatusText(String status, String localeName) {
+  final value = status.trim().toLowerCase();
+  final names = _statusNames[value];
+  return names == null ? status : _pick(names, localeName);
+}
+
+/// VIP 等级：0 表示未开通，避免用户看到一个孤零零的 0。
+String vipLevelText(int level, String localeName) {
+  if (level > 0) return 'VIP $level';
+  return switch (localeName) {
+    'zh' => '未开通',
+    'id' => 'Belum aktif',
+    _ => 'Not subscribed',
+  };
+}

lib/core/theme/app_colors.dart

@@ -78,7 +78,12 @@ abstract final class AppColors {
   /// 中性深灰卡片与控件表面。
   static const contentCard = Color(0xFF16161A);
   static const contentSurface = Color(0xFF1C1C1E);
+
+  /// 首页、分类与搜索网格骨架的极暗底色。
   static const skeletonSurface = Color(0xFF0E0E0E);
+
+  /// 播放器、推荐与详情页大面积媒体占位的深灰底色。
+  static const skeletonMedia = Color(0xFF1C1C1E);
   static const contentChip = Color(0xFF2C2C2E);
   static const contentBorder = Color(0x1AFFFFFF);
   static const filterChipSelected = Color(0xFF21090E);

lib/core/widgets/drama_grid_skeleton.dart

@@ -12,7 +12,7 @@ const double _shimmerTravel = 2.4;
 const double _shimmerStart = -1.2;
 const double _subtitleWidthFactor = 0.62;
 const double _shimmerPhaseStep = 0.13;
-const Color _shimmerHighlight = Color(0x12FFFFFF);
+const Color _shimmerHighlight = Color(0x0DFFFFFF);
 
 /// 首页短剧网格的占位。行数至少铺满可视高度，并带一道扫光。
 class DramaGridSkeleton extends StatefulWidget {
@@ -116,41 +116,48 @@ class _SkeletonCard extends StatelessWidget {
   @override
   Widget build(BuildContext context) {
     final phase = (shimmerValue + index * _shimmerPhaseStep) % 1.0;
-    return ShaderMask(
+    return Stack(
-      blendMode: BlendMode.srcATop,
+      key: Key('drama-grid-skeleton-$index'),
-      shaderCallback: (bounds) => _cardShader(bounds, phase),
+      children: [
-      child: Column(
+        Column(
-        key: Key('drama-grid-skeleton-$index'),
+          crossAxisAlignment: CrossAxisAlignment.start,
-        crossAxisAlignment: CrossAxisAlignment.start,
+          children: [
-        children: [
+            AspectRatio(
-          AspectRatio(
+              aspectRatio: AppDimens.cardCoverAspectRatio,
-            aspectRatio: AppDimens.cardCoverAspectRatio,
+              child: const _SkeletonBlock(),
-            child: const _SkeletonBlock(),
+            ),
+            const SizedBox(height: AppDimens.cardCoverTitleGap),
+            const _SkeletonBar(),
+            const SizedBox(height: AppDimens.skeletonTitleBarGap),
+            const FractionallySizedBox(
+              widthFactor: _subtitleWidthFactor,
+              child: _SkeletonBar(),
+            ),
+          ],
+        ),
+        Positioned.fill(
+          child: IgnorePointer(
+            child: ClipRRect(
+              borderRadius: BorderRadius.circular(AppDimens.homeCardRadius),
+              child: DecoratedBox(
+                decoration: BoxDecoration(gradient: _cardHighlight(phase)),
+              ),
+            ),
           ),
-          const SizedBox(height: AppDimens.cardCoverTitleGap),
+        ),
-          const _SkeletonBar(),
+      ],
-          const SizedBox(height: AppDimens.skeletonTitleBarGap),
-          const FractionallySizedBox(
-            widthFactor: _subtitleWidthFactor,
-            child: _SkeletonBar(),
-          ),
-        ],
-      ),
     );
   }
 }
 
-Shader _cardShader(Rect bounds, double shimmerValue) {
+LinearGradient _cardHighlight(double shimmerValue) {
   final shift = _shimmerStart + _shimmerTravel * shimmerValue;
   return LinearGradient(
     begin: Alignment(shift, -0.3),
     end: Alignment(shift + 1, 0.3),
-    colors: const [
+    colors: const [Colors.transparent, _shimmerHighlight, Colors.transparent],
-      AppColors.skeletonSurface,
+    stops: const [0.42, 0.5, 0.58],
-      _shimmerHighlight,
+  );
-      AppColors.skeletonSurface,
-    ],
-  ).createShader(bounds);
 }
 
 class _SkeletonBlock extends StatelessWidget {

lib/pages/account/account_profile_page.dart

@@ -8,6 +8,7 @@ import 'package:provider/provider.dart';
 import '../../core/data/models/account_profile.dart';
 import '../../core/data/repositories/account_repository.dart';
 import '../../core/data/services/auth_controller.dart';
+import '../../core/formatting/account_display.dart';
 import '../../core/formatting/error_text.dart';
 import '../../core/formatting/localized_date_time.dart';
 import '../../core/theme/app_colors.dart';
@@ -225,6 +226,7 @@ class _AccountProfilePageState extends State<AccountProfilePage> {
   );
 
   Widget _readOnlyCard(AccountProfile profile, AppLocalizations l10n) {
+    final localeName = Localizations.localeOf(context).languageCode;
     return _AccountCard(
       child: Column(
         crossAxisAlignment: CrossAxisAlignment.start,
@@ -238,13 +240,34 @@ class _AccountProfilePageState extends State<AccountProfilePage> {
           ),
           const SizedBox(height: 10),
           _info(l10n.accountMaskedAccount, profile.maskedTarget),
-          _info(l10n.accountCountry, profile.countryCode),
+          _info(
+            l10n.accountCountry,
+            countryName(profile.countryCode, localeName),
+          ),
           _info(l10n.accountCurrency, profile.currency),
-          _info(l10n.accountStatus, profile.status),
+          _info(
-          _info(l10n.accountLanguage, profile.language),
+            l10n.accountStatus,
-          _info(l10n.accountTimezone, profile.timezone),
+            accountStatusText(profile.status, localeName),
-          _info(l10n.accountRegion, profile.regionCode),
+          ),
-          _info(l10n.accountVipLevel, '${profile.vipLevel}'),
+          _info(
+            l10n.accountLanguage,
+            languageName(profile.language, localeName),
+          ),
+          _info(
+            l10n.accountTimezone,
+            timezoneName(profile.timezone, localeName),
+          ),
+          // region 与 country 后端写的是同一个值，重复时不再单列一行
+          if (profile.regionCode.isNotEmpty &&
+              profile.regionCode != profile.countryCode)
+            _info(
+              l10n.accountRegion,
+              countryName(profile.regionCode, localeName),
+            ),
+          _info(
+            l10n.accountVipLevel,
+            vipLevelText(profile.vipLevel, localeName),
+          ),
           if (profile.createdAt != null)
             _info(
               l10n.accountCreatedAt,
@@ -275,7 +298,7 @@ class _AccountProfilePageState extends State<AccountProfilePage> {
         ),
         Flexible(
           child: Text(
-            value.isEmpty ? '-' : value,
+            value.isEmpty ? '—' : value,
             textAlign: TextAlign.right,
             style: const TextStyle(fontSize: AppDimens.body),
           ),

lib/pages/drama_detail/widgets/drama_episode_states.dart

@@ -13,7 +13,7 @@ const double _gridSpacing = 8;
 const double _radius = 10;
 const double _horizontal = 14;
 const double _sectionTop = 16;
-const double _minOpacity = 0.65;
+const double _minOpacity = 0.45;
 const double _maxOpacity = 0.8;
 const Duration _breathDuration = Duration(milliseconds: 900);
 
@@ -94,7 +94,7 @@ class _DramaEpisodesLoadingState extends State<DramaEpisodesLoading>
               opacity: _opacity,
               child: Container(
                 decoration: BoxDecoration(
-                  color: AppColors.skeletonSurface,
+                  color: AppColors.skeletonMedia,
                   borderRadius: BorderRadius.circular(_radius),
                 ),
               ),

lib/pages/mine/mine_view.dart

@@ -6,8 +6,11 @@ import 'package:flutter/material.dart';
 import 'package:flutter/services.dart';
 import 'package:provider/provider.dart';
 
+import '../../core/data/models/drama.dart';
+import '../../core/data/models/watch_progress.dart';
 import '../../core/data/repositories/watch_history_repository.dart';
 import '../../core/data/services/auth_controller.dart';
+import '../../core/data/services/catalog_controller.dart';
 import '../../core/data/services/favorite_controller.dart';
 import '../../core/data/services/locale_controller.dart';
 import '../../core/data/services/wallet_controller.dart';
@@ -22,6 +25,7 @@ import '../downloads/downloads_page.dart';
 import '../account/account_profile_page.dart';
 import '../filter/filter_page.dart';
 import '../notices/notices_page.dart';
+import '../player/open_player.dart';
 import '../settings/settings_page.dart';
 import '../store/vip_page.dart';
 import '../wallet/wallet_page.dart';
@@ -222,6 +226,7 @@ class _MyPageState extends State<MyPage> {
           const SizedBox(height: AppDimens.mineSectionGap),
           MineContinueWatching(
             records: continueWatching,
+            onOpenRecord: _openContinueRecord,
             onOpenAll: _openHistoryTab,
           ),
         ],
@@ -294,6 +299,36 @@ class _MyPageState extends State<MyPage> {
     unawaited(_openHistoryPage());
   }
 
+  /// 继续观看卡片：补齐剧集后直接进全屏播放页，播放器自己会定位到记录的秒数。
+  Future<void> _openContinueRecord(WatchProgress record) async {
+    final catalog = context.read<CatalogController>();
+    // 续看记录只有剧的概要信息，先拼一个占位对象让目录去取完整详情
+    final summary = Drama(
+      id: record.dramaId,
+      title: record.dramaTitle ?? '',
+      synopsis: '',
+      posterUrl: record.dramaCover ?? '',
+    );
+    Drama drama;
+    try {
+      drama = await catalog.requireDetail(summary);
+    } catch (_) {
+      if (!mounted) return;
+      final l10n = AppLocalizations.of(context)!;
+      ScaffoldMessenger.of(
+        context,
+      ).showSnackBar(SnackBar(content: Text(l10n.detailLoadFailed)));
+      return;
+    }
+    if (!mounted) return;
+    await playDramaFromCatalog(
+      context,
+      drama,
+      episodeId: record.episodeId.isEmpty ? null : record.episodeId,
+    );
+    if (mounted) unawaited(logic.refreshRecent());
+  }
+
   Future<void> _openHistoryPage() async {
     await _push(const WatchRecordsPage());
     if (mounted) unawaited(logic.refreshRecent());

lib/pages/mine/widgets/mine_continue_watching.dart

@@ -12,10 +12,14 @@ class MineContinueWatching extends StatelessWidget {
   const MineContinueWatching({
     super.key,
     required this.records,
+    required this.onOpenRecord,
     required this.onOpenAll,
   });
 
   final List<WatchProgress> records;
+
+  /// 单张卡片：直接进入该剧的播放页，并定位到记录的集。
+  final ValueChanged<WatchProgress> onOpenRecord;
   final VoidCallback onOpenAll;
 
   @override
@@ -94,7 +98,11 @@ class MineContinueWatching extends StatelessWidget {
     );
   }
 
-  Widget _card(AppLocalizations l10n, WatchProgress record, String languageCode) {
+  Widget _card(
+    AppLocalizations l10n,
+    WatchProgress record,
+    String languageCode,
+  ) {
     final title = record.localizedTitle(languageCode).trim();
     final episode = record.episodeNumber;
     final hasProgress = record.duration > Duration.zero;
@@ -103,7 +111,7 @@ class MineContinueWatching extends StatelessWidget {
       child: InkWell(
         key: Key('mine-continue-${record.dramaId}'),
         borderRadius: BorderRadius.circular(AppDimens.homeCardRadius),
-        onTap: onOpenAll,
+        onTap: () => onOpenRecord(record),
         child: Column(
           crossAxisAlignment: CrossAxisAlignment.start,
           children: [

lib/pages/player/widgets/player_overlay.dart

@@ -178,14 +178,6 @@ class PlayerPlaybackOverlay extends StatelessWidget {
                 selected: data.saved,
                 onTap: actions.onSave,
               ),
-              InteractionRailItem(
-                key: const Key('player-rail-comments'),
-                asset: 'assets/icon/rail/rail_comment.png',
-                label: data.l10n.comments,
-                count: data.commentCount,
-                countKey: const Key('player-rail-comments-count'),
-                onTap: actions.onComments,
-              ),
               InteractionRailItem(
                 key: const Key('player-rail-like'),
                 asset: 'assets/icon/rail/rail_like.png',
@@ -196,6 +188,14 @@ class PlayerPlaybackOverlay extends StatelessWidget {
                 selectedColor: AppColors.doubleTapHeartRed,
                 onTap: actions.onLike,
               ),
+              InteractionRailItem(
+                key: const Key('player-rail-comments'),
+                asset: 'assets/icon/rail/rail_comment.png',
+                label: data.l10n.comments,
+                count: data.commentCount,
+                countKey: const Key('player-rail-comments-count'),
+                onTap: actions.onComments,
+              ),
               InteractionRailItem(
                 key: const Key('player-rail-share'),
                 asset: 'assets/icon/rail/rail_share.png',

lib/pages/recommend/recommend_page.dart

@@ -49,10 +49,16 @@ class RecommendPage extends StatefulWidget {
 
 class _RecommendPageState extends State<RecommendPage>
     with AutomaticKeepAliveClientMixin<RecommendPage> {
+  static const Duration _recommendRetryDelay = Duration(milliseconds: 1500);
+  static const int _maxRecommendRetries = 3;
+
   RecommendInnerTab _tab = RecommendInnerTab.feed;
   final PageController _pageController = PageController();
   int _scrubCancelRequest = 0;
   bool _recommendDataRefreshScheduled = false;
+  bool _recommendRefreshInFlight = false;
+  int _recommendRetryAttempts = 0;
+  Timer? _recommendRetryTimer;
   HomeFeedChannel? _observedFeedChannel;
 
   @override
@@ -71,9 +77,13 @@ class _RecommendPageState extends State<RecommendPage>
     super.didUpdateWidget(oldWidget);
     if (oldWidget.feedController != widget.feedController) {
       oldWidget.feedController.removeListener(_handleFeedControllerChanged);
+      _cancelRecommendRetries();
       _observedFeedChannel = widget.feedController.channel;
       widget.feedController.addListener(_handleFeedControllerChanged);
     }
+    if (oldWidget.active && !widget.active) {
+      _cancelRecommendRetries();
+    }
     if (_requiresRecommendDataRefresh(oldWidget)) {
       _scheduleRecommendData();
     }
@@ -88,9 +98,32 @@ class _RecommendPageState extends State<RecommendPage>
 
   void _handleFeedControllerChanged() {
     final channel = widget.feedController.channel;
-    if (channel == _observedFeedChannel) return;
+    if (channel != _observedFeedChannel) {
-    _observedFeedChannel = channel;
+      _observedFeedChannel = channel;
-    if (widget.active) _scheduleRecommendData();
+      _cancelRecommendRetries();
+      if (widget.active) _scheduleRecommendData();
+      return;
+    }
+    _handleRecommendFeedState();
+  }
+
+  void _handleRecommendFeedState() {
+    if (!mounted || !widget.active) return;
+    final feed = widget.feedController;
+    if (feed.dramas.isNotEmpty) {
+      _cancelRecommendRetries();
+      return;
+    }
+    if (feed.loaded &&
+        feed.lastError == null &&
+        !feed.isLoading &&
+        !_recommendRefreshInFlight) {
+      _cancelRecommendRetries();
+      return;
+    }
+    if (feed.loaded && feed.lastError != null && !_recommendRefreshInFlight) {
+      _scheduleRecommendRetry();
+    }
   }
 
   void _scheduleRecommendData() {
@@ -100,8 +133,15 @@ class _RecommendPageState extends State<RecommendPage>
       _recommendDataRefreshScheduled = false;
       if (!mounted || !widget.active) return;
       final feed = widget.feedController;
-      if (!feed.loaded && !feed.loadingFirstPage) {
+      if (feed.dramas.isEmpty || feed.lastError != null) {
-        unawaited(feed.refreshCurrent());
+        _recommendRetryAttempts = 0;
+        if (!feed.isLoading && !_recommendRefreshInFlight) {
+          if (feed.loaded) {
+            _scheduleRecommendRetry();
+          } else {
+            unawaited(_refreshRecommendData());
+          }
+        }
       }
       final playlists = _readPlaylists();
       if (playlists != null && !playlists.loaded && !playlists.loading) {
@@ -110,9 +150,51 @@ class _RecommendPageState extends State<RecommendPage>
     });
   }
 
+  void _scheduleRecommendRetry() {
+    if (!mounted ||
+        !widget.active ||
+        _recommendRefreshInFlight ||
+        _recommendRetryTimer != null ||
+        _recommendRetryAttempts >= _maxRecommendRetries) {
+      return;
+    }
+    setState(() {
+      _recommendRetryTimer = Timer(_recommendRetryDelay, () {
+        _recommendRetryTimer = null;
+        if (!mounted || !widget.active) return;
+        _recommendRetryAttempts += 1;
+        unawaited(_refreshRecommendData());
+      });
+    });
+  }
+
+  Future<void> _refreshRecommendData() async {
+    if (!mounted || !widget.active || _recommendRefreshInFlight) return;
+    setState(() => _recommendRefreshInFlight = true);
+    final succeeded = await widget.feedController.refreshCurrent();
+    if (!mounted) return;
+    _recommendRefreshInFlight = false;
+    if (!widget.active) return;
+    final feed = widget.feedController;
+    if (succeeded || (feed.loaded && feed.lastError == null)) {
+      _cancelRecommendRetries();
+      setState(() {});
+      return;
+    }
+    setState(() {});
+    _scheduleRecommendRetry();
+  }
+
+  void _cancelRecommendRetries() {
+    _recommendRetryTimer?.cancel();
+    _recommendRetryTimer = null;
+    _recommendRetryAttempts = 0;
+  }
+
   @override
   void dispose() {
     widget.feedController.removeListener(_handleFeedControllerChanged);
+    _cancelRecommendRetries();
     _pageController.dispose();
     super.dispose();
   }
@@ -199,39 +281,51 @@ class _RecommendPageState extends State<RecommendPage>
   }
 
   Widget _recommendFeed(BuildContext context) {
+    final feed = widget.feedController;
     final dramas = widget.feedController.dramas;
-    if (dramas.isEmpty) {
+    if (dramas.isNotEmpty) {
-      final l10n = AppLocalizations.of(context)!;
+      return PlayerPage(
-      if (widget.feedController.loadingFirstPage) {
+        key: const Key('recommend-feed-player'),
-        return const _RecommendFeedSkeleton();
+        homeMode: true,
-      }
+        embedded: true,
+        active: widget.active && _tab == RecommendInnerTab.feed,
+        showHomeFeedHeader: false,
+        drama: dramas.first,
+        initialIndex: 0,
+        feedDramas: dramas,
+        feedChannel: widget.feedController.channel,
+        onOpenFullPlayer: (drama, episode) =>
+            _openDrama(drama, episodeId: episode.id),
+        onRefreshFeed: widget.feedController.refreshCurrent,
+        onLoadMore: widget.feedController.loadMore,
+        onImmersiveChanged: widget.onImmersiveChanged,
+        scrubCancelRequest: _scrubCancelRequest,
+      );
+    }
+    if (!feed.loaded ||
+        feed.isLoading ||
+        _recommendRefreshInFlight ||
+        _recommendRetryTimer != null) {
+      return const _RecommendFeedSkeleton();
+    }
+    final l10n = AppLocalizations.of(context)!;
+    if (feed.lastError != null) {
       return ColoredBox(
         color: AppColors.mediaBlack,
         child: EmptyState(
           key: const Key('recommend-feed-empty'),
-          icon: Icons.movie_outlined,
+          icon: Icons.wifi_off_rounded,
-          title: l10n.noStories,
+          title: l10n.networkError,
-          actionLabel: l10n.retry,
-          onAction: () => unawaited(widget.feedController.refreshCurrent()),
         ),
       );
     }
-    return PlayerPage(
+    return ColoredBox(
-      key: const Key('recommend-feed-player'),
+      color: AppColors.mediaBlack,
-      homeMode: true,
+      child: EmptyState(
-      embedded: true,
+        key: const Key('recommend-feed-empty'),
-      active: widget.active && _tab == RecommendInnerTab.feed,
+        icon: Icons.movie_outlined,
-      showHomeFeedHeader: false,
+        title: l10n.noStories,
-      drama: dramas.first,
+      ),
-      initialIndex: 0,
-      feedDramas: dramas,
-      feedChannel: widget.feedController.channel,
-      onOpenFullPlayer: (drama, episode) =>
-          _openDrama(drama, episodeId: episode.id),
-      onRefreshFeed: widget.feedController.refreshCurrent,
-      onLoadMore: widget.feedController.loadMore,
-      onImmersiveChanged: widget.onImmersiveChanged,
-      scrubCancelRequest: _scrubCancelRequest,
     );
   }
 
@@ -426,7 +520,7 @@ class _RecommendFeedSkeleton extends StatelessWidget {
               height: 176,
               child: DecoratedBox(
                 decoration: BoxDecoration(
-                  color: AppColors.skeletonSurface,
+                  color: AppColors.skeletonMedia,
                   borderRadius: BorderRadius.all(Radius.circular(12)),
                 ),
               ),
@@ -465,7 +559,7 @@ class _SkeletonLine extends StatelessWidget {
       width: width,
       height: height,
       decoration: BoxDecoration(
-        color: AppColors.skeletonSurface,
+        color: AppColors.skeletonMedia,
         borderRadius: BorderRadius.circular(6),
       ),
     );

pubspec.lock

@@ -216,7 +216,7 @@ packages:
     source: hosted
     version: "2.0.2"
   html:
-    dependency: transitive
+    dependency: "direct main"
     description:
       name: html
       sha256: "43b67b8f43321ab066817dfac5619596c98bb1b61624e77203bb4351785f9699"
@@ -248,10 +248,10 @@ packages:
     dependency: transitive
     description:
       name: intl
-      sha256: "3df61194eb431efc39c4ceba583b95633a403f46c9fd341e550ce0bfa50e9aa5"
+      sha256: "1ca20c894b1717686a2319b8548763d812bc0aabdac580420a44c5178c57a867"
       url: "https://pub.flutter-io.cn"
     source: hosted
-    version: "0.20.2"
+    version: "0.20.3"
   jni:
     dependency: transitive
     description:
@@ -328,10 +328,10 @@ packages:
     dependency: transitive
     description:
       name: matcher
-      sha256: dc0b7dc7651697ea4ff3e69ef44b0407ea32c487a39fff6a4004fa585e901861
+      sha256: "31bd099b47c10cd1aeb55146a2d46ce0277630ecef3f7dae54ad7873f36696cd"
       url: "https://pub.flutter-io.cn"
     source: hosted
-    version: "0.12.19"
+    version: "0.12.20"
   material_color_utilities:
     dependency: transitive
     description:
@@ -344,10 +344,10 @@ packages:
     dependency: transitive
     description:
       name: meta
-      sha256: "1741988757a65eb6b36abe716829688cf01910bbf91c34354ff7ec1c3de2b349"
+      sha256: "307249ce4ff29d58a18e97f6345f539382eb9c9c29ecda628900f31de0443dd9"
       url: "https://pub.flutter-io.cn"
     source: hosted
-    version: "1.18.0"
+    version: "1.19.0"
   mime:
     dependency: transitive
     description:
@@ -380,14 +380,6 @@ packages:
       url: "https://pub.flutter-io.cn"
     source: hosted
     version: "3.0.0"
-  petitparser:
-    dependency: transitive
-    description:
-      name: petitparser
-      sha256: "2f1564aadb14215e478563b5406cb80729d022158c01dc50c96013c2f7eb4790"
-      url: "https://pub.flutter-io.cn"
-    source: hosted
-    version: "7.1.0"
   path:
     dependency: transitive
     description:
@@ -444,6 +436,14 @@ packages:
       url: "https://pub.flutter-io.cn"
     source: hosted
     version: "2.3.0"
+  petitparser:
+    dependency: transitive
+    description:
+      name: petitparser
+      sha256: "2f1564aadb14215e478563b5406cb80729d022158c01dc50c96013c2f7eb4790"
+      url: "https://pub.flutter-io.cn"
+    source: hosted
+    version: "7.1.0"
   platform:
     dependency: transitive
     description:
@@ -613,10 +613,10 @@ packages:
     dependency: transitive
     description:
       name: test_api
-      sha256: "949a932224383300f01be9221c39180316445ecb8e7547f70a41a35bf421fb9e"
+      sha256: "2a122cbe059f8b610d3a5415f42e255b6c17b1f21eee1d960f31080237fb4f11"
       url: "https://pub.flutter-io.cn"
     source: hosted
-    version: "0.7.11"
+    version: "0.7.12"
   typed_data:
     dependency: transitive
     description:
@@ -637,10 +637,10 @@ packages:
     dependency: transitive
     description:
       name: vector_math
-      sha256: d530bd74fea330e6e364cda7a85019c434070188383e1cd8d9777ee586914c5b
+      sha256: "92b9910f66ed1057fd4da7b040ae7c74cafacf885bdc81be496928d5049b032d"
       url: "https://pub.flutter-io.cn"
     source: hosted
-    version: "2.2.0"
+    version: "2.4.3"
   video_player:
     dependency: "direct main"
     description:
@@ -730,5 +730,5 @@ packages:
     source: hosted
     version: "3.1.4"
 sdks:
-  dart: ">=3.12.2 <4.0.0"
+  dart: ">=3.13.0 <4.0.0"
   flutter: ">=3.44.0"

test/account/account_display_test.dart

@@ -0,0 +1,40 @@
+// Author: fruit.com.cn
+
+import 'package:flutter_test/flutter_test.dart';
+import 'package:fruitshorts/core/formatting/account_display.dart';
+
+void main() {
+  test('should_localize_country_name', () {
+    expect(countryName('ID', 'zh'), '印度尼西亚');
+    expect(countryName('us', 'en'), 'United States');
+    expect(countryName('TH', 'id'), 'Thailand');
+    // 未收录的码原样返回，避免展示成空白
+    expect(countryName('ZZ', 'zh'), 'ZZ');
+    expect(countryName('', 'zh'), '');
+  });
+
+  test('should_localize_timezone_to_city', () {
+    expect(timezoneName('Asia/Jakarta', 'zh'), '雅加达');
+    expect(timezoneName('Asia/Jakarta', 'en'), 'Jakarta');
+    expect(
+      timezoneName('America/Argentina/Buenos_Aires', 'en'),
+      'Buenos Aires',
+    );
+    expect(timezoneName('', 'zh'), '');
+  });
+
+  test('should_localize_language_by_primary_tag', () {
+    expect(languageName('id-ID', 'zh'), '印度尼西亚语');
+    expect(languageName('zh-TW', 'en'), 'Chinese');
+    expect(languageName('en-US', 'id'), 'Inggris');
+    expect(languageName('', 'zh'), '');
+  });
+
+  test('should_localize_status_and_vip_level', () {
+    expect(accountStatusText('normal', 'zh'), '正常');
+    expect(accountStatusText('banned', 'id'), 'Diblokir');
+    expect(accountStatusText('weird', 'zh'), 'weird');
+    expect(vipLevelText(0, 'zh'), '未开通');
+    expect(vipLevelText(2, 'zh'), 'VIP 2');
+  });
+}

test/core/device_id_test.dart

@@ -0,0 +1,81 @@
+// Author: fruit.com.cn
+
+import 'package:flutter_test/flutter_test.dart';
+import 'package:fruitshorts/core/data/services/auth_session_store.dart';
+import 'package:fruitshorts/core/data/services/device_id_provider.dart';
+import 'package:shared_preferences_platform_interface/in_memory_shared_preferences_async.dart';
+import 'package:shared_preferences_platform_interface/shared_preferences_async_platform_interface.dart';
+
+/// 可控的系统设备标识来源。
+class _FakeDeviceIdProvider implements DeviceIdProvider {
+  _FakeDeviceIdProvider(this.value, {this.region});
+
+  final String? value;
+  final String? region;
+  int calls = 0;
+
+  @override
+  Future<String?> systemDeviceId() async {
+    calls++;
+    return value;
+  }
+
+  @override
+  Future<String?> deviceRegion() async => region;
+}
+
+void main() {
+  setUp(() {
+    SharedPreferencesAsyncPlatform.instance =
+        InMemorySharedPreferencesAsync.empty();
+  });
+
+  test('should_prefer_system_device_id_over_local_value', () async {
+    final provider = _FakeDeviceIdProvider('a-9774d56d682e549c');
+    final store = AuthSessionStore(deviceIdProvider: provider);
+
+    expect(await store.deviceId(), 'a-9774d56d682e549c');
+  });
+
+  test('should_fall_back_to_stable_local_uuid_when_system_id_missing', () async {
+    final store = AuthSessionStore(
+      deviceIdProvider: _FakeDeviceIdProvider(null),
+    );
+
+    final first = await store.deviceId();
+    final second = await store.deviceId();
+
+    // 同一次运行内固定，且符合 UUIDv4 形态
+    expect(first, second);
+    expect(first, startsWith('d-'));
+    expect(
+      RegExp(
+        r'^d-[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$',
+      ).hasMatch(first),
+      isTrue,
+      reason: '本地兜底必须是 UUIDv4，避免 32 位随机带来的碰撞',
+    );
+  });
+
+  test('should_cache_system_id_within_one_session', () async {
+    final provider = _FakeDeviceIdProvider('i-E621E1F8-C36C-495A-93FC-0C247A3E6E5F');
+    final store = AuthSessionStore(deviceIdProvider: provider);
+
+    await store.deviceId();
+    await store.deviceId();
+
+    expect(provider.calls, 1);
+  });
+
+  test('should_return_device_region_or_empty_string', () async {
+    final store = AuthSessionStore(
+      deviceIdProvider: _FakeDeviceIdProvider(null, region: 'TH'),
+    );
+    final missing = AuthSessionStore(
+      deviceIdProvider: _FakeDeviceIdProvider(null),
+    );
+
+    expect(await store.deviceRegion(), 'TH');
+    expect(await missing.deviceRegion(), '');
+  });
+}

test/discover/drama_grid_skeleton_test.dart

@@ -5,7 +5,7 @@ import 'package:flutter_test/flutter_test.dart';
 import 'package:fruitshorts/core/widgets/drama_grid_skeleton.dart';
 
 void main() {
-  testWidgets('renders one local shimmer mask per skeleton card', (
+  testWidgets('renders one narrow highlight overlay per skeleton card', (
     tester,
   ) async {
     tester.view.physicalSize = const Size(390, 1000);
@@ -28,20 +28,34 @@ void main() {
     await tester.pump(const Duration(milliseconds: 100));
 
     expect(find.byType(GridView), findsOneWidget);
-    expect(
+    expect(find.byType(ShaderMask), findsNothing);
-      find.ancestor(
-        of: find.byType(GridView),
-        matching: find.byType(ShaderMask),
-      ),
-      findsNothing,
-    );
     for (var index = 0; index < 9; index++) {
       final card = find.byKey(Key('drama-grid-skeleton-$index'));
       expect(card, findsOneWidget);
       expect(
-        find.ancestor(of: card, matching: find.byType(ShaderMask)),
+        find.descendant(of: card, matching: find.byType(IgnorePointer)),
         findsOneWidget,
       );
+      final overlay = find.descendant(
+        of: card,
+        matching: find.byWidgetPredicate(
+          (widget) =>
+              widget is DecoratedBox &&
+              widget.decoration is BoxDecoration &&
+              (widget.decoration as BoxDecoration).gradient != null,
+        ),
+      );
+      expect(overlay, findsOneWidget);
+      final decoration =
+          tester.widget<DecoratedBox>(overlay).decoration as BoxDecoration;
+      final gradient = decoration.gradient! as LinearGradient;
+      expect(gradient.colors, const [
+        Colors.transparent,
+        Color(0x0DFFFFFF),
+        Colors.transparent,
+      ]);
+      expect(gradient.stops, const [0.42, 0.5, 0.58]);
+      expect(gradient.stops![2] - gradient.stops![0], lessThanOrEqualTo(0.25));
     }
   });
 }

test/mine/mine_preview_layout_test.dart

@@ -437,6 +437,24 @@ void main() {
     expect(find.byKey(const Key('following-history-grid')), findsOneWidget);
   });
 
+  testWidgets('should_open_player_when_tapping_continue_watching_card', (
+    tester,
+  ) async {
+    await _pumpApp(
+      tester,
+      signedIn: true,
+      history: InMemoryWatchHistoryRepository(seed: [_recent]),
+    );
+    await _openMine(tester);
+
+    await tester.tap(find.byKey(const Key('mine-continue-city-lights-demo')));
+    await tester.pumpAndSettle();
+
+    expect(find.byKey(const Key('player-scaffold')), findsOneWidget);
+    // 继续观看直接进播放页，不应该先落到历史列表
+    expect(find.byKey(const Key('following-page')), findsNothing);
+  });
+
   testWidgets('should_open_vip_from_mine_without_floating_player', (
     tester,
   ) async {

test/player/player_fullscreen_test.dart

@@ -1359,9 +1359,9 @@ void main() {
     final shareRect = tester.getRect(
       find.byKey(const Key('player-rail-share')),
     );
-    expect(commentsRect.top - saveRect.bottom, closeTo(24, 0.1));
+    expect(likeRect.top - saveRect.bottom, closeTo(24, 0.1));
-    expect(likeRect.top - commentsRect.bottom, closeTo(24, 0.1));
+    expect(commentsRect.top - likeRect.bottom, closeTo(24, 0.1));
-    expect(shareRect.top - likeRect.bottom, closeTo(24, 0.1));
+    expect(shareRect.top - commentsRect.bottom, closeTo(24, 0.1));
 
     final saveButton = tester.widget<IconButton>(
       find.descendant(

test/recommend/recommend_refresh_scheduling_test.dart

@@ -11,6 +11,14 @@ import '../support/fake_catalog.dart';
 import '../support/fake_category.dart';
 
 void main() {
+  testWidgets('should_show_skeleton_before_feed_is_loaded', (tester) async {
+    await _pumpRecommend(tester, active: false);
+
+    expect(find.byKey(const Key('recommend-feed-skeleton')), findsOneWidget);
+    expect(find.byKey(const Key('recommend-feed-empty')), findsNothing);
+    expect(find.text('Retry'), findsNothing);
+  });
+
   testWidgets('should_refresh_once_when_parent_rebuilds_repeatedly', (
     tester,
   ) async {
@@ -52,6 +60,64 @@ void main() {
     expect(fixture.controller.refreshCalls, 2);
   });
 
+  testWidgets('should_auto_retry_three_times_then_show_network_error', (
+    tester,
+  ) async {
+    final fixture = await _pumpFailingRecommend(tester);
+
+    expect(fixture.controller.refreshCalls, 1);
+    expect(find.byKey(const Key('recommend-feed-skeleton')), findsOneWidget);
+    expect(find.byKey(const Key('recommend-feed-empty')), findsNothing);
+
+    for (var attempt = 0; attempt < 3; attempt++) {
+      await tester.pump(const Duration(milliseconds: 1500));
+      await tester.pump();
+      expect(fixture.controller.refreshCalls, attempt + 2);
+      if (attempt < 2) {
+        expect(
+          find.byKey(const Key('recommend-feed-skeleton')),
+          findsOneWidget,
+        );
+        expect(find.byKey(const Key('recommend-feed-empty')), findsNothing);
+      }
+    }
+
+    final l10n = AppLocalizations.of(
+      tester.element(find.byType(RecommendPage)),
+    )!;
+    expect(fixture.controller.refreshCalls, 4);
+    expect(find.byKey(const Key('recommend-feed-skeleton')), findsNothing);
+    expect(find.byKey(const Key('recommend-feed-empty')), findsOneWidget);
+    expect(find.text(l10n.networkError), findsOneWidget);
+    expect(find.text(l10n.retry), findsNothing);
+  });
+
+  testWidgets('should_cancel_pending_auto_retry_when_disposed', (tester) async {
+    final fixture = await _pumpFailingRecommend(tester);
+    expect(fixture.controller.refreshCalls, 1);
+
+    await tester.pumpWidget(const MaterialApp(home: SizedBox.shrink()));
+    await tester.pump(const Duration(seconds: 2));
+
+    expect(fixture.controller.refreshCalls, 1);
+  });
+
+  testWidgets(
+    'should_show_no_stories_without_retry_when_loaded_feed_is_empty',
+    (tester) async {
+      final fixture = await _pumpEmptyRecommend(tester);
+
+      final l10n = AppLocalizations.of(
+        tester.element(find.byType(RecommendPage)),
+      )!;
+      expect(fixture.controller.refreshCalls, 1);
+      expect(find.byKey(const Key('recommend-feed-skeleton')), findsNothing);
+      expect(find.byKey(const Key('recommend-feed-empty')), findsOneWidget);
+      expect(find.text(l10n.noStories), findsOneWidget);
+      expect(find.text(l10n.retry), findsNothing);
+    },
+  );
+
   testWidgets('should_not_refresh_after_dispose_when_channel_changes', (
     tester,
   ) async {
@@ -96,6 +162,58 @@ Future<_RecommendFixture> _pumpRecommend(
   return fixture;
 }
 
+Future<_StatefulRecommendFixture> _pumpFailingRecommend(
+  WidgetTester tester,
+) async {
+  tester.view.physicalSize = const Size(390, 844);
+  tester.view.devicePixelRatio = 1;
+  addTearDown(tester.view.resetPhysicalSize);
+  addTearDown(tester.view.resetDevicePixelRatio);
+
+  final catalog = FakeCatalogRepository();
+  final controller = _StatefulHomeFeedController(catalog);
+  final categories = CategoryController(
+    FakeCategoryRepository(catalog: catalog),
+  );
+  addTearDown(controller.dispose);
+  addTearDown(categories.dispose);
+
+  final fixture = _StatefulRecommendFixture(
+    controller: controller,
+    categoryController: categories,
+  );
+  await tester.pumpWidget(fixture.app());
+  await tester.pump();
+  await tester.pump(const Duration(milliseconds: 1));
+  return fixture;
+}
+
+Future<_StatefulRecommendFixture> _pumpEmptyRecommend(
+  WidgetTester tester,
+) async {
+  tester.view.physicalSize = const Size(390, 844);
+  tester.view.devicePixelRatio = 1;
+  addTearDown(tester.view.resetPhysicalSize);
+  addTearDown(tester.view.resetDevicePixelRatio);
+
+  final catalog = FakeCatalogRepository();
+  final controller = _StatefulHomeFeedController(catalog, fail: false);
+  final categories = CategoryController(
+    FakeCategoryRepository(catalog: catalog),
+  );
+  addTearDown(controller.dispose);
+  addTearDown(categories.dispose);
+
+  final fixture = _StatefulRecommendFixture(
+    controller: controller,
+    categoryController: categories,
+  );
+  await tester.pumpWidget(fixture.app());
+  await tester.pump();
+  await tester.pump(const Duration(milliseconds: 1));
+  return fixture;
+}
+
 class _RecommendFixture {
   const _RecommendFixture({
     required this.controller,
@@ -123,6 +241,32 @@ class _RecommendFixture {
   }
 }
 
+class _StatefulRecommendFixture {
+  const _StatefulRecommendFixture({
+    required this.controller,
+    required this.categoryController,
+  });
+
+  final _StatefulHomeFeedController controller;
+  final CategoryController categoryController;
+
+  Widget app() {
+    return MaterialApp(
+      localizationsDelegates: AppLocalizations.localizationsDelegates,
+      supportedLocales: AppLocalizations.supportedLocales,
+      home: ChangeNotifierProvider<CategoryController>.value(
+        value: categoryController,
+        child: RecommendPage(
+          feedController: controller,
+          active: true,
+          videoOnly: true,
+          onSearch: () {},
+        ),
+      ),
+    );
+  }
+}
+
 class _RecommendHarness extends StatefulWidget {
   const _RecommendHarness({
     super.key,
@@ -181,3 +325,36 @@ class _RecordingHomeFeedController extends HomeFeedController {
     return true;
   }
 }
+
+class _StatefulHomeFeedController extends HomeFeedController {
+  _StatefulHomeFeedController(super.repository, {this.fail = true});
+
+  final bool fail;
+  int refreshCalls = 0;
+  bool _loaded = false;
+  bool _isLoading = false;
+  String? _lastError;
+
+  @override
+  bool get loaded => _loaded;
+
+  @override
+  bool get isLoading => _isLoading;
+
+  @override
+  String? get lastError => _lastError;
+
+  @override
+  Future<bool> refreshCurrent() async {
+    refreshCalls++;
+    _isLoading = true;
+    _lastError = null;
+    notifyListeners();
+    await Future<void>.delayed(Duration.zero);
+    _isLoading = false;
+    _loaded = true;
+    if (fail) _lastError = 'network error';
+    notifyListeners();
+    return !fail;
+  }
+}

test/theme/app_theme_test.dart

@@ -26,6 +26,8 @@ void main() {
     expect(AppColors.cardAlt, const Color(0xFF101010));
     expect(AppColors.raised, const Color(0xFF1C1C1E));
     expect(AppColors.border, const Color(0xFF1C1C1E));
+    expect(AppColors.skeletonSurface, const Color(0xFF0E0E0E));
+    expect(AppColors.skeletonMedia, const Color(0xFF1C1C1E));
     expect(AppColors.textPrimary, const Color(0xFFFFFFFF));
     expect(AppColors.textSecondary, const Color(0xFFB0B0B0));
     expect(AppColors.textTertiary, const Color(0xFF8E8E93));