> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wuji.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# 固件升级

点击 Activity bar 的 **Upgrade** 图标 <svg width="1.2em" height="1.2em" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" style={{verticalAlign: 'middle', display: 'inline'}}><path d="M12 2v8" /><path d="m16 6-4 4-4-4" /><rect width="20" height="8" x="2" y="14" rx="2" /><path d="M6 18h.01" /><path d="M10 18h.01" /></svg> 进入固件升级视图。Wuji Studio 提供向导式固件升级流程。

<img src="https://mintcdn.com/wuji-0bbde051/Q08CII5VOvpQDcUt/assets/source/images/zh/wuji-studio/upgrade-steps.png?fit=max&auto=format&n=Q08CII5VOvpQDcUt&q=85&s=bb96838a954b456ffa2a4ae475eebeda" alt="固件升级" width="1438" height="898" data-path="assets/source/images/zh/wuji-studio/upgrade-steps.png" />

## 升级流程

### 第 1 步：选择设备

进入升级视图后，Sidebar 列出所有已连接设备。Sidebar 按产品类型分组展示设备，无法识别的设备归入 **Other Devices** 分组。

选择要升级的目标设备后：

* 显示设备当前固件版本
* 自动检测是否有可用的新版本
* 如果已是最新版本，会给出提示

### 第 2 步：选择固件

应用自动从服务器获取可用固件列表，按版本号从新到旧排序。每个固件条目显示：

* 版本号
* 发布日期
* 发布说明（Release Notes）

选择目标版本后，会显示从当前版本到目标版本的累积变更记录，帮助理解将获得的全部功能更新。

<Warning>
  如果选择的目标版本低于当前版本（降级），升级界面会显示警告提示，并用删除线标记将丢失的功能。请确认降级影响后再继续。
</Warning>

### 第 3 步：升级中

确认升级后，进度条实时显示升级状态：

1. **准备** — 初始化升级环境
2. **传输中** — 将固件传输到设备
3. **验证** — 校验固件完整性

<Warning>
  * 升级过程中请勿关闭应用或断开设备连接。如果尝试关闭应用，会弹出确认对话框提醒升级正在进行。
    升级过程中出现问题，请查阅[故障排查](/docs/wuji-studio/troubleshooting)。
</Warning>

### 第 4 步：升级结果

* **成功**：显示升级前后的版本对比和验证结果
* **失败**：显示错误详情和升级日志，提供重试选项。升级失败时固件会自动回滚到之前的版本


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.