Files
zhy200308 3ae97259ed feat(ui): 交付手环升级(DFU固件升级)方案5并对齐语言设置/版型切换360px 1fr占比
1. 【手环升级 / DFU固件升级】:按用户选定方案5(Master-Detail Inset Pro)完成6件套全量物料交付:
   - 栅格比例严格对齐【语言设置】与【版型切换】的 360px 1fr 经典双栏比例,避免页面比例失衡;
   - 视觉体系严格对齐全局主色蓝规范 #2563EB(深色 #1D4ED8、浅底 #EFF6FF、高亮 #1E40AF);
   - 左侧 360px 布局:待升级手环硬件状态卡片(方案5 Inset 经典属性胶囊条:手环 ID/当前版本/剩余电量 + 取消升级暖黄按钮)与固件包版本源;
   - 右侧 1fr 布局:升级进度条、毫秒级百分比读数、传输速率与极客暗晶升级日志控制台 Terminal;
   - 弹窗交互:居中底部抽拉式 Sheet(560px 宽度自适应居中),配备顶部阻尼把手、左上角动态雷达声呐动效与 BLE 协议胶囊标签;
   - 交互闭环:支持手环信道建立、固件下发传输、校验重启与安全取消全流程;
   - Chrome Headless 自动渲染生成官方 image.png 交付图。
2. 更新 README.md 项目进度(已完成 6/11 页面)。
2026-08-17 17:37:18 +08:00

53 lines
3.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 手环升级 (DFU固件升级) 视觉重构规格说明书 (DESIGN_SPEC)
## 1. 业务与界面定位
- **模块名称**:手环升级 / DFU 固件升级 (Device Firmware Upgrade)
- **方案选型**:**方案 5 (Master-Detail Inset Pro · 360px 1fr 经典比例)**
- **核心场景**:用于运动手环设备的 BLE OTA 固件空中升级与引导维护。提供目标手环信息展示、固件源校验切换、多阶段固件烧录进度监控、异常取消以及底层 DFU 协议日志输出。
- **设计基准**:严格统一遵循全局核心主色蓝标准(`#2563EB` 体系)、AppBar 40dp 纯净触控规范、左右 360px 1fr 经典占比(严格对齐【语言设置】与【版型切换】)与居中底部抽拉式 Sheet 面板。
---
## 2. 字段与槽位 100% 对应表
| 区域 | 原图字段 / 控件 | 重构 UI 对应槽位 | 规范与交互行为 |
| :--- | :--- | :--- | :--- |
| **顶部栏** | 返回箭头 + `手环升级` | AppBar (高度 60px) | 40dp 纯净透明触控槽 + Hover 微圆底,返回上一级 |
| **设备卡片** | 手环插画 + ID / 版本 / 电量 | 左侧上部【待升级手环状态】卡片 | Inset 经典属性胶囊条(手环 ID、当前版本、剩余电量) |
| **设备操作** | `取消升级` 按钮 | 卡片右下角操作按钮 | 暖琥珀色(`#FEF3C7` / `#D97706`),传输中可随时安全熔断 DFU 进程 |
| **固件卡片** | 固件包文件名 (内置版本) | 左侧下部【固件包与版本源】卡片 | 代码等宽字号展示,清晰标注 `固件来源: 内置 (优先)` |
| **固件操作** | `检查服务端版本` / `使用内置固件` | 双操作按钮栅格 | 标准幽灵边框按钮,Hover 高亮 `--color-primary-light` |
| **升级控制** | `升级进度` 标题 + 进度条 + 百分比 | 右侧【升级进度与控制】面板 | 动态平滑渐变进度条,毫秒级百分比读数与实时传输速率展示 |
| **主按钮** | `开始升级` (全宽主按钮) | 右侧核心 CTA 按钮 | 渐变主色蓝 `--color-primary-gradient`,带弥散光晕 |
| **协议日志** | 同步日志输出 | 右侧下方【升级日志控制台】 | 极客暗晶终端 HUD,完整打印 DFU 阶段流转与握手报文 |
| **悬浮按钮** | 右下角蓝牙标志 | 右下角 FAB 悬浮按钮 (52×52dp) | 点击唤出居中底部抽拉面板 |
| **设备选择** | 弹窗【选择设备】 | 居中底部抽拉式 Sheet (560px) | 左上角动态雷达声呐扩散动画,顶部阻尼把手,BLE 胶囊标签 |
---
## 3. 全局 Design Tokens 声明
```css
:root {
--color-primary: #2563EB;
--color-primary-dark: #1D4ED8;
--color-on-primary-container: #1E40AF;
--color-primary-light: #EFF6FF;
--color-primary-container: #EFF6FF;
--color-primary-border: #DBEAFE;
--color-primary-glow: rgba(37, 99, 235, 0.25);
--color-primary-gradient: linear-gradient(135deg, #2563EB 0%, #1D4ED8 100%);
--color-surface: #FFFFFF;
--color-surface-variant: #F8FAFC;
--color-background: #EEF2F6;
--text-main: #0F172A;
--text-sub: #64748B;
--text-dim: #94A3B8;
--divider: #E2E8F0;
--terminal-bg: #0F172A;
}
```