跳到主要内容

架构总览

BlinkLife Flutter 客户端采用分层架构：screens（页面）→ services/utils（业务逻辑）→ models（数据）→ SQLite/文件系统（持久化），无第三方状态管理框架，核心使用 ChangeNotifier + ValueNotifier。

分层结构​

┌─────────────────────────────────────────────────────┐
│                    screens/ (18个)                    │
│  页面层：持有状态、组合 widgets、调用 services        │
├─────────────────────────────────────────────────────┤
│                    widgets/ (29个)                    │
│  组件层：无业务逻辑的 UI 组件                        │
├──────────────────┬──────────────────────────────────┤
│  services/ (14个) │         utils/ (20个)            │
│  业务服务层       │         工具类                    │
│  DB/剪辑/同步     │         BLE/加密/格式化           │
├──────────────────┴──────────────────────────────────┤
│                    models/ (6个)                      │
│  数据模型：RecordingRecord / ClipRecord / ...         │
├─────────────────────────────────────────────────────┤
│          SQLite (sqflite)  +  文件系统 (.blink)       │
│          持久化层                                     │
└─────────────────────────────────────────────────────┘

核心模块关系​

                    录制页 (recording_page)
                         │
                    ┌────┴────┐
                    │ 保存录制 │
                    └────┬────┘
                         │
                    ┌────▼────┐     ┌────────────────┐
                    │   DB    │────▶│  .blink 文件    │
                    │ SQLite  │     │ AES-256-CBC     │
                    └────┬────┘     └────────────────┘
                         │
              ┌──────────┼──────────┐
              │          │          │
         ┌────▼────┐ ┌──▼───┐ ┌───▼────┐
         │ 回放页   │ │首页  │ │历史记录│
         │ review   │ │home  │ │history │
         └────┬────┘ └──────┘ └────────┘
              │
    ┌─────────┼─────────┐
    │         │         │
┌───▼───┐ ┌──▼───┐ ┌──▼──────┐
│时间轴 │ │事件  │ │剪辑任务 │
│3层绘制│ │列表  │ │TaskMgr  │
└───────┘ └──────┘ └────┬────┘
                        │
                   ┌────▼────┐
                   │ FFmpeg  │
                   │ 异步剪辑│
                   └────┬────┘
                        │
                   ┌────▼────┐
                   │剪辑列表 │
                   │批次详情 │
                   └─────────┘

状态管理策略​

不使用 Provider/Riverpod/BLoC 等第三方方案。采用 Flutter 原生机制：

机制用途示例
ChangeNotifier + addListener低频状态（页面数据、筛选）PlaybackSession, ReviewDetailData
ValueNotifier + ValueListenableBuilder高频状态（播放位置 ~10Hz）session.position
setState页面局部状态_isRecording, _isSaving
全局单例跨页面服务VideoClipTaskManager, FavoriteService
StreamSubscription系统事件（BLE、传感器）BluetoothService, AccelerometerEvent

详见 状态管理。

关键设计决策​

为什么不用状态管理框架？​

回放页通过双 Model 分层（PlaybackSession + ReviewDetailData）已解决最复杂页面的状态问题。引入 Provider/Riverpod 的 boilerplate 与当前项目规模不匹配。

为什么 FFmpeg 使用 executeAsync？​

execute 是同步调用，会阻塞 UI 线程导致 ANR。executeAsync 通过 Completer 桥接为 Future，配合 VideoClipTaskManager 的 fire-and-forget 模式实现后台剪辑。

为什么视频保存优先用 rename？​

File.rename 是原子操作（<1ms），而后台 Isolate 拷贝可能需要数分钟。rename 仅在同一文件系统内有效，跨文件系统时回退到 Isolate 拷贝。

已知事实 / 合理假设 / 待确认项​

类型内容
✅ 已知当前无第三方状态管理框架，使用 ChangeNotifier + ValueNotifier
✅ 已知数据库版本 v13，包含 5 个核心表
💡 假设未来接入 AI 复盘时可能需要独立的 AI Service 层
❓ 待确认是否计划引入 Provider 或 Riverpod 统一状态管理

相关文档​