本文档旨在为您提供 UKey Core 26 硬件设备在进行固件升级（尤其是目标版本 ≥ 1.1.0）时，若通过 UKey Wallet 客户端遇到底层报错或持续提示“更新失败”时的标准排查与修复方案。
请依次按照以下两种方案进行操作排查。
方案一：提升客户端运行权限 (适用于桌面端系统)
系统底层的权限拦截可能导致客户端无法正常调用 USB 通信接口或写入临时文件。
操作步骤：
彻底关闭当前正在运行的 UKey Wallet 客户端程序。
在桌面或应用程序目录中找到 UKey Wallet 的启动图标，单击鼠标右键，在系统菜单中选择 【以管理员身份运行】。
再次尝试在客户端内执行版本升级流程。
若系统仍报相同错误，请放弃此方法并执行方案二。
方案二：通过固件包执行底层离线修复
当客户端自动更新链路受阻时，您可以通过访问 UKey 官方 CDN 资源库，手动获取资源并对设备进行底层读写修复。本方案包含两部分：系统资源部署与核心固件刷写。
第一阶段：部署底层系统资源 (Resource)
此步骤旨在修复硬件内部缺失或损坏的 UI 与系统底层资源文件。
获取资源包：访问 UKey 官方 CDN 目录，定位至
Core 26 > 最新的 firmware > fullResource路径，下载完整的系统资源压缩包。本地预处理：将下载的压缩包解压，并务必将解压后生成的资源文件夹重命名为
res（全小写）。连接与挂载设备：
将 UKey Core 26 硬件设备手动切入 【存储模式 (Storage Mode)】。
使用原装数据线将设备连接至电脑。
在操作系统的资源管理器中，找到并打开挂载名为
UKey DATA的外置移动磁盘。
写入资源文件：
系统要求：请确保您的计算机操作系统已开启“显示隐藏文件及文件夹”功能。
将预先准备好的
res文件夹，直接复制并粘贴至UKey DATA磁盘根目录。
重启生效：数据写入完成后，安全弹出设备并在物理设备上长按电源键重启 UKey Core 26。
第二阶段：刷写核心固件 (Firmware)
此步骤将利用本地文件完成设备核心驱动与协议的更新。
获取固件本体：再次访问 UKey 官方 CDN 目录，定位至
Core 26 > 最新的 firmware > url路径，下载最新版本的.bin格式固件文件。启动离线安装：使用浏览器访问 UKey 官方在线固件安装与修复工具页面。
导入并执行刷写：
在工具页面中点击 【选择本地文件】 按钮。
在弹出的文件管理器中，选中您刚刚下载的
.bin固件文件。保持设备连接稳定，严格按照页面上的通信交互指引，等待进度条走完以完成最终的底层固件刷写。