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

53 lines
3.2 KiB
Markdown
Raw 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 · 1:1 双栏等比占比)**
- **核心场景**:用于运动手环设备的 BLE OTA 固件空中升级与引导维护。提供目标手环信息展示、固件源校验切换、多阶段固件烧录进度监控、异常取消以及底层 DFU 协议日志输出。
- **设计基准**:严格统一遵循全局核心主色蓝标准(`#2563EB` 体系)、AppBar 40dp 纯净触控规范、左右 1:1 双栏等比均衡占比(与【手环配置】保持高度一致)与居中底部抽拉式 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;
}
```