故障排除

4.1 安装依赖问题

安装 deb 包时出现依赖问题，执行以下命令修复：

sudo apt-get install -f

4.2 串口权限问题

启动时提示串口权限不足，使用以下方式解决：

sudo wujihand-upgrader

或将当前用户加入 dialout 组（推荐，无需每次 sudo）：

sudo usermod -a -G dialout $USER
newgrp dialout
wujihand-upgrader

4.3 升级工具窗口不显示

如果安装完成后点击桌面图标，任务栏中出现了升级工具图标，但主窗口始终没有显示，可先在终端中启动程序进行排查。

若终端中出现 Failed to create GBM buffer of size 1280x720: Permission denied（GBM 缓冲区错误），通常说明 NVIDIA 驱动未启用 DRM 内核模式设置（Kernel Mode Setting）。相关背景可参考 dioxus#1909。

可按以下步骤处理：

1. 检查是否已启用 modesetting：

   cat /sys/module/nvidia_drm/parameters/modeset

2. 如果输出为 N，执行以下命令启用：

   echo options nvidia_drm modeset=1 | sudo tee /etc/modprobe.d/nvidia_drm.conf

3. 重启计算机后，再次启动升级工具。