如果你是装了 Decky 的 Steam Deck 用户，可能对这种场面不陌生：昨天用着还好好的，系统照常更新，今天打开插件商店就直接报错，界面错乱、插件失灵，严重的连机器都没法正常开机。6 月那波事故里，就有用户在评论区记录：昨天用着没问题，没想到今天就报错了。哔哩哔哩这不是个例。我翻了 B 站上专门针对「插件商店报错」的修复视频：5 月底和 6 月底的两个月里，两波事故各催生出一批自救教程，其中四支集中发布的视频合计播放超过 7.3 万，评论接近一千条。哔哩哔哩再往前倒，去年 10 月、11 月也各有一支同类修复视频。也就是说，这已经是 Decky 用户反复经历至少半年的老毛病了。今天就把它讲清楚：为什么总是坏、坏了怎么办、以后怎么更新才能少中招。
为什么总是坏
先说 Decky Loader 是什么。它是社区做的插件运行框架，相当于一个扩展平台，插件商店和各种插件都嵌在 Steam Deck 的游戏模式界面里运行。知乎玩家常用的 PowerTools 功耗调节、小黄鸭插帧，还有 SteamGridDB 封面替换这类系统增强工具，都依赖它运行，不少进阶用户其实早就装好了。知乎
问题就出在这个「嵌进去」的结构上。Valve 一直在高频推送 SteamOS 和 Steam 客户端更新，底层界面一动，Decky 的嵌入层和插件商店就可能跟着失效。做修复视频的 UP 主自己也看明白了这一点：插件商店会根据你的系统更新而跟着更新。哔哩哔哩所以顺序永远是 Valve 先更新、社区跟着坏、坏了之后再有人放出适配版本和修复教程，这就是修复视频总是一波一波出现的根本原因。
2026 年的两波事故，帮你捋一遍
5 月底是第一波。插件商店早在去年 11 月就更新到了 v3.2.0。哔哩哔哩而这次的导火索是 5 月 27 日的 SteamOS 客户端更新，插件商店打开直接报错，第二天就有人出视频讲解决方法。哔哩哔哩当时商店版本卡在 v3.2.5-pre1 和 3.2.6 之间，有用户装了预览版之后商店更新一直转圈，等 30 分钟没反应，搜索插件也变得很慢。哔哩哔哩
6 月 24 日的第二波更严重。不只是商店报错，有人的机器直接纯黑屏、无法唤醒，重启还卡在开机图标上，反复重启两三次才开机，系统语言都被重置成了英文。哔哩哔哩当天就有两支修复视频发布，其中一支用的工具箱还在持续迭代，作者直接写明 A6 和 D1 两个分支都能修复插件报错。哔哩哔哩
坏了之后，按症状自救
我把评论区里被验证过的方法按症状整理出来，从温和到激进：
症状 | 首选做法 | 备注 |
|---|---|---|
商店打不开、报错 | 进插件商店设置，把「更新通道」切到测试/发布候选，再升级商店 | 两波事故评论区支持最多的路线，网络不畅时可能要连热点 |
商店加载一直转圈 | 先排除网络问题，再重装商店 | 评论区多人靠重装恢复 |
个别插件报错、UI 错位 | 先停用出问题的插件，等作者更新 | 5 月那波 cheatdeck、MangoPeel 都有个例 |
黑屏、无法正常开机 | 强制重启后先禁用 Decky，保证能开机再修 | 6 月波个例，别急着重装系统 |
cheatdeck 的冲突有人验证过解法：装测试版商店就能解决，插件冲突的也要跟着装测试版。哔哩哔哩Freedeck 这类第三方商店则是作者一个月没更新、SteamOS 一更新就出了问题，只能等作者修。哔哩哔哩
上面都不行，还有两个更通用的大招。大招一：用官方安装器重装 Decky，命令和首次安装一样，评论区有人验证过这条官方命令可以直接下载。哔哩哔哩
`curl -L https://github.com/SteamDeckHomebrew/decky-installer/releases/latest/download/install_release.sh | sh`
在桌面模式的终端里执行，注意两个细节：输 sudo 密码时屏幕不显示字符，照常输入回车就行，UP 主专门在评论区解释过这一点。哔哩哔哩再就是官方渠道在 GitHub，国内网络经常连不上，有人感叹国内安装个 Decky Loader 运气不好都要搞很久，这也是修复脚本和工具箱大多走 Gitee、视频站传播的原因。知乎
大招二：第三方修复工具箱。6 月波传得最多的是这条 Gitee 一行脚本，UP 主自己 34 个赞的置顶评论就是让大家重新安装万能工具箱，并且提示地址已经换过。哔哩哔哩
`curl -sL https://gitee.com/soforeve/plugin_patch/raw/master/install | sh -`
但有两点提醒：一是这类脚本地址会变，别照抄旧教程里的链接；二是 `curl | sh` 这种写法等于直接下载并执行别人的脚本，本身是高风险操作，确认信得过作者再用。
再补一个老病例。去年 10 月那波商店崩溃是权限问题引起的，修法是在 homebrew 目录下把插件目录的所有者改回 deck。哔哩哔哩有的教程还会顺手带一条 chmod 777 给满权限，方便是方便，但不推荐照做，普通权限修复一般改所有者就够了。
更重要的事：以后的正确更新姿势
这个坑社区已经反复踩过，评论区也形成了高赞共识：先把插件更到测试版，再更新系统，就不会这么麻烦。哔哩哔哩翻译成操作步骤：
看到系统更新提示先别急着点，打开插件商店，把更新通道切到测试，将商店和你常用的插件都更新到最新；
重启确认商店能正常打开，再去更新系统；
万一更新后还是崩了，按上面的症状表自救。
也有用户分享了自己的实操顺序：先把商城更新到测试版本，然后重启再更新系统，整个过程很简单。哔哩哔哩如果不想赌，更稳的做法是放慢更新节奏：更新提示出来先晾两三天，让社区先踩一轮，等对应的修复方案出现了再更；遇到像 5 月底那种已知有问题的版本，干脆跳过。另外值得知道的是，Steam Deck 目前还处在 SteamOS 3.8.x 分支，8 月中旬已经有性能实测视频在测 3.8.25 版本。哔哩哔哩更新不会停，这场拉锯战短期内也不会结束。
它适合谁，谁可以换个活法
离不开小黄鸭插帧、PowerTools 这些插件的，照「先测试版、后系统」的流程走，这是今年社区验证下来成本最低的活法；
不太懂技术、不想碰终端的，记住两条：报错先重启，再去找最新的修复视频照着最新一期做；
被折腾到躺平的也不必勉强，确实有玩家三天两头遇到问题，已经懒得用了，真受不了画质就开主机玩。哔哩哔哩Decky 不是 SteamOS 的必需品，纯系统照样玩游戏，别让插件变成负担。
最后留个话题：你的插件商店今年崩过几次，最后是怎么修好的？评论区交流一下情报。
