状态管理重构：从混乱到统一

// 分散在各处的 _isOffline 设置（17 处）
Future<void> _loadMetadata() async {
  // ...
  _isOffline = true;  // 这里设置
  // ...
  _isOffline = false; // 那里又设置
}
 
Future<void> refreshFiles() async {
  // ...
  _isOffline = true;  // 这里也设置
}
 
Future<void> forceRefresh() async {
  // 60+ 行代码，多处设置 _isOffline
}

/// 刷新健康状态（统一的离线状态管理入口）
Future<void> refreshHealthStatus() async {
  try {
    final coreResult = await api.checkCoreHealth();
    final storageResult = await api.checkStorageHealth();
    
    // 统一设置离线状态
    _isOffline = !coreResult.isSuccess || !storageResult.isSuccess;
    
    // 根据错误类型设置错误码
    if (!coreResult.isSuccess) {
      _healthErrorCode = 'core_error';
    } else if (!storageResult.isSuccess) {
      _healthErrorCode = 's3_error';
    } else {
      _healthErrorCode = null;
    }
    
    notifyListeners();
  } catch (e) {
    _isOffline = true;
    notifyListeners();
  }
}
 
/// 加载元数据（不改变离线状态，由 refreshHealthStatus 统一管理）
Future<bool> _loadMetadata() async {
  try {
    final result = await api.getMetadata();
    if (result.isSuccess && result.data != null) {
      _files = result.data!.files.values.toList();
      _markSystemFolders();
      await _syncToLocalDb(result.data!);
      return true;  // 只返回成功/失败，不设置 _isOffline
    } else {
      await _loadFromLocalDb();
      return false;
    }
  } catch (e) {
    await _loadFromLocalDb();
    return false;
  }
}
 
/// 强制刷新（简化后：从 60+ 行减少到 20 行）
Future<void> forceRefresh() async {
  _isLoading = true;
  notifyListeners();
 
  // 1. 先刷新健康状态（统一的离线状态管理入口）
  await refreshHealthStatus();
 
  if (!_isOffline) {
    // 2. 在线时：先尝试重新认证
    await _tryReauthenticate();
    // 3. 加载最新数据
    await _loadMetadata();
  } else {
    // 4. 离线时：加载本地缓存
    await _loadFromLocalDb();
  }
 
  _isLoading = false;
  notifyListeners();
}

body: Consumer<AppState>(
  builder: (context, appState, _) {
    // 只有在"从未连接过"（未解锁且没有缓存）时才显示大的锁定提示
    // 一旦有缓存，即使离线/未解锁，也正常显示列表（只用红色云朵提示）
    final neverConnected = !appState.isUnlocked && _sessions.isEmpty && !_loading;
    
    if (neverConnected) {
      return _buildLockedState(isDark);  // 全屏提示
    }
    
    // 有缓存时正常显示，通过 AppBar 的红色云朵提示离线状态
    return _buildSessionList(isDark);
  },
),

class AppState extends ChangeNotifier {
  AppState() {
    _initCoreAndNetwork();  // 异步！不阻塞构造函数
  }
  
  Future<void> _initCoreAndNetwork() async {
    await _loadPreferences();
    await _ensureCoreModeLoaded();
    await _maybeStartEmbeddedCore();
    await _checkInitialNetworkStatus();  // 这里才设置正确的离线状态
  }
}

// 添加导入
import '../core/services/video_thumbnail_service.dart';
 
// 在上传成功后添加缩略图生成
if (result.isSuccess && result.data != null) {
  // 成功：替换临时消息为真实消息
  setState(() {
    // ... 更新消息列表
  });
  
  // 更新本地数据库
  await appState.db.deleteSendMessage(tempId);
  await appState.db.upsertSendMessage(result.data!);
  
  // 视频文件上传成功后，生成并上传缩略图
  if (isVideoFile(safeFileName)) {
    _generateAndUploadVideoThumbnail(appState, filePath, uploadedFileId);
  }
}
 
/// 视频上传后生成并上传缩略图（异步，不阻塞上传流程）
Future<void> _generateAndUploadVideoThumbnail(
  AppState appState,
  String videoPath,
  String fileId,
) async {
  try {
    // 使用统一的缩略图服务从本地文件生成
    final thumbData = await VideoThumbnailService().generateFromFile(videoPath);
    if (thumbData != null) {
      await appState.api.uploadThumbnail(fileId, thumbData);
      debugPrint('[ChatPage] Video thumbnail uploaded for $fileId');
    }
  } catch (e) {
    // 缩略图生成失败不影响上传流程
    debugPrint('[ChatPage] Failed to generate video thumbnail: $e');
  }
}

const (
  sendSessionsKey = ".e2eepan/send/sessions.enc"
  sendMessagesDir = ".e2eepan/send/messages/"
)

final taskResult = await appState.api.uploadByPath(
  filePath: filePath,
  fileName: safeFileName,
  remotePath: '/sender/',  // 聊天文件存储在这里
);

// 之前（会 OOM）
final fileData = await File(filePath).readAsBytes();
await api.uploadFile(fileData, fileName);
 
// 之后（流式处理）
await api.uploadByPath(
  filePath: filePath,
  fileName: fileName,
  remotePath: '/sender/',
);

# Flutter 代码分析
flutter analyze
# 结果：3 issues found（都是 info 级别的 use_build_context_synchronously）
 
# APK 构建
.\scripts\bat\build_android.bat
# 结果：成功，133.6MB
 
# 安装到设备
adb install -r app-release.apk
# 结果：成功

  bool _isInitialized = false;
  bool _isUnlocked = false;
  bool _isLoading = false;
  bool _isOffline = false;
+ bool _isReady = false; // 应用状态是否初始化完成
 
  // Getters
+ bool get isReady => _isReady;
  bool get isInitialized => _isInitialized;
  bool get isUnlocked => _isUnlocked;
 
  Future<void> _initCoreAndNetwork() async {
    await _loadPreferences();
    await _ensureCoreModeLoaded();
    await _maybeStartEmbeddedCore();
    await _checkInitialNetworkStatus();
    _cleanupFilePickerCache();
+
+   // 标记初始化完成
+   _isReady = true;
+   notifyListeners();
  }

  Widget build(BuildContext context) {
    return Consumer<AppState>(
      builder: (context, appState, _) {
        return MaterialApp(
-         home: appPinRequired ? const AppPinLockPage() : const HomePage(),
+         home: _buildHome(appState, appPinRequired),
        );
      },
    );
  }
 
+ Widget _buildHome(AppState appState, bool appPinRequired) {
+   if (!appState.isReady) {
+     return const _SplashScreen();
+   }
+   if (appPinRequired) {
+     return const AppPinLockPage();
+   }
+   return const HomePage();
+ }

+ import '../core/services/video_thumbnail_service.dart';
 
  if (result.isSuccess && result.data != null) {
    // ... 更新消息
    
+   // 视频文件上传成功后，生成并上传缩略图
+   if (isVideoFile(safeFileName)) {
+     _generateAndUploadVideoThumbnail(appState, filePath, uploadedFileId);
+   }
  }
 
+ Future<void> _generateAndUploadVideoThumbnail(
+   AppState appState,
+   String videoPath,
+   String fileId,
+ ) async {
+   try {
+     final thumbData = await VideoThumbnailService().generateFromFile(videoPath);
+     if (thumbData != null) {
+       await appState.api.uploadThumbnail(fileId, thumbData);
+     }
+   } catch (e) {
+     debugPrint('[ChatPage] Failed to generate video thumbnail: $e');
+   }
+ }