Merge fix/auto-20260326-103901: 设备绑定状态检查、路由记忆恢复、错误拦截优化

airhub_app/CLAUDE.md

@@ -0,0 +1,294 @@
+# Airhub App 开发规范
+
+> 所有新功能开发、代码修改、Bug 修复均需遵循本规范
+
+---
+
+## 一、项目架构
+
+```
+lib/
+├── core/                  # 基础设施层（全局共享）
+│   ├── errors/            # 异常类 & Failure 类
+│   ├── network/           # ApiClient, TokenManager, ApiConfig
+│   ├── router/            # go_router 路由配置
+│   └── services/          # 全局服务（LogCenter 等）
+├── features/              # 功能模块（按业务领域划分）
+│   ├── auth/              # 认证
+│   ├── badge/             # 电子吧唧
+│   ├── device/            # 设备管理
+│   ├── notification/      # 通知
+│   ├── spirit/            # 精灵/角色
+│   ├── user/              # 用户
+│   └── system/            # 系统（版本检查等）
+├── pages/                 # 独立页面（未归入 feature 的页面）
+├── widgets/               # 全局可复用 Widget
+├── theme/                 # 主题、颜色、Design Tokens
+├── services/              # 应用级服务（TTS、音乐生成等）
+└── main.dart              # 入口
+```
+
+### Feature 模块内部结构
+
+```
+features/xxx/
+├── data/
+│   ├── datasources/       # 远程/本地数据源
+│   ├── models/            # 数据模型（Freezed）
+│   └── repositories/      # Repository 实现
+├── domain/
+│   └── repositories/      # Repository 接口
+└── presentation/
+    ├── controllers/       # Riverpod 控制器
+    ├── pages/             # 页面
+    └── widgets/           # 功能专属 Widget
+```
+
+---
+
+## 二、状态管理（Riverpod）
+
+### 规则
+
+1. **使用 `@riverpod` 注解**声明 Provider，不手写 `StateNotifierProvider` 等
+2. Controller 使用 `AsyncValue<T>` 管理异步状态
+3. Repository 返回 `Either<Failure, T>`（fpdart），Controller 内 `fold` 处理
+4. **页面中优先使用 `ConsumerWidget`**（无状态）；需要动画/本地状态时用 `ConsumerStatefulWidget`
+5. **`ref.watch()` 用于 UI 绑定**（触发重建），**`ref.read()` 用于事件处理**（不触发重建）
+6. **`ref.listen()` 用于副作用**（弹窗、导航、Toast），不触发 Widget 重建
+
+### 示例
+
+```dart
+@riverpod
+class MyController extends _$MyController {
+  @override
+  FutureOr<MyState> build() async {
+    final repo = ref.watch(myRepositoryProvider);
+    final result = await repo.fetchData();
+    return result.fold(
+      (failure) => throw failure,
+      (data) => MyState(data: data),
+    );
+  }
+}
+```
+
+---
+
+## 三、网络层
+
+### 规则
+
+1. 所有 API 调用通过 `ApiClient`（Dio 封装），不直接使用 `http` 包或 `Dio()`
+2. `ApiClient` 自动处理：Token 附加、401 自动刷新、错误上报
+3. 后端统一返回 `{code, message, data}`，`ApiClient._request()` 自动解析
+4. 异常类型：`ServerException`（code != 0）、`NetworkException`（连接失败）
+5. **不在 Widget/Controller 中直接调用 ApiClient**，应通过 Repository 层
+
+### 错误处理链
+
+```
+DataSource (throw Exception)
+  → Repository (catch → Either<Failure, T>)
+    → Controller (fold → AsyncValue)
+      → UI (AsyncValue.when: loading/data/error)
+```
+
+---
+
+## 四、路由（go_router）
+
+### 规则
+
+1. 所有路由定义在 `core/router/app_router.dart`
+2. 使用 `context.go()` 进行声明式导航，避免 `Navigator.push()`（页面内二级跳转除外）
+3. 登录态检查在 `redirect` 中统一处理
+4. 产品类型 → 路由映射在 `_productRoutes` Map 中维护
+
+---
+
+## 五、性能规范
+
+### 内存管理
+
+1. **所有 Stream 订阅必须存入变量，dispose 时取消**
+   ```dart
+   // ✅ 正确
+   StreamSubscription<Duration>? _positionSub;
+   _positionSub = stream.listen((data) { ... });
+
+   @override
+   void dispose() {
+     _positionSub?.cancel();
+     super.dispose();
+   }
+
+   // ❌ 错误 — 无法取消，造成内存泄漏
+   stream.listen((data) { ... });
+   ```
+
+2. **AnimationController、VideoPlayerController、AudioPlayer 等必须在 dispose 中释放**
+
+3. **页面离开时停止 BLE 扫描**
+   ```dart
+   @override
+   void dispose() {
+     FlutterBluePlus.stopScan();
+     _scanSubscription?.cancel();
+     super.dispose();
+   }
+   ```
+
+### Widget 重建优化
+
+4. **能用 `const` 的地方必须加 `const`**
+   ```dart
+   // ✅
+   const SizedBox(height: 16)
+   const EdgeInsets.all(16)
+   const Text('Hello')
+
+   // ❌
+   SizedBox(height: 16)
+   EdgeInsets.all(16)
+   ```
+
+5. **动画区域用 `RepaintBoundary` 包裹**，防止全页面重绘
+   ```dart
+   RepaintBoundary(
+     child: AnimatedGradientBackground(),
+   )
+   ```
+
+6. **`AnimatedBuilder` 必须使用 `child` 参数**，将不变的子树传入 child，不要在 builder 中重建
+   ```dart
+   // ✅
+   AnimatedBuilder(
+     animation: _controller,
+     child: const HeavyWidget(),  // 只构建一次
+     builder: (context, child) => Transform.rotate(
+       angle: _controller.value,
+       child: child,  // 复用
+     ),
+   )
+   ```
+
+### API 调用
+
+7. **多个独立 API 调用使用 `Future.wait` 并行**，不要顺序 await
+   ```dart
+   // ✅ 并行
+   final results = await Future.wait([
+     api.get('/shelves/'),
+     api.get('/stories/'),
+   ]);
+
+   // ❌ 顺序（慢 N 倍）
+   final shelves = await api.get('/shelves/');
+   final stories = await api.get('/stories/');
+   ```
+
+8. **耗时计算（JSON 解析、图片处理）放到 Isolate**
+   ```dart
+   final result = await Isolate.run(() => jsonDecode(bigJson));
+   ```
+
+### 图片
+
+9. **网络图片使用 `Image.network` + `fit: BoxFit.cover`**，不要手动指定 `cacheWidth/cacheHeight`（会导致显示异常）
+10. **大量图片列表使用 `ListView.builder`**，不要 `ListView(children: [...])`
+
+---
+
+## 六、构建配置
+
+### Android Release
+
+- `build.gradle.kts` 中 release 配置：
+  - `isMinifyEnabled = true` — R8 代码压缩
+  - `isShrinkResources = true` — 移除未使用资源
+  - ProGuard 规则在 `proguard-rules.pro` 维护
+- 打包命令：`flutter build apk --release --split-per-abi --obfuscate --split-debug-info=./debug-info`
+
+### iOS Release
+
+- 构建命令：`flutter build ipa --release --obfuscate --split-debug-info=./debug-info`
+
+---
+
+## 七、命名规范
+
+### 文件命名
+
+| 类型 | 格式 | 示例 |
+|------|------|------|
+| 页面 | `xxx_page.dart` | `login_page.dart` |
+| 控制器 | `xxx_controller.dart` | `auth_controller.dart` |
+| 数据源 | `xxx_remote_data_source.dart` | `spirit_remote_data_source.dart` |
+| 仓库实现 | `xxx_repository_impl.dart` | `auth_repository_impl.dart` |
+| 仓库接口 | `xxx_repository.dart` | `auth_repository.dart` |
+| 模型 | `xxx_model.dart` | `user_model.dart` |
+| Widget | `xxx_widget.dart` 或直接描述 | `gradient_button.dart` |
+| 生成文件 | `*.g.dart` / `*.freezed.dart` | 自动生成，不手动编辑 |
+
+### 类命名
+
+- PascalCase：`AuthController`、`DeviceControlPage`、`ServerException`
+- 私有前缀：`_buildHeader()`、`_positionSub`
+
+### 变量命名
+
+- camelCase：`currentUser`、`isPlaying`、`_audioPlayer`
+- Provider：`xxxProvider`（由 `@riverpod` 自动生成）
+
+---
+
+## 八、主题系统
+
+### 颜色
+
+- 全局颜色定义在 `theme/app_colors.dart`
+- 产品主题颜色在 `theme/product_theme.dart`（4 种产品类型）
+- **不要在 Widget 中硬编码颜色值**，优先使用 `AppColors.xxx` 或 `Theme.of(context)`
+
+### 字体
+
+- 主字体：DM Sans（正文）、Outfit（标题）、Press Start 2P（品牌像素风）
+- 通过 `google_fonts` 包引用，**运行时自动下载并缓存**
+- 本地字体：Inter（在 `pubspec.yaml` 中声明）
+
+### 间距
+
+- 使用 `AppSpacing.xs/sm/md/lg/xl` 常量
+- 不要在 Widget 中硬编码间距数值
+
+---
+
+## 九、Git 规范
+
+### 分支命名
+
+- 功能分支：`fix/auto-YYYYMMDD-HHMMSS`
+- 合并目标：`main`
+
+### Commit 规范
+
+- `fix:` — Bug 修复
+- `feat:` — 新功能
+- `refactor:` — 重构（不改变行为）
+- `chore:` — 构建配置、依赖更新等
+
+---
+
+## 十、检查清单（PR 提交前）
+
+- [ ] `dart analyze` 无 Error（Warning/Info 可接受）
+- [ ] 所有 Stream 订阅已在 dispose 中取消
+- [ ] 所有 Controller/Player 已在 dispose 中释放
+- [ ] 多个独立 API 调用已用 `Future.wait` 并行化
+- [ ] 动画 Widget 使用了 `RepaintBoundary` 或 `AnimatedBuilder(child:)`
+- [ ] 新增的 Widget 构造函数尽可能标记为 `const`
+- [ ] 列表使用 `ListView.builder`，而非 `ListView(children:)`
+- [ ] 未引入新的硬编码颜色值（使用 AppColors 或 theme）
+- [ ] Android release 构建正常（minify + shrinkResources 不会崩溃）

airhub_app/FLUTTER_OPTIMIZATION_GUIDE.md

