shelter完全指南:为什么这款“永不断线”的新一代Discord客户端Mod值得你立刻上车
shelter完全指南:为什么这款“永不断线”的新一代Discord客户端Mod值得你立刻上车
如果你正在寻找一款不会因Discord更新而失效的Discord客户端Mod,那么shelter就是值得立刻上车的选择。shelter是一款“为最坏情况做准备”(an attempt to prepare for the worst)的新一代Discord客户端Mod,由uwu.network(前Cumcord团队)开发。本文带你快速了解它的核心卖点、安装方法和插件玩法。
为什么shelter被称为“永不断线”的客户端Mod?
2022年9月,Discord的一次内部更新导致几乎所有主流客户端Mod(包括当时流行的那几款)一夜之间集体失效。shelter正是在这个背景下诞生的——它吸取了前代Cumcord的全部经验,设计目标只有一个:对Discord内部代码的依赖降到最低。
它的“稳定”不是口号,而是三条清晰的设计决策:
- 下注稳定组件:shelter几乎不碰Discord的webpack内部模块,而是依赖Flux(Discord的状态管理核心)、React Fiber和HTTP层这些“几乎不可能更换”的底层设施。文档在 packages/shelter-docs/docs/guides/ideals.md 中把这套思路讲得非常透彻。
- 不做破坏性变更:shelter的API更新时只做向后兼容,插件“今天能跑,明天也能跑”。
- 注入方式抗更新:桌面端使用 sheltupdate 代理Discord的模块更新服务器来完成注入,不修改asar包,天然免疫客户端更新。
结果是:shelter自2022年底发布以来持续维护,从未因一次Discord更新而失效,这对“用一天坏三天”的客户端Mod来说几乎是奇迹。
最快安装步骤:桌面端与浏览器双通道
shelter的安装对普通用户非常友好,全程无需Node.js环境,也不需要在电脑上留下零散的Mod文件。
桌面端:一键安装器(sheltupdate)
- 下载并运行官方shelter安装器(shelter-installer)。
- 安装器会自动通过 sheltupdate 完成注入,无需root权限,全平台、全渠道(stable/ptb/canary)均可用。
- 如果你之前装过旧版shelter,安装器会在更新过程中自动移除传统注入器。
- 安装后打开Discord设置,会出现一个
Client Mods区块,用于配置加载项。
⚠️ 小贴士:旧版注入器的技术细节(asar替换原理)在 packages/shelter-docs/docs/guides/injection.md 中仍有完整说明,遇到异常时可对照排查。
浏览器端:装一个扩展即可
shelter完全运行在Web上下文里,因此在浏览器里使用Discord Web版也能装:
- Firefox / Microsoft Edge:直接在对应商店安装shelter官方扩展。
- 其他Chromium内核浏览器:手动加载未打包扩展(在
chrome://extensions开启开发者模式),步骤见 packages/shelter-docs/docs/install.md。
上手shelter插件系统:复制URL即装即用
shelter的插件体验是“新一代”的另一层含义:插件可以热加载,无需刷新页面,随开随关。
安装后在Discord设置中的玩法:
- 分支(Branches)自由组合:sheltupdate支持多个注入分支,比如
shelter、vencord、reactdevtools、yt_ad_block(屏蔽YouTube嵌入广告)、spotify_embed_volume(Spotify嵌入音量条)等,用+拼接即可同时加载,如shelter+yt_ad_block。 - 添加插件只需复制URL:把插件仓库页面的URL粘贴进shelter的插件界面,shelter会拉取、校验并立即运行,整个过程不重启Discord。
- 内置的插件管理UI基于SolidJS构建,源码在 packages/shelter/src/plugins.tsx,设置面板源码在 packages/shelter/src/settings.tsx。
Lune构建工具还能为你的一键式插件站点生成带“复制即装”链接的页面,下图是默认插件页的结构拆解:
而包含完整插件列表的索引页则长这样(同样由Lune SSG生成):
更多插件可以在官网的插件列表页找到,仓库文档也收录了插件索引说明,见 packages/shelter-docs/docs/plugins.md。
开发者向:为什么说shelter的生态“上手即丝滑”?
即使你不写代码,了解这些能力也能帮你判断插件质量;如果你是开发者,这里就是shelter真正的宝藏:
- 全量API暴露:
window.shelter提供Flux拦截(监听/修改/屏蔽dispatch)、HTTP请求拦截、DOM观察器、React Fiber工具等,完整签名见 packages/shelter-docs/docs/reference.md。 - Scoped API自动清理:插件卸载时所有补丁、订阅、拦截器自动撤销,不污染客户端,见 packages/shelter/src/util/scopedApi.ts。
- Lune构建工具:shelter官方的一体式插件构建器,支持esbuild/rolldown两种打包器、秒级构建、Sass/CSS Modules,还有热重载devmode,让“改完立即在Discord里看到效果”成为现实。工具源码位于 packages/lune/,指南见 packages/shelter-docs/docs/guides/lune.md。
- UI组件库:shelter UI用Solid忠实复刻了Discord原生组件(按钮、开关、滑块、模态框、Toast等),插件界面可以做得和原生设置页一样精致,组件源码在 packages/shelter-ui/。
官方开发指南(从零写一个插件)入口在 packages/shelter-docs/docs/guides/plugin.md。
常见问题FAQ
问:Discord更新后shelter会坏吗? 答:shelter的设计目标就是免疫宿主更新,发布至今没有因更新失效过。注入代理sheltupdate每次会校验并同步最新构建,更新由安装器托管。
问:shelter依赖外部服务器,服务器挂了Discord还能打开吗?
答:sheltupdate依赖 inject.shelter.uwu.network 分发构建,官方已为它搭建了高可用部署来保障可靠性;极端情况下可自托管。详见 packages/shelter-docs/docs/guides/injection.md。
问:能同时装Vencord或BetterDiscord吗?
答:可以。sheltupdate的分支机制允许 shelter+vencord 这类组合,在Discord设置的 Client Mods 区块配置后重启Discord生效。
问:插件安全吗? 答:shelter的理念是“你应当可以只信任Mod开发者本身,而不是被迫依赖任何中心化仓库”。插件以URL形式安装,你可以选择安装任何来源的插件,也可以自行构建分发。
总结:上车只需要两分钟
用一句话概括shelter的价值主张:它不是一颗需要不断抢救的“定时炸弹”,而是一座真正为最坏情况准备好的避难所。桌面端跑一遍安装器、浏览器装一个扩展,就能获得两年零失效记录的稳定性、复制URL即装的插件体验,以及一套对开发者极其友好的API生态。如果你受够了客户端Mod三天两头失联的折腾,shelter值得你现在就去试。



