> ## 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 连接、关闭升级软件或断开设备电源，保持计算机处于活动状态，避免进入休眠。
</Warning>

### 一键升级（推荐）

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

2. 确认设备信息和目标版本无误后，点击**开始升级**。
   <img src="https://mintcdn.com/wuji-0bbde051/GsT0bEnPZ_18e5HL/assets/source/images/zh/wuji-hand-upgrader/start-upgrade-2025-12.png?fit=max&auto=format&n=GsT0bEnPZ_18e5HL&q=85&s=bfe6b17ccc23327d8395637a341cab66" alt="开始升级" width="1327" height="766" data-path="assets/source/images/zh/wuji-hand-upgrader/start-upgrade-2025-12.png" />

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

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

### 手动选择固件

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

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

<img src="https://mintcdn.com/wuji-0bbde051/GsT0bEnPZ_18e5HL/assets/source/images/zh/wuji-hand-upgrader/firmware-selection-2025-12.png?fit=max&auto=format&n=GsT0bEnPZ_18e5HL&q=85&s=546baee54c119cc682c74f7c1580b88e" alt="固件选择界面" width="1326" height="763" data-path="assets/source/images/zh/wuji-hand-upgrader/firmware-selection-2025-12.png" />

#### 选择在线固件

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

#### 选择本地固件

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

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

### 升级完成

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

<img src="https://mintcdn.com/wuji-0bbde051/GsT0bEnPZ_18e5HL/assets/source/images/zh/wuji-hand-upgrader/upgrade-complete-2026-05.png?fit=max&auto=format&n=GsT0bEnPZ_18e5HL&q=85&s=6fbec327c2ee64f5640299c5d2655f8c" alt="升级完成" width="1278" height="718" data-path="assets/source/images/zh/wuji-hand-upgrader/upgrade-complete-2026-05.png" />

页面显示：

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

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

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


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