@@ -0,0 +1,703 @@
+# Flutter App 全面优化方案
+
+> 针对 airhub_app 项目的从头到尾优化整改方案
+> 目标：减小包大小、降低发热、消除卡顿
+
+---
+
+## 一、项目现状分析
+
+| 指标 | 当前值 | 问题 |
+|------|--------|------|
+| Flutter 版本 | 3.41.2 (Dart 3.11.0) | 较新，支持 Impeller |
+| 代码规模 | 132 个 Dart 文件 / 28k 行 | 中等规模 |
+| assets 总大小 | **~135MB** | **严重超标** |
+| storybook_videos/ | **92MB** (11个mp4，最大48MB) | **主要元凶** |
+| music/ | **15MB** (10个mp3) | 应该CDN下载 |
+| story_covers/ | **7.4MB** (PNG图片) | 需压缩或远程加载 |
+| 背景图 PNG | 单张 4.5-4.7MB | **未压缩的巨型PNG** |
+| 字体文件 | 1.6MB (4个Inter字重) | 可裁剪子集 |
+| google_fonts 依赖 | 存在 | 会下载额外字体 |
+| Android release 配置 | 未启用 minifyEnabled | 缺少代码压缩 |
+| ProGuard | 已引用但未启用 shrinkResources | 资源未裁剪 |
+| iOS 构建 | 默认配置 | 未做符号裁剪优化 |
+
+---
+
+## 二、包大小优化（预估可减少 60-70%）
+
+### 阶段 1：资源外迁（预估减少 110MB+ → 约 80% 的包大小）
+
+这是**最关键也是收益最大**的一步。
+
+#### 1.1 视频资源迁移到 CDN / 服务器
+```
+当前: assets/www/storybook_videos/ → 92MB 全部打进包
+目标: 视频从服务端按需下载，本地缓存
+```
+
+**实施方案：**
+- 将所有 mp4 文件上传到后端服务器或 OSS/CDN
+- App 端改为流式播放或首次使用时下载到本地缓存
+- 使用 `video_player` 的网络播放功能直接播放远程URL
+- 实现下载进度显示和本地缓存管理
+
+```dart
+// 改为网络播放
+VideoPlayerController.networkUrl(Uri.parse('https://cdn.example.com/videos/magic_broom.mp4'))
+
+// 或按需下载到缓存
+final cacheDir = await getTemporaryDirectory();
+final file = File('${cacheDir.path}/magic_broom.mp4');
+if (!file.existsSync()) {
+  await dio.download(url, file.path, onReceiveProgress: (received, total) {
+    // 显示下载进度
+  });
+}
+```
+
+#### 1.2 音频资源迁移
+```
+当前: assets/www/music/ → 15MB
+目标: 音频按需下载或流式播放
+```
+
+- `just_audio` 本身支持网络URL播放
+- 改为 `AudioSource.uri(Uri.parse('https://cdn.example.com/music/xxx.mp3'))`
+
+#### 1.3 故事封面图迁移
+```
+当前: assets/www/story_covers/ → 7.4MB
+目标: 网络图片 + 本地缓存
+```
+
+- 添加 `cached_network_image` 依赖
+- 封面图改为网络加载，自动缓存
+
+#### 1.4 背景图压缩
+```
+当前: 首页背景2.png (4.7MB) + 首页底图.png (4.5MB)
+目标: 压缩到 200-500KB
+```
+
+**方案A：转 WebP 格式**
+```bash
+# 安装 cwebp
+brew install webp
+
+# 转换 (质量80，通常可减少 85%+)
+cwebp -q 80 "assets/www/首页背景2.png" -o "assets/www/首页背景2.webp"
+cwebp -q 80 "assets/www/首页底图.png" -o "assets/www/首页底图.webp"
+```
+
+**方案B：用 pngquant 压缩**
+```bash
+pngquant --quality=65-80 "assets/www/首页背景2.png" --output "assets/www/首页背景2.png"
+```
+
+预期效果：4.7MB → 300-500KB（减少 **90%**）
+
+### 阶段 2：构建配置优化（预估再减 30-40%）
+
+#### 2.1 Android 构建优化
+
+**修改 `android/app/build.gradle.kts`：**
+```kotlin
+android {
+    buildTypes {
+        release {
+            signingConfig = signingConfigs.getByName("release") // 换正式签名
+
+            // 启用代码压缩和资源裁剪
+            isMinifyEnabled = true
+            isShrinkResources = true
+
+            proguardFiles(
+                getDefaultProguardFile("proguard-android-optimize.txt"),
+                "proguard-rules.pro"
+            )
+        }
+    }
+}
+```
+
+**构建命令使用 `--split-per-abi`：**
+```bash
+# 分架构打包，每个 APK 减少 30-40%
+flutter build apk --release --split-per-abi --obfuscate --split-debug-info=./debug-info
+
+# 或 App Bundle（Google Play 自动按设备裁剪）
+flutter build appbundle --release --obfuscate --split-debug-info=./debug-info
+```
+
+| 参数 | 作用 | 预估收益 |
+|------|------|----------|
+| `--split-per-abi` | 按 CPU 架构分包 | 减少 30-40% |
+| `--obfuscate` | 代码混淆 | 减少 5-10% |
+| `--split-debug-info` | 分离调试符号 | 减少 5-10% |
+| `minifyEnabled=true` | R8 代码压缩 | 减少 15-25% |
+| `shrinkResources=true` | 移除未使用资源 | 减少 5-10% |
+
+#### 2.2 iOS 构建优化
+
+**Xcode Build Settings 调整：**
+- Strip Debug Symbols During Copy → YES
+- Strip Linked Product → YES
+- Dead Code Stripping → YES
+- Optimization Level → -Oz (Smallest)
+
+**构建命令：**
+```bash
+flutter build ipa --release --obfuscate --split-debug-info=./debug-info
+```
+
+### 阶段 3：依赖瘦身
+
+#### 3.1 审计当前依赖
+
+| 依赖 | 大小影响 | 建议 |
+|------|----------|------|
+| `google_fonts` | 较大，会下载字体 | 已内嵌 Inter 字体，考虑移除 |
+| `webview_flutter` | ~4MB 原生库 | 仅在需要时加载(deferred) |
+| `video_player` | ~3-4MB | 考虑 deferred import |
+| `image` (dart包) | 纯 Dart 图像处理 | 检查是否真的需要 |
+| `http` | 与 `dio` 重复 | 统一用 dio，移除 http |
+| `flutter_svg` | 中等 | 保留（SVG 比 PNG 小得多） |
+
+#### 3.2 移除 `google_fonts`
+
+你已经在 `pubspec.yaml` 中内嵌了 Inter 字体，`google_fonts` 是多余的：
+```yaml
+# 移除这个依赖
+# google_fonts: ^6.1.0
+
+# 已有本地字体
+fonts:
+  - family: Inter
+    fonts:
+      - asset: assets/fonts/Inter-Regular.ttf
+      # ...
+```
+
+代码中改用 `TextStyle(fontFamily: 'Inter')` 替代 `GoogleFonts.inter()`。
+
+#### 3.3 移除重复的 `http` 包
+```yaml
+# 移除 - 已有 dio 做网络请求
+# http: ^1.2.0
+```
+
+#### 3.4 字体子集化
+
+当前 4 个 Inter 字体文件共 1.6MB。如果只需要中英文：
+```bash
+# 安装 fonttools
+pip install fonttools brotli
+
+# 裁剪只保留需要的字符集（中文 + 英文 + 数字 + 标点）
+pyftsubset Inter-Regular.ttf \
+  --text-file=used_chars.txt \
+  --output-file=Inter-Regular-subset.ttf
+
+# 通常可从 400KB → 50-80KB
+```
+
+---
+
+## 三、性能优化：降低发热与 CPU 占用
+
+### 3.1 Widget 重建优化（最重要）
+
+#### 使用 `const` 构造函数
+```dart
+// ❌ 每次 build 都创建新实例
+Widget build(BuildContext context) {
+  return Container(
+    padding: EdgeInsets.all(16),  // 每次创建新对象
+    child: Text('Hello'),
+  );
+}
+
+// ✅ 编译期常量，不会触发重建
+Widget build(BuildContext context) {
+  return Container(
+    padding: const EdgeInsets.all(16),
+    child: const Text('Hello'),
+  );
+}
+```
+
+**全项目检查：** 运行 `dart analyze` 查看 `prefer_const_constructors` 警告。
+
+#### 使用 `RepaintBoundary` 隔离重绘区域
+```dart
+// 对频繁更新的局部 Widget 包裹 RepaintBoundary
+RepaintBoundary(
+  child: AnimatedWidget(...),  // 只重绘这部分，不影响外部
+)
+```
+
+适用场景：
+- 动画区域
+- 频繁刷新的倒计时/进度条
+- BLE 数据实时显示
+
+#### 拆分 Widget，避免大范围重建
+```dart
+// ❌ 整个页面一个大 build 方法
+class MyPage extends ConsumerWidget {
+  Widget build(BuildContext context, WidgetRef ref) {
+    final state = ref.watch(someProvider); // 任何变化都重建整个页面
+    return Scaffold(
+      body: Column(children: [Header(), Content(state), Footer()]),
+    );
+  }
+}
+
+// ✅ 拆成独立 Widget，只监听需要的部分
+class _Content extends ConsumerWidget {
+  Widget build(BuildContext context, WidgetRef ref) {
+    final data = ref.watch(someProvider.select((s) => s.data)); // 精准监听
+    return ...;
+  }
+}
+```
+
+### 3.2 Riverpod 状态管理优化
+
+#### 使用 `select` 精准订阅
+```dart
+// ❌ 监听整个 state，任何字段变化都重建
+final state = ref.watch(deviceProvider);
+
+// ✅ 只监听需要的字段
+final deviceName = ref.watch(deviceProvider.select((s) => s.name));
+final isConnected = ref.watch(deviceProvider.select((s) => s.isConnected));
+```
+
+#### 区分 `watch` 和 `listen`
+```dart
+// watch: 用于 UI 显示的数据（需要重建）
+final name = ref.watch(provider.select((s) => s.name));
+
+// listen: 用于副作用（弹窗、导航、日志），不触发重建
+ref.listen(provider, (prev, next) {
+  if (next.hasError) showErrorDialog(context, next.error);
+});
+```
+
+### 3.3 BLE 通信优化（降低发热的关键）
+
+你的 app 大量使用蓝牙（`flutter_blue_plus`），这是发热的主要来源之一。
+
+```dart
+// ❌ 持续高频扫描
+FlutterBluePlus.startScan(timeout: Duration(seconds: 30));
+
+// ✅ 扫到目标设备后立即停止
+FlutterBluePlus.startScan(timeout: Duration(seconds: 10));
+// 找到目标后
+FlutterBluePlus.stopScan();
+
+// ❌ 不必要的频繁读取特征值
+Timer.periodic(Duration(milliseconds: 100), (_) => characteristic.read());
+
+// ✅ 使用 notify 替代轮询
+await characteristic.setNotifyValue(true);
+characteristic.onValueReceived.listen((value) {
+  // 只在有新数据时处理
+});
+```
+
+**BLE 省电策略：**
+- 连接成功后立即停止扫描
+- 使用 notification 而非 polling
+- 非活跃页面暂停 BLE 数据监听
+- 合理设置连接间隔参数
+
+### 3.4 图片与内存管理
+
+#### 网络图片缓存
+```yaml
+# 添加依赖
+dependencies:
+  cached_network_image: ^3.3.0
+```
+
+```dart
+// 使用缓存图片组件
+CachedNetworkImage(
+  imageUrl: imageUrl,
+  memCacheWidth: 300,  // 限制内存中图片尺寸
+  memCacheHeight: 300,
+  placeholder: (_, __) => const CircularProgressIndicator(),
+  errorWidget: (_, __, ___) => const Icon(Icons.error),
+)
+```
+
+#### 大图降采样
+```dart
+// ❌ 直接加载 4.7MB 的 PNG 到内存
+Image.asset('assets/www/首页背景2.png')
+
+// ✅ 指定缓存尺寸，降低内存占用
+Image.asset(
+  'assets/www/首页背景2.webp',
+  cacheWidth: 750,   // 按屏幕宽度限制
+  cacheHeight: 1334,
+)
+```
+
+#### 页面销毁时释放资源
+```dart
+class _MyPageState extends State<MyPage> {
+  VideoPlayerController? _videoController;
+
+  @override
+  void dispose() {
+    _videoController?.dispose();  // 必须释放！
+    super.dispose();
+  }
+}
+```
+
+### 3.5 Isolate 处理耗时任务
+
+```dart
+// 图片处理、数据解析等放到 Isolate
+import 'package:flutter/foundation.dart';
+
+// 简单任务用 compute
+final result = await compute(processImage, imageData);
+
+// 复杂任务用 Isolate
+Future<Uint8List> processImageInIsolate(Uint8List rawData) async {
+  return await Isolate.run(() {
+    // 在独立线程处理图片
+    return heavyImageProcessing(rawData);
+  });
+}
+```
+
+适用场景：
+- BLE 接收的大量数据解析
+- 图片编解码（badge 图片处理）
+- JSON 大数据解析
+
+---
+
+## 四、UI 流畅度优化（消除卡顿）
+
+### 4.1 列表优化
+
+#### 使用 `ListView.builder` 而非 `ListView`
+```dart
+// ❌ 一次性创建所有子 Widget
+ListView(children: items.map((e) => ItemWidget(e)).toList())
+
+// ✅ 按需创建可见项
+ListView.builder(
+  itemCount: items.length,
+  itemExtent: 80,  // 固定高度可提升滚动性能
+  addAutomaticKeepAlives: false,  // 不需要保活的列表关闭此项
+  addRepaintBoundaries: true,
+  itemBuilder: (context, index) => ItemWidget(items[index]),
+)
+```
+
+#### 图片列表优化
+```dart
+ListView.builder(
+  cacheExtent: 500,  // 预缓存区域
+  itemBuilder: (context, index) {
+    return RepaintBoundary(
+      child: CachedNetworkImage(
+        imageUrl: items[index].imageUrl,
+        memCacheWidth: 200,  // 限制内存图片大小
+      ),
+    );
+  },
+)
+```
+
+### 4.2 Impeller 渲染引擎（Flutter 3.41.2 默认启用）
+
+你的 Flutter 版本已默认使用 Impeller 渲染引擎，优势：
+- **消除 Shader 编译卡顿**（Skia 的最大痛点）
+- 更稳定的帧率
+- 更低的 GPU 内存占用
+
+验证 Impeller 是否启用：
+```bash
+# iOS 默认启用，Android 3.22+ 默认启用
+flutter run --profile  # 然后查看 DevTools
+```
+
+如果遇到兼容性问题可临时回退：
+```bash
+flutter run --no-enable-impeller
+```
+
+### 4.3 Shader 预热（如仍用 Skia）
+
+```dart
+// 在 main.dart 中
+void main() async {
+  WidgetsFlutterBinding.ensureInitialized();
+
+  // 预编译 shader 缓存
+  await ShaderWarmUp().execute();
+
+  runApp(const MyApp());
+}
+```
+
+SkSL 收集命令：
+```bash
+# 1. 收集 shader
+flutter run --profile --cache-sksl --purge-persistent-cache
+
+# 2. 操作 app 中所有页面和动画
+
+# 3. 按 M 导出 flutter_01.sksl.json
+
+# 4. 使用缓存构建
+flutter build apk --bundle-sksl-path flutter_01.sksl.json
+```
+
+### 4.4 页面切换优化
+
+```dart
+// go_router 中预加载关键页面
+GoRoute(
+  path: '/device-control',
+  pageBuilder: (context, state) => CustomTransitionPage(
+    transitionDuration: const Duration(milliseconds: 200),  // 缩短动画时间
+    child: const DeviceControlPage(),
+    transitionsBuilder: (context, animation, secondaryAnimation, child) {
+      return FadeTransition(opacity: animation, child: child);  // 用 Fade 替代 Slide
+    },
+  ),
+)
+```
+
+### 4.5 WebView 优化
+
+```dart
+// WebView 是重量级组件
+// 1. 延迟初始化
+late final WebViewController _controller;
+
+@override
+void initState() {
+  super.initState();
+  // 延迟到页面完全展示后再初始化 WebView
+  WidgetsBinding.instance.addPostFrameCallback((_) {
+    _initWebView();
+  });
+}
+
+// 2. 页面销毁时清理
+@override
+void dispose() {
+  _controller.clearCache();
+  _controller.clearLocalStorage();
+  super.dispose();
+}
+```
+
+---
+
+## 五、工具与监控
+
+### 5.1 包大小分析
+```bash
+# 分析 APK 大小组成
+flutter build apk --analyze-size
+
+# 分析 iOS 包大小
+flutter build ipa --analyze-size
+```
+
+### 5.2 性能分析
+```bash
+# Profile 模式运行（有性能数据但接近 release 性能）
+flutter run --profile
+
+# 打开 DevTools
+flutter pub global activate devtools
+flutter pub global run devtools
+```
+
+### 5.3 检测无用代码和依赖
+```bash
+# 检测未使用的依赖
+dart pub deps --no-dev
+
+# 分析代码问题
+dart analyze
+```
+
+### 5.4 Glance（APM 监控库）
+```yaml
+# 生产环境卡顿检测
+dependencies:
+  glance_flutter: ^0.x.x  # 实验性
+```
+
+---
+
+## 六、实施优先级与预期效果
+
+### P0 紧急（1-2天，收益巨大）
+
+| 任务 | 预期收益 |
+|------|----------|
+| 视频/音频迁移到 CDN | 包大小 -107MB (80%) |
+| 背景图转 WebP 压缩 | 包大小 -8MB |
+| 启用 `minifyEnabled` + `shrinkResources` | 包大小 -15-25% |
+| `--split-per-abi` 分架构打包 | APK -30-40% |
+
+### P1 重要（3-5天）
+
+| 任务 | 预期收益 |
+|------|----------|
+| 移除 `google_fonts` 和 `http` 包 | 包大小 -2-4MB |
+| 字体子集化 | 包大小 -1.2MB |
+| `--obfuscate --split-debug-info` | 包大小 -5-10% |
+| BLE 扫描/通信优化 | 降低发热 30-50% |
+| 图片内存管理 (cacheWidth/Height) | 降低内存 40% |
+
+### P2 优化（1-2周）
+
+| 任务 | 预期收益 |
+|------|----------|
+| 全项目 const 构造函数审查 | 减少 Widget 重建 |
+| Riverpod select 精准订阅 | 减少不必要重建 |
+| 列表 ListView.builder 优化 | 滚动更流畅 |
+| 耗时任务移入 Isolate | 消除主线程卡顿 |
+| RepaintBoundary 隔离动画区域 | 减少重绘范围 |
+| Deferred import (webview/video) | 减小初始加载 |
+
+### P3 持续（长期）
+
+| 任务 | 预期收益 |
+|------|----------|
+| 接入性能监控 (Glance/Sentry) | 线上问题感知 |
+| 定期 `flutter build --analyze-size` | 包大小回归检测 |
+| CI 集成包大小检查 | 防止包大小退化 |
+
+---
+
+## 七、预期总体效果
+
+| 指标 | 优化前 | 优化后（预估） | 改善 |
+|------|--------|----------------|------|
+| APK 大小 | ~150-180MB | ~25-35MB | **80%+** |
+| IPA 大小 | ~200MB+ | ~40-60MB | **70%+** |
+| 冷启动时间 | 3-5s | 1-2s | **60%** |
+| 内存占用 | 较高 | 降低 40%+ | **40%+** |
+| 手机发热 | 明显 | 温热 | **显著改善** |
+| 滚动帧率 | 有掉帧 | 稳定 60fps | **流畅** |
+
+---
+
+## 八、Impeller 渲染引擎性能数据
+
+Flutter 3.41.2 已默认启用 Impeller（替代 Skia），关键性能数据：
+
+| 维度 | Skia | Impeller | 改善 |
+|------|------|---------|------|
+| Shader 编译 | 运行时 JIT（首次卡顿 20-200ms） | 构建时 AOT 预编译 | **消除 Shader 卡顿** |
+| GPU 光栅化耗时 | 4.05ms | 2.81ms | **-30%** |
+| 120Hz 帧率达标率 | 67.1% | 91.6% | **+36%** |
+| 复杂场景掉帧率 | ~12% | ~1.5% | **-87%** |
+
+确认 Impeller 状态：
+```bash
+flutter run --profile  # 然后在 DevTools 中查看渲染后端
+```
+
+Android 持久化配置（`AndroidManifest.xml`）：
+```xml
+<meta-data
+  android:name="io.flutter.embedding.android.EnableImpeller"
+  android:value="true" />
+```
+
+---
+
+## 九、低端设备适配策略
+
+针对不同档次手机动态降级：
+
+```dart
+// 设备分级
+enum DeviceTier { low, mid, high }
+
+DeviceTier getDeviceTier() {
+  final memory = SysInfo.getTotalPhysicalMemory(); // 需原生获取
+  if (memory < 3 * 1024 * 1024 * 1024) return DeviceTier.low;
+  if (memory < 6 * 1024 * 1024 * 1024) return DeviceTier.mid;
+  return DeviceTier.high;
+}
+```
+
+| 策略 | 低端 | 中端 | 高端 |
+|------|------|------|------|
+| 动画 | 关闭粒子/复杂动画 | 简化动画 | 全特效 |
+| 图片 | WebP 降分辨率 30% | 标准分辨率 | 高清 |
+| BackdropFilter | 纯色替代 | 简化模糊 | 全高斯模糊 |
+| 并发网络请求 | 限 2 个 | 限 4 个 | 不限制 |
+
+---
+
+## 十、生产环境性能监控
+
+| 工具 | 类型 | 用途 |
+|------|------|------|
+| [Glance](https://github.com/littleGnAl/glance) | 开源 APM | 采集卡顿时的堆栈，定位具体函数 |
+| [flutter_smooth](https://github.com/fzyzcjy/flutter_smooth) | 开源库 | 即使 Widget 树极重也能达到 ~60fps |
+| Firebase Performance | 云端 APM | 启动时间、网络延迟、自定义追踪 |
+| Sentry | 错误+性能 | 崩溃报告+性能事务 |
+
+### 自动化性能测试（CI 集成）
+
+```dart
+// integration_test/performance_test.dart
+import 'package:integration_test/integration_test.dart';
+
+void main() {
+  final binding = IntegrationTestWidgetsFlutterBinding.ensureInitialized();
+
+  testWidgets('scrolling performance', (tester) async {
+    await tester.pumpWidget(const MyApp());
+    await binding.traceAction(() async {
+      await tester.fling(find.byType(ListView), const Offset(0, -500), 10000);
+      await tester.pumpAndSettle();
+    }, reportKey: 'scrolling_timeline');
+  });
+}
+```
+
+---
+
+## 十一、参考资源
+
+### 官方文档
+- [Flutter Performance Best Practices](https://docs.flutter.dev/perf/best-practices)
+- [App Size Optimization](https://docs.flutter.dev/perf/app-size)
+- [Impeller Rendering Engine](https://docs.flutter.dev/perf/impeller)
+- [Deferred Components](https://docs.flutter.dev/perf/deferred-components)
+- [Shader Compilation Jank](https://docs.flutter.dev/perf/shader)
+
+### 优秀开源项目参考
+- [flutter_deer](https://github.com/simplezhli/flutter_deer) — 完善的 Flutter 实践项目，代码规范
+- [Best-Flutter-UI-Templates](https://github.com/mitesh77/Best-Flutter-UI-Templates) — UI 模板合集
+- [Solido/awesome-flutter](https://github.com/Solido/awesome-flutter) — Flutter 最全资源汇总
+
+### 工具
+- [Glance](https://pub.dev/packages/glance_flutter) — APM 卡顿检测
+- [TinyPNG](https://tinypng.com/) — PNG/WebP 压缩
+- [pngquant](https://pngquant.org/) — 批量 PNG 压缩
+- [pyftsubset](https://fonttools.readthedocs.io/) — 字体子集化

airhub_app/ios/Podfile.lock

@@ -23,6 +23,9 @@ PODS:
   - shared_preferences_foundation (0.0.1):
     - Flutter
     - FlutterMacOS
+  - video_player_avfoundation (0.0.1):
+    - Flutter
+    - FlutterMacOS
   - webview_flutter_wkwebview (0.0.1):
     - Flutter
     - FlutterMacOS
@@ -36,6 +39,7 @@ DEPENDENCIES:
   - just_audio (from `.symlinks/plugins/just_audio/darwin`)
   - permission_handler_apple (from `.symlinks/plugins/permission_handler_apple/ios`)
   - shared_preferences_foundation (from `.symlinks/plugins/shared_preferences_foundation/darwin`)
+  - video_player_avfoundation (from `.symlinks/plugins/video_player_avfoundation/darwin`)
   - webview_flutter_wkwebview (from `.symlinks/plugins/webview_flutter_wkwebview/darwin`)
 
 SPEC REPOS:
@@ -60,6 +64,8 @@ EXTERNAL SOURCES:
     :path: ".symlinks/plugins/permission_handler_apple/ios"
   shared_preferences_foundation:
     :path: ".symlinks/plugins/shared_preferences_foundation/darwin"
+  video_player_avfoundation:
+    :path: ".symlinks/plugins/video_player_avfoundation/darwin"
   webview_flutter_wkwebview:
     :path: ".symlinks/plugins/webview_flutter_wkwebview/darwin"
 
@@ -74,6 +80,7 @@ SPEC CHECKSUMS:
   permission_handler_apple: 4ed2196e43d0651e8ff7ca3483a069d469701f2d
   SDWebImage: 1bb6a1b84b6fe87b972a102bdc77dd589df33477
   shared_preferences_foundation: 7036424c3d8ec98dfe75ff1667cb0cd531ec82bb
+  video_player_avfoundation: dd410b52df6d2466a42d28550e33e4146928280a
   webview_flutter_wkwebview: 8ebf4fded22593026f7dbff1fbff31ea98573c8d
 
 PODFILE CHECKSUM: 3c63482e143d1b91d2d2560aee9fb04ecc74ac7e

airhub_app/ios/Runner/Info.plist

@@ -26,6 +26,10 @@
 	<string>$(FLUTTER_BUILD_NUMBER)</string>
 	<key>LSRequiresIPhoneOS</key>
 	<true/>
+	<key>NSCameraUsageDescription</key>
+	<string>需要相机权限来拍照传图到徽章设备</string>
+	<key>NSPhotoLibraryUsageDescription</key>
+	<string>需要相册权限来选择图片传图到徽章设备</string>
 	<key>NSBluetoothAlwaysUsageDescription</key>
 	<string>需要蓝牙权限来搜索和连接您的设备</string>
 	<key>NSBluetoothPeripheralUsageDescription</key>

airhub_app/lib/core/network/api_client.dart

@@ -143,7 +143,6 @@ class _AuthInterceptor extends Interceptor {
       '/auth/phone-login/',
       '/auth/refresh/',
       '/version/check/',
-      '/devices/query-by-mac/',
     ];
 
     final needsAuth = !noAuthPaths.any((p) => options.path.contains(p));

airhub_app/lib/core/network/api_config.dart

@@ -1,6 +1,14 @@
+import 'package:flutter/foundation.dart' show kIsWeb;
+
 class ApiConfig {
-  /// 后端服务器地址（本地开发环境）
+  /// 本地开发地址（Web 调试用）
-  static const String baseUrl = 'http://192.168.124.8:8000';
+  static const String _localUrl = 'http://192.168.124.8:8000';
+
+  /// 线上地址（APP 用）
+  static const String _prodUrl = 'https://qiyuan-rtc-api.airlabs.art';
+
+  /// 根据运行环境自动选择：Web → 本地，APP → 线上
+  static String get baseUrl => kIsWeb ? _localUrl : _prodUrl;
 
   /// 一键授权登录专用域名（HTTPS，用于阿里云号码认证）
   static const String authBaseUrl = 'https://qiyuan-rtc-api.airlabs.art';

airhub_app/lib/core/router/app_router.dart

@@ -1,5 +1,9 @@
+import 'dart:typed_data';
+import 'package:flutter/foundation.dart';
+import 'package:flutter/widgets.dart';
 import 'package:go_router/go_router.dart';
 import 'package:riverpod_annotation/riverpod_annotation.dart';
+import 'package:shared_preferences/shared_preferences.dart';
 
 import '../../features/auth/presentation/pages/login_page.dart';
 import '../../pages/bluetooth_page.dart';
@@ -9,12 +13,27 @@ import '../../pages/product_selection_page.dart';
 import '../../pages/profile/profile_page.dart';
 import '../../pages/webview_page.dart';
 import '../../pages/wifi_config_page.dart';
+import '../../features/badge/presentation/pages/badge_basic_control_page.dart';
+import '../../features/badge/presentation/pages/badge_control_page.dart';
 import '../../features/badge/presentation/pages/badge_home_page.dart';
 import '../../features/badge/presentation/pages/badge_transfer_page.dart';
+import '../../features/device/data/datasources/device_remote_data_source.dart';
+import '../../theme/product_theme.dart';
 import '../network/token_manager.dart';
 
 part 'app_router.g.dart';
 
+const _lastRouteKey = 'last_business_route';
+const _lastProductTypeKey = 'last_product_type';
+const _validBusinessRoutes = {'/device-control', '/badge-control', '/badge-basic-control'};
+
+/// 产品代码 → 路由 + ProductType 的映射
+const _productCodeRoutes = {
+  'KPBL-ON': (route: '/device-control', type: ProductType.capybara),
+  'DZBJ-ON': (route: '/badge-control', type: ProductType.badgeAi),
+  'DZBJ-OFF': (route: '/badge-basic-control', type: ProductType.badgeBasic),
+};
+
 @riverpod
 GoRouter goRouter(Ref ref) {
   final tokenManager = ref.watch(tokenManagerProvider);
@@ -30,6 +49,60 @@ GoRouter goRouter(Ref ref) {
         return '/login';
       }
       if (hasToken && isLoginRoute) {
+        // 登录成功 → 获取已绑定设备列表
+        try {
+          final dataSource = ref.read(deviceRemoteDataSourceProvider);
+          final devices = await dataSource.getMyDevices();
+          debugPrint('[Router] 已绑定设备数: ${devices.length}');
+
+          if (devices.isNotEmpty) {
+            // 收集用户当前绑定的所有业务路由
+            final boundRoutes = <String>{};
+            for (final d in devices) {
+              final dt = d.device.deviceType ?? d.device.deviceTypeInfo;
+              final code = dt?.productCode ?? '';
+              final m = _productCodeRoutes[code];
+              if (m != null) boundRoutes.add(m.route);
+            }
+
+            // 优先恢复上次退出时的业务页面（需确认该设备仍在绑定中）
+            try {
+              final prefs = await SharedPreferences.getInstance();
+              final savedRoute = prefs.getString(_lastRouteKey);
+              final savedProductType = prefs.getString(_lastProductTypeKey);
+              if (savedRoute != null && boundRoutes.contains(savedRoute)) {
+                debugPrint('[Router] 恢复上次页面: $savedRoute');
+                if (savedProductType != null) {
+                  final pt = ProductType.values.where((e) => e.name == savedProductType).firstOrNull;
+                  if (pt != null) {
+                    ref.read(currentProductTypeProvider.notifier).set(pt);
+                  }
+                }
+                return savedRoute;
+              }
+            } catch (e) {
+              debugPrint('[Router] 读取上次页面失败: $e');
+            }
+
+            // Fallback：按设备最近使用时间跳转
+            devices.sort((a, b) {
+              final ta = a.device.lastOnlineAt ?? '';
+              final tb = b.device.lastOnlineAt ?? '';
+              return tb.compareTo(ta);
+            });
+            final recent = devices.first;
+            final resolvedDt = recent.device.deviceType ?? recent.device.deviceTypeInfo;
+            final code = resolvedDt?.productCode ?? '';
+            debugPrint('[Router] 最近设备 sn=${recent.device.sn}, productCode=$code');
+            final mapping = _productCodeRoutes[code];
+            if (mapping != null) {
+              ref.read(currentProductTypeProvider.notifier).set(mapping.type);
+              return mapping.route;
+            }
+          }
+        } catch (e) {
+          debugPrint('[Router] 获取设备失败: $e');
+        }
         return '/home';
       }
       return null;
@@ -63,6 +136,14 @@ GoRouter goRouter(Ref ref) {
         path: '/webview_fallback',
         builder: (context, state) => const WebViewPage(),
       ),
+      GoRoute(
+        path: '/badge-control',
+        builder: (context, state) => const BadgeControlPage(),
+      ),
+      GoRoute(
+        path: '/badge-basic-control',
+        builder: (context, state) => const BadgeBasicControlPage(),
+      ),
       GoRoute(
         path: '/badge',
         builder: (context, state) => const BadgeHomePage(),
@@ -73,9 +154,43 @@ GoRouter goRouter(Ref ref) {
           final extra = state.extra as Map<String, dynamic>? ?? {};
           return BadgeTransferPage(
             imageUrl: extra['imageUrl'] as String? ?? '',
+            imageBytes: extra['imageBytes'] is Uint8List
+                ? extra['imageBytes'] as Uint8List
+                : extra['imageBytes'] is List
+                    ? Uint8List.fromList(List<int>.from(extra['imageBytes'] as List))
+                    : null,
           );
         },
       ),
     ],
+    observers: [_BusinessRouteObserver(ref)],
   );
 }
+
+/// 监听路由变化，进入业务页时自动保存到 SharedPreferences
+class _BusinessRouteObserver extends NavigatorObserver {
+  final Ref _ref;
+  _BusinessRouteObserver(this._ref);
+
+  void _saveIfBusiness(Route<dynamic>? route) {
+    final name = route?.settings.name;
+    if (name != null && _validBusinessRoutes.contains(name)) {
+      final productType = _ref.read(currentProductTypeProvider);
+      debugPrint('[Router] 保存业务页: $name, productType=${productType.name}');
+      SharedPreferences.getInstance().then((prefs) {
+        prefs.setString(_lastRouteKey, name);
+        prefs.setString(_lastProductTypeKey, productType.name);
+      });
+    }
+  }
+
+  @override
+  void didPush(Route<dynamic> route, Route<dynamic>? previousRoute) {
+    _saveIfBusiness(route);
+  }
+
+  @override
+  void didReplace({Route<dynamic>? newRoute, Route<dynamic>? oldRoute}) {
+    _saveIfBusiness(newRoute);
+  }
+}

airhub_app/lib/core/router/app_router.g.dart

@@ -48,4 +48,4 @@ final class GoRouterProvider
   }
 }
 
-String _$goRouterHash() => r'4b725bca8dba655c6abb2f19069fca97c8bebbb6';
+String _$goRouterHash() => r'276ed56c903c6bd5bb43569f7b8f58103d73198c';

airhub_app/lib/features/auth/presentation/pages/login_page.dart

@@ -5,7 +5,6 @@ import 'package:flutter/material.dart';
 import 'package:flutter/services.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:go_router/go_router.dart';
-import 'package:google_fonts/google_fonts.dart';
 
 import '../../../../core/services/phone_auth_service.dart';
 import '../../../../theme/app_colors.dart';
@@ -95,7 +94,7 @@ class _LoginPageState extends ConsumerState<LoginPage> {
             // Title
             Text(
               '服务协议',
-              style: GoogleFonts.outfit(
+              style: TextStyle(fontFamily: 'Outfit',
                 fontSize: 18,
                 fontWeight: FontWeight.w600,
                 color: const Color(0xFF374151),
@@ -219,7 +218,7 @@ class _LoginPageState extends ConsumerState<LoginPage> {
     final success = await ref.read(authControllerProvider.notifier).tokenLogin(token);
     debugPrint('[Login] tokenLogin 结果: $success');
     if (success && mounted) {
-      await _navigateAfterLogin();
+      context.go('/login');
     }
   }
 
@@ -274,25 +273,8 @@ class _LoginPageState extends ConsumerState<LoginPage> {
         .read(authControllerProvider.notifier)
         .codeLogin(_phoneController.text, _codeController.text);
     if (success && mounted) {
-      await _navigateAfterLogin();
+      // 登录成功后跳到 /login，触发 router redirect 统一处理跳转
-    }
+      context.go('/login');
-  }
-
-  Future<void> _navigateAfterLogin() async {
-    if (!mounted) return;
-    try {
-      final devices = await ref.read(deviceControllerProvider.future);
-      if (!mounted) return;
-      if (devices.isNotEmpty) {
-        debugPrint('[Login] User has ${devices.length} device(s), navigating to device control');
-        context.go('/device-control');
-      } else {
-        debugPrint('[Login] No devices, navigating to home');
-        context.go('/home');
-      }
-    } catch (e) {
-      debugPrint('[Login] Device check failed: $e');
-      if (mounted) context.go('/home');
     }
   }
 
@@ -324,7 +306,7 @@ class _LoginPageState extends ConsumerState<LoginPage> {
                 // Logo — 匹配 HTML .login-logo
                 Text(
                   'Airhub',
-                  style: GoogleFonts.pressStart2p(
+                  style: TextStyle(fontFamily: 'Press Start 2P',
                     fontSize: 28,
                     color: const Color(0xFF6366F1), // 靛蓝
                     letterSpacing: 2,
@@ -480,7 +462,7 @@ class _LoginPageState extends ConsumerState<LoginPage> {
                       children: [
                         Text(
                           '欢迎使用 Airhub',
-                          style: GoogleFonts.outfit(
+                          style: TextStyle(fontFamily: 'Outfit',
                             fontSize: 32,
                             fontWeight: FontWeight.w700,
                             color: const Color(0xFF6B5B95),
@@ -745,7 +727,7 @@ class _AgreementContentPage extends StatelessWidget {
         ),
         title: Text(
           title,
-          style: GoogleFonts.outfit(
+          style: TextStyle(fontFamily: 'Outfit',
             fontSize: 18,
             fontWeight: FontWeight.w600,
             color: const Color(0xFF374151),

airhub_app/lib/features/badge/data/services/badge_transfer_service.dart

@@ -1,38 +1,361 @@
 import 'dart:async';
-import 'dart:typed_data';
+import 'dart:io';
+
 import 'package:flutter/foundation.dart';
 import 'package:flutter_blue_plus/flutter_blue_plus.dart';
+import 'package:http/http.dart' as http;
+import 'package:image/image.dart' as img;
 
-enum TransferState { idle, transferring, complete, error }
+/// BLE 图片传输服务
+/// 协议参考：APP蓝牙传图接口说明.md
+///
+/// BLE 服务与特征 UUID (16-bit → 128-bit):
+///   服务:     0x0B00 → 00000b00-0000-1000-8000-00805f9b34fb
+///   写入特征: 0x0B01 → 00000b01-0000-1000-8000-00805f9b34fb
+///   管理特征: 0x0B02 → 00000b02-0000-1000-8000-00805f9b34fb
+class BadgeBleTransferService {
+  /// 目标图片尺寸（设备屏幕 360×360 圆形 LCD）
+  static const _targetSize = 360;
 
-class BadgeTransferState {
+  /// 设备端约定 MTU = 512（见 ble_service_config.h）
-  final TransferState transferState;
+  /// requestMtu 在 iOS/Web 上可能不可用，但实际协商仍由底层完成
-  final List<ScanResult> scannedDevices;
+  static const _defaultMtu = 512;
-  final BluetoothDevice? selectedDevice;
-  final double progress;
-  final String? errorMessage;
 
-  const BadgeTransferState({
+  /// ATT 协议头占 3 字节 + GATT Handle 占 2 字节
-    this.transferState = TransferState.idle,
+  static const _attOverhead = 3;
-    this.scannedDevices = const [],
-    this.selectedDevice,
-    this.progress = 0,
-    this.errorMessage,
-  });
 
-  BadgeTransferState copyWith({
+  /// 数据帧头: 包序号(1) + 结束标志(1)
-    TransferState? transferState,
+  static const _frameHeaderSize = 2;
-    List<ScanResult>? scannedDevices,
+
-    BluetoothDevice? selectedDevice,
+  /// 前序帧后等待设备建立接收通道（malloc / fopen）
-    double? progress,
+  static const _preambleDelayMs = 50;
-    String? errorMessage,
+
-  }) {
+  /// 每包之间的延迟 (ms)，给 ESP32 BLE 缓冲区消化时间
-    return BadgeTransferState(
+  static const _packetDelayMs = 5;
-      transferState: transferState ?? this.transferState,
+
-      scannedDevices: scannedDevices ?? this.scannedDevices,
+  /// 每 N 包用一次 write-with-response 做同步点
-      selectedDevice: selectedDevice ?? this.selectedDevice,
+  static int get _syncInterval => kIsWeb ? 5 : 10;
-      progress: progress ?? this.progress,
+
-      errorMessage: errorMessage ?? this.errorMessage,
+  /// 最大重传次数
-    );
+  static const _maxTransferRetries = 2;
+
+  /// 连接设备并传输图片（支持断连自动重传）
+  Future<void> connectAndTransfer({
+    required BluetoothDevice device,
+    required String imageUrl,
+    Uint8List? imageBytes,
+    void Function(double progress, String message)? onProgress,
+  }) async {
+    // ── 预处理图片（只做一次，重传时复用）──
+    onProgress?.call(0.05, '处理图片...');
+    final jpegBytes = await _prepareImage(imageUrl, imageBytes);
+    debugPrint('[BLE Transfer] JPEG 大小: ${jpegBytes.length} 字节');
+
+    final filename =
+        'face_${DateTime.now().millisecondsSinceEpoch ~/ 1000}.jpg';
+
+    // ── 带重传的传输循环 ──
+    for (int attempt = 0; attempt <= _maxTransferRetries; attempt++) {
+      try {
+        await _doTransfer(
+          device: device,
+          filename: filename,
+          imageData: jpegBytes,
+          onProgress: onProgress,
+        );
+        return;
+      } catch (e) {
+        try {
+          await device.disconnect();
+        } catch (_) {}
+
+        if (attempt < _maxTransferRetries) {
+          final wait = 2 * (attempt + 1);
+          onProgress?.call(
+              0.0, '传输中断，${wait}秒后重试 (${attempt + 1}/$_maxTransferRetries)...');
+          debugPrint('[BLE Transfer] 第 ${attempt + 1} 次失败: $e，${wait}s 后重试');
+          await Future.delayed(Duration(seconds: wait));
+        } else {
+          rethrow;
+        }
+      }
+    }
+  }
+
+  /// 单次传输流程
+  Future<void> _doTransfer({
+    required BluetoothDevice device,
+    required String filename,
+    required Uint8List imageData,
+    void Function(double progress, String message)? onProgress,
+  }) async {
+    StreamSubscription<BluetoothConnectionState>? connSub;
+    bool disconnected = false;
+
+    try {
+      // ── 1. 连接设备 ──
+      onProgress?.call(0.0, '正在连接设备...');
+      await device.connect(timeout: const Duration(seconds: 10));
+
+      connSub = device.connectionState.listen((state) {
+        if (state == BluetoothConnectionState.disconnected) {
+          disconnected = true;
+        }
+      });
+
+      // ── 2. 协商 MTU ──
+      onProgress?.call(0.02, '协商传输参数...');
+      final mtu = await _negotiateMtu(device);
+      final chunkSize = mtu - _attOverhead - _frameHeaderSize;
+      debugPrint('[BLE Transfer] 最终 MTU=$mtu, chunkSize=$chunkSize');
+
+      // ── 3. 发现服务和特征 ──
+      onProgress?.call(0.05, '发现服务...');
+      final services = await device.discoverServices();
+
+      for (final s in services) {
+        debugPrint('[BLE Transfer] 服务: ${s.uuid}');
+        for (final c in s.characteristics) {
+          debugPrint(
+              '[BLE Transfer]   特征: ${c.uuid} (${_propsStr(c.properties)})');
+        }
+      }
+
+      final imageService = services.firstWhere(
+        (s) => _matchUuid16(s.uuid.toString(), '0b00'),
+        orElse: () => throw Exception('未找到图片传输服务 (0x0B00)'),
+      );
+
+      final writeChar = imageService.characteristics.firstWhere(
+        (c) => _matchUuid16(c.uuid.toString(), '0b01'),
+        orElse: () => throw Exception('未找到写入特征 (0x0B01)'),
+      );
+
+      // ── 4. 分包传输 ──
+      onProgress?.call(0.10, '开始传输...');
+
+      await _sendImage(
+        writeChar: writeChar,
+        filename: filename,
+        imageData: imageData,
+        chunkSize: chunkSize,
+        isDisconnected: () => disconnected,
+        onProgress: (p) {
+          final overall = 0.10 + p * 0.90;
+          onProgress?.call(overall, '正在传输...');
+        },
+      );
+
+      onProgress?.call(1.0, '传输完成');
+    } finally {
+      connSub?.cancel();
+      try {
+        await device.disconnect();
+      } catch (_) {}
+    }
+  }
+
+  /// MTU 协商：尝试请求 512 → 等待底层协商完成 → 读取实际值
+  Future<int> _negotiateMtu(BluetoothDevice device) async {
+    // 1. Android 上显式请求
+    try {
+      final result = await device.requestMtu(_defaultMtu);
+      debugPrint('[BLE Transfer] requestMtu 返回: $result');
+    } catch (e) {
+      debugPrint('[BLE Transfer] requestMtu 不可用（iOS/Web 正常）: $e');
+    }
+
+    // 2. 立即读一次
+    int mtu = device.mtuNow;
+    debugPrint('[BLE Transfer] mtuNow 初始值: $mtu');
+
+    if (mtu >= 64) return mtu;
+
+    // 3. mtuNow 过小（23），说明底层协商尚未完成
+    //    监听 mtu 流，等待协商结果（iOS/Web 自动协商，通常几百 ms 内完成）
+    try {
+      mtu = await device.mtu
+          .where((v) => v >= 64) // 过滤掉默认的 23
+          .first
+          .timeout(const Duration(seconds: 3));
+      debugPrint('[BLE Transfer] MTU 流更新: $mtu');
+      return mtu;
+    } catch (_) {
+      debugPrint('[BLE Transfer] 等待 MTU 协商超时，使用设备端约定值 $_defaultMtu');
+    }
+
+    // 4. 最终兜底：设备端 ble_service_config.h 配置 MTU=512
+    return _defaultMtu;
+  }
+
+  /// 加载图片 → 裁剪为 360×360 正方形 → 编码为 JPEG
+  Future<Uint8List> _prepareImage(
+      String imageUrl, Uint8List? localBytes) async {
+    // ── 1. 获取原始字节 ──
+    Uint8List rawBytes;
+    if (localBytes != null) {
+      rawBytes = localBytes;
+    } else if (imageUrl.startsWith('http')) {
+      final response = await http.get(Uri.parse(imageUrl));
+      if (response.statusCode != 200) {
+        throw Exception('下载图片失败 (${response.statusCode})');
+      }
+      rawBytes = response.bodyBytes;
+    } else if (!kIsWeb) {
+      final file = File(imageUrl);
+      if (!await file.exists()) {
+        throw Exception('本地图片不存在: $imageUrl');
+      }
+      rawBytes = await file.readAsBytes();
+    } else {
+      throw Exception('无法加载图片: $imageUrl');
+    }
+
+    // ── 2. 在 isolate 中解码 → 裁剪 → 编码 JPEG ──
+    final jpegBytes = await compute(_processImageToJpeg, rawBytes);
+    debugPrint(
+        '[BLE Transfer] 图片处理完成: ${rawBytes.length} → ${jpegBytes.length} 字节');
+    return jpegBytes;
+  }
+
+  /// 纯函数：解码任意格式图片 → 居中裁剪为正方形 → 缩放 360×360 → JPEG 编码
+  /// 在 isolate 中运行，不阻塞 UI
+  static Uint8List _processImageToJpeg(Uint8List rawBytes) {
+    final decoded = img.decodeImage(rawBytes);
+    if (decoded == null) {
+      throw Exception('图片解码失败，不支持的格式');
+    }
+
+    // 居中裁剪为正方形
+    final cropSide =
+        decoded.width < decoded.height ? decoded.width : decoded.height;
+    final cropX = (decoded.width - cropSide) ~/ 2;
+    final cropY = (decoded.height - cropSide) ~/ 2;
+
+    img.Image cropped = img.copyCrop(decoded,
+        x: cropX, y: cropY, width: cropSide, height: cropSide);
+
+    // 缩放到目标尺寸
+    if (cropped.width != _targetSize || cropped.height != _targetSize) {
+      cropped = img.copyResize(cropped,
+          width: _targetSize,
+          height: _targetSize,
+          interpolation: img.Interpolation.linear);
+    }
+
+    // 编码为 JPEG（quality 85 兼顾质量和大小）
+    return Uint8List.fromList(img.encodeJpg(cropped, quality: 85));
+  }
+
+  /// 发送图片到设备（前序帧 + 混合写入模式分包）
+  Future<void> _sendImage({
+    required BluetoothCharacteristic writeChar,
+    required String filename,
+    required Uint8List imageData,
+    required int chunkSize,
+    required bool Function() isDisconnected,
+    void Function(double)? onProgress,
+  }) async {
+    final len = imageData.length;
+    final totalPackets = (len / chunkSize).ceil();
+    debugPrint('[BLE Transfer] 总包数: $totalPackets, chunkSize: $chunkSize');
+
+    // ── 前序帧（26 字节）── 用 write-with-response 确保设备收到
+    final header = Uint8List(26);
+    header[0] = 0xFD;
+    final nameBytes = Uint8List.fromList(filename.codeUnits);
+    for (int i = 0; i < nameBytes.length && i < 22; i++) {
+      header[i + 1] = nameBytes[i];
+    }
+    header[23] = (len >> 16) & 0xFF;
+    header[24] = (len >> 8) & 0xFF;
+    header[25] = len & 0xFF;
+
+    await _bleWriteWithRetry(writeChar, header, withoutResponse: false);
+    await Future.delayed(const Duration(milliseconds: _preambleDelayMs));
+
+    // ── 数据帧（混合写入模式）──
+    int offset = 0;
+    int packetNo = 0;
+    final syncEvery = _syncInterval;
+
+    while (offset < len) {
+      if (isDisconnected()) {
+        throw Exception(
+            'BLE 连接断开，传输中止于 $offset/$len 字节 (${(offset * 100 / len).toInt()}%)');
+      }
+
+      final remaining = len - offset;
+      final chunkLen = remaining < chunkSize ? remaining : chunkSize;
+      final isEnd = (offset + chunkLen >= len) ? 0x01 : 0x00;
+
+      final packet = Uint8List(2 + chunkLen);
+      packet[0] = packetNo & 0xFF;
+      packet[1] = isEnd;
+      packet.setRange(2, 2 + chunkLen, imageData, offset);
+
+      // 每 N 包或最后一包用同步写入（write-with-response）做流控
+      final useSync = (packetNo % syncEvery == 0) || isEnd == 1;
+      await _bleWriteWithRetry(writeChar, packet,
+          withoutResponse: !useSync);
+
+      if (!useSync) {
+        await Future.delayed(const Duration(milliseconds: _packetDelayMs));
+      }
+
+      offset += chunkLen;
+      packetNo++;
+      onProgress?.call(offset / len);
+    }
+
+    debugPrint('[BLE Transfer] 发送完成: $offset/$len 字节, $packetNo 包');
+  }
+
+  /// 模糊匹配 16-bit UUID
+  bool _matchUuid16(String uuid, String short16) {
+    final u = uuid.toLowerCase();
+    final s = short16.toLowerCase();
+    if (u == '0000$s-0000-1000-8000-00805f9b34fb') return true;
+    if (u == s || u == '0000$s') return true;
+    if (u.startsWith('0000$s-')) return true;
+    return false;
+  }
+
+  /// BLE 写入，带 3 次重试 + 退避 + 降级
+  Future<void> _bleWriteWithRetry(
+    BluetoothCharacteristic characteristic,
+    Uint8List data, {
+    bool withoutResponse = true,
+  }) async {
+    const maxRetry = 3;
+    for (int i = 0; i < maxRetry; i++) {
+      try {
+        await characteristic.write(data, withoutResponse: withoutResponse);
+        return;
+      } catch (e) {
+        if (i < maxRetry - 1) {
+          await Future.delayed(Duration(milliseconds: 20 * (i + 1)));
+        } else if (withoutResponse) {
+          try {
+            await characteristic.write(data, withoutResponse: false);
+            return;
+          } catch (_) {
+            rethrow;
+          }
+        } else {
+          rethrow;
+        }
+      }
+    }
+  }
+
+  String _propsStr(CharacteristicProperties p) {
+    final parts = <String>[];
+    if (p.write) parts.add('write');
+    if (p.writeWithoutResponse) parts.add('writeNoResp');
+    if (p.read) parts.add('read');
+    if (p.notify) parts.add('notify');
+    if (p.indicate) parts.add('indicate');
+    return parts.join(' + ');
   }
 }

airhub_app/lib/features/badge/presentation/controllers/badge_transfer_controller.dart

@@ -1,6 +1,10 @@
+import 'dart:typed_data';
+import 'package:flutter/foundation.dart';
 import 'package:flutter_blue_plus/flutter_blue_plus.dart';
 import 'package:riverpod_annotation/riverpod_annotation.dart';
 
+import '../../data/services/badge_transfer_service.dart';
+
 part 'badge_transfer_controller.g.dart';
 
 enum TransferStatus { idle, scanning, connecting, transferring, done, error }
@@ -9,12 +13,14 @@ class BadgeTransferState {
   final TransferStatus status;
   final BluetoothDevice? device;
   final double progress;
+  final String? statusMessage;
   final String? errorMessage;
 
   const BadgeTransferState({
     this.status = TransferStatus.idle,
     this.device,
     this.progress = 0.0,
+    this.statusMessage,
     this.errorMessage,
   });
 
@@ -22,12 +28,14 @@ class BadgeTransferState {
     TransferStatus? status,
     BluetoothDevice? device,
     double? progress,
+    String? statusMessage,
     String? errorMessage,
   }) {
     return BadgeTransferState(
       status: status ?? this.status,
       device: device ?? this.device,
       progress: progress ?? this.progress,
+      statusMessage: statusMessage ?? this.statusMessage,
       errorMessage: errorMessage ?? this.errorMessage,
     );
   }
@@ -35,6 +43,8 @@ class BadgeTransferState {
 
 @riverpod
 class BadgeTransferController extends _$BadgeTransferController {
+  final _transferService = BadgeBleTransferService();
+
   @override
   BadgeTransferState build() {
     ref.onDispose(() {
@@ -43,53 +53,50 @@ class BadgeTransferController extends _$BadgeTransferController {
     return const BadgeTransferState();
   }
 
-  void startScan() {
+  /// 连接设备并传输图片
-    if (!ref.mounted) return;
-    state = state.copyWith(status: TransferStatus.scanning);
-    FlutterBluePlus.startScan(timeout: const Duration(seconds: 10));
-
-    FlutterBluePlus.scanResults.listen((results) {
-      if (!ref.mounted) return;
-      // Process scan results
-    });
-
-    FlutterBluePlus.adapterState.listen((adapterState) {
-      if (!ref.mounted) return;
-      // Handle adapter state changes
-    });
-  }
-
-  void stopScan() {
-    FlutterBluePlus.stopScan();
-    if (!ref.mounted) return;
-    state = state.copyWith(status: TransferStatus.idle);
-  }
-
   Future<void> connectAndTransfer(
     BluetoothDevice device,
-    String imageUrl,
+    String imageUrl, {
-  ) async {
+    Uint8List? imageBytes,
+  }) async {
     if (!ref.mounted) return;
     state = state.copyWith(
       status: TransferStatus.connecting,
       device: device,
+      progress: 0.0,
+      statusMessage: '正在连接设备...',
     );
+
     try {
-      await device.connect();
+      await _transferService.connectAndTransfer(
-      if (!ref.mounted) return;
+        device: device,
-      state = state.copyWith(status: TransferStatus.transferring);
+        imageUrl: imageUrl,
-      // Transfer logic here
+        imageBytes: imageBytes,
-      await Future.delayed(const Duration(seconds: 2));
+        onProgress: (progress, message) {
+          if (!ref.mounted) return;
+          final newStatus = progress < 0.15
+              ? TransferStatus.connecting
+              : TransferStatus.transferring;
+          state = state.copyWith(
+            status: newStatus,
+            progress: progress,
+            statusMessage: message,
+          );
+        },
+      );
+
       if (!ref.mounted) return;
       state = state.copyWith(
         status: TransferStatus.done,
         progress: 1.0,
+        statusMessage: '传输完成',
       );
     } catch (e) {
+      debugPrint('[BadgeTransfer] 传输失败: $e');
       if (!ref.mounted) return;
       state = state.copyWith(
         status: TransferStatus.error,
-        errorMessage: e.toString(),
+        errorMessage: e.toString().replaceFirst('Exception: ', ''),
       );
     }
   }

airhub_app/lib/features/badge/presentation/controllers/badge_transfer_controller.g.dart

@@ -42,7 +42,7 @@ final class BadgeTransferControllerProvider
 }
 
 String _$badgeTransferControllerHash() =>
-    r'6ed7ce6b7aa6eae541366245e297b1c1ed1413f2';
+    r'5f06a9bcf5c9fcf0caf428497d2b9901b1b7f626';
 
 abstract class _$BadgeTransferController extends $Notifier<BadgeTransferState> {
   BadgeTransferState build();

airhub_app/lib/features/badge/presentation/pages/badge_basic_control_page.dart

@@ -0,0 +1,412 @@
+import 'dart:ui';
+import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:flutter_svg/flutter_svg.dart';
+import 'package:go_router/go_router.dart';
+
+import '../../../../core/network/api_client.dart';
+import '../../../../pages/profile/profile_page.dart';
+import '../../../../theme/product_theme.dart';
+import '../../../../widgets/animated_gradient_background.dart';
+
+/// 普通电子吧唧 (DZBJ-OFF) 业务主页
+class BadgeBasicControlPage extends ConsumerStatefulWidget {
+  const BadgeBasicControlPage({super.key});
+
+  @override
+  ConsumerState<BadgeBasicControlPage> createState() =>
+      _BadgeBasicControlPageState();
+}
+
+class _BadgeBasicControlPageState extends ConsumerState<BadgeBasicControlPage>
+    with SingleTickerProviderStateMixin {
+  int _currentTab = 0;
+  late AnimationController _floatController;
+  late Animation<double> _floatAnimation;
+
+  String? _lastImageUrl;
+  bool _loading = true;
+
+  @override
+  void initState() {
+    super.initState();
+    Future.microtask(() => ref.read(currentProductTypeProvider.notifier).set(ProductType.badgeBasic));
+    _floatController = AnimationController(
+      vsync: this,
+      duration: const Duration(milliseconds: 3000),
+    )..repeat(reverse: true);
+    _floatAnimation = Tween<double>(begin: -8, end: 8).animate(
+      CurvedAnimation(parent: _floatController, curve: Curves.easeInOut),
+    );
+    _loadLastImage();
+  }
+
+  @override
+  void dispose() {
+    _floatController.dispose();
+    super.dispose();
+  }
+
+  Future<void> _loadLastImage() async {
+    try {
+      final apiClient = ref.read(apiClientProvider);
+      final data = await apiClient.get('/badge/history/');
+      final images = ((data as Map<String, dynamic>)['images'] as List<dynamic>? ?? [])
+          .cast<Map<String, dynamic>>()
+          .where((img) =>
+              img['generation_status'] == 'completed' &&
+              (img['image_url'] as String?)?.isNotEmpty == true)
+          .toList();
+      if (images.isNotEmpty && mounted) {
+        setState(() => _lastImageUrl = images.first['image_url'] as String);
+      }
+    } catch (_) {}
+    if (mounted) setState(() => _loading = false);
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final productTheme = ref.watch(currentProductThemeProvider);
+
+    return Scaffold(
+      backgroundColor: Colors.white,
+      body: Stack(
+        children: [
+          const AnimatedGradientBackground(),
+
+          IndexedStack(
+            index: _currentTab,
+            children: [
+              _buildHomePage(productTheme),
+              const ProfilePage(),
+            ],
+          ),
+
+          Positioned(
+            left: 0,
+            right: 0,
+            bottom: MediaQuery.of(context).padding.bottom + 12,
+            child: _buildBottomNavBar(productTheme),
+          ),
+        ],
+      ),
+    );
+  }
+
+  Widget _buildHomePage(ProductThemeData productTheme) {
+    return SafeArea(
+      bottom: false,
+      child: Stack(
+        children: [
+          Center(
+            child: AnimatedBuilder(
+              animation: _floatAnimation,
+              builder: (context, child) => Transform.translate(
+                offset: Offset(0, _floatAnimation.value),
+                child: child,
+              ),
+              child: Column(
+                mainAxisAlignment: MainAxisAlignment.center,
+                children: [
+                  _BadgePreviewCircle(
+                    imageUrl: _lastImageUrl,
+                    loading: _loading,
+                    accentColor: productTheme.accentColor,
+                    size: 240,
+                  ),
+                  const SizedBox(height: 16),
+                  if (!_loading && _lastImageUrl == null)
+                    Text(
+                      '点击右上角「传图」上传你的第一张图',
+                      style: TextStyle(
+                        fontSize: 13,
+                        color: productTheme.accentColor.withOpacity(0.5),
+                      ),
+                    ),
+                ],
+              ),
+            ),
+          ),
+
+          Positioned(
+            top: 8,
+            left: 16,
+            right: 16,
+            child: Row(
+              mainAxisAlignment: MainAxisAlignment.spaceBetween,
+              children: [
+                _GlassIconButton(
+                  onTap: () => context.push('/product-selection'),
+                  child: SvgPicture.asset(
+                    'assets/www/icons/icon-switch.svg',
+                    width: 20,
+                    height: 20,
+                    colorFilter: const ColorFilter.mode(
+                      Color(0xFF4B5563),
+                      BlendMode.srcIn,
+                    ),
+                  ),
+                ),
+                _GlassPillButton(
+                  onTap: () => context.push('/badge'),
+                  child: Row(
+                    mainAxisSize: MainAxisSize.min,
+                    children: [
+                      Text(
+                        '传图',
+                        style: TextStyle(
+                          fontSize: 14,
+                          fontWeight: FontWeight.w600,
+                          color: productTheme.accentColor,
+                        ),
+                      ),
+                      const SizedBox(width: 4),
+                      Icon(Icons.send_rounded,
+                          size: 16, color: productTheme.accentColor),
+                    ],
+                  ),
+                ),
+              ],
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+
+  Widget _buildBottomNavBar(ProductThemeData productTheme) {
+    return Center(
+      child: ClipRRect(
+        borderRadius: BorderRadius.circular(32),
+        child: BackdropFilter(
+          filter: ImageFilter.blur(sigmaX: 20, sigmaY: 20),
+          child: Container(
+            width: 180,
+            padding: const EdgeInsets.symmetric(vertical: 6, horizontal: 8),
+            decoration: BoxDecoration(
+              color: Colors.white.withOpacity(0.6),
+              borderRadius: BorderRadius.circular(32),
+              border: Border.all(color: Colors.white.withOpacity(0.8)),
+              boxShadow: [
+                BoxShadow(
+                  color: const Color(0xFF4B5563).withOpacity(0.08),
+                  offset: const Offset(0, 10),
+                  blurRadius: 30,
+                ),
+              ],
+            ),
+            child: Row(
+              mainAxisAlignment: MainAxisAlignment.spaceEvenly,
+              children: [
+                _buildNavItem(0, 'assets/www/icons/icon-home-pixel.svg',
+                    Icons.home, productTheme),
+                _buildNavItem(1, 'assets/www/icons/icon-user-pixel.svg',
+                    Icons.person, productTheme),
+              ],
+            ),
+          ),
+        ),
+      ),
+    );
+  }
+
+  Widget _buildNavItem(
+      int index, String iconPath, IconData fallback, ProductThemeData theme) {
+    final isActive = _currentTab == index;
+    return GestureDetector(
+      onTap: () => setState(() => _currentTab = index),
+      child: AnimatedContainer(
+        duration: const Duration(milliseconds: 250),
+        width: 56,
+        height: 56,
+        decoration: BoxDecoration(
+          gradient: isActive ? theme.buttonGradient : null,
+          borderRadius: BorderRadius.circular(28),
+          boxShadow: isActive
+              ? [
+                  BoxShadow(
+                    color: theme.accentColor.withOpacity(0.4),
+                    offset: const Offset(0, 4),
+                    blurRadius: 15,
+                  ),
+                ]
+              : null,
+        ),
+        alignment: Alignment.center,
+        child: SvgPicture.asset(
+          iconPath,
+          width: isActive ? 28 : 26,
+          height: isActive ? 28 : 26,
+          colorFilter: ColorFilter.mode(
+            isActive ? Colors.white : const Color(0xFF6B7280).withOpacity(0.6),
+            BlendMode.srcIn,
+          ),
+          placeholderBuilder: (_) => Icon(
+            fallback,
+            color: isActive ? Colors.white : const Color(0xFF6B7280),
+            size: 24,
+          ),
+        ),
+      ),
+    );
+  }
+}
+
+class _BadgePreviewCircle extends StatelessWidget {
+  final String? imageUrl;
+  final bool loading;
+  final Color accentColor;
+  final double size;
+
+  const _BadgePreviewCircle({
+    required this.imageUrl,
+    required this.loading,
+    required this.accentColor,
+    required this.size,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    return Container(
+      width: size,
+      height: size,
+      decoration: BoxDecoration(
+        shape: BoxShape.circle,
+        color: const Color(0xFF2D3748),
+        border: Border.all(color: const Color(0xFF4A5568), width: 4),
+        boxShadow: [
+          BoxShadow(
+            color: accentColor.withOpacity(0.2),
+            blurRadius: 40,
+            spreadRadius: 8,
+          ),
+          BoxShadow(
+            color: Colors.black.withOpacity(0.3),
+            blurRadius: 20,
+            offset: const Offset(0, 8),
+          ),
+        ],
+      ),
+      padding: const EdgeInsets.all(8),
+      child: ClipOval(
+        child: loading
+            ? Center(
+                child: CircularProgressIndicator(
+                  strokeWidth: 2,
+                  color: accentColor.withOpacity(0.5),
+                ),
+              )
+            : imageUrl != null
+                ? Image.network(
+                    imageUrl!,
+                    fit: BoxFit.cover,
+                    errorBuilder: (_, __, ___) => _buildPlaceholder(),
+                  )
+                : _buildPlaceholder(),
+      ),
+    );
+  }
+
+  Widget _buildPlaceholder() {
+    return Container(
+      color: const Color(0xFF1A202C),
+      child: Center(
+        child: Column(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            Icon(Icons.add_photo_alternate_outlined,
+                size: 48, color: accentColor.withOpacity(0.4)),
+            const SizedBox(height: 8),
+            Text(
+              '暂无图片',
+              style: TextStyle(
+                fontSize: 13,
+                color: accentColor.withOpacity(0.3),
+              ),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}
+
+class _GlassIconButton extends StatefulWidget {
+  final VoidCallback onTap;
+  final Widget child;
+  const _GlassIconButton({required this.onTap, required this.child});
+  @override
+  State<_GlassIconButton> createState() => _GlassIconButtonState();
+}
+
+class _GlassIconButtonState extends State<_GlassIconButton> {
+  bool _pressed = false;
+  @override
+  Widget build(BuildContext context) {
+    return GestureDetector(
+      onTapDown: (_) => setState(() => _pressed = true),
+      onTapUp: (_) => setState(() => _pressed = false),
+      onTapCancel: () => setState(() => _pressed = false),
+      onTap: () {
+        HapticFeedback.lightImpact();
+        widget.onTap();
+      },
+      child: AnimatedScale(
+        scale: _pressed ? 0.92 : 1.0,
+        duration: const Duration(milliseconds: 120),
+        curve: Curves.easeOut,
+        child: Container(
+          width: 44,
+          height: 44,
+          decoration: BoxDecoration(
+            color: Colors.white.withOpacity(_pressed ? 0.45 : 0.25),
+            borderRadius: BorderRadius.circular(22),
+            border: Border.all(color: Colors.white.withOpacity(0.4)),
+          ),
+          alignment: Alignment.center,
+          child: widget.child,
+        ),
+      ),
+    );
+  }
+}
+
+class _GlassPillButton extends StatefulWidget {
+  final VoidCallback onTap;
+  final Widget child;
+  const _GlassPillButton({required this.onTap, required this.child});
+  @override
+  State<_GlassPillButton> createState() => _GlassPillButtonState();
+}
+
+class _GlassPillButtonState extends State<_GlassPillButton> {
+  bool _pressed = false;
+  @override
+  Widget build(BuildContext context) {
+    return GestureDetector(
+      onTapDown: (_) => setState(() => _pressed = true),
+      onTapUp: (_) => setState(() => _pressed = false),
+      onTapCancel: () => setState(() => _pressed = false),
+      onTap: () {
+        HapticFeedback.lightImpact();
+        widget.onTap();
+      },
+      child: AnimatedScale(
+        scale: _pressed ? 0.94 : 1.0,
+        duration: const Duration(milliseconds: 120),
+        curve: Curves.easeOut,
+        child: Container(
+          height: 44,
+          padding: const EdgeInsets.symmetric(horizontal: 16),
+          decoration: BoxDecoration(
+            color: Colors.white.withOpacity(_pressed ? 0.45 : 0.25),
+            borderRadius: BorderRadius.circular(22),
+            border: Border.all(color: Colors.white.withOpacity(0.4)),
+          ),
+          child: widget.child,
+        ),
+      ),
+    );
+  }
+}

airhub_app/lib/features/badge/presentation/pages/badge_control_page.dart

@@ -0,0 +1,320 @@
+import 'dart:ui';
+import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:flutter_svg/flutter_svg.dart';
+import 'package:go_router/go_router.dart';
+
+import '../../../../pages/profile/profile_page.dart';
+import '../../../../theme/product_theme.dart';
+import '../../../../widgets/animated_gradient_background.dart';
+
+/// 电子吧唧 AI (DZBJ-ON) 业务主页
+class BadgeControlPage extends ConsumerStatefulWidget {
+  const BadgeControlPage({super.key});
+
+  @override
+  ConsumerState<BadgeControlPage> createState() => _BadgeControlPageState();
+}
+
+class _BadgeControlPageState extends ConsumerState<BadgeControlPage>
+    with SingleTickerProviderStateMixin {
+  int _currentTab = 0; // 0: 主页, 1: 设置
+  late AnimationController _floatController;
+  late Animation<double> _floatAnimation;
+
+  @override
+  void initState() {
+    super.initState();
+    Future.microtask(() => ref.read(currentProductTypeProvider.notifier).set(ProductType.badgeAi));
+    _floatController = AnimationController(
+      vsync: this,
+      duration: const Duration(milliseconds: 3000),
+    )..repeat(reverse: true);
+    _floatAnimation = Tween<double>(begin: -8, end: 8).animate(
+      CurvedAnimation(parent: _floatController, curve: Curves.easeInOut),
+    );
+  }
+
+  @override
+  void dispose() {
+    _floatController.dispose();
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final productTheme = ref.watch(currentProductThemeProvider);
+
+    return Scaffold(
+      backgroundColor: Colors.white,
+      body: Stack(
+        children: [
+          const AnimatedGradientBackground(),
+
+          // 内容区
+          IndexedStack(
+            index: _currentTab,
+            children: [
+              _buildHomePage(productTheme),
+              const ProfilePage(),
+            ],
+          ),
+
+          // 底部导航栏
+          Positioned(
+            left: 0,
+            right: 0,
+            bottom: MediaQuery.of(context).padding.bottom + 12,
+            child: _buildBottomNavBar(productTheme),
+          ),
+        ],
+      ),
+    );
+  }
+
+  Widget _buildHomePage(ProductThemeData productTheme) {
+    return SafeArea(
+      bottom: false,
+      child: Stack(
+        children: [
+          // 居中的吧唧图片
+          Center(
+            child: AnimatedBuilder(
+              animation: _floatAnimation,
+              builder: (context, child) => Transform.translate(
+                offset: Offset(0, _floatAnimation.value),
+                child: child,
+              ),
+              child: Container(
+                decoration: BoxDecoration(
+                  shape: BoxShape.circle,
+                  boxShadow: [
+                    BoxShadow(
+                      color: productTheme.accentColor.withOpacity(0.2),
+                      blurRadius: 60,
+                      spreadRadius: 15,
+                    ),
+                    BoxShadow(
+                      color: productTheme.accentColorLight.withOpacity(0.1),
+                      blurRadius: 100,
+                      spreadRadius: 30,
+                    ),
+                  ],
+                ),
+                child: Image.asset(
+                  'assets/www/Capybara.png',
+                  width: 260,
+                  fit: BoxFit.contain,
+                  errorBuilder: (_, __, ___) => Icon(
+                      Icons.smart_toy,
+                      size: 150,
+                      color: productTheme.accentColor),
+                ),
+              ),
+            ),
+          ),
+
+          // 顶部操作栏
+          Positioned(
+            top: 8,
+            left: 16,
+            right: 16,
+            child: Row(
+              mainAxisAlignment: MainAxisAlignment.spaceBetween,
+              children: [
+                _GlassIconButton(
+                  onTap: () => context.push('/product-selection'),
+                  child: SvgPicture.asset(
+                    'assets/www/icons/icon-switch.svg',
+                    width: 20,
+                    height: 20,
+                    colorFilter: const ColorFilter.mode(
+                      Color(0xFF4B5563),
+                      BlendMode.srcIn,
+                    ),
+                  ),
+                ),
+                _GlassPillButton(
+                  onTap: () => context.push('/badge'),
+                  child: Row(
+                    mainAxisSize: MainAxisSize.min,
+                    children: [
+                      Text(
+                        '传图',
+                        style: TextStyle(
+                          fontSize: 14,
+                          fontWeight: FontWeight.w600,
+                          color: productTheme.accentColor,
+                        ),
+                      ),
+                      const SizedBox(width: 4),
+                      Icon(Icons.send_rounded,
+                          size: 16, color: productTheme.accentColor),
+                    ],
+                  ),
+                ),
+              ],
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+
+  Widget _buildBottomNavBar(ProductThemeData productTheme) {
+    return Center(
+      child: ClipRRect(
+        borderRadius: BorderRadius.circular(32),
+        child: BackdropFilter(
+          filter: ImageFilter.blur(sigmaX: 20, sigmaY: 20),
+          child: Container(
+            width: 180,
+            padding: const EdgeInsets.symmetric(vertical: 6, horizontal: 8),
+            decoration: BoxDecoration(
+              color: Colors.white.withOpacity(0.6),
+              borderRadius: BorderRadius.circular(32),
+              border: Border.all(color: Colors.white.withOpacity(0.8)),
+              boxShadow: [
+                BoxShadow(
+                  color: const Color(0xFF4B5563).withOpacity(0.08),
+                  offset: const Offset(0, 10),
+                  blurRadius: 30,
+                ),
+              ],
+            ),
+            child: Row(
+              mainAxisAlignment: MainAxisAlignment.spaceEvenly,
+              children: [
+                _buildNavItem(0, 'assets/www/icons/icon-home-pixel.svg',
+                    Icons.home, productTheme),
+                _buildNavItem(1, 'assets/www/icons/icon-user-pixel.svg',
+                    Icons.person, productTheme),
+              ],
+            ),
+          ),
+        ),
+      ),
+    );
+  }
+
+  Widget _buildNavItem(
+      int index, String iconPath, IconData fallback, ProductThemeData theme) {
+    final isActive = _currentTab == index;
+    return GestureDetector(
+      onTap: () => setState(() => _currentTab = index),
+      child: AnimatedContainer(
+        duration: const Duration(milliseconds: 250),
+        width: 56,
+        height: 56,
+        decoration: BoxDecoration(
+          gradient: isActive ? theme.buttonGradient : null,
+          borderRadius: BorderRadius.circular(28),
+          boxShadow: isActive
+              ? [
+                  BoxShadow(
+                    color: theme.accentColor.withOpacity(0.4),
+                    offset: const Offset(0, 4),
+                    blurRadius: 15,
+                  ),
+                ]
+              : null,
+        ),
+        alignment: Alignment.center,
+        child: SvgPicture.asset(
+          iconPath,
+          width: isActive ? 28 : 26,
+          height: isActive ? 28 : 26,
+          colorFilter: ColorFilter.mode(
+            isActive ? Colors.white : const Color(0xFF6B7280).withOpacity(0.6),
+            BlendMode.srcIn,
+          ),
+          placeholderBuilder: (_) => Icon(
+            fallback,
+            color: isActive ? Colors.white : const Color(0xFF6B7280),
+            size: 24,
+          ),
+        ),
+      ),
+    );
+  }
+}
+
+class _GlassIconButton extends StatefulWidget {
+  final VoidCallback onTap;
+  final Widget child;
+  const _GlassIconButton({required this.onTap, required this.child});
+  @override
+  State<_GlassIconButton> createState() => _GlassIconButtonState();
+}
+
+class _GlassIconButtonState extends State<_GlassIconButton> {
+  bool _pressed = false;
+  @override
+  Widget build(BuildContext context) {
+    return GestureDetector(
+      onTapDown: (_) => setState(() => _pressed = true),
+      onTapUp: (_) => setState(() => _pressed = false),
+      onTapCancel: () => setState(() => _pressed = false),
+      onTap: () {
+        HapticFeedback.lightImpact();
+        widget.onTap();
+      },
+      child: AnimatedScale(
+        scale: _pressed ? 0.92 : 1.0,
+        duration: const Duration(milliseconds: 120),
+        curve: Curves.easeOut,
+        child: Container(
+          width: 44,
+          height: 44,
+          decoration: BoxDecoration(
+            color: Colors.white.withOpacity(_pressed ? 0.45 : 0.25),
+            borderRadius: BorderRadius.circular(22),
+            border: Border.all(color: Colors.white.withOpacity(0.4)),
+          ),
+          alignment: Alignment.center,
+          child: widget.child,
+        ),
+      ),
+    );
+  }
+}
+
+class _GlassPillButton extends StatefulWidget {
+  final VoidCallback onTap;
+  final Widget child;
+  const _GlassPillButton({required this.onTap, required this.child});
+  @override
+  State<_GlassPillButton> createState() => _GlassPillButtonState();
+}
+
+class _GlassPillButtonState extends State<_GlassPillButton> {
+  bool _pressed = false;
+  @override
+  Widget build(BuildContext context) {
+    return GestureDetector(
+      onTapDown: (_) => setState(() => _pressed = true),
+      onTapUp: (_) => setState(() => _pressed = false),
+      onTapCancel: () => setState(() => _pressed = false),
+      onTap: () {
+        HapticFeedback.lightImpact();
+        widget.onTap();
+      },
+      child: AnimatedScale(
+        scale: _pressed ? 0.94 : 1.0,
+        duration: const Duration(milliseconds: 120),
+        curve: Curves.easeOut,
+        child: Container(
+          height: 44,
+          padding: const EdgeInsets.symmetric(horizontal: 16),
+          decoration: BoxDecoration(
+            color: Colors.white.withOpacity(_pressed ? 0.45 : 0.25),
+            borderRadius: BorderRadius.circular(22),
+            border: Border.all(color: Colors.white.withOpacity(0.4)),
+          ),
+          child: widget.child,
+        ),
+      ),
+    );
+  }
+}

airhub_app/lib/features/badge/presentation/pages/badge_home_page.dart

@@ -3,6 +3,7 @@ import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:go_router/go_router.dart';
 
+import '../../../../theme/product_theme.dart';
 import '../../../../widgets/animated_gradient_background.dart';
 import '../../data/services/badge_ai_generation_service.dart';
 import '../controllers/badge_ai_controller.dart';
@@ -23,13 +24,13 @@ class _BadgeHomePageState extends ConsumerState<BadgeHomePage>
 
   // 上传图片
   String? _uploadedImagePath;
+  Uint8List? _uploadedImageBytes;
 
   // AI 生成
   bool _isGenerating = false;
   double _genProgress = 0;
   String _genStatus = '';
   String? _generatedImageUrl;
-  bool _hasAiResult = false;
 
   @override
   void initState() {
@@ -43,7 +44,6 @@ class _BadgeHomePageState extends ConsumerState<BadgeHomePage>
     final pending = BadgeAiGenerationService.instance.consumePendingResult();
     if (pending != null) {
       _generatedImageUrl = pending.imageUrl;
-      _hasAiResult = true;
     }
 
     // 注册 AI 服务回调
@@ -61,7 +61,6 @@ class _BadgeHomePageState extends ConsumerState<BadgeHomePage>
         setState(() {
           _isGenerating = false;
           _generatedImageUrl = result.imageUrl;
-          _hasAiResult = true;
         });
         _showResultDialog(result.imageUrl);
       }
@@ -87,6 +86,7 @@ class _BadgeHomePageState extends ConsumerState<BadgeHomePage>
   }
 
   void _showResultDialog(String imageUrl) {
+    final theme = ref.read(currentProductThemeProvider);
     showDialog(
       context: context,
       barrierDismissible: false,
@@ -163,14 +163,7 @@ class _BadgeHomePageState extends ConsumerState<BadgeHomePage>
                       height: 48,
                       child: DecoratedBox(
                         decoration: BoxDecoration(
-                          gradient: const LinearGradient(
+                          gradient: theme.buttonGradient,
-                            colors: [
-                              Color(0xFF22D3EE),
-                              Color(0xFF3B82F6),
-                              Color(0xFF6366F1),
-                              Color(0xFF8B5CF6),
-                            ],
-                          ),
                           borderRadius: BorderRadius.circular(14),
                         ),
                         child: ElevatedButton(
@@ -213,7 +206,6 @@ class _BadgeHomePageState extends ConsumerState<BadgeHomePage>
     setState(() {
       _isGenerating = true;
       _generatedImageUrl = null;
-      _hasAiResult = false;
       _genProgress = 0;
       _genStatus = '正在连接 AI...';
     });
@@ -236,24 +228,30 @@ class _BadgeHomePageState extends ConsumerState<BadgeHomePage>
   void _handleUploadSelected(String path, Uint8List? bytes) {
     setState(() {
       _uploadedImagePath = path;
+      _uploadedImageBytes = bytes;
     });
   }
 
   void _handleRetry() {
     setState(() {
       _generatedImageUrl = null;
-      _hasAiResult = false;
     });
   }
 
   void _handleUseImage() {
     final imageSource = _generatedImageUrl ?? _uploadedImagePath;
     if (imageSource == null) return;
-    context.push('/badge/transfer', extra: {'imageUrl': imageSource});
+    context.push('/badge/transfer', extra: {
+      'imageUrl': imageSource,
+      if (_uploadedImageBytes != null && _generatedImageUrl == null)
+        'imageBytes': _uploadedImageBytes,
+    });
   }
 
   @override
   Widget build(BuildContext context) {
+    final productTheme = ref.watch(currentProductThemeProvider);
+
     return Scaffold(
       backgroundColor: Colors.white,
       body: Stack(
@@ -263,13 +261,13 @@ class _BadgeHomePageState extends ConsumerState<BadgeHomePage>
             child: Column(
               children: [
                 _buildHeader(),
-                _buildTabBar(),
+                _buildTabBar(productTheme),
-                Expanded(child: _buildTabContent()),
+                Expanded(child: _buildTabContent(productTheme)),
               ],
             ),
           ),
-          if (_isGenerating) _buildGeneratingOverlay(),
+          if (_isGenerating) _buildGeneratingOverlay(productTheme),
-          _buildFixedBottomBar(),
+          _buildFixedBottomBar(productTheme),
         ],
       ),
     );
@@ -281,13 +279,7 @@ class _BadgeHomePageState extends ConsumerState<BadgeHomePage>
       child: Row(
         children: [
           GestureDetector(
-            onTap: () {
+            onTap: () => context.pop(),
-              if (context.canPop()) {
-                context.pop();
-              } else {
-                context.go('/');
-              }
-            },
             child: Container(
               width: 40,
               height: 40,
@@ -318,7 +310,7 @@ class _BadgeHomePageState extends ConsumerState<BadgeHomePage>
     );
   }
 
-  Widget _buildTabBar() {
+  Widget _buildTabBar(ProductThemeData productTheme) {
     return Container(
       margin: const EdgeInsets.symmetric(horizontal: 20, vertical: 4),
       padding: const EdgeInsets.all(4),
@@ -334,7 +326,7 @@ class _BadgeHomePageState extends ConsumerState<BadgeHomePage>
           borderRadius: BorderRadius.circular(12),
           boxShadow: [
             BoxShadow(
-              color: const Color(0xFF6366F1).withOpacity(0.15),
+              color: productTheme.accentColor.withOpacity(0.15),
               blurRadius: 12,
               offset: const Offset(0, 2),
             ),
@@ -342,7 +334,7 @@ class _BadgeHomePageState extends ConsumerState<BadgeHomePage>
         ),
         indicatorSize: TabBarIndicatorSize.tab,
         dividerColor: Colors.transparent,
-        labelColor: const Color(0xFF6366F1),
+        labelColor: productTheme.accentColor,
         unselectedLabelColor: const Color(0xFF6B7280),
         labelStyle: const TextStyle(fontSize: 14, fontWeight: FontWeight.w600),
         unselectedLabelStyle: const TextStyle(fontSize: 14, fontWeight: FontWeight.w500),
@@ -354,7 +346,7 @@ class _BadgeHomePageState extends ConsumerState<BadgeHomePage>
     );
   }
 
-  Widget _buildTabContent() {
+  Widget _buildTabContent(ProductThemeData productTheme) {
     return TabBarView(
       controller: _tabController,
       children: [
@@ -362,13 +354,17 @@ class _BadgeHomePageState extends ConsumerState<BadgeHomePage>
           key: _aiTabKey,
           onGenerate: _handleAiGenerate,
           isGenerating: _isGenerating,
+          accentColor: productTheme.accentColor,
+        ),
+        BadgeUploadTab(
+          onImageSelected: _handleUploadSelected,
+          accentColor: productTheme.accentColor,
         ),
-        BadgeUploadTab(onImageSelected: _handleUploadSelected),
       ],
     );
   }
 
-  Widget _buildGeneratingOverlay() {
+  Widget _buildGeneratingOverlay(ProductThemeData productTheme) {
     return Positioned.fill(
       child: Container(
         color: Colors.black.withOpacity(0.4),
@@ -383,21 +379,21 @@ class _BadgeHomePageState extends ConsumerState<BadgeHomePage>
             child: Column(
               mainAxisSize: MainAxisSize.min,
               children: [
-                const SizedBox(
+                SizedBox(
                   width: 48,
                   height: 48,
                   child: CircularProgressIndicator(
-                    color: Color(0xFF6366F1),
+                    color: productTheme.accentColor,
                     strokeWidth: 3,
                   ),
                 ),
                 const SizedBox(height: 16),
                 Text(
                   _genStatus,
-                  style: const TextStyle(
+                  style: TextStyle(
                     fontSize: 15,
                     fontWeight: FontWeight.w500,
-                    color: Color(0xFF6366F1),
+                    color: productTheme.accentColor,
                   ),
                 ),
                 const SizedBox(height: 12),
@@ -405,8 +401,8 @@ class _BadgeHomePageState extends ConsumerState<BadgeHomePage>
                   borderRadius: BorderRadius.circular(2),
                   child: LinearProgressIndicator(
                     value: _genProgress / 100,
-                    backgroundColor: const Color(0xFF6366F1).withOpacity(0.15),
+                    backgroundColor: productTheme.accentColor.withOpacity(0.15),
-                    valueColor: const AlwaysStoppedAnimation(Color(0xFF6366F1)),
+                    valueColor: AlwaysStoppedAnimation(productTheme.accentColor),
                     minHeight: 4,
                   ),
                 ),
@@ -419,38 +415,40 @@ class _BadgeHomePageState extends ConsumerState<BadgeHomePage>
   }
 
   /// 固定底部按钮栏 — 无背景渐变，无阴影
-  Widget _buildFixedBottomBar() {
+  Widget _buildFixedBottomBar(ProductThemeData productTheme) {
     final isAiTab = _tabController.index == 0;
     final isUploadTab = _tabController.index == 1;
 
     Widget? buttonContent;
 
     if (isAiTab) {
-      // 有结果时由弹窗处理，底部只显示"开始生成"
+      buttonContent = _buildGradientButton(
-      if (!_isGenerating && !_hasAiResult) {
+        '开始生成',
-        buttonContent = _buildGradientButton('开始生成', () {
+        _isGenerating
-          final aiState = _aiTabKey.currentState;
+            ? null
-          if (aiState == null) return;
+            : () {
-          final prompt = aiState.currentPrompt;
+                final aiState = _aiTabKey.currentState;
-          final isI2I = aiState.referenceImageBytes != null;
+                if (aiState == null) return;
-          // 文生图必须输入描述，图生图可选
+                final prompt = aiState.currentPrompt;
-          if (!isI2I && prompt.isEmpty) {
+                final isI2I = aiState.referenceImageBytes != null;
-            ScaffoldMessenger.of(context).showSnackBar(
+                // 文生图必须输入描述，图生图可选
-              const SnackBar(
+                if (!isI2I && prompt.isEmpty) {
-                content: Text('请输入图片描述'),
+                  ScaffoldMessenger.of(context).showSnackBar(
-                backgroundColor: Colors.orange,
+                    const SnackBar(
-              ),
+                      content: Text('请输入图片描述'),
-            );
+                      backgroundColor: Colors.orange,
-            return;
+                    ),
-          }
+                  );
-          _handleAiGenerate(
+                  return;
-            prompt: prompt,
+                }
-            style: aiState.selectedStyle,
+                _handleAiGenerate(
-            imageBytes: aiState.referenceImageBytes,
+                  prompt: prompt,
-            strength: aiState.strength,
+                  style: aiState.selectedStyle,
-          );
+                  imageBytes: aiState.referenceImageBytes,
-        });
+                  strength: aiState.strength,
-      }
+                );
+              },
+      );
     } else if (isUploadTab) {
       if (_uploadedImagePath != null) {
         buttonContent = _buildGradientButton('使用此图', _handleUseImage);
@@ -480,14 +478,13 @@ class _BadgeHomePageState extends ConsumerState<BadgeHomePage>
     );
   }
 
-  Widget _buildGradientButton(String label, VoidCallback onPressed) {
+  Widget _buildGradientButton(String label, VoidCallback? onPressed) {
+    final theme = ref.read(currentProductThemeProvider);
     return SizedBox(
       height: 52,
       child: DecoratedBox(
         decoration: BoxDecoration(
-          gradient: const LinearGradient(
+          gradient: theme.buttonGradient,
-            colors: [Color(0xFF22D3EE), Color(0xFF3B82F6), Color(0xFF6366F1), Color(0xFF8B5CF6)],
-          ),
           borderRadius: BorderRadius.circular(16),
         ),
         child: ElevatedButton(

airhub_app/lib/features/badge/presentation/widgets/badge_ai_tab.dart

@@ -12,11 +12,13 @@ class BadgeAiTab extends StatefulWidget {
     double strength,
   }) onGenerate;
   final bool isGenerating;
+  final Color accentColor;
 
   const BadgeAiTab({
     super.key,
     required this.onGenerate,
     this.isGenerating = false,
+    this.accentColor = const Color(0xFF6366F1),
   });
 
   @override
@@ -64,25 +66,26 @@ class BadgeAiTabState extends State<BadgeAiTab> {
 
   @override
   Widget build(BuildContext context) {
+    final accent = widget.accentColor;
     return SingleChildScrollView(
       padding: const EdgeInsets.fromLTRB(20, 16, 20, 100),
       child: Column(
         crossAxisAlignment: CrossAxisAlignment.start,
         children: [
           // 模式切换
-          _buildModeToggle(),
+          _buildModeToggle(accent),
           const SizedBox(height: 16),
 
           // 图生图：参考图上传
           if (_isI2I) ...[
-            _buildReferenceImageSection(),
+            _buildReferenceImageSection(accent),
             const SizedBox(height: 16),
-            _buildStrengthSlider(),
+            _buildStrengthSlider(accent),
             const SizedBox(height: 16),
           ],
 
           // 提示词输入
-          _buildPromptInput(),
+          _buildPromptInput(accent),
           const SizedBox(height: 20),
 
           // 风格选择
@@ -101,35 +104,35 @@ class BadgeAiTabState extends State<BadgeAiTab> {
             ],
           ),
           const SizedBox(height: 12),
-          _buildStyleGrid(),
+          _buildStyleGrid(accent),
         ],
       ),
     );
   }
 
-  Widget _buildModeToggle() {
+  Widget _buildModeToggle(Color accent) {
     return Row(
       children: [
-        _buildModeBtn('文生图', !_isI2I, () => setState(() => _isI2I = false)),
+        _buildModeBtn('文生图', !_isI2I, () => setState(() => _isI2I = false), accent),
         const SizedBox(width: 8),
-        _buildModeBtn('图生图', _isI2I, () => setState(() => _isI2I = true)),
+        _buildModeBtn('图生图', _isI2I, () => setState(() => _isI2I = true), accent),
       ],
     );
   }
 
-  Widget _buildModeBtn(String label, bool active, VoidCallback onTap) {
+  Widget _buildModeBtn(String label, bool active, VoidCallback onTap, Color accent) {
     return GestureDetector(
       onTap: onTap,
       child: AnimatedContainer(
         duration: const Duration(milliseconds: 250),
         padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 8),
         decoration: BoxDecoration(
-          color: active ? const Color(0xFF6366F1) : Colors.transparent,
+          color: active ? accent : Colors.transparent,
           borderRadius: BorderRadius.circular(20),
           border: Border.all(
             color: active
-                ? const Color(0xFF6366F1)
+                ? accent
-                : const Color(0xFF6366F1).withOpacity(0.2),
+                : accent.withOpacity(0.2),
             width: 1.5,
           ),
         ),
@@ -145,7 +148,7 @@ class BadgeAiTabState extends State<BadgeAiTab> {
     );
   }
 
-  Widget _buildReferenceImageSection() {
+  Widget _buildReferenceImageSection(Color accent) {
     return Container(
       padding: const EdgeInsets.all(16),
       decoration: BoxDecoration(
@@ -204,7 +207,7 @@ class BadgeAiTabState extends State<BadgeAiTab> {
                 height: 180,
                 decoration: BoxDecoration(
                   border: Border.all(
-                    color: const Color(0xFF6366F1).withOpacity(0.25),
+                    color: accent.withOpacity(0.25),
                     width: 2,
                   ),
                   borderRadius: BorderRadius.circular(16),
@@ -213,7 +216,7 @@ class BadgeAiTabState extends State<BadgeAiTab> {
                 child: Column(
                   mainAxisAlignment: MainAxisAlignment.center,
                   children: [
-                    Icon(Icons.add, size: 36, color: const Color(0xFFA78BFA)),
+                    Icon(Icons.add, size: 36, color: accent.withOpacity(0.6)),
                     const SizedBox(height: 8),
                     const Text('点击上传参考图', style: TextStyle(fontSize: 14, color: Color(0xFF6B7280))),
                     const SizedBox(height: 4),
@@ -227,7 +230,7 @@ class BadgeAiTabState extends State<BadgeAiTab> {
     );
   }
 
-  Widget _buildStrengthSlider() {
+  Widget _buildStrengthSlider(Color accent) {
     return Container(
       padding: const EdgeInsets.all(16),
       decoration: BoxDecoration(
@@ -246,18 +249,18 @@ class BadgeAiTabState extends State<BadgeAiTab> {
               ),
               Text(
                 (_strength).toStringAsFixed(1),
-                style: const TextStyle(fontSize: 14, fontWeight: FontWeight.w600, color: Color(0xFF6366F1)),
+                style: TextStyle(fontSize: 14, fontWeight: FontWeight.w600, color: accent),
               ),
             ],
           ),
           const SizedBox(height: 8),
           SliderTheme(
             data: SliderTheme.of(context).copyWith(
-              activeTrackColor: const Color(0xFF6366F1),
+              activeTrackColor: accent,
-              inactiveTrackColor: const Color(0xFF6366F1).withOpacity(0.15),
+              inactiveTrackColor: accent.withOpacity(0.15),
               thumbColor: Colors.white,
               thumbShape: const RoundSliderThumbShape(enabledThumbRadius: 11),
-              overlayColor: const Color(0xFF6366F1).withOpacity(0.1),
+              overlayColor: accent.withOpacity(0.1),
               trackHeight: 6,
             ),
             child: Slider(
@@ -280,7 +283,7 @@ class BadgeAiTabState extends State<BadgeAiTab> {
     );
   }
 
-  Widget _buildPromptInput() {
+  Widget _buildPromptInput(Color accent) {
     return Container(
       padding: const EdgeInsets.all(20),
       decoration: BoxDecoration(
@@ -315,7 +318,7 @@ class BadgeAiTabState extends State<BadgeAiTab> {
               ),
               focusedBorder: OutlineInputBorder(
                 borderRadius: BorderRadius.circular(14),
-                borderSide: const BorderSide(color: Color(0xFFA78BFA)),
+                borderSide: BorderSide(color: accent),
               ),
               contentPadding: const EdgeInsets.all(14),
             ),
@@ -325,7 +328,7 @@ class BadgeAiTabState extends State<BadgeAiTab> {
     );
   }
 
-  Widget _buildStyleGrid() {
+  Widget _buildStyleGrid(Color accent) {
     return GridView.builder(
       shrinkWrap: true,
       physics: const NeverScrollableScrollPhysics(),
@@ -341,6 +344,7 @@ class BadgeAiTabState extends State<BadgeAiTab> {
         return BadgeStyleChip(
           style: style,
           selected: _selectedStyle == style.id,
+          accentColor: accent,
           onTap: () {
             setState(() {
               _selectedStyle = _selectedStyle == style.id ? null : style.id;

airhub_app/lib/features/badge/presentation/widgets/badge_ble_device_card.dart

@@ -1,25 +1,23 @@
 import 'package:flutter/material.dart';
-import 'package:flutter_blue_plus/flutter_blue_plus.dart';
 
 class BadgeBleDeviceCard extends StatelessWidget {
-  final ScanResult scanResult;
+  final String displayName;
+  final int rssi;
   final bool selected;
   final VoidCallback onTap;
+  final Color accentColor;
 
   const BadgeBleDeviceCard({
     super.key,
-    required this.scanResult,
+    required this.displayName,
+    required this.rssi,
     required this.selected,
     required this.onTap,
+    this.accentColor = const Color(0xFF8B5CF6),
   });
 
   @override
   Widget build(BuildContext context) {
-    final name = scanResult.device.platformName.isNotEmpty
-        ? scanResult.device.platformName
-        : '未知设备';
-    final rssi = scanResult.rssi;
-
     return GestureDetector(
       onTap: onTap,
       child: Container(
@@ -27,12 +25,12 @@ class BadgeBleDeviceCard extends StatelessWidget {
         padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 14),
         decoration: BoxDecoration(
           color: selected
-              ? const Color(0xFF8B5CF6).withOpacity(0.08)
+              ? accentColor.withOpacity(0.08)
               : Colors.white.withOpacity(0.7),
           borderRadius: BorderRadius.circular(14),
           border: Border.all(
             color: selected
-                ? const Color(0xFF8B5CF6)
+                ? accentColor
                 : Colors.black.withOpacity(0.06),
             width: selected ? 2 : 1,
           ),
@@ -42,7 +40,7 @@ class BadgeBleDeviceCard extends StatelessWidget {
             Icon(
               Icons.bluetooth,
               color: selected
-                  ? const Color(0xFF8B5CF6)
+                  ? accentColor
                   : const Color(0xFF9CA3AF),
               size: 22,
             ),
@@ -52,12 +50,12 @@ class BadgeBleDeviceCard extends StatelessWidget {
                 crossAxisAlignment: CrossAxisAlignment.start,
                 children: [
                   Text(
-                    name,
+                    displayName,
                     style: TextStyle(
                       fontSize: 15,
                       fontWeight: FontWeight.w600,
                       color: selected
-                          ? const Color(0xFF8B5CF6)
+                          ? accentColor
                           : const Color(0xFF1F2937),
                     ),
                   ),
@@ -72,7 +70,7 @@ class BadgeBleDeviceCard extends StatelessWidget {
               ),
             ),
             if (selected)
-              const Icon(Icons.check_circle, color: Color(0xFF8B5CF6), size: 22),
+              Icon(Icons.check_circle, color: accentColor, size: 22),
           ],
         ),
       ),

airhub_app/lib/features/badge/presentation/widgets/badge_style_chip.dart

@@ -5,12 +5,14 @@ class BadgeStyleChip extends StatelessWidget {
   final BadgeStyle style;
   final bool selected;
   final VoidCallback onTap;
+  final Color accentColor;
 
   const BadgeStyleChip({
     super.key,
     required this.style,
     required this.selected,
     required this.onTap,
+    this.accentColor = const Color(0xFF6366F1),
   });
 
   @override
@@ -21,12 +23,12 @@ class BadgeStyleChip extends StatelessWidget {
         duration: const Duration(milliseconds: 200),
         decoration: BoxDecoration(
           color: selected
-              ? const Color(0xFF6366F1).withOpacity(0.1)
+              ? accentColor.withOpacity(0.1)
               : Colors.white.withOpacity(0.65),
           borderRadius: BorderRadius.circular(14),
           border: Border.all(
             color: selected
-                ? const Color(0xFF6366F1)
+                ? accentColor
                 : Colors.white.withOpacity(0.4),
             width: selected ? 2 : 1,
           ),
@@ -42,7 +44,7 @@ class BadgeStyleChip extends StatelessWidget {
                 fontSize: 11,
                 fontWeight: selected ? FontWeight.w600 : FontWeight.w500,
                 color: selected
-                    ? const Color(0xFF6366F1)
+                    ? accentColor
                     : const Color(0xFF6B7280),
               ),
             ),

airhub_app/lib/features/badge/presentation/widgets/badge_upload_tab.dart

@@ -8,10 +8,12 @@ import '../../../../core/network/api_config.dart';
 
 class BadgeUploadTab extends StatefulWidget {
   final void Function(String imagePath, Uint8List? bytes) onImageSelected;
+  final Color accentColor;
 
   const BadgeUploadTab({
     super.key,
     required this.onImageSelected,
+    this.accentColor = const Color(0xFF6366F1),
   });
 
   @override
@@ -66,6 +68,7 @@ class _BadgeUploadTabState extends State<BadgeUploadTab> {
           Navigator.of(context).pop();
           _selectAiImage(url);
         },
+        accentColor: widget.accentColor,
       ),
     );
   }
@@ -180,7 +183,7 @@ class _BadgeUploadTabState extends State<BadgeUploadTab> {
           child: Column(
             mainAxisAlignment: MainAxisAlignment.center,
             children: [
-              Icon(icon, color: const Color(0xFF6366F1), size: 48),
+              Icon(icon, color: widget.accentColor, size: 48),
               const SizedBox(height: 12),
               Text(
                 label,
@@ -200,8 +203,12 @@ class _BadgeUploadTabState extends State<BadgeUploadTab> {
 
 class _AiHistoryBottomSheet extends StatefulWidget {
   final void Function(String imageUrl) onSelect;
+  final Color accentColor;
 
-  const _AiHistoryBottomSheet({required this.onSelect});
+  const _AiHistoryBottomSheet({
+    required this.onSelect,
+    this.accentColor = const Color(0xFF6366F1),
+  });
 
   @override
   State<_AiHistoryBottomSheet> createState() => _AiHistoryBottomSheetState();
@@ -286,8 +293,8 @@ class _AiHistoryBottomSheetState extends State<_AiHistoryBottomSheet> {
 
   Widget _buildContent() {
     if (_loading) {
-      return const Center(
+      return Center(
-        child: CircularProgressIndicator(color: Color(0xFF6366F1)),
+        child: CircularProgressIndicator(color: widget.accentColor),
       );
     }
     if (_error != null) {

airhub_app/lib/features/badge/presentation/widgets/transfer_progress_ring.dart

@@ -1,79 +1,178 @@
 import 'dart:math';
 import 'package:flutter/material.dart';
 
-class TransferProgressRing extends StatelessWidget {
+/// 渐变进度环 — 带平滑动画
+class TransferProgressRing extends StatefulWidget {
   final double progress;
   final bool isComplete;
+  final Color accentColor;
 
   const TransferProgressRing({
     super.key,
     required this.progress,
     this.isComplete = false,
+    this.accentColor = const Color(0xFF8B5CF6),
   });
 
+  @override
+  State<TransferProgressRing> createState() => _TransferProgressRingState();
+}
+
+class _TransferProgressRingState extends State<TransferProgressRing>
+    with SingleTickerProviderStateMixin {
+  late AnimationController _controller;
+  late Animation<double> _progressAnim;
+  double _oldProgress = 0.0;
+
+  @override
+  void initState() {
+    super.initState();
+    _controller = AnimationController(
+      vsync: this,
+      duration: const Duration(milliseconds: 400),
+    );
+    _progressAnim = Tween<double>(begin: 0, end: widget.progress)
+        .animate(CurvedAnimation(parent: _controller, curve: Curves.easeOut));
+    _controller.forward();
+  }
+
+  @override
+  void didUpdateWidget(TransferProgressRing oldWidget) {
+    super.didUpdateWidget(oldWidget);
+    if (oldWidget.progress != widget.progress) {
+      _oldProgress = _progressAnim.value;
+      _progressAnim = Tween<double>(begin: _oldProgress, end: widget.progress)
+          .animate(CurvedAnimation(parent: _controller, curve: Curves.easeOut));
+      _controller
+        ..reset()
+        ..forward();
+    }
+  }
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    super.dispose();
+  }
+
   @override
   Widget build(BuildContext context) {
-    return SizedBox(
+    return AnimatedBuilder(
-      width: 120,
+      animation: _progressAnim,
-      height: 120,
+      builder: (context, child) {
-      child: CustomPaint(
+        final p = _progressAnim.value.clamp(0.0, 1.0);
-        painter: _ProgressRingPainter(
+        return SizedBox(
-          progress: progress,
+          width: 120,
-          isComplete: isComplete,
+          height: 120,
-        ),
+          child: CustomPaint(
-        child: Center(
+            painter: _GradientRingPainter(
-          child: isComplete
+              progress: p,
-              ? const Icon(Icons.check, color: Color(0xFF10B981), size: 48)
+              isComplete: widget.isComplete,
-              : Text(
+              accentColor: widget.accentColor,
-                  '${(progress * 100).toInt()}%',
+            ),
-                  style: const TextStyle(
+            child: Center(
-                    fontSize: 24,
+              child: widget.isComplete
-                    fontWeight: FontWeight.w700,
+                  ? TweenAnimationBuilder<double>(
-                    color: Color(0xFF8B5CF6),
+                      tween: Tween(begin: 0.0, end: 1.0),
-                  ),
+                      duration: const Duration(milliseconds: 400),
-                ),
+                      curve: Curves.elasticOut,
-        ),
+                      builder: (context, value, child) {
-      ),
+                        return Transform.scale(
+                          scale: value,
+                          child: child,
+                        );
+                      },
+                      child: Container(
+                        width: 52,
+                        height: 52,
+                        decoration: const BoxDecoration(
+                          color: Color(0xFF10B981),
+                          shape: BoxShape.circle,
+                        ),
+                        child: const Icon(Icons.check_rounded,
+                            color: Colors.white, size: 32),
+                      ),
+                    )
+                  : Text(
+                      '${(p * 100).toInt()}%',
+                      style: TextStyle(
+                        fontSize: 24,
+                        fontWeight: FontWeight.w700,
+                        color: widget.accentColor,
+                      ),
+                    ),
+            ),
+          ),
+        );
+      },
     );
   }
 }
 
-class _ProgressRingPainter extends CustomPainter {
+class _GradientRingPainter extends CustomPainter {
   final double progress;
   final bool isComplete;
+  final Color accentColor;
 
-  _ProgressRingPainter({required this.progress, required this.isComplete});
+  _GradientRingPainter({
+    required this.progress,
+    required this.isComplete,
+    required this.accentColor,
+  });
 
   @override
   void paint(Canvas canvas, Size size) {
     final center = Offset(size.width / 2, size.height / 2);
     final radius = size.width / 2 - 6;
+    final rect = Rect.fromCircle(center: center, radius: radius);
 
-    // Background ring
+    // 背景环
     final bgPaint = Paint()
-      ..color = const Color(0xFFE5E7EB)
+      ..color = accentColor.withOpacity(0.1)
       ..style = PaintingStyle.stroke
       ..strokeWidth = 8
       ..strokeCap = StrokeCap.round;
     canvas.drawCircle(center, radius, bgPaint);
 
-    // Progress arc
+    if (progress <= 0) return;
-    final color = isComplete ? const Color(0xFF10B981) : const Color(0xFF8B5CF6);
+
-    final fgPaint = Paint()
+    // 前景弧 — 渐变色
-      ..color = color
+    final sweepAngle = 2 * pi * progress;
+
+    if (isComplete) {
+      final completePaint = Paint()
+        ..color = const Color(0xFF10B981)
+        ..style = PaintingStyle.stroke
+        ..strokeWidth = 8
+        ..strokeCap = StrokeCap.round;
+      canvas.drawArc(rect, -pi / 2, sweepAngle, false, completePaint);
+      return;
+    }
+
+    // 渐变弧：主题色 → 主题色浅色
+    final gradient = SweepGradient(
+      startAngle: -pi / 2,
+      endAngle: -pi / 2 + sweepAngle,
+      colors: [
+        accentColor.withOpacity(0.4),
+        accentColor,
+      ],
+      stops: const [0.0, 1.0],
+      transform: const GradientRotation(-pi / 2),
+    );
+
+    final gradientPaint = Paint()
+      ..shader = gradient.createShader(rect)
       ..style = PaintingStyle.stroke
       ..strokeWidth = 8
       ..strokeCap = StrokeCap.round;
-    canvas.drawArc(
+
-      Rect.fromCircle(center: center, radius: radius),
+    canvas.drawArc(rect, -pi / 2, sweepAngle, false, gradientPaint);
-      -pi / 2,
-      2 * pi * progress,
-      false,
-      fgPaint,
-    );
   }
 
   @override
-  bool shouldRepaint(covariant _ProgressRingPainter oldDelegate) =>
+  bool shouldRepaint(covariant _GradientRingPainter oldDelegate) =>
-      oldDelegate.progress != progress || oldDelegate.isComplete != isComplete;
+      oldDelegate.progress != progress ||
+      oldDelegate.isComplete != isComplete ||
+      oldDelegate.accentColor != accentColor;
 }

airhub_app/lib/features/device/domain/entities/device.dart

@@ -3,6 +3,23 @@ import 'package:freezed_annotation/freezed_annotation.dart';
 part 'device.freezed.dart';
 part 'device.g.dart';
 
+/// API 有时返回完整对象，有时只返回整数 ID，需要容错
+class _SafeDeviceTypeConverter
+    implements JsonConverter<DeviceType?, Object?> {
+  const _SafeDeviceTypeConverter();
+
+  @override
+  DeviceType? fromJson(Object? json) {
+    if (json is Map<String, dynamic>) {
+      return DeviceType.fromJson(json);
+    }
+    return null; // 整数 ID 或 null → 忽略
+  }
+
+  @override
+  Object? toJson(DeviceType? object) => object?.toJson();
+}
+
 @freezed
 abstract class DeviceType with _$DeviceType {
   const factory DeviceType({
@@ -24,8 +41,8 @@ abstract class DeviceInfo with _$DeviceInfo {
   const factory DeviceInfo({
     required int id,
     required String sn,
-    DeviceType? deviceType,
+    @_SafeDeviceTypeConverter() DeviceType? deviceType,
-    DeviceType? deviceTypeInfo,
+    @_SafeDeviceTypeConverter() DeviceType? deviceTypeInfo,
     String? macAddress,
     @Default('') String name,
     @Default('in_stock') String status,

airhub_app/lib/features/device/domain/entities/device.freezed.dart

@@ -296,7 +296,7 @@ as String?,
 /// @nodoc
 mixin _$DeviceInfo {
 
- int get id; String get sn; DeviceType? get deviceType; DeviceType? get deviceTypeInfo; String? get macAddress; String get name; String get status; bool get isOnline; String get firmwareVersion; String? get lastOnlineAt; String? get createdAt;
+ int get id; String get sn;@_SafeDeviceTypeConverter() DeviceType? get deviceType;@_SafeDeviceTypeConverter() DeviceType? get deviceTypeInfo; String? get macAddress; String get name; String get status; bool get isOnline; String get firmwareVersion; String? get lastOnlineAt; String? get createdAt;
 /// Create a copy of DeviceInfo
 /// with the given fields replaced by the non-null parameter values.
 @JsonKey(includeFromJson: false, includeToJson: false)
@@ -329,7 +329,7 @@ abstract mixin class $DeviceInfoCopyWith<$Res>  {
   factory $DeviceInfoCopyWith(DeviceInfo value, $Res Function(DeviceInfo) _then) = _$DeviceInfoCopyWithImpl;
 @useResult
 $Res call({
- int id, String sn, DeviceType? deviceType, DeviceType? deviceTypeInfo, String? macAddress, String name, String status, bool isOnline, String firmwareVersion, String? lastOnlineAt, String? createdAt
+ int id, String sn,@_SafeDeviceTypeConverter() DeviceType? deviceType,@_SafeDeviceTypeConverter() DeviceType? deviceTypeInfo, String? macAddress, String name, String status, bool isOnline, String firmwareVersion, String? lastOnlineAt, String? createdAt
 });
 
 
@@ -468,7 +468,7 @@ return $default(_that);case _:
 /// }
 /// ```
 
-@optionalTypeArgs TResult maybeWhen<TResult extends Object?>(TResult Function( int id,  String sn,  DeviceType? deviceType,  DeviceType? deviceTypeInfo,  String? macAddress,  String name,  String status,  bool isOnline,  String firmwareVersion,  String? lastOnlineAt,  String? createdAt)?  $default,{required TResult orElse(),}) {final _that = this;
+@optionalTypeArgs TResult maybeWhen<TResult extends Object?>(TResult Function( int id,  String sn, @_SafeDeviceTypeConverter()  DeviceType? deviceType, @_SafeDeviceTypeConverter()  DeviceType? deviceTypeInfo,  String? macAddress,  String name,  String status,  bool isOnline,  String firmwareVersion,  String? lastOnlineAt,  String? createdAt)?  $default,{required TResult orElse(),}) {final _that = this;
 switch (_that) {
 case _DeviceInfo() when $default != null:
 return $default(_that.id,_that.sn,_that.deviceType,_that.deviceTypeInfo,_that.macAddress,_that.name,_that.status,_that.isOnline,_that.firmwareVersion,_that.lastOnlineAt,_that.createdAt);case _:
@@ -489,7 +489,7 @@ return $default(_that.id,_that.sn,_that.deviceType,_that.deviceTypeInfo,_that.ma
 /// }
 /// ```
 
-@optionalTypeArgs TResult when<TResult extends Object?>(TResult Function( int id,  String sn,  DeviceType? deviceType,  DeviceType? deviceTypeInfo,  String? macAddress,  String name,  String status,  bool isOnline,  String firmwareVersion,  String? lastOnlineAt,  String? createdAt)  $default,) {final _that = this;
+@optionalTypeArgs TResult when<TResult extends Object?>(TResult Function( int id,  String sn, @_SafeDeviceTypeConverter()  DeviceType? deviceType, @_SafeDeviceTypeConverter()  DeviceType? deviceTypeInfo,  String? macAddress,  String name,  String status,  bool isOnline,  String firmwareVersion,  String? lastOnlineAt,  String? createdAt)  $default,) {final _that = this;
 switch (_that) {
 case _DeviceInfo():
 return $default(_that.id,_that.sn,_that.deviceType,_that.deviceTypeInfo,_that.macAddress,_that.name,_that.status,_that.isOnline,_that.firmwareVersion,_that.lastOnlineAt,_that.createdAt);case _:
@@ -509,7 +509,7 @@ return $default(_that.id,_that.sn,_that.deviceType,_that.deviceTypeInfo,_that.ma
 /// }
 /// ```
 
-@optionalTypeArgs TResult? whenOrNull<TResult extends Object?>(TResult? Function( int id,  String sn,  DeviceType? deviceType,  DeviceType? deviceTypeInfo,  String? macAddress,  String name,  String status,  bool isOnline,  String firmwareVersion,  String? lastOnlineAt,  String? createdAt)?  $default,) {final _that = this;
+@optionalTypeArgs TResult? whenOrNull<TResult extends Object?>(TResult? Function( int id,  String sn, @_SafeDeviceTypeConverter()  DeviceType? deviceType, @_SafeDeviceTypeConverter()  DeviceType? deviceTypeInfo,  String? macAddress,  String name,  String status,  bool isOnline,  String firmwareVersion,  String? lastOnlineAt,  String? createdAt)?  $default,) {final _that = this;
 switch (_that) {
 case _DeviceInfo() when $default != null:
 return $default(_that.id,_that.sn,_that.deviceType,_that.deviceTypeInfo,_that.macAddress,_that.name,_that.status,_that.isOnline,_that.firmwareVersion,_that.lastOnlineAt,_that.createdAt);case _:
@@ -524,13 +524,13 @@ return $default(_that.id,_that.sn,_that.deviceType,_that.deviceTypeInfo,_that.ma
 @JsonSerializable()
 
 class _DeviceInfo implements DeviceInfo {
-  const _DeviceInfo({required this.id, required this.sn, this.deviceType, this.deviceTypeInfo, this.macAddress, this.name = '', this.status = 'in_stock', this.isOnline = false, this.firmwareVersion = '', this.lastOnlineAt, this.createdAt});
+  const _DeviceInfo({required this.id, required this.sn, @_SafeDeviceTypeConverter() this.deviceType, @_SafeDeviceTypeConverter() this.deviceTypeInfo, this.macAddress, this.name = '', this.status = 'in_stock', this.isOnline = false, this.firmwareVersion = '', this.lastOnlineAt, this.createdAt});
   factory _DeviceInfo.fromJson(Map<String, dynamic> json) => _$DeviceInfoFromJson(json);
 
 @override final  int id;
 @override final  String sn;
-@override final  DeviceType? deviceType;
+@override@_SafeDeviceTypeConverter() final  DeviceType? deviceType;
-@override final  DeviceType? deviceTypeInfo;
+@override@_SafeDeviceTypeConverter() final  DeviceType? deviceTypeInfo;
 @override final  String? macAddress;
 @override@JsonKey() final  String name;
 @override@JsonKey() final  String status;
@@ -572,7 +572,7 @@ abstract mixin class _$DeviceInfoCopyWith<$Res> implements $DeviceInfoCopyWith<$
   factory _$DeviceInfoCopyWith(_DeviceInfo value, $Res Function(_DeviceInfo) _then) = __$DeviceInfoCopyWithImpl;
 @override @useResult
 $Res call({
- int id, String sn, DeviceType? deviceType, DeviceType? deviceTypeInfo, String? macAddress, String name, String status, bool isOnline, String firmwareVersion, String? lastOnlineAt, String? createdAt
+ int id, String sn,@_SafeDeviceTypeConverter() DeviceType? deviceType,@_SafeDeviceTypeConverter() DeviceType? deviceTypeInfo, String? macAddress, String name, String status, bool isOnline, String firmwareVersion, String? lastOnlineAt, String? createdAt
 });
 
 

airhub_app/lib/features/device/domain/entities/device.g.dart

@@ -30,12 +30,10 @@ Map<String, dynamic> _$DeviceTypeToJson(_DeviceType instance) =>
 _DeviceInfo _$DeviceInfoFromJson(Map<String, dynamic> json) => _DeviceInfo(
   id: (json['id'] as num).toInt(),
   sn: json['sn'] as String,
-  deviceType: json['device_type'] == null
+  deviceType: const _SafeDeviceTypeConverter().fromJson(json['device_type']),
-      ? null
+  deviceTypeInfo: const _SafeDeviceTypeConverter().fromJson(
-      : DeviceType.fromJson(json['device_type'] as Map<String, dynamic>),
+    json['device_type_info'],
-  deviceTypeInfo: json['device_type_info'] == null
+  ),
-      ? null
-      : DeviceType.fromJson(json['device_type_info'] as Map<String, dynamic>),
   macAddress: json['mac_address'] as String?,
   name: json['name'] as String? ?? '',
   status: json['status'] as String? ?? 'in_stock',
@@ -45,20 +43,23 @@ _DeviceInfo _$DeviceInfoFromJson(Map<String, dynamic> json) => _DeviceInfo(
   createdAt: json['created_at'] as String?,
 );
 
-Map<String, dynamic> _$DeviceInfoToJson(_DeviceInfo instance) =>
+Map<String, dynamic> _$DeviceInfoToJson(
-    <String, dynamic>{
+  _DeviceInfo instance,
-      'id': instance.id,
+) => <String, dynamic>{
-      'sn': instance.sn,
+  'id': instance.id,
-      'device_type': instance.deviceType,
+  'sn': instance.sn,
-      'device_type_info': instance.deviceTypeInfo,
+  'device_type': const _SafeDeviceTypeConverter().toJson(instance.deviceType),
-      'mac_address': instance.macAddress,
+  'device_type_info': const _SafeDeviceTypeConverter().toJson(
-      'name': instance.name,
+    instance.deviceTypeInfo,
-      'status': instance.status,
+  ),
-      'is_online': instance.isOnline,
+  'mac_address': instance.macAddress,
-      'firmware_version': instance.firmwareVersion,
+  'name': instance.name,
-      'last_online_at': instance.lastOnlineAt,
+  'status': instance.status,
-      'created_at': instance.createdAt,
+  'is_online': instance.isOnline,
-    };
+  'firmware_version': instance.firmwareVersion,
+  'last_online_at': instance.lastOnlineAt,
+  'created_at': instance.createdAt,
+};
 
 _UserDevice _$UserDeviceFromJson(Map<String, dynamic> json) => _UserDevice(
   id: (json['id'] as num).toInt(),

airhub_app/lib/features/device/presentation/controllers/device_controller.dart

@@ -19,16 +19,16 @@ class DeviceController extends _$DeviceController {
     );
   }
 
-  Future<bool> bindDevice(String sn, {int? spiritId}) async {
+  /// 绑定设备，成功返回 null，失败返回错误信息
+  Future<String?> bindDevice(String sn, {int? spiritId}) async {
     final repository = ref.read(deviceRepositoryProvider);
     final result = await repository.bindDevice(sn, spiritId: spiritId);
-    if (!ref.mounted) return false;
+    if (!ref.mounted) return null; // 组件已卸载，绑定请求已发出，视为成功
     return result.fold(
-      (failure) => false,
+      (failure) => failure.message,
       (bindingId) {
-        if (!ref.mounted) return false;
+        if (ref.mounted) ref.invalidateSelf();
-        ref.invalidateSelf();
+        return null;
-        return true;
       },
     );
   }

airhub_app/lib/pages/bluetooth_page.dart

@@ -5,7 +5,6 @@ import 'package:flutter/material.dart';
 import 'package:flutter_blue_plus/flutter_blue_plus.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:go_router/go_router.dart';
-import 'package:google_fonts/google_fonts.dart';
 import 'package:permission_handler/permission_handler.dart';
 import 'package:flutter_svg/flutter_svg.dart';
 import '../core/services/ble_provisioning_service.dart';
@@ -14,6 +13,7 @@ import '../features/device/presentation/controllers/device_controller.dart';
 import '../widgets/animated_gradient_background.dart';
 import '../widgets/gradient_button.dart';
 import '../widgets/glass_dialog.dart';
+import '../theme/product_theme.dart';
 
 /// 设备类型
 enum DeviceType { plush, badgeAi, badge }
@@ -26,6 +26,7 @@ class MockDevice {
   final DeviceType type;
   final bool hasAI;
   final bool isNetworkRequired;
+  final String bindStatus; // unbound / bound_by_me / bound_by_other
   final BluetoothDevice? bleDevice;
 
   const MockDevice({
@@ -35,9 +36,12 @@ class MockDevice {
     required this.type,
     required this.hasAI,
     this.isNetworkRequired = true,
+    this.bindStatus = 'unbound',
     this.bleDevice,
   });
 
+  bool get isBoundByOther => bindStatus == 'bound_by_other';
+
   String get iconPath {
     switch (type) {
       case DeviceType.plush:
@@ -218,10 +222,19 @@ class _BluetoothPageState extends ConsumerState<BluetoothPage>
     });
 
     // 持续扫描（不设超时），由 _queryDeviceByMac 成功后停止
-    await FlutterBluePlus.startScan(
+    try {
-      timeout: const Duration(seconds: 30),
+      await FlutterBluePlus.startScan(
-      androidUsesFineLocation: true,
+        timeout: const Duration(seconds: 30),
-    );
+        androidUsesFineLocation: true,
+      );
+    } catch (e) {
+      // Web 平台: 用户取消 requestDevice() 选择器会抛出 FlutterBluePlusException
+      debugPrint('[BLE Scan] startScan 异常（用户可能取消了选择器）: $e');
+      if (mounted) {
+        setState(() => _isSearching = false);
+      }
+      return;
+    }
 
     // 30 秒兜底超时：如果始终没找到设备
     if (mounted && _isSearching) {
@@ -243,8 +256,10 @@ class _BluetoothPageState extends ConsumerState<BluetoothPage>
       _macInfoCache[mac] = data;
 
       final deviceTypeName = data['device_type']?['name'] as String? ?? '';
+      final productCode = data['device_type']?['product_code'] as String? ?? '';
       final sn = data['sn'] as String? ?? '';
       final isNetworkRequired = data['device_type']?['is_network_required'] as bool? ?? true;
+      final bindStatus = data['bind_status'] as String? ?? 'unbound';
       final bleDevice = _pendingBleDevices[mac];
 
       // API 返回了有效设备名 → 添加到列表
@@ -257,9 +272,10 @@ class _BluetoothPageState extends ConsumerState<BluetoothPage>
             sn: sn,
             name: displayName,
             macAddress: mac,
-            type: _inferDeviceType(displayName),
+            type: _inferDeviceTypeByCode(productCode, displayName),
             hasAI: _inferHasAI(displayName),
             isNetworkRequired: isNetworkRequired,
+            bindStatus: bindStatus,
             bleDevice: bleDevice,
           ));
         }
@@ -273,36 +289,45 @@ class _BluetoothPageState extends ConsumerState<BluetoothPage>
       debugPrint('[Bluetooth] 设备已就绪: $mac → $displayName');
     } catch (e) {
       debugPrint('[Bluetooth] queryByMac 失败($mac): $e');
-      // API 查询失败时，用 BLE 名作为 fallback 也显示出来
       if (!mounted) return;
-      final bleDevice = _pendingBleDevices[mac];
+      // 查询失败 → 停止扫描，提示用户
-      setState(() {
+      setState(() => _isSearching = false);
-        if (!_devices.any((d) => d.macAddress == mac)) {
-          _devices.add(MockDevice(
-            sn: '',
-            name: '${_airhubPrefix}设备',
-            macAddress: mac,
-            type: DeviceType.plush,
-            hasAI: true,
-            bleDevice: bleDevice,
-          ));
-        }
-        _isSearching = false;
-      });
       try { await FlutterBluePlus.stopScan(); } catch (_) {}
+      _macInfoCache.remove(mac); // 移除占位，允许重新扫描时再查
+      showGlassDialog(
+        context: context,
+        title: '设备查询失败',
+        description: '无法验证设备信息，请检查网络后重试。',
+        confirmText: '确定',
+        onConfirm: () => Navigator.of(context).pop(),
+      );
     }
   }
 
   /// 根据设备名称推断设备类型
-  DeviceType _inferDeviceType(String name) {
+  /// 优先用 product_code 精确匹配，fallback 到名称推断
+  DeviceType _inferDeviceTypeByCode(String productCode, String name) {
+    // product_code 精确匹配
+    switch (productCode) {
+      case 'KPBL-ON':
+        return DeviceType.plush;
+      case 'DZBJ-ON':
+        return DeviceType.badgeAi;
+      case 'DZBJ-OFF':
+        return DeviceType.badge;
+    }
+    // fallback: 名称推断
     final lower = name.toLowerCase();
-    if (lower.contains('plush') || lower.contains('卡皮巴拉') || lower.contains('机芯') || lower.contains('airhub')) {
+    if (lower.contains('plush') || lower.contains('卡皮巴拉') || lower.contains('机芯')) {
       return DeviceType.plush;
     }
     if (lower.contains('ai') || lower.contains('智能')) {
       return DeviceType.badgeAi;
     }
-    return DeviceType.badge;
+    if (lower.contains('吧唧') || lower.contains('badge')) {
+      return DeviceType.badge;
+    }
+    return DeviceType.plush;
   }
 
   /// 根据设备名称推断是否支持 AI
@@ -354,6 +379,21 @@ class _BluetoothPageState extends ConsumerState<BluetoothPage>
 
   bool _isConnecting = false;
 
+  /// 根据设备类型设置产品主题并跳转到对应业务页面
+  void _setThemeAndNavigate(DeviceType type) {
+    switch (type) {
+      case DeviceType.badgeAi:
+        ref.read(currentProductTypeProvider.notifier).set(ProductType.badgeAi);
+        context.go('/badge-control');
+      case DeviceType.badge:
+        ref.read(currentProductTypeProvider.notifier).set(ProductType.badgeBasic);
+        context.go('/badge-basic-control');
+      case DeviceType.plush:
+        ref.read(currentProductTypeProvider.notifier).set(ProductType.capybara);
+        context.go('/device-control');
+    }
+  }
+
   /// 连接设备
   Future<void> _handleConnect() async {
     if (_devices.isEmpty || _isConnecting) return;
@@ -365,11 +405,55 @@ class _BluetoothPageState extends ConsumerState<BluetoothPage>
     }
 
     final device = _devices[_currentIndex];
-    debugPrint('[Bluetooth] 连接设备: sn=${device.sn}, mac=${device.macAddress}, needsNetwork=${device.isNetworkRequired}');
+    debugPrint('[Bluetooth] 连接设备: sn=${device.sn}, mac=${device.macAddress}, bindStatus=${device.bindStatus}');
+
+    // 设备已被其他用户绑定 → 拦截
+    if (device.isBoundByOther) {
+      showGlassDialog(
+        context: context,
+        title: '无法连接',
+        description: '该设备已被其他用户绑定，无法使用。如需解绑请联系设备所有者。',
+        confirmText: '确定',
+        onConfirm: () => Navigator.of(context).pop(),
+      );
+      return;
+    }
 
     if (!device.isNetworkRequired) {
-      // 不需要联网 -> 直接去设备控制页
+      // 不需要联网 -> 跳过配网，绑定设备后进入业务页
-      context.go('/device-control');
+      if (device.sn.isNotEmpty) {
+        setState(() => _isConnecting = true);
+        try {
+          final error = await ref.read(deviceControllerProvider.notifier).bindDevice(device.sn);
+          if (!mounted) return;
+          if (error != null) {
+            setState(() => _isConnecting = false);
+            showGlassDialog(
+              context: context,
+              title: '绑定失败',
+              description: error,
+              confirmText: '确定',
+              onConfirm: () => Navigator.of(context).pop(),
+            );
+            return;
+          }
+        } catch (e) {
+          debugPrint('[Bluetooth] bindDevice 异常: $e');
+          if (!mounted) return;
+          setState(() => _isConnecting = false);
+          showGlassDialog(
+            context: context,
+            title: '绑定失败',
+            description: '$e',
+            confirmText: '确定',
+            onConfirm: () => Navigator.of(context).pop(),
+          );
+          return;
+        }
+        if (!mounted) return;
+        setState(() => _isConnecting = false);
+      }
+      _setThemeAndNavigate(device.type);
       return;
     }
 
@@ -378,11 +462,23 @@ class _BluetoothPageState extends ConsumerState<BluetoothPage>
       debugPrint('[Bluetooth] Web 环境，直接绑定 sn=${device.sn}');
       setState(() => _isConnecting = true);
       if (device.sn.isNotEmpty) {
-        await ref.read(deviceControllerProvider.notifier).bindDevice(device.sn);
+        final error = await ref.read(deviceControllerProvider.notifier).bindDevice(device.sn);
+        if (!mounted) return;
+        if (error != null) {
+          setState(() => _isConnecting = false);
+          showGlassDialog(
+            context: context,
+            title: '绑定失败',
+            description: error,
+            confirmText: '确定',
+            onConfirm: () => Navigator.of(context).pop(),
+          );
+          return;
+        }
       }
       if (!mounted) return;
       setState(() => _isConnecting = false);
-      context.go('/device-control');
+      _setThemeAndNavigate(device.type);
       return;
     }
 
@@ -473,7 +569,13 @@ class _BluetoothPageState extends ConsumerState<BluetoothPage>
         children: [
           // 返回按钮 - CSS: border-radius: 12px, bg: rgba(255,255,255,0.6), no border
           GestureDetector(
-            onTap: () => context.go('/home'),
+            onTap: () {
+              if (context.canPop()) {
+                context.pop();
+              } else {
+                context.go('/');
+              }
+            },
             child: Container(
               width: 40,
               height: 40,
@@ -494,7 +596,7 @@ class _BluetoothPageState extends ConsumerState<BluetoothPage>
             child: Text(
               '搜索设备',
               textAlign: TextAlign.center,
-              style: GoogleFonts.outfit(
+              style: TextStyle(fontFamily: 'Outfit',
                 fontSize: 17,
                 fontWeight: FontWeight.w600,
                 color: const Color(0xFF1F2937),
@@ -566,7 +668,7 @@ class _BluetoothPageState extends ConsumerState<BluetoothPage>
               height: 120,
               placeholderBuilder: (_) => Text(
                 '?',
-                style: GoogleFonts.outfit(
+                style: TextStyle(fontFamily: 'Outfit',
                   fontSize: 48,
                   fontWeight: FontWeight.w700,
                   color: const Color(0xFFF59E0B), // Amber color per HTML
@@ -735,12 +837,25 @@ class _BluetoothPageState extends ConsumerState<BluetoothPage>
         // 设备名称
         Text(
           device.name,
-          style: GoogleFonts.outfit(
+          style: TextStyle(fontFamily: 'Outfit',
             fontSize: 18,
             fontWeight: FontWeight.w600,
-            color: const Color(0xFF1F2937),
+            color: device.isBoundByOther
+                ? const Color(0xFF9CA3AF)
+                : const Color(0xFF1F2937),
           ),
         ),
+        // 已被其他用户绑定提示
+        if (device.isBoundByOther) ...[
+          const SizedBox(height: 4),
+          Text(
+            '已被其他用户绑定',
+            style: TextStyle(
+              fontSize: 12,
+              color: const Color(0xFFEF4444),
+            ),
+          ),
+        ],
       ],
     );
   }
@@ -798,7 +913,13 @@ class _BluetoothPageState extends ConsumerState<BluetoothPage>
         children: [
           // 取消按钮 - HTML: frosted glass with border
           GestureDetector(
-            onTap: () => context.go('/home'),
+            onTap: () {
+              if (context.canPop()) {
+                context.pop();
+              } else {
+                context.go('/');
+              }
+            },
             child: ClipRRect(
               borderRadius: BorderRadius.circular(25),
               child: Container(

airhub_app/lib/pages/device_control_page.dart

@@ -2,7 +2,6 @@ import 'dart:math';
 import 'dart:ui';
 import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
-import 'package:google_fonts/google_fonts.dart';
 import 'package:flutter_svg/flutter_svg.dart';
 import '../core/network/api_client.dart';
 import 'story_detail_page.dart';
@@ -19,6 +18,7 @@ import '../widgets/ios_toast.dart';
 import '../widgets/animated_gradient_background.dart';
 import '../widgets/gradient_button.dart';
 import '../features/device/presentation/controllers/device_controller.dart';
+import '../theme/product_theme.dart';
 
 class DeviceControlPage extends ConsumerStatefulWidget {
   const DeviceControlPage({super.key});
@@ -48,6 +48,7 @@ class _DeviceControlPageState extends ConsumerState<DeviceControlPage>
   @override
   void initState() {
     super.initState();
+    Future.microtask(() => ref.read(currentProductTypeProvider.notifier).set(ProductType.capybara));
     _mascotAnimController = AnimationController(
       vsync: this,
       duration: const Duration(seconds: 4),
@@ -301,7 +302,7 @@ class _DeviceControlPageState extends ConsumerState<DeviceControlPage>
           const SizedBox(width: 8),
           Text(
             statusText,
-            style: GoogleFonts.dmSans(
+            style: TextStyle(fontFamily: 'DM Sans',
               fontSize: 13,
               fontWeight: FontWeight.w600,
               color: const Color(0xFF4B5563),
@@ -325,7 +326,7 @@ class _DeviceControlPageState extends ConsumerState<DeviceControlPage>
           const SizedBox(width: 4),
           Text(
             batteryText,
-            style: GoogleFonts.dmSans(
+            style: TextStyle(fontFamily: 'DM Sans',
               fontSize: 13,
               fontWeight: FontWeight.w600,
               color: const Color(0xFF4B5563),

airhub_app/lib/pages/home_page.dart

@@ -1,6 +1,5 @@
 import 'package:flutter/material.dart';
 import 'package:go_router/go_router.dart';
-import 'package:google_fonts/google_fonts.dart';
 
 import '../theme/app_colors.dart';
 import '../widgets/animated_gradient_background.dart';
@@ -88,7 +87,7 @@ class _HomePageState extends State<HomePage>
       child: Text(
         'Airhub',
         // Use Press Start 2P pixel font per HTML CSS
-        style: GoogleFonts.pressStart2p(
+        style: TextStyle(fontFamily: 'Press Start 2P',
           fontSize: 28,
           color: const Color(0xFF6366F1), // 靛蓝
           letterSpacing: 2,
@@ -239,7 +238,7 @@ class _HomePageState extends State<HomePage>
                 child: Center(
                   child: Text(
                     '立即连接',
-                    style: GoogleFonts.dmSans(
+                    style: TextStyle(fontFamily: 'DM Sans',
                       fontSize: 17,
                       fontWeight: FontWeight.w600,
                       color: Colors.white,

airhub_app/lib/pages/login_page.dart

@@ -2,7 +2,6 @@ import 'dart:async';
 import 'package:flutter/material.dart';
 import 'package:flutter/services.dart';
 import 'package:go_router/go_router.dart';
-import 'package:google_fonts/google_fonts.dart';
 
 import '../theme/app_colors.dart';
 import '../widgets/gradient_button.dart';
@@ -58,7 +57,7 @@ class _LoginPageState extends State<LoginPage> with TickerProviderStateMixin {
             // Title
             Text(
               '服务协议',
-              style: GoogleFonts.outfit(
+              style: TextStyle(fontFamily: 'Outfit',
                 fontSize: 18,
                 fontWeight: FontWeight.w600,
                 color: const Color(0xFF1F2937),
@@ -326,7 +325,7 @@ class _LoginPageState extends State<LoginPage> with TickerProviderStateMixin {
             padding: const EdgeInsets.only(top: 32),
             child: Text(
               'Airhub',
-              style: GoogleFonts.pressStart2p(
+              style: TextStyle(fontFamily: 'Press Start 2P',
                 fontSize: 28,
                 color: const Color(0xFF6366F1),
                 letterSpacing: 2,
@@ -502,7 +501,7 @@ class _LoginPageState extends State<LoginPage> with TickerProviderStateMixin {
                         // Heading - font-size: 32px, font-weight: 700
                         Text(
                           '欢迎使用 Airhub',
-                          style: GoogleFonts.outfit(
+                          style: TextStyle(fontFamily: 'Outfit',
                             fontSize: 32,
                             fontWeight: FontWeight.w700,
                             color: const Color(0xFF6B5B95),

airhub_app/lib/pages/music_creation_page.dart

@@ -2,7 +2,6 @@ import 'dart:math';
 import 'dart:ui';
 import 'package:flutter/material.dart';
 import 'package:flutter/services.dart' show PlatformException;
-import 'package:google_fonts/google_fonts.dart';
 import 'package:just_audio/just_audio.dart';
 import '../services/music_generation_service.dart';
 import '../widgets/animated_gradient_background.dart';
@@ -801,7 +800,7 @@ class _MusicCreationPageState extends State<MusicCreationPage>
             child: Text(
               '灵感电台',
               textAlign: TextAlign.center,
-              style: GoogleFonts.outfit(
+              style: TextStyle(fontFamily: 'Outfit',
                 fontSize: 17,
                 fontWeight: FontWeight.w600,
                 color: const Color(0xFF1F2937),
@@ -1108,7 +1107,7 @@ class _MusicCreationPageState extends State<MusicCreationPage>
                   track.lyrics.isNotEmpty
                       ? _cleanLyrics(track.lyrics)
                       : '生成音乐后\n点我看歌词',
-                  style: GoogleFonts.dmSans(
+                  style: TextStyle(fontFamily: 'DM Sans',
                     fontSize: 12,
                     height: 1.6,
                     color: track.lyrics.isNotEmpty
@@ -1170,7 +1169,7 @@ class _MusicCreationPageState extends State<MusicCreationPage>
               ),
               child: Text(
                 bubbleText,
-                style: GoogleFonts.dmSans(
+                style: TextStyle(fontFamily: 'DM Sans',
                   fontSize: 12.5,
                   fontWeight: FontWeight.w500,
                   color: const Color(0xFF6B4423),
@@ -1227,7 +1226,7 @@ class _MusicCreationPageState extends State<MusicCreationPage>
                           child: Text(
                             _currentTime,
                             textAlign: TextAlign.center,
-                            style: GoogleFonts.dmSans(
+                            style: TextStyle(fontFamily: 'DM Sans',
                               fontSize: 12,
                               color: const Color(0xFF6B7280),
                               fontFeatures: const [FontFeature.tabularFigures()],
@@ -1277,7 +1276,7 @@ class _MusicCreationPageState extends State<MusicCreationPage>
                           child: Text(
                             _totalTime,
                             textAlign: TextAlign.center,
-                            style: GoogleFonts.dmSans(
+                            style: TextStyle(fontFamily: 'DM Sans',
                               fontSize: 12,
                               color: const Color(0xFF6B7280),
                               fontFeatures: const [FontFeature.tabularFigures()],
@@ -1434,7 +1433,7 @@ class _MusicCreationPageState extends State<MusicCreationPage>
               children: [
                 Text(
                   mood['title'] as String,
-                  style: GoogleFonts.outfit(
+                  style: TextStyle(fontFamily: 'Outfit',
                     fontSize: 14,
                     fontWeight: isActive ? FontWeight.w700 : FontWeight.w600,
                     color: isActive
@@ -1447,7 +1446,7 @@ class _MusicCreationPageState extends State<MusicCreationPage>
                 const SizedBox(height: 2),
                 Text(
                   mood['desc'] as String,
-                  style: GoogleFonts.dmSans(
+                  style: TextStyle(fontFamily: 'DM Sans',
                     fontSize: 11,
                     color: isActive
                         ? const Color(0xFF6B7280)
@@ -1908,7 +1907,7 @@ class _InputModalContent extends StatelessWidget {
               children: [
                 Text(
                   '自由创作',
-                  style: GoogleFonts.outfit(
+                  style: TextStyle(fontFamily: 'Outfit',
                     fontSize: 16,
                     fontWeight: FontWeight.w600,
                     color: const Color(0xFF374151),
@@ -1935,7 +1934,7 @@ class _InputModalContent extends StatelessWidget {
               alignment: Alignment.centerLeft,
               child: Text(
                 '描述你想要的音乐氛围、场景或情绪',
-                style: GoogleFonts.dmSans(
+                style: TextStyle(fontFamily: 'DM Sans',
                   fontSize: 12,
                   color: const Color(0xFF9CA3AF),
                 ),
@@ -1950,11 +1949,11 @@ class _InputModalContent extends StatelessWidget {
                 controller: controller,
                 minLines: 4,
                 maxLines: 6,
-                style: GoogleFonts.dmSans(
+                style: TextStyle(fontFamily: 'DM Sans',
                     fontSize: 14, color: const Color(0xFF374151)),
                 decoration: InputDecoration(
                   hintText: '例如：水豚在雨中等公交，心情却很平静...',
-                  hintStyle: GoogleFonts.dmSans(
+                  hintStyle: TextStyle(fontFamily: 'DM Sans',
                       fontSize: 14, color: const Color(0xFF9CA3AF)),
                   filled: true,
                   fillColor: Colors.black.withOpacity(0.03),
@@ -2099,7 +2098,7 @@ class _PlaylistModalContentState extends State<_PlaylistModalContent>
             children: [
               Text(
                 '我的唱片架',
-                style: GoogleFonts.outfit(
+                style: TextStyle(fontFamily: 'Outfit',
                   fontSize: 15,
                   fontWeight: FontWeight.w600,
                   color: const Color(0xFF374151),
@@ -2266,7 +2265,7 @@ class _PlaylistModalContentState extends State<_PlaylistModalContent>
                             Flexible(
                               child: Text(
                                 track.title,
-                                style: GoogleFonts.dmSans(
+                                style: TextStyle(fontFamily: 'DM Sans',
                                   fontSize: 12,
                                   fontWeight: isCurrent ? FontWeight.w600 : FontWeight.w500,
                                   color: isCurrent

airhub_app/lib/pages/product_selection_page.dart

@@ -1,11 +1,11 @@
 import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:go_router/go_router.dart';
-import 'package:google_fonts/google_fonts.dart';
 import 'package:flutter_svg/flutter_svg.dart';
 import '../widgets/animated_gradient_background.dart';
 import '../features/device/presentation/controllers/device_controller.dart';
 import '../features/device/domain/entities/device.dart';
+import '../theme/product_theme.dart';
 
 class ProductSelectionPage extends ConsumerStatefulWidget {
   const ProductSelectionPage({super.key});
@@ -38,6 +38,13 @@ class _ProductSelectionPageState extends ConsumerState<ProductSelectionPage> {
     'badge-basic': ['DZBJ-OFF'],
   };
 
+  /// 产品 ID 到 ProductType 的映射
+  static const Map<String, ProductType> _productTypeMap = {
+    'capybara': ProductType.capybara,
+    'badge-ai': ProductType.badgeAi,
+    'badge-basic': ProductType.badgeBasic,
+  };
+
   /// 查找用户是否已绑定该产品类型的设备
   UserDevice? _findBoundDevice(String productId, List<UserDevice> devices) {
     final codes = _productCodeMap[productId];
@@ -190,12 +197,23 @@ class _ProductSelectionPageState extends ConsumerState<ProductSelectionPage> {
                   fadeStartY: headerHeight + 16,
                   fadeEndY: safeTop,
                   onTap: () {
+                    // 设置当前产品主题
+                    final productType = _productTypeMap[product['id']] ?? ProductType.common;
+                    ref.read(currentProductTypeProvider.notifier).set(productType);
+
                     if (boundDevice != null) {
-                      // 已绑定 → 直接进入设备控制页
+                      // 已绑定 → 根据产品类型进入对应控制页
-                      context.go('/device-control');
+                      final pid = product['id'] as String;
+                      if (pid == 'badge-ai') {
+                        context.go('/badge-control');
+                      } else if (pid == 'badge-basic') {
+                        context.go('/badge-basic-control');
+                      } else {
+                        context.go('/device-control');
+                      }
                     } else {
-                      // 未绑定 → 跳转蓝牙搜索页
+                      // 未绑定 → 跳转蓝牙搜索页（push 保留返回栈）
-                      context.go('/bluetooth');
+                      context.push('/bluetooth');
                     }
                   },
                 );
@@ -214,7 +232,7 @@ class _ProductSelectionPageState extends ConsumerState<ProductSelectionPage> {
                 children: [
                   Text(
                     '选择产品',
-                    style: GoogleFonts.outfit(
+                    style: TextStyle(fontFamily: 'Outfit',
                       fontSize: 17,
                       fontWeight: FontWeight.w600,
                       color: const Color(0xFF1F2937),
@@ -346,7 +364,7 @@ class _ProductCard extends StatelessWidget {
                 children: [
                   Text(
                     product['name'],
-                    style: GoogleFonts.outfit(
+                    style: TextStyle(fontFamily: 'Outfit',
                       fontSize: 19,
                       fontWeight: FontWeight.bold,
                       color: Colors.white,

airhub_app/lib/pages/settings_page.dart

@@ -1,7 +1,6 @@
 import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:go_router/go_router.dart';
-import 'package:google_fonts/google_fonts.dart';
 import '../widgets/glass_dialog.dart';
 import '../widgets/animated_gradient_background.dart';
 import '../widgets/ios_toast.dart';
@@ -100,7 +99,7 @@ class _SettingsPageState extends ConsumerState<SettingsPage> {
                     ),
                     Text(
                       '设置',
-                      style: GoogleFonts.outfit(
+                      style: TextStyle(fontFamily: 'Outfit',
                         fontSize: 16,
                         fontWeight: FontWeight.w600,
                         color: const Color(0xFF1F2937),

airhub_app/lib/pages/wifi_config_page.dart

@@ -2,12 +2,14 @@ import 'dart:async';
 import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:go_router/go_router.dart';
-import 'package:google_fonts/google_fonts.dart';
 import 'package:flutter_svg/flutter_svg.dart';
 import '../core/services/ble_provisioning_service.dart';
+import '../features/device/data/datasources/device_remote_data_source.dart';
 import '../features/device/presentation/controllers/device_controller.dart';
 import '../widgets/animated_gradient_background.dart';
 import '../widgets/gradient_button.dart';
+import '../widgets/glass_dialog.dart';
+import '../theme/product_theme.dart';
 
 class WifiConfigPage extends ConsumerStatefulWidget {
   final Map<String, dynamic>? extra;
@@ -132,18 +134,74 @@ class _WifiConfigPageState extends ConsumerState<WifiConfigPage>
       if (_isBinding) return;
       setState(() => _isBinding = true);
 
+      // 绑定前再次检查设备归属（防止 BLE 扫描时检查遗漏）
+      final mac = _deviceInfo['mac'] as String? ?? '';
+      if (mac.isNotEmpty) {
+        try {
+          final dataSource = ref.read(deviceRemoteDataSourceProvider);
+          final macData = await dataSource.queryByMac(mac);
+          final bindStatus = macData['bind_status'] as String? ?? 'unbound';
+          if (bindStatus == 'bound_by_other') {
+            if (!mounted) return;
+            setState(() => _isBinding = false);
+            showGlassDialog(
+              context: context,
+              title: '无法绑定',
+              description: '该设备已被其他用户绑定，无法使用。如需解绑请联系设备所有者。',
+              confirmText: '确定',
+              onConfirm: () => Navigator.of(context).pop(),
+            );
+            return;
+          }
+        } catch (e) {
+          debugPrint('[WiFi Config] 检查设备归属失败: $e');
+        }
+      }
+
       final sn = _deviceInfo['sn'] as String? ?? '';
       if (sn.isNotEmpty) {
         try {
           debugPrint('[WiFi Config] Binding device sn=$sn');
-          await ref.read(deviceControllerProvider.notifier).bindDevice(sn);
+          final error = await ref.read(deviceControllerProvider.notifier).bindDevice(sn);
+          if (!mounted) return;
+          if (error != null) {
+            setState(() => _isBinding = false);
+            showGlassDialog(
+              context: context,
+              title: '绑定失败',
+              description: error,
+              confirmText: '确定',
+              onConfirm: () => Navigator.of(context).pop(),
+            );
+            return;
+          }
         } catch (e) {
           debugPrint('[WiFi Config] bindDevice 异常: $e');
+          if (!mounted) return;
+          setState(() => _isBinding = false);
+          showGlassDialog(
+            context: context,
+            title: '绑定失败',
+            description: '$e',
+            confirmText: '确定',
+            onConfirm: () => Navigator.of(context).pop(),
+          );
+          return;
         }
       }
       if (!mounted) return;
       setState(() => _isBinding = false);
-      context.go('/device-control');
+      final deviceType = _deviceInfo['type'] as String? ?? '';
+      if (deviceType == 'badgeAi') {
+        ref.read(currentProductTypeProvider.notifier).set(ProductType.badgeAi);
+        context.go('/badge-control');
+      } else if (deviceType == 'badge') {
+        ref.read(currentProductTypeProvider.notifier).set(ProductType.badgeBasic);
+        context.go('/badge-basic-control');
+      } else {
+        ref.read(currentProductTypeProvider.notifier).set(ProductType.capybara);
+        context.go('/device-control');
+      }
       return;
     }
 
@@ -298,7 +356,7 @@ class _WifiConfigPageState extends ConsumerState<WifiConfigPage>
             child: Text(
               'WiFi配网',
               textAlign: TextAlign.center,
-              style: GoogleFonts.outfit(
+              style: TextStyle(fontFamily: 'Outfit',
                 fontSize: 17,
                 fontWeight: FontWeight.w600,
                 color: const Color(0xFF1F2937),
@@ -362,7 +420,7 @@ class _WifiConfigPageState extends ConsumerState<WifiConfigPage>
         ),
         Text(
           '选择WiFi网络',
-          style: GoogleFonts.outfit(
+          style: TextStyle(fontFamily: 'Outfit',
             fontSize: 20,
             fontWeight: FontWeight.bold,
             color: const Color(0xFF1F2937),
@@ -504,7 +562,7 @@ class _WifiConfigPageState extends ConsumerState<WifiConfigPage>
         ),
         Text(
           _selectedWifiSsid,
-          style: GoogleFonts.outfit(
+          style: TextStyle(fontFamily: 'Outfit',
             fontSize: 20,
             fontWeight: FontWeight.bold,
             color: const Color(0xFF1F2937),
@@ -572,7 +630,7 @@ class _WifiConfigPageState extends ConsumerState<WifiConfigPage>
         ),
         Text(
           '正在配网...',
-          style: GoogleFonts.outfit(
+          style: TextStyle(fontFamily: 'Outfit',
             fontSize: 20,
             fontWeight: FontWeight.bold,
             color: const Color(0xFF1F2937),
@@ -688,7 +746,7 @@ class _WifiConfigPageState extends ConsumerState<WifiConfigPage>
         const SizedBox(height: 24),
         Text(
           '配网成功!',
-          style: GoogleFonts.outfit(
+          style: TextStyle(fontFamily: 'Outfit',
             fontSize: 24,
             fontWeight: FontWeight.bold,
             color: const Color(0xFF1F2937),

airhub_app/lib/theme/app_theme.dart

@@ -1,11 +1,10 @@
 import 'package:flutter/material.dart';
-import 'package:google_fonts/google_fonts.dart';
 import 'app_colors.dart';
 
 class AppTheme {
   static ThemeData get lightTheme {
     // Base text theme with DM Sans (PRD: 正文/UI 字体)
-    final baseTextTheme = GoogleFonts.dmSansTextTheme(const TextTheme(
+    final baseTextTheme = const TextTheme(
       // h1 / Large Headings
       displayLarge: TextStyle(
         color: AppColors.textPrimary,
@@ -40,19 +39,19 @@ class AppTheme {
         fontWeight: FontWeight.w600,
         letterSpacing: 0.5,
       ),
-    ));
+    ).apply(fontFamily: 'DM Sans');
 
     // Apply Outfit to heading styles (PRD: 标题/Display 字体)
     final textTheme = baseTextTheme.copyWith(
-      displayLarge: GoogleFonts.outfit(textStyle: baseTextTheme.displayLarge),
+      displayLarge: baseTextTheme.displayLarge?.copyWith(fontFamily: 'Outfit'),
-      displayMedium: GoogleFonts.outfit(textStyle: baseTextTheme.displayMedium),
+      displayMedium: baseTextTheme.displayMedium?.copyWith(fontFamily: 'Outfit'),
-      displaySmall: GoogleFonts.outfit(textStyle: baseTextTheme.displaySmall),
+      displaySmall: baseTextTheme.displaySmall?.copyWith(fontFamily: 'Outfit'),
-      headlineLarge: GoogleFonts.outfit(textStyle: baseTextTheme.headlineLarge),
+      headlineLarge: baseTextTheme.headlineLarge?.copyWith(fontFamily: 'Outfit'),
-      headlineMedium: GoogleFonts.outfit(textStyle: baseTextTheme.headlineMedium),
+      headlineMedium: baseTextTheme.headlineMedium?.copyWith(fontFamily: 'Outfit'),
-      headlineSmall: GoogleFonts.outfit(textStyle: baseTextTheme.headlineSmall),
+      headlineSmall: baseTextTheme.headlineSmall?.copyWith(fontFamily: 'Outfit'),
-      titleLarge: GoogleFonts.outfit(textStyle: baseTextTheme.titleLarge),
+      titleLarge: baseTextTheme.titleLarge?.copyWith(fontFamily: 'Outfit'),
-      titleMedium: GoogleFonts.outfit(textStyle: baseTextTheme.titleMedium),
+      titleMedium: baseTextTheme.titleMedium?.copyWith(fontFamily: 'Outfit'),
-      titleSmall: GoogleFonts.outfit(textStyle: baseTextTheme.titleSmall),
+      titleSmall: baseTextTheme.titleSmall?.copyWith(fontFamily: 'Outfit'),
     );
 
     return ThemeData(
@@ -67,7 +66,7 @@ class AppTheme {
         background: AppColors.bgBase,
       ),
       // PRD: DM Sans 为默认正文字体，回退到系统字体
-      fontFamily: GoogleFonts.dmSans().fontFamily,
+      fontFamily: 'DM Sans',
       fontFamilyFallback: const [
         'Roboto',
         'PingFang SC',

airhub_app/lib/theme/design_tokens.dart

@@ -1,5 +1,4 @@
 import 'package:flutter/material.dart';
-import 'package:google_fonts/google_fonts.dart';
 
 /// 颜色定义 - 精确还原 Profile PRD
 class AppColors {
@@ -111,77 +110,77 @@ class AppColors {
 /// 字体样式 - PRD规范: Outfit(标题) + DM Sans(正文) + Press Start 2P(Logo)
 class AppTextStyles {
   // 页面标题 — 统一规范: 17px w600 #1F2937
-  static final TextStyle title = GoogleFonts.outfit(
+  static final TextStyle title = TextStyle(fontFamily: 'Outfit',
     fontSize: 17,
     fontWeight: FontWeight.w600,
     color: const Color(0xFF1F2937),
   );
 
   // User Name → Outfit (heading/display)
-  static final TextStyle userName = GoogleFonts.outfit(
+  static final TextStyle userName = TextStyle(fontFamily: 'Outfit',
     fontSize: 20,
     fontWeight: FontWeight.w600,
     color: AppColors.textPrimary,
   );
 
   // User ID → DM Sans (body)
-  static final TextStyle userId = GoogleFonts.dmSans(
+  static final TextStyle userId = TextStyle(fontFamily: 'DM Sans',
     fontSize: 13,
     fontWeight: FontWeight.w400,
     color: AppColors.textSecondary,
   );
 
   // Menu Text → DM Sans (body/UI)
-  static final TextStyle menuText = GoogleFonts.dmSans(
+  static final TextStyle menuText = TextStyle(fontFamily: 'DM Sans',
     fontSize: 16,
     fontWeight: FontWeight.w400,
     color: AppColors.textPrimary,
   );
 
   // Badge Text → DM Sans (small UI)
-  static final TextStyle badge = GoogleFonts.dmSans(
+  static final TextStyle badge = TextStyle(fontFamily: 'DM Sans',
     fontSize: 10,
     fontWeight: FontWeight.w400,
     color: Colors.white,
   );
 
   // Modal Title → Outfit (heading)
-  static final TextStyle modalTitle = GoogleFonts.outfit(
+  static final TextStyle modalTitle = TextStyle(fontFamily: 'Outfit',
     fontSize: 18,
     fontWeight: FontWeight.w600,
     color: AppColors.textPrimary,
   );
 
   // Book specific styles → Outfit (heading)
-  static final TextStyle bookTitle = GoogleFonts.outfit(
+  static final TextStyle bookTitle = TextStyle(fontFamily: 'Outfit',
     fontSize: 18,
     fontWeight: FontWeight.w700,
     color: AppColors.textPrimary,
   );
 
   // Book count → DM Sans (body)
-  static final TextStyle bookCount = GoogleFonts.dmSans(
+  static final TextStyle bookCount = TextStyle(fontFamily: 'DM Sans',
     fontSize: 13,
     fontWeight: FontWeight.w600,
     color: AppColors.textSecondary,
   );
 
   // Slot title → DM Sans (small UI)
-  static final TextStyle slotTitle = GoogleFonts.dmSans(
+  static final TextStyle slotTitle = TextStyle(fontFamily: 'DM Sans',
     fontSize: 10,
     color: Colors.white,
     fontWeight: FontWeight.w400,
   );
 
   // PRD: font-size: 24px, color: #9CA3AF, font-weight: 300, opacity: 0.7
-  static final TextStyle emptyPlus = GoogleFonts.dmSans(
+  static final TextStyle emptyPlus = TextStyle(fontFamily: 'DM Sans',
     fontSize: 24,
     fontWeight: FontWeight.w300,
     color: const Color(0xB39CA3AF), // #9CA3AF with 0.7 opacity
   );
 
   // Button text → DM Sans (UI)
-  static final TextStyle createStoryBtn = GoogleFonts.dmSans(
+  static final TextStyle createStoryBtn = TextStyle(fontFamily: 'DM Sans',
     fontSize: 17,
     fontWeight: FontWeight.w600,
     color: Colors.white,

airhub_app/lib/theme/product_theme.dart

@@ -0,0 +1,190 @@
+import 'package:flutter/material.dart';
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+
+part 'product_theme.g.dart';
+
+/// 产品类型枚举
+enum ProductType {
+  /// 公共页面（登录、配网等）
+  common,
+
+  /// 毛绒机芯
+  capybara,
+
+  /// 电子吧唧 AI
+  badgeAi,
+
+  /// 普通吧唧
+  badgeBasic,
+}
+
+/// 每个产品类型对应的主题配色
+class ProductThemeData {
+  /// 按钮渐变
+  final LinearGradient buttonGradient;
+
+  /// 强调色（用于图标、文字高亮、进度条、选中态等）
+  final Color accentColor;
+
+  /// 次强调色（用于阴影、选中背景等）
+  final Color accentColorLight;
+
+  /// 按钮阴影
+  final List<BoxShadow> buttonShadows;
+
+  const ProductThemeData({
+    required this.buttonGradient,
+    required this.accentColor,
+    required this.accentColorLight,
+    required this.buttonShadows,
+  });
+}
+
+/// 各产品的主题定义
+class ProductThemes {
+  ProductThemes._();
+
+  /// 公共/默认 — 蓝色色调 (cyan → blue → indigo → purple)
+  static final common = ProductThemeData(
+    buttonGradient: const LinearGradient(
+      begin: Alignment.centerLeft,
+      end: Alignment.centerRight,
+      colors: [
+        Color(0xFF22D3EE),
+        Color(0xFF3B82F6),
+        Color(0xFF6366F1),
+        Color(0xFF8B5CF6),
+      ],
+      stops: [0.0, 0.35, 0.65, 1.0],
+    ),
+    accentColor: const Color(0xFF6366F1),
+    accentColorLight: const Color(0xFF8B5CF6),
+    buttonShadows: [
+      BoxShadow(
+        color: const Color(0xFF6366F1).withOpacity(0.4),
+        offset: const Offset(0, 4),
+        blurRadius: 20,
+      ),
+      BoxShadow(
+        color: const Color(0xFF8B5CF6).withOpacity(0.2),
+        offset: Offset.zero,
+        blurRadius: 40,
+      ),
+    ],
+  );
+
+  /// 毛绒机芯 — 金色/暖棕色
+  static final capybara = ProductThemeData(
+    buttonGradient: const LinearGradient(
+      begin: Alignment.topLeft,
+      end: Alignment.bottomRight,
+      colors: [Color(0xFFECCFA8), Color(0xFFC99672)],
+    ),
+    accentColor: const Color(0xFFC99672),
+    accentColorLight: const Color(0xFFECCFA8),
+    buttonShadows: [
+      BoxShadow(
+        color: const Color(0xFFC99672).withOpacity(0.35),
+        offset: Offset.zero,
+        blurRadius: 15,
+      ),
+      BoxShadow(
+        color: const Color(0xFFC99672).withOpacity(0.25),
+        offset: Offset.zero,
+        blurRadius: 30,
+      ),
+      BoxShadow(
+        color: const Color(0xFFC99672).withOpacity(0.4),
+        offset: const Offset(0, 6),
+        blurRadius: 20,
+      ),
+    ],
+  );
+
+  /// 电子吧唧 AI — 蓝渐变紫（与产品卡片一致）
+  static final badgeAi = ProductThemeData(
+    buttonGradient: const LinearGradient(
+      begin: Alignment.centerLeft,
+      end: Alignment.centerRight,
+      colors: [
+        Color(0xFF22D3EE),
+        Color(0xFF60A5FA),
+        Color(0xFF818CF8),
+        Color(0xFFA78BFA),
+      ],
+      stops: [0.0, 0.35, 0.70, 1.0],
+    ),
+    accentColor: const Color(0xFF818CF8),
+    accentColorLight: const Color(0xFFA78BFA),
+    buttonShadows: [
+      BoxShadow(
+        color: const Color(0xFF818CF8).withOpacity(0.4),
+        offset: const Offset(0, 4),
+        blurRadius: 20,
+      ),
+      BoxShadow(
+        color: const Color(0xFFA78BFA).withOpacity(0.2),
+        offset: Offset.zero,
+        blurRadius: 40,
+      ),
+    ],
+  );
+
+  /// 普通吧唧 — 粉渐变紫（与产品卡片一致）
+  static final badgeBasic = ProductThemeData(
+    buttonGradient: const LinearGradient(
+      begin: Alignment.centerLeft,
+      end: Alignment.centerRight,
+      colors: [
+        Color(0xFFC084FC),
+        Color(0xFFD8B4FE),
+        Color(0xFFC4B5FD),
+        Color(0xFFA78BFA),
+      ],
+      stops: [0.0, 0.35, 0.70, 1.0],
+    ),
+    accentColor: const Color(0xFFC084FC),
+    accentColorLight: const Color(0xFFD8B4FE),
+    buttonShadows: [
+      BoxShadow(
+        color: const Color(0xFFC084FC).withOpacity(0.4),
+        offset: const Offset(0, 4),
+        blurRadius: 20,
+      ),
+      BoxShadow(
+        color: const Color(0xFFA78BFA).withOpacity(0.2),
+        offset: Offset.zero,
+        blurRadius: 40,
+      ),
+    ],
+  );
+
+  /// 根据产品类型获取主题
+  static ProductThemeData of(ProductType type) {
+    switch (type) {
+      case ProductType.common:
+        return common;
+      case ProductType.capybara:
+        return capybara;
+      case ProductType.badgeAi:
+        return badgeAi;
+      case ProductType.badgeBasic:
+        return badgeBasic;
+    }
+  }
+}
+
+/// 全局当前产品类型 Notifier
+@Riverpod(keepAlive: true)
+class CurrentProductType extends _$CurrentProductType {
+  @override
+  ProductType build() => ProductType.common;
+
+  void set(ProductType type) => state = type;
+}
+
+/// 当前产品主题（派生自产品类型）
+@riverpod
+ProductThemeData currentProductTheme(Ref ref) {
+  return ProductThemes.of(ref.watch(currentProductTypeProvider));
+}

airhub_app/lib/theme/product_theme.g.dart

@@ -0,0 +1,121 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+
+part of 'product_theme.dart';
+
+// **************************************************************************
+// RiverpodGenerator
+// **************************************************************************
+
+// GENERATED CODE - DO NOT MODIFY BY HAND
+// ignore_for_file: type=lint, type=warning
+/// 全局当前产品类型 Notifier
+
+@ProviderFor(CurrentProductType)
+const currentProductTypeProvider = CurrentProductTypeProvider._();
+
+/// 全局当前产品类型 Notifier
+final class CurrentProductTypeProvider
+    extends $NotifierProvider<CurrentProductType, ProductType> {
+  /// 全局当前产品类型 Notifier
+  const CurrentProductTypeProvider._()
+    : super(
+        from: null,
+        argument: null,
+        retry: null,
+        name: r'currentProductTypeProvider',
+        isAutoDispose: false,
+        dependencies: null,
+        $allTransitiveDependencies: null,
+      );
+
+  @override
+  String debugGetCreateSourceHash() => _$currentProductTypeHash();
+
+  @$internal
+  @override
+  CurrentProductType create() => CurrentProductType();
+
+  /// {@macro riverpod.override_with_value}
+  Override overrideWithValue(ProductType value) {
+    return $ProviderOverride(
+      origin: this,
+      providerOverride: $SyncValueProvider<ProductType>(value),
+    );
+  }
+}
+
+String _$currentProductTypeHash() =>
+    r'53603ab5884787f0a4bb1aed5de18ff33089b5e7';
+
+/// 全局当前产品类型 Notifier
+
+abstract class _$CurrentProductType extends $Notifier<ProductType> {
+  ProductType build();
+  @$mustCallSuper
+  @override
+  void runBuild() {
+    final created = build();
+    final ref = this.ref as $Ref<ProductType, ProductType>;
+    final element =
+        ref.element
+            as $ClassProviderElement<
+              AnyNotifier<ProductType, ProductType>,
+              ProductType,
+              Object?,
+              Object?
+            >;
+    element.handleValue(ref, created);
+  }
+}
+
+/// 当前产品主题（派生自产品类型）
+
+@ProviderFor(currentProductTheme)
+const currentProductThemeProvider = CurrentProductThemeProvider._();
+
+/// 当前产品主题（派生自产品类型）
+
+final class CurrentProductThemeProvider
+    extends
+        $FunctionalProvider<
+          ProductThemeData,
+          ProductThemeData,
+          ProductThemeData
+        >
+    with $Provider<ProductThemeData> {
+  /// 当前产品主题（派生自产品类型）
+  const CurrentProductThemeProvider._()
+    : super(
+        from: null,
+        argument: null,
+        retry: null,
+        name: r'currentProductThemeProvider',
+        isAutoDispose: true,
+        dependencies: null,
+        $allTransitiveDependencies: null,
+      );
+
+  @override
+  String debugGetCreateSourceHash() => _$currentProductThemeHash();
+
+  @$internal
+  @override
+  $ProviderElement<ProductThemeData> $createElement($ProviderPointer pointer) =>
+      $ProviderElement(pointer);
+
+  @override
+  ProductThemeData create(Ref ref) {
+    return currentProductTheme(ref);
+  }
+
+  /// {@macro riverpod.override_with_value}
+  Override overrideWithValue(ProductThemeData value) {
+    return $ProviderOverride(
+      origin: this,
+      providerOverride: $SyncValueProvider<ProductThemeData>(value),
+    );
+  }
+}
+
+String _$currentProductThemeHash() =>
+    r'a4e7be1ce8791e6e3323950346ef72e4f5d07fa9';

airhub_app/lib/widgets/glass_dialog.dart

@@ -1,5 +1,4 @@
 import 'package:flutter/material.dart';
-import 'package:google_fonts/google_fonts.dart';
 import 'gradient_button.dart';
 import '../theme/app_colors.dart' as appclr;
 
@@ -11,8 +10,8 @@ class GlassDialog extends StatelessWidget {
   final String confirmText;
   final VoidCallback onCancel;
   final VoidCallback onConfirm;
-  final bool
+  final bool isDanger;
-  isDanger; // If we need a specific danger style, though CSS shows Pink Gradient default
+  final Gradient? confirmGradient;
 
   const GlassDialog({
     super.key,
@@ -24,6 +23,7 @@ class GlassDialog extends StatelessWidget {
     required this.onCancel,
     required this.onConfirm,
     this.isDanger = false,
+    this.confirmGradient,
   });
 
   @override
@@ -54,7 +54,7 @@ class GlassDialog extends StatelessWidget {
             // Title
             Text(
               title,
-              style: GoogleFonts.outfit(
+              style: TextStyle(fontFamily: 'Outfit',
                 fontSize: 20,
                 fontWeight: FontWeight.w600,
                 color: const Color(0xFF4B2404),
@@ -98,7 +98,7 @@ class GlassDialog extends StatelessWidget {
               GradientButton(
                 text: confirmText,
                 height: 48,
-                gradient: appclr.AppColors.btnPlushGradient,
+                gradient: confirmGradient ?? appclr.AppColors.btnPlushGradient,
                 onPressed: onConfirm,
               ),
             ] else ...[
@@ -131,7 +131,7 @@ class GlassDialog extends StatelessWidget {
                     child: GradientButton(
                       text: confirmText,
                       height: 44,
-                      gradient: appclr.AppColors.btnPlushGradient,
+                      gradient: confirmGradient ?? appclr.AppColors.btnPlushGradient,
                       onPressed: onConfirm,
                     ),
                   ),
@@ -155,6 +155,7 @@ Future<T?> showGlassDialog<T>({
   String confirmText = '确定',
   required VoidCallback onConfirm,
   bool isDanger = false,
+  Gradient? confirmGradient,
 }) {
   return showGeneralDialog<T>(
     context: context,
@@ -176,6 +177,7 @@ Future<T?> showGlassDialog<T>({
         onCancel: () => Navigator.of(context).pop(),
         onConfirm: onConfirm,
         isDanger: isDanger,
+        confirmGradient: confirmGradient,
       );
     },
     transitionBuilder: (context, anim1, anim2, child) {

airhub_app/lib/widgets/gradient_button.dart

@@ -1,6 +1,6 @@
 import 'package:flutter/material.dart';
-import 'package:google_fonts/google_fonts.dart';
 import '../theme/app_colors.dart';
+import '../theme/product_theme.dart';
 
 class GradientButton extends StatelessWidget {
   final String text;
@@ -9,6 +9,7 @@ class GradientButton extends StatelessWidget {
   final double height;
   final bool isLoading;
   final Gradient? gradient;
+  final List<BoxShadow>? shadows;
 
   const GradientButton({
     super.key,
@@ -18,57 +19,53 @@ class GradientButton extends StatelessWidget {
     this.height = 48.0, // 统一规范高度
     this.isLoading = false,
     this.gradient,
+    this.shadows,
   });
 
-  // Check if using plush/capybara gradient
+  /// 从 ProductThemeData 创建，自动匹配渐变和阴影
-  bool get _isPlushGradient {
+  factory GradientButton.fromTheme({
-    if (gradient == null) return false;
+    Key? key,
-    if (gradient is LinearGradient) {
+    required String text,
-      final lg = gradient as LinearGradient;
+    required ProductThemeData theme,
-      // Check if colors match plush gradient colors
+    VoidCallback? onPressed,
-      if (lg.colors.length >= 2) {
+    double width = double.infinity,
-        return lg.colors.first.value == 0xFFECCFA8 ||
+    double height = 48.0,
-            lg.colors.last.value == 0xFFC99672;
+    bool isLoading = false,
-      }
+  }) {
-    }
+    return GradientButton(
-    return false;
+      key: key,
+      text: text,
+      onPressed: onPressed,
+      width: width,
+      height: height,
+      isLoading: isLoading,
+      gradient: theme.buttonGradient,
+      shadows: theme.buttonShadows,
+    );
   }
 
   List<BoxShadow> get _boxShadows {
-    if (_isPlushGradient) {
+    if (shadows != null) return shadows!;
-      // Warm brown glow for Capybara plush gradient
+    // 根据渐变颜色自动推断阴影
-      return [
+    if (gradient is LinearGradient) {
-        BoxShadow(
+      final lg = gradient as LinearGradient;
-          color: const Color(0xFFC99672).withOpacity(0.35),
+      if (lg.colors.length >= 2) {
-          offset: Offset.zero,
+        final shadowColor = lg.colors[lg.colors.length ~/ 2];
-          blurRadius: 15,
+        return [
-        ),
+          BoxShadow(
-        BoxShadow(
+            color: shadowColor.withOpacity(0.4),
-          color: const Color(0xFFC99672).withOpacity(0.25),
+            offset: const Offset(0, 4),
-          offset: Offset.zero,
+            blurRadius: 20,
-          blurRadius: 30,
+          ),
-        ),
+          BoxShadow(
-        BoxShadow(
+            color: lg.colors.last.withOpacity(0.2),
-          color: const Color(0xFFC99672).withOpacity(0.4),
+            offset: Offset.zero,
-          offset: const Offset(0, 6),
+            blurRadius: 40,
-          blurRadius: 20,
+          ),
-        ),
+        ];
-      ];
+      }
-    } else {
-      // Purple/indigo glow for primary gradient
-      return [
-        BoxShadow(
-          color: const Color(0xFF6366F1).withOpacity(0.4),
-          offset: const Offset(0, 4),
-          blurRadius: 20,
-        ),
-        BoxShadow(
-          color: const Color(0xFF8B5CF6).withOpacity(0.2),
-          offset: Offset.zero,
-          blurRadius: 40,
-        ),
-      ];
     }
+    return AppColors.shadowPrimaryButton;
   }
 
   @override
@@ -127,7 +124,7 @@ class GradientButton extends StatelessWidget {
                         )
                       : Text(
                           text,
-                          style: GoogleFonts.dmSans(
+                          style: TextStyle(fontFamily: 'DM Sans',
                             fontSize: 17,
                             fontWeight: FontWeight.w600,
                             color: Colors.white,

airhub_app/pubspec.lock

@@ -40,6 +40,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "0.13.10"
+  archive:
+    dependency: transitive
+    description:
+      name: archive
+      sha256: a96e8b390886ee8abb49b7bd3ac8df6f451c621619f52a26e815fdcf568959ff
+      url: "https://pub.dev"
+    source: hosted
+    version: "4.0.9"
   args:
     dependency: transitive
     description:
@@ -516,14 +524,6 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "14.8.1"
-  google_fonts:
-    dependency: "direct main"
-    description:
-      name: google_fonts
-      sha256: ba03d03bcaa2f6cb7bd920e3b5027181db75ab524f8891c8bc3aa603885b8055
-      url: "https://pub.dev"
-    source: hosted
-    version: "6.3.3"
   graphs:
     dependency: transitive
     description:
@@ -580,6 +580,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "4.1.2"
+  image:
+    dependency: "direct main"
+    description:
+      name: image
+      sha256: f9881ff4998044947ec38d098bc7c8316ae1186fa786eddffdb867b9bc94dfce
+      url: "https://pub.dev"
+    source: hosted
+    version: "4.8.0"
   image_picker:
     dependency: "direct main"
     description:
@@ -956,6 +964,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "1.5.2"
+  posix:
+    dependency: transitive
+    description:
+      name: posix
+      sha256: "185ef7606574f789b40f289c233efa52e96dead518aed988e040a10737febb07"
+      url: "https://pub.dev"
+    source: hosted
+    version: "6.5.0"
   pub_semver:
     dependency: transitive
     description:

airhub_app/pubspec.yaml

@@ -61,10 +61,11 @@ dependencies:
   # Existing dependencies
   webview_flutter: ^4.4.2
   permission_handler: ^11.0.0
-  google_fonts: ^6.1.0
+  # google_fonts removed — local fonts used instead
   flutter_blue_plus: ^1.31.0
   flutter_svg: ^2.0.9
   image_picker: ^1.2.1
+  image: ^4.3.0
   just_audio: ^0.9.42
   http: ^1.2.0
   video_player: ^2.9.2
@@ -89,6 +90,17 @@ flutter:
           weight: 600
         - asset: assets/fonts/Inter-Bold.ttf
           weight: 700
+    - family: DM Sans
+      fonts:
+        - asset: assets/fonts/DMSans-Variable.ttf
+        - asset: assets/fonts/DMSans-Italic-Variable.ttf
+          style: italic
+    - family: Outfit
+      fonts:
+        - asset: assets/fonts/Outfit-Variable.ttf
+    - family: Press Start 2P
+      fonts:
+        - asset: assets/fonts/PressStart2P-Regular.ttf
   # An image asset can refer to one or more resolution-specific "variants", see
   # https://flutter.dev/to/resolution-aware-images