> ## 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.

# 固件升级

> [!WARNING]
>
> 升级过程中，**不要**断开 USB 连接、关闭升级软件或断开设备电源，保持计算机处于活动状态，避免进入休眠。

### 一键升级（推荐）

1. 在设备信息页面，点击**一键升级**，进入升级确认界面。

2. 确认设备信息和目标版本无误后，点击**开始升级**。

   ![开始升级](https://mintcdn.com/wuji-0bbde051/3uhnC3cY-ox8e3b-/shared/assets/source/images/zh/wuji-hand-upgrader/start-upgrade-2025-12.png?fit=max\&auto=format\&n=3uhnC3cY-ox8e3b-\&q=85\&s=5567fa58ec1e658f616402d1773c1aa8)

3. 软件自动执行以下操作，等待升级完成：
   * 下载最新固件
   * 验证固件完整性
   * 执行烧录操作

4. 升级完成后，界面跳转到**升级完成**页面。参考 [升级完成](#升级完成) 完成收尾操作。

### 手动选择固件

需要特定版本或本地固件时，使用手动选择模式。在连接设备页面的**一键升级**下方，点击**或手动选择版本**，进入固件选择界面。

* 左侧显示固件详情和发布说明
* 右侧上方显示可用固件版本卡片
* 右侧下方显示**上传本地固件**

![固件选择界面](https://mintcdn.com/wuji-0bbde051/3uhnC3cY-ox8e3b-/shared/assets/source/images/zh/wuji-hand-upgrader/firmware-selection-2025-12.png?fit=max\&auto=format\&n=3uhnC3cY-ox8e3b-\&q=85\&s=d7b54b3a00528e7274d6a226aba24cc8)

#### 选择在线固件

1. 在可用固件版本区域选择需要的固件版本。
2. 点击版本卡片选中。
3. 点击**安装固件**开始升级。

#### 选择本地固件

1. 点击**上传本地固件**。
2. 选择本地固件压缩包文件（.zip 格式）。
3. 等待文件解压和验证完成。
4. 点击**安装固件**开始升级。

点击**安装固件**后，等待烧录完成，参考 [升级完成](#升级完成) 完成收尾操作。

### 升级完成

升级流程结束后，软件跳转到**更新完成**页面，提示**固件版本验证通过**。

![升级完成](https://mintcdn.com/wuji-0bbde051/3uhnC3cY-ox8e3b-/shared/assets/source/images/zh/wuji-hand-upgrader/upgrade-complete-2026-05.png?fit=max\&auto=format\&n=3uhnC3cY-ox8e3b-\&q=85\&s=a90f3b245fe42cca3277812ef811e706)

页面显示：

* **后续步骤**：关闭本程序、将设备重新上电
* **版本对比**：当前版本 与 目标版本，并标识版本一致

按以下步骤完成升级收尾：

1. 点击**关闭程序**退出 Upgrader，或点击**返回首页**继续升级其他设备。
2. 给灵巧手断电后重新上电，使设备退出 Bootloader 模式，恢复正常工作状态。


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