diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 0000000..dae7022
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,6 @@
+[submodule "lib/UF4COM"]
+	path = lib/UF4COM
+	url = https://github.com/UF4OVER/UF4COM.git
+[submodule "lib/DAPLINK"]
+	path = lib/DAPLINK
+	url = https://github.com/UF4OVER/DAPLINK_STM32F103XB.git
diff --git a/README.md b/README.md
index 260503c..032c62a 100644
--- a/README.md
+++ b/README.md
@@ -1,162 +1,762 @@
-# F4CP
+# F4CP 与 UF4DigitalPower 项目说明
 
-F4CP 是 `UF4DigitalPower` 项目的 Windows 上位机，面向数字电源调试、监控、参数配置和固件烧录。应用基于 Python、PyQt5、qfluentwidgets、pyqtgraph 和 pyOCD 构建，入口为 `start.py`。
+F4CP 数字电源项目分为两个部分：
 
-当前主窗口类为 `Window(MSFluentWindow)`，默认导航包含：
+1. [下位机固件](https://update.hepi.ng) 可以搭配上位机使用，也可以独立使用，提供基本的固件下载功能
+2. [上位机软件](https://github.com/UF4OVER/UF4DigitalPower) 此仓库
+3. 其实作者想过通过硬件上位机来代替软件上位机，但是软硬件的复杂度还比较高，作者没办法同时兼顾，所以先把软件上位机做好了，硬件上位机就先放一放了。
 
-- 引导 (`HomePage`)：软件概览、最新动态、多功能按钮导航与快捷通知展示。
-- 串口 (`DevicePage`)：串口与蓝牙通信调试，支持 Raw 发送与 TVLCOM V2 (TLV 组包与解析)。
-- 设备 (`PowerPage`)：数字电源看板、输出控制、参数设定与多通道图表采样。
-- 烧录 (`DaplinkPage`)：基于 pyOCD 进程的 DAPLink 在线擦除、固件烧录、运行复位及本地包管理。
-- 版本 (`VersionPage`)：查看当前软件/固件版本、配置 GitHub API 密钥、一键检索/下载最新固件与更新升级。
-- 设置 (`SettingsPage`)：软件主题（浅色/深色/跟随系统）、字体大小及高 DPI 缩放。
+项目中借鉴道到的其他项目或者公开文档
 
-仓库中还包含 `BatteryPage` 电池组面板实现，用于 4 串电池组状态展示和连接模式预留；当前 `start.py` 尚未把该页面正式加入主窗口导航。
+- 通信协议 [UF4COM V3](https://github.com/UF4OVER/UF4COM)
+- DAPLINK 固件 [DAPLink](https://github.com/UF4OVER/DAPLINK_STM32F103XB)
+- 参考代码 [Buck-Boost-Digital-Power](https://github.com/zeruns/Synchronous-Rectification-Buck-Boost-Digital-Power-Supply-Based-on-STM32)
+- TI官方文档 [Multimode control for a four-switch buck-boost converter](https://www.ti.com/lit/an/slyt765/slyt765.pdf?ts=1781482881151)
+- ST官方文档 [Buck-boost converter using the STM32F334 Discovery kit](https://www.st.com/resource/en/application_note/an4449-buckboost-converter-using-the-stm32f334-discovery-kit-stmicroelectronics.pdf)
 
-## 快速开始
+> 注意： 由于焊接的水平不同和实际硬件的差异，作者不对任何人使用本项目造成的任何直接或间接损失负责，使用前请务必做好充分的风险评估和安全防护措施。
+---
 
-### 环境要求
+## 目录
 
-- Windows 10/11
-- Python `>=3.11`
+- [1. 项目总览](#1-项目总览)
+- [2. 硬件介绍](#2-硬件介绍)
+- [3. 下位机 C 代码解析](#3-下位机-c-代码解析)
+- [4. 借鉴代码与参考资料](#4-借鉴代码与参考资料)
+- [5. F4CP 上位机介绍](#5-f4cp-上位机介绍)
+- [6. 项目结构](#6-项目结构)
+- [7. 快速开始](#7-快速开始)
+
+---
+
+## 1. 项目总览
+
+本项目是一套基于 STM32G474 的双向四管升降压数字电源
+- 设计输入: `5V - 40V ` `10AMAX`
+- 输出范围: `0.5V - 40V`，
+- 功率拓扑: 四开关同步整流 Buck-Boost
+- 正反向电流均可以到0-10A
+
+
+优点：搭配上位机可以实现非常灵活的控制、监控和调试，上位机提供图表显示、参数调整、模式切换和固件升级等功能，无需任何烧录器即可通过 USB 直接控制和升级固件。
+> 板载了DAPLINK(STM32F103)，如果您需要在线烧录固件，你还需要将[DAPLink固件](https://github.com/UF4OVER/DAPLINK_STM32F103XB)烧录到STM32F103上
+
+> 注意: 作者使用的MOS可能不够理想 ，因此在高压低压两端的效率和稳定性可能不够好，你在可以选择更适合的MOSFET以提升性能。
+
+> 实物图
+> ![IMG_20260604_213728.jpg](https://img.hepi.ng/v2/NCb81Dz.jpeg)
+> ![IMG_20260604_213704.jpg](https://img.hepi.ng/v2/VqxCobD.jpeg)
+> ![IMG_20260616_153259.jpg](https://img.hepi.ng/v2/3x1zBgu.jpeg)
+> ![86ec51f830c4e1613f834f868d97668d.jpg](https://img.hepi.ng/v2/NemKAHw.jpeg)
+
+## 2. 硬件介绍
+
+> 当前作者测试使用到的硬件参数及其计算详情见 [计算记录](https://blog.hepi.ng/posts/overview_of_hardware_parameters_and_loops)
+### 2.1 主控与系统定位
+
+- 主控 MCU: `STM32G474CBT6`
+- 板载DEBUG: `STM32F103C8T6（DAPLink）`
+- 栅极驱动器: `UCC27211`
+- 辅助电源1: VIN->5V `LMR36520F`  用于运放，基准电压和风扇供电
+- 辅助电源2: 5V->3V3 `LM1117-3.3`  用于MCU 与外设控制逻辑供电
+- 辅助电源3: 5V->11.1V `SY7304DBC` 用于栅极驱动器供电
+
+当前板卡定位是四开关同步整流 Buck-Boost 数字电源控制板，下位机负责控制与保护，上位机负责人机交互、调试、监控和升级。
+
+### 2.2 功率级与工作模式
+
+当前功率拓扑是四开关 Buck-Boost，固件中划分三种模式：
+
+- `Buck`
+  - 输入明显高于输出
+  - Buck 桥主调制
+  - Boost 桥承担同步整流或固定导通辅助角色
+- `Mix`
+  - 输入电压接近输出电压
+  - 两侧桥臂共同参与调制
+  - 用于平滑跨越 Buck 和 Boost 边界
+- `Boost`
+  - 输入明显低于输出
+  - Boost 桥主调制
+  - Buck 桥承担同步整流或固定导通辅助角色
+
+- ![功率级电路图](https://img.hepi.ng/v2/WKNQnxV.png "功率级电路图")
+
+当前 IOC 与固件约定中：
+
+- `HRTIM Timer A` 对应 Buck 桥
+- `HRTIM Timer D` 对应 Boost 桥
+- `PA8/PA9` 为一组互补 PWM
+- `PB14/PB15` 为另一组互补 PWM
+
+### 2.3 栅极驱动与 Bootstrap 特性
+
+项目使用 `UCC27211` 半桥驱动器。该器件高边驱动采用 bootstrap 供电思路：
+
+- 高边供电使用 `HB-HS`
+- 需要 `HB-HS` 自举电容,使用100nF的贴片电容
+- 需要 `HS` 周期性回到较低电位，bootstrap 电容才能补电
+
+这意味着在 `Mix` 或 `Boost` 模式中，如果某一侧高边长期接近常开，不给 bootstrap 刷新窗口，就可能出现高边驱动电压下跌，进而表现为：
+
+- 模式不稳定
+- 输入被突然拉低
+- 无法顺利进入 `Mix` / `Boost`
+- 模式反复抖动
+
+因此控制代码中不能只看理论占空比，还必须兼顾驱动器刷新条件。
+- ![6f4cab3df3eb4a79ca3ce2c1fd22781c.png](https://img.hepi.ng/v2/ajeCH7l.png)
+### 2.4 采样链路
+
+当前固件的主要采样量如下：
+
+- `VIN`
+- `IIN`
+- `VOUT`
+- `IOUT`
+- `Board TEMP1`
+- `Board TEMP2`
+- `CPU TEMP`
+
+采样与换算特性：
+
+- 电压采样采用分压进入 ADC，再由软件恢复真实电压值，使用 GS8558-SR 运放
+- 电流采样基于 `7 mΩ` 分流电阻、`20x` 放大增益和 `1.65 V` 中点偏置,使用INA240A1 进行差分采样并放大
+- `ADC1` 规则组用于 `VIN/IIN/VOUT/IOUT`
+- 温度由 `ADC2/ADC3/ADC5` 配合 `temp.c` 完成换算 使用10k NTC热敏电阻
+
+- ![电压采样](https://img.hepi.ng/v2/pWFbBcN.png)
+- ![电流采样与基准](https://img.hepi.ng/v2/tMQ0m25.png)
+- ![温度采样](https://img.hepi.ng/v2/X8Ft1Mr.png)
+
+### 2.5 辅助硬件
+
+- 外部参数存储：`W25Q64`
+- 风扇：`TIM8_CH3` PWM 控制
+- 三色 LED：红 / 黄 / 绿状态指示
+- `DIV_SW`、驱动使能等 GPIO 作为板级辅助控制
+
+
+### 2.6 PCB
+
+- ![顶层](https://img.hepi.ng/v2/PldqpuZ.png)
+- ![地层](https://img.hepi.ng/v2/zlATTa3.png)
+- ![电层](https://img.hepi.ng/v2/UT0qUFB.png)
+- ![底层](https://img.hepi.ng/v2/nbD0gaq.png)
+
+### 效率实测
+![img.png](https://img.hepi.ng/v2/6RHUOSX.png)
+---
+
+## 3. 下位机 C 代码解析
+
+本章对应当前实际参与运行的 C 代码。
+
+### 3.1 总体执行结构
+
+下位机执行节拍分为三层：
+
+1. `main.c`
+   - 负责所有外设初始化
+   - 启动 ADC、DMA、USB、定时器、HRTIM、看门狗
+2. `TIM7` 5 ms 中断
+   - 负责采样平均、保护、主状态机推进、模式判断、协议流 tick
+3. `HRTIM` 快环中断
+   - 负责电流环、电压环、模式对应 duty 计算和 PWM 比较值刷新
+
+整体上是“中断驱动 + 全局控制变量共享”的经典数字电源固件结构。
+
+### 3.2 主要用户控制文件
+
+#### `Core/Src/main.c`
+
+作用：
+
+- 系统入口
+- 启动所有底层外设
+- 启动风扇 PWM
+- 启动 `TIM6 / TIM7 / TIM16`
+- 启动 ADC 与 HRTIM
+- 在主循环里运行慢速后台任务
+
+关键点：
+
+- `TIM6` 负责毫秒计数与喂狗
+- `TIM7` 负责控制主节拍
+- `TIM16` 负责把 ADC 平均值换算成物理量
+- 主循环负责：
+  - `StatusLed_Update()`
+  - `Update_Flash()`
+  - `UF4Transport_RunTask()`
+
+#### `Core/Src/function.c`
+
+作用：
+
+- 保存全局控制变量
+- 实现 ADC 平均
+- 实现主状态机
+- 实现 Buck / Mix / Boost 模式判定
+- 实现 OVP / OCP / OTP / Short 保护
+- 实现参数默认值、Flash 初始化与读写
+- 实现风扇 PWM 控制
+- 实现模式切换占空注入准备
+
+核心职责可以分成六类：
+
+1. 数据与状态变量
+   - `CtrValue`
+   - `DF`
+   - `SADC`
+   - `SET_Value`
+2. ADC 采样平均
+   - `ADCSample()`
+   - `ADC_calculate()`
+3. 主状态机
+   - `StateM()`
+   - `StateMInit()`
+   - `StateMWait()`
+   - `StateMRise()`
+   - `StateMRun()`
+   - `StateMErr()`
+4. 模式切换
+   - `BBMode()`
+   - `PowerControl_PrepareModeSwitch()`
+5. 保护
+   - `ShortOff()`
+   - `OVP()`
+   - `OCP()`
+   - `OTP()`
+6. 辅助
+   - `PowerControl_DisableOutput()`
+   - `FAN_PWM_set()`
+   - `Init_Flash() / Read_Flash() / Update_Flash()`
+
+当前重要变更也集中在这个文件：
+
+- 已删除输入欠压保护
+- 已删除固件自动风扇策略，改为上位机直接控制
+- 新增切模前 duty 预计算与注入准备
+
+#### `Core/Src/pid.c`
+
+作用：
+
+- 实现双环控制
+- 根据当前模式输出 Buck / Boost 支路占空比
+- 直接刷新 HRTIM 比较寄存器
+
+当前快环结构：
+
+1. 电流环先生成电压参考修正量
+2. 电压环再根据当前模式生成主 duty
+3. 根据 `Buck / Mix / Boost` 决定：
+   - 哪一侧主调制
+   - 哪一侧固定占空或平滑逼近目标占空
+4. 最后写入：
+   - `Timer A Compare1`
+   - `Timer A Compare3`
+   - `Timer D Compare1`
+
+当前代码已经加入三类关键增强：
+
+- `Buck` 模式下，Boost 支路对齐为同步整流安全占空
+- `Mix` 模式进入改成平滑爬升，避免一刀切到高占空
+- `Boost` 模式进入改成平滑爬升，避免 Buck 支路瞬时拉到极高占空
+
+另外还增加了 TI 思路的切模注入：
+
+- 切换到 `Buck` 前先按 `D = Vout / Vin` 计算目标 duty
+- 切换到 `Mix` 前先按 `D = Vout / (Vin + Vout)` 计算目标 duty
+- 切换到 `Boost` 前先按 `D = (Vout - Vin) / Vout` 计算目标 duty
+- 切模时把 duty 与环路种子直接装入快环，避免沿用旧模式积分硬跳
+
+#### `Core/Src/uf4_transport.c`
+
+作用：
+
+- 把固件控制变量绑定到 `UF4COM V3` 协议 ID
+- 处理 USB CDC / USART DMA 收发
+- 处理 `READ / WRITE / REPORT / STREAM`
+- 负责把上位机写入同步到控制变量
+
+主要内容：
+
+1. 固定传输端口选择
+2. UF4 ID 表绑定
+3. 读寄存器镜像刷新
+4. 写寄存器应用
+5. CDC / UART DMA 输入处理
+6. 流发送调度
+
+这部分是下位机和 F4CP 上位机之间的桥。
+
+#### `Core/Src/status_led.c`
+
+作用：
+
+- 按当前状态机、故障和输出状态更新三色 LED
+- 保持项目当前定义的状态语义
+
+该文件不参与功率控制本身，但负责把运行状态转换成板上可视反馈。
+
+#### `Core/Src/temp.c`
+
+作用：
+
+- NTC 温度换算
+- MCU 温度换算
+
+它为 `OTP()`、上报温度和风扇控制数据源提供支持。
+
+#### `Core/Src/W25Q64.c`
+
+作用：
+
+- SPI Flash 底层驱动
+- 提供读、写、擦除接口
+
+上层由 `function.c` 中的 `Init_Flash() / Read_Flash() / Update_Flash()` 调用。
+
+### 3.3 主要 CubeMX/HAL 生成文件
+
+这些文件大多由 CubeMX 或 HAL 模板生成，但在项目运行中实际承担关键底层角色，因此也应当纳入说明。
+
+#### `Core/Src/adc.c`
+
+- 配置 `ADC1 / ADC2 / ADC3 / ADC5`
+- 定义采样通道、触发源、过采样、DMA 方式
+- `ADC1` 是主功率量采样入口
+
+#### `Core/Src/hrtim.c`
+
+- 配置 `HRTIM1`
+- 定义 `Timer A` 和 `Timer D`
+- 配置死区
+- 配置 ADC 触发点
+- 配置互补输出引脚
+
+这是功率控制的底层核心之一。
+
+#### `Core/Src/tim.c`
+
+- 配置 `TIM6`
+- 配置 `TIM7`
+- 配置 `TIM8`
+- 配置 `TIM16`
+
+其中：
+
+- `TIM6`：1 ms
+- `TIM7`：5 ms
+- `TIM16`：10 ms
+- `TIM8_CH3`：风扇 PWM
+
+#### `Core/Src/gpio.c`
+
+- 配置 LED
+- 配置 PWM 引脚复用
+- 配置 `DIV_SW` 等辅助引脚
+
+#### `Core/Src/usart.c`
+
+- 配置 `USART1 / USART2`
+- 配合 `UF4Transport` 处理串口通信
+
+#### `Core/Src/spi.c`
+
+- 配置 `SPI1`
+- 供 `W25Q64.c` 使用
+
+#### `Core/Src/dma.c`
+
+- 配置 DMA 控制器
+- 为 `ADC1 DMA`、UART DMA 等提供底层支持
+
+#### `Core/Src/iwdg.c`
+
+- 配置独立看门狗
+- 由固定节拍任务喂狗
+
+#### `Core/Src/stm32g4xx_it.c`
+
+- 中断入口
+- 把 HRTIM、TIM、DMA、USB 等中断交给 HAL 和用户逻辑
+
+#### `Core/Src/stm32g4xx_hal_msp.c`
+
+- MSP 初始化
+- GPIO AF、DMA 链接、时钟使能等底层板级装配
+
+#### `Core/Src/system_stm32g4xx.c`
+
+- 系统时钟基础支持
+- 核心启动时钟框架
+
+### 3.4 配套中间件与接口层 C 文件
+
+除了 `Core/Src`，还有几类 C 文件同样是固件运行必需部分：
+
+#### `USB_Device/App/usbd_cdc_if.c`
+
+- USB CDC 收发桥接
+- 把收到的 USB 数据转发到 `UF4Transport_OnUsbCdcRx()`
+
+#### `Middlewares` / `Drivers`
+
+- `STM32 HAL`
+- `CMSIS`
+- `USB Device`
+
+这些代码不是本项目手写控制逻辑，但属于最终可运行固件的一部分。
+
+### 3.5 当前固件实际调用链
+
+可以把当前控制链概括为：
+
+1. `main.c` 初始化外设
+2. `TIM7` 周期调用：
+   - `ADCSample()`
+   - 保护逻辑
+   - `StateM()`
+   - `BBMode()`
+3. `HRTIM` 快环中断调用：
+   - `BuckBoostVILoopCtlPID()`
+4. `UF4Transport`
+   - 处理上位机命令
+   - 回传状态与流数据
+5. 主循环
+   - 更新状态灯
+   - 保存参数
+   - 处理通信后台任务
+
+---
+
+## 4. 借鉴代码与参考资料
+
+本项目不是从零开始完全自写。下面按“来源 -> 用到什么”列出。
+
+### 4.1 直接借鉴的代码工程
+
+#### 参考代码 [Buck-Boost-Digital-Power](https://github.com/zeruns/Synchronous-Rectification-Buck-Boost-Digital-Power-Supply-Based-on-STM32)
+
+这是当前 `UF4DigitalPower` 最直接的代码来源，借鉴内容包括：
+
+- 控制变量组织方式
+- 主状态机结构
+- `Buck / Mix / Boost` 模式判定框架
+- `pid.c` 的双环控制结构
+- 软启动框架
+- Flash 参数存储方式
+- 温度换算与风扇 PWM 基础接口
+
+当前工程并不是简单复制，而是做了以下方向上的重构：
+
+- 从 `D/F` HRTIM 映射迁移到当前 `A/D` 映射
+- 删除按键和 OLED 本地人机交互
+- 改为 `UF4COM + F4CP` 上下位机协同
+- 去掉 `FMAC / CRC` 硬件依赖，改为纯软件路径
+- 修复多处模式切换、占空钳位、保护与上报问题
+
+### 4.2 协议核心来源
+
+#### [UF4COM V3](https://github.com/UF4OVER/UF4COM)
+
+借鉴内容：
+
+- `UF4COM V3` 帧结构
+- CRC16-CCITT
+- TV 数据项编码
+- `READ / WRITE / REPORT / STREAM` 交互范式
+
+当前固件的 `uf4_transport.c` 与上位机 `app/protocol/tvlcom*.py` 都基于这一协议核心。
+
+### 4.3 ST 官方工具链与自动生成代码
+
+#### STM32CubeMX / STM32CubeG4 / HAL / CMSIS
+
+借鉴内容：
+
+- 外设初始化代码骨架
+- HRTIM、ADC、TIM、USART、SPI、USB CDC 配置模板
+- 中断框架
+- HAL 驱动与启动文件
+
+这些内容主要体现在：
+
+- `adc.c`
+- `hrtim.c`
+- `tim.c`
+- `gpio.c`
+- `usart.c`
+- `spi.c`
+- `dma.c`
+- `stm32g4xx_it.c`
+- `stm32g4xx_hal_msp.c`
+
+### 4.4 控制策略参考资料
+
+#### TI官方文档 [Multimode control for a four-switch buck-boost converter](https://www.ti.com/lit/an/slyt765/slyt765.pdf?ts=1781482881151)
+
+标题：
+
+- `Multimode control for a four-switch buck-boost converter`
+
+借鉴内容：
+
+- `Buck / Buck-Boost / Boost` 多模态 duty 公式
+- 切模前先按目标模式计算 duty，再把目标 duty 注入控制环的思路
+- 认识到模式切换时不应依赖旧模式积分慢慢追
+
+当前项目里新增的“切模前预计算 duty 并注入”机制直接参考了这条思路。
+
+#### ST官方文档 [Buck-boost converter using the STM32F334 Discovery kit](https://www.st.com/resource/en/application_note/an4449-buckboost-converter-using-the-stm32f334-discovery-kit-stmicroelectronics.pdf)
+
+标题：
+
+- `Buck-boost converter using the STM32F334 Discovery kit`
+
+借鉴内容：
+
+- HRTIM 在 Buck-Boost 电源中的使用方法
+- ADC 触发和 PWM 协调方式
+- 高分辨率定时器在数字电源中的组织思路
+
+### 4.5 器件资料参考
+
+#### `UCC27211` 数据手册
+
+借鉴内容：
+
+- 半桥高边 bootstrap 驱动机制
+- `HB / HS / HO / LO` 含义
+- 高边长期近似常开时 bootstrap 刷新约束
+
+这对当前 `Mix / Boost` 模式稳定性分析非常重要。
+
+---
+
+## 5. F4CP 上位机介绍
+> 上位机具体实现可以参考 [F4CP 工程实现档案](https://blog.hepi.ng/posts/f4cp-project-archive/)
+`F4CP` 是当前系统的 Windows 上位机，负责：
+
+- 串口连接
+- 设备控制
+- 实时监控
+- 实时曲线
+- 固件烧录
+- 版本检查与升级
+- 通用 UF4COM 调试
+
+> 界面展示
+> ![0e2c171f7100f64bd503c33d64c4cd88.png](https://img.hepi.ng/v2/Lh206dl.png)
+> ![c99161a30ec4ce058ffab5c0103279fa.png](https://img.hepi.ng/v2/mSwzYPx.png)
+
+### 5.1 技术栈
+
+- Python `3.11`
+- PyQt5
+- qfluentwidgets
+- pyqtgraph
+- pyOCD
 - `uv`
-- DAPLink/pyOCD 烧录功能需要 `Resources/Tools/Pack/` 下存在可用 CMSIS Pack
 
-### 安装依赖
+入口文件是：
 
-```powershell
-uv sync
-```
+- `start.py`
 
-### 启动应用
+### 5.2 主窗口与页面
 
-```powershell
-uv run python start.py
-```
+当前导航在 `app/window/navigation.py` 中定义，主要页面包括：
 
-### 运行测试
+- `HomePage`
+  - 首页与软件概览
+- `DevicePage`
+  - 串口与 `UF4COM` 调试
+- `PowerPage`
+  - 数字电源设备主控制页
+- `DaplinkPage`
+  - DAPLink / pyOCD 烧录页
+- `VersionPage`
+  - 应用与固件版本管理页
 
-```powershell
-uv run python -m unittest discover -s tests
-```
+仓库中还保留：
 
-### 打包
+- `BatteryPage`
 
-```powershell
-.\script\package_exe.ps1
-```
+该页面当前未作为主导航默认入口，但代码仍在仓库中维护。
 
-cx_Freeze 配置位于 `pyproject.toml`，打包产物输出到 `build/exe/`。需要进一步压缩体积时，可以在打包后运行：
+### 5.3 上位机协议层
 
-```powershell
-uv run python script\upx_zip.py
+当前协议栈主要位于：
+
+- `app/protocol/tvlcom.py`
+- `app/protocol/tvlcom_frame.py`
+- `app/protocol/tvlcom_tlv.py`
+- `app/protocol/tvlcom_stream.py`
+- `app/protocol/tvlcom_crc.py`
+
+职责如下：
+
+- 组帧
+- 解帧
+- CRC16-CCITT
+- TV 编码/解码
+- 流式数据请求打包
+
+虽然文件名里还保留 `tvlcom` 历史命名，但当前实际承载的是 `UF4COM` 协议实现。
+
+### 5.4 电源设备会话层
+
+数字电源专用会话位于：
+
+- `app/session/session_power/session_power.py`
+
+核心职责：
+
+1. 串口会话接管
+2. `READ / WRITE / REPORT / STREAM` 请求
+3. `PowerStatus` 快照整理
+4. 写入事务暂停与恢复
+5. 流式采样解析
+6. 调试快照读取
+7. 通信失败与自动断开管理
+
+其中最核心的类是：
+
+- `F4CPPowerClient`
+
+它把协议值整理成 UI 可直接使用的状态，例如：
+
+- 输入输出电压电流
+- 模式名
+- 拓扑名
+- 故障标志
+- OVP/OCP/OTP 当前值和设定值
+- 风扇当前值与设定值
+- PWM Compare 调试量
+
+### 5.5 页面与控制器分工
+
+当前页面分工比较清晰：
+
+- `app/widgets/pages/`
+  - 负责控件创建、布局、显示
+- `app/controllers/`
+  - 负责页面事件绑定与业务流程编排
+- `app/session/`
+  - 负责串口、设备、烧录会话
+- `app/core/`
+  - 负责常量、数据中心、基础对象
+
+例如：
+
+- `controller_power_page.py`
+  - 负责把 `PowerPage` 的按钮、输入框和 `F4CPPowerClient` 连起来
+- `page_power.py`
+  - 负责设备看板、输出控制、保护参数、实时曲线等 UI
+
+### 5.6 实时曲线与数据流
+
+实时曲线由以下部分组成：
+
+- `app/core/data_hub.py`
+- `app/widgets/chart/`
+- `pyqtgraph`
+
+数据流：
+
+1. 串口收到 `UF4COM` 帧
+2. `F4CPPowerClient` 解帧并生成状态
+3. 状态写入 `DataHub`
+4. 图表组件从 `DataHub` 读取滑动窗口
+5. 页面刷新波形与数值
+
+### 5.7 烧录与版本管理
+
+#### 烧录
+
+- 页面：`page_daplink.py`
+- 会话：`session_daplink.py`
+
+负责：
+
+- pyOCD 进程管理
+- 固件擦除
+- 固件下载
+- 复位运行
+- 本地包管理
+
+#### 版本管理
+
+- 页面：`page_version.py`
+- 固件发布脚本：`E:\PROJECT_C\UF4DigitalPower\scripts\publish_firmware.py`
+- 发布入口脚本：`E:\PROJECT_C\UF4DigitalPower\scripts\deploy.ps1`
+
+当前支持：
+
+- `stable / beta` 通道
+- 固件 `manifest.json`
+- `index.json`
+- `latest.json`
+- `min_client` 最低上位机版本要求
+
+---
+
+## 6. 项目结构
+
+### 6.1 下位机固件
+
+```text
+UF4DigitalPower/
+├─ Core/
+│  ├─ Inc/
+│  └─ Src/
+├─ Drivers/
+├─ Middlewares/
+├─ USB_Device/
+├─ docs/
+├─ scripts/
+├─ storage/
+└─ UF4DigitalPower.ioc
 ```
 
-## 项目结构
+### 6.2 上位机软件
 
 ```text
 F4CP/
 ├─ app/
-│  ├─ controllers/           # 页面控制器，集中注册复杂页面的信号和操作入口
-│  ├─ core/                  # 数据中心、通道、设备基类、通用 UI 工具
-│  ├─ devices/               # 电源/BMS/虚拟设备适配层
-│  ├─ manager/               # 字体、样式、固件、更新管理
-│  ├─ protocol/              # TVLCOM V2 通用帧、Payload、类型工具
-│  ├─ session/               # 串口、电源协议、DAPLink、蓝牙会话
-│  └─ widgets/
-│     ├─ chart/              # DataHub 驱动的实时曲线组件
-│     ├─ components/         # 启动画面、DynamicIsland 等复用组件
-│     ├─ icon/               # UF4 图标资源与封装
-│     └─ pages/              # Home/Device/Power/Daplink/Settings/Battery 页面
-├─ config/                   # 路径、JSON 配置和日志初始化
-├─ docs/                     # 项目协作说明
+│  ├─ controllers/
+│  ├─ core/
+│  ├─ devices/
+│  ├─ manager/
+│  ├─ protocol/
+│  ├─ session/
+│  ├─ widgets/
+│  └─ window/
+├─ config/
+├─ docs/
 ├─ Resources/
-│  ├─ Assets/                # 应用图标、图片资源
-│  ├─ Config/                # config.json，运行时配置
-│  ├─ Firmware/              # 本地上下位机固件
-│  ├─ Font/                  # 字体资源
-│  ├─ Theme/qss/             # light/dark 页面样式
-│  └─ Tools/Pack/            # 本地 CMSIS Pack
-├─ script/                   # 打包、pyOCD 启动和资料生成脚本
-├─ tests/                    # unittest 测试
-├─ start.py                  # 应用入口、主窗口和导航
-└─ pyproject.toml            # 依赖、版本和 cx_Freeze 配置
+├─ script/
+├─ tests/
+├─ start.py
+└─ pyproject.toml
 ```
 
-## 关键模块
-
-| 模块 | 说明 |
-| --- | --- |
-| `start.py` | 应用入口、主窗口导航、启动画面和标题栏 DynamicIsland 通知 |
-| `app/controllers/` | 复杂页面控制器，负责把控件事件、页面信号和后台 client/session 事件集中绑定 |
-| `config/config.py` | `AppContext`、路径解析、日志和 JSON 配置 |
-| `app/widgets/pages/page_home.py` | 首页、软件更新检查、固件版本检查与下载 |
-| `app/widgets/pages/page_device.py` | 串口/蓝牙调试页，支持 Raw 和 TVLCOM V2 模式 |
-| `app/widgets/pages/page_power.py` | 数字电源仪表盘、输出控制、保护参数、实时曲线 |
-| `app/widgets/pages/page_daplink.py` | DAPLink/pyOCD 烧录页面 |
-| `app/widgets/pages/page_settings.py` | 主题、字体和应用设置 |
-| `app/widgets/pages/page_battery.py` | 电池组面板 UI 与快照数据模型 |
-| `app/session/session_serial.py` | 通用串口会话、串口枚举和 Qt 事件投递 |
-| `app/session/session_power.py` | 数字电源专用协议客户端、状态模型和流式采样 |
-| `app/session/session_daplink.py` | pyOCD 后台烧录会话 |
-| `app/protocol/` | TVLCOM V2 通用帧构建、解析、Payload 和类型注册 |
-| `app/core/data_hub.py` | 多通道时序数据缓存，供曲线和仪表盘读取 |
-| `app/widgets/chart/` | 实时曲线模型、控制面板、数值面板和 pyqtgraph 渲染 |
-| `app/core/utility.py` | 统一通知入口 `showMessage(...)` |
-
-## 通信与数据流
-
-### 串口/TVLCOM V2 调试
-
-串口页位于 `app/widgets/pages/page_device.py`，使用 `SerialSession` 管理串口收发，也提供蓝牙 RFCOMM 连接的 UI 与会话封装。页面有两种发送模式：
-
-- Raw：按 HEX 或 ASCII 直接发送。
-- TVLCOM V2：根据 TLV 表组包，由 `app/protocol/frameBuilder.py`、`frameParser.py`、`payLoad.py` 和 `dataType.py` 处理帧和类型。
-
-### 数字电源协议
-
-Power 页面使用 `app/session/session_power.py` 中的专用协议，不与 `app/protocol/` 的通用 TVLCOM V2 调试工具共享状态机。
-
-- 帧头：`0xAA 0x55`
-- 长度：`CMD + SEQ + Payload` 的字节数，little-endian
-- 校验：Modbus CRC16，little-endian
-- 载荷：TLV 列表，格式为 `Type(1) + Length(2) + Value(N)`
-- 命令：`ACK(0x00)`、`READ(0x01)`、`WRITE(0x02)`、`REPORT(0x03)`、`STREAM_START(0x04)`、`STREAM_STOP(0x05)`、`NACK(0xFF)`
-- 原始流分隔：流式采样通道使用 `0xFE 0xED` 作为通道分隔符
-
-常用数据类型在 `PowerDataType` 与 `POWER_DATA_META` 中维护。修改协议时，需要同步上位机、下位机枚举、协议文档和测试。
-
-### 图表数据流
-
-电源页面将解析后的状态转换为通道数据，写入 `DataHub`。`ChartModel` 从 `DataHub` 读取窗口内数据，`RealtimeChartWidget` 使用 pyqtgraph 展示曲线，并提供通道显示、时间窗口和数值面板。
-
-## 开发约定
-
-- 分层文件命名采用“层名在前、对象在后”的形式，便于文件列表中按职责聚合：页面用 `page_power.py`，控制器用 `controller_power_page.py`，会话用 `session_power.py`，管理器用 `manager_firmware.py`。
-- 类名使用 `PascalCase`，并保留清晰的分层后缀，例如 `PowerPage`、`PowerPageController`、`DaplinkPyocdSession`。
-- 普通函数和局部工具函数优先使用 `snake_case`；已有 PyQt 页面方法可以继续沿用项目现有的 `camelCase` 风格，避免为了统一命名做无意义的大范围改动。
-- 私有方法按用途分组命名：`_init_xxx` 创建界面，`_bind_xxx` 注册事件，`_apply_xxx` 应用配置或状态，`_update_xxx` 刷新显示，`_on_xxx` 响应控件或事件。
-- 页面和业务之间的信号按事件语义命名：请求类用 `xxxRequested`，状态类用 `xxxChanged` / `xxxUpdated`，结果类用 `xxxReady` / `xxxFinished`，错误类用 `xxxFailed` / `errorOccurred`。
-- 复杂页面优先加 Controller 层。Page 负责控件创建和状态展示，Controller 负责信号绑定和操作入口编排，Session/Client 负责通信细节。
-- 页面提示统一调用 `app/core/utility.py` 的 `showMessage(...)`；主窗口会同时显示右上角 InfoBar 和标题栏 DynamicIsland。
-- 跨线程通信使用 Qt 信号或自定义 Qt 事件，不要从 worker 线程直接操作控件。
-- 新增持久化设置统一走 `config.CTX.cfg` / qfluentwidgets `QConfig`。
-- 新增页面样式时，同步 `StyleSheet` 枚举、页面 `objectName` 和 `Resources/Theme/qss/{light,dark}/` 下的 QSS 文件名。
-- 修改 Power 协议前，先更新协议表，再同步上下位机枚举、元数据、读写处理和测试。
-- DAPLink 烧录默认依赖 `Resources/Tools/Pack/` 中的本地 `.pack` 文件。
-- `build/`、`Logs/`、`.venv/`、`__pycache__/`、`.pytest_cache/` 和运行时配置目录不作为源码维护。
-
-## 常用入口
-
-- 应用入口与主窗口导航：`start.py`
-- 电源页面：`app/widgets/pages/page_power.py`
-- 电源协议：`app/session/session_power.py`
-- 串口/蓝牙调试页：`app/widgets/pages/page_device.py`
-- 通用串口会话：`app/session/session_serial.py`
-- TVLCOM V2 工具：`app/protocol/`
-- DAPLink 页面：`app/widgets/pages/page_daplink.py`
-- DAPLink 会话：`app/session/session_daplink.py`
-- 电池组页面：`app/widgets/pages/page_battery.py`
-- 配置与路径：`config/config.py`
-- 样式管理：`app/manager/manager_stylesheet.py`
-- 实时曲线：`app/widgets/chart/`
+---
+
+## 7. 快速开始
+
+### 7.1 启动上位机
+
+```powershell
+git clone https://github.com/UF4OVER/UF4DigitalPower
+git submodule update --init --recursive
+```
+```powershell
+uv sync
+uv run python start.py
+```
+
+
+---
\ No newline at end of file
diff --git a/docs/HW_POWER/gerber/Gerber_POWER_2026-06-16.zip b/docs/HW_POWER/gerber/Gerber_POWER_2026-06-16.zip
new file mode 100644
index 0000000..fe04395
Binary files /dev/null and b/docs/HW_POWER/gerber/Gerber_POWER_2026-06-16.zip differ
diff --git a/docs/HW_POWER/schematic/SCH_POWER_1-POWER_2026-06-16.png b/docs/HW_POWER/schematic/SCH_POWER_1-POWER_2026-06-16.png
new file mode 100644
index 0000000..d9c1992
Binary files /dev/null and b/docs/HW_POWER/schematic/SCH_POWER_1-POWER_2026-06-16.png differ
diff --git a/docs/HW_POWER/schematic/SCH_POWER_2-STLINK_2026-06-16.png b/docs/HW_POWER/schematic/SCH_POWER_2-STLINK_2026-06-16.png
new file mode 100644
index 0000000..4323b2d
Binary files /dev/null and b/docs/HW_POWER/schematic/SCH_POWER_2-STLINK_2026-06-16.png differ
diff --git a/docs/HW_POWER/schematic/SCH_POWER_3-MCU_2026-06-16.png b/docs/HW_POWER/schematic/SCH_POWER_3-MCU_2026-06-16.png
new file mode 100644
index 0000000..235ee36
Binary files /dev/null and b/docs/HW_POWER/schematic/SCH_POWER_3-MCU_2026-06-16.png differ
diff --git a/docs/HW_UPPER/gerber/Gerber_PCB4_2026-06-16.zip b/docs/HW_UPPER/gerber/Gerber_PCB4_2026-06-16.zip
new file mode 100644
index 0000000..62f1b8e
Binary files /dev/null and b/docs/HW_UPPER/gerber/Gerber_PCB4_2026-06-16.zip differ
diff --git a/docs/HW_UPPER/schematic/SCH_STM32H743_1-ALL_PART_2026-05-09.png b/docs/HW_UPPER/schematic/SCH_STM32H743_1-ALL_PART_2026-05-09.png
new file mode 100644
index 0000000..214094c
Binary files /dev/null and b/docs/HW_UPPER/schematic/SCH_STM32H743_1-ALL_PART_2026-05-09.png differ
diff --git a/lib/DAPLINK b/lib/DAPLINK
new file mode 160000
index 0000000..e9acf77
--- /dev/null
+++ b/lib/DAPLINK
@@ -0,0 +1 @@
+Subproject commit e9acf7722e8db83fbf929670953c03269c56ec87
diff --git a/lib/UF4COM b/lib/UF4COM
new file mode 160000
index 0000000..90bc2dd
--- /dev/null
+++ b/lib/UF4COM
@@ -0,0 +1 @@
+Subproject commit 90bc2dd42bc5392a9a7efdb6b48e723a7bf4979b
diff --git a/start.py b/start.py
index 54402d4..050c788 100644
--- a/start.py
+++ b/start.py
@@ -13,11 +13,9 @@
 
 import sys
 import time
-
-from PyQt5.QtGui import QCloseEvent
-
 time_ = time.time()
 
+from PyQt5.QtGui import QCloseEvent
 from PyQt5.QtCore import Qt, QTimer
 from PyQt5.QtWidgets import QApplication
 
@@ -26,11 +24,7 @@
 
 logger = get_logger("Bootstrap")
 
-
 from ui import Window
-# # 解决 qfluentwidgets 对 QSS 中 path 带空格的情况无法识别的问题
-# from PyQt5.QtWidgets import QStyleFactory
-# QStyleFactory.setStyle("Fusion")
 
 class Application(Window):
     def __init__(self):