路由器插件这事，最怕的不是安装失败。
安装失败至少还没动起来。更烦的是：昨天还能用，今天在软件中心点了一下升级，回来发现插件打不开、App 认不到设备，甚至卸载以后页面还显示已安装。
遇到这种情况，最不建议的就是直接重刷、格式化 U 盘，或者反复卸载重装。
更稳的排查顺序是：存储是否还在、软件中心状态是否正常、插件服务有没有启动、数据目录有没有被新版本改坏。
1. 看 U 盘 / 硬盘有没有掉
易有云、Immich、Aria2 这类插件，很多时候不是单独一个页面按钮。它们背后会用到存储挂载、数据目录、Docker 镜像或下载目录。
如果升级后 App 识别不到设备、插件页面能进但服务起不来，先去后台看 USB 设备和挂载点还在不在。
有 SSH 的话也可以看：
df -h
mount
重点看原来的 U 盘 / 硬盘是不是还挂在原路径。如果系统提示要格式化，先别点。 这种时候更应该确认是不是挂载点变了、硬盘盒没上电、USB 口识别异常，或者路径和插件配置对不上。
2. 看软件中心是不是自己卡住了
如果软件中心空白、版本显示异常、插件卸载后还显示已安装，先别急着判断插件坏了。
可以做这几件小动作：
- 换浏览器或无痕窗口打开后台
- 清一下浏览器缓存再进软件中心
- 到软件中心调试页重启 / 重置软件中心状态
- 重启路由器后只进软件中心，不先点插件升级
这一步主要是排除页面缓存、软件中心索引和插件入口残留。页面显示异常，不一定代表插件数据已经坏了。
3. 插件能打开但服务起不来，就看日志
如果插件页面能打开，但状态一直是“获取中”“未运行”“启动失败”，这时要看系统日志和插件日志。
常见方向就几个：
- 新版本依赖没装完整
- 端口被占用
- 数据目录权限不对
- Docker 镜像拉取失败
- 插件脚本更新后和当前固件分支不匹配
这类问题不适合靠反复点启动解决。日志里出现依赖、权限、端口、镜像这类字样，方向基本就出来了。
4. 真要回退，先保数据再找包
如果确认是新版本插件本身的问题，下一步才考虑回退。
但回退前要确认两件事：
- 插件数据目录在哪里，能不能先备份
- 旧版本安装包是不是来自官方发布帖或可信来源
不要为了赶紧恢复，随便找一个网盘旧包就装。插件包和固件分支、架构、软件中心版本不匹配，可能会把问题扩大。
一个简单判断
可以按这个顺序分：
- U 盘 / 硬盘不见了：优先查存储挂载和供电
- 软件中心空白或版本异常：优先查缓存和软件中心状态
- 页面正常但服务起不来：优先查插件日志
- 升级后新版本普遍异常：备份数据后等修复或走可信回退
所以插件升级后不能用，第一反应不应该是“要不要重刷”。
更稳的做法是保住数据，再把问题分到存储、软件中心、插件服务、版本回退这几层里。这样至少不会越修越乱。