NuvioMobile 插件安装完整实战指南：半小时从空壳到装满影视资源

NuvioMobile 插件安装完整实战指南：半小时从空壳到装满影视资源

【免费下载链接】NuvioMobileOfficial Nuvio Mobile Repository项目地址: https://gitcode.com/gh_mirrors/nu/NuvioMobile

NuvioMobile 是一款基于 Kotlin Multiplatform 打造的跨平台媒体中心应用，它的核心本事是让你像拼乐高一样，用各种插件把流媒体资源「搬」进同一个界面里。如果你受够了在各个网站之间反复横跳，这篇文章会带你用半个小时把影视库真正搭起来——不需要任何技术背景，跟着步骤走就行。

先给个结论：NuvioMobile 的插件安装只有两条路——手填链接，或点 stremio:// 协议链接。两条路我下面都会拆开揉碎讲清楚，各有适合的场景。

---

为什么你的应用装完了，却感觉「空空如也」

很多朋友第一次打开 NuvioMobile 时的第一反应是：首页怎么这么素？这不是错觉，而是它的设计理念——应用本身只提供「房子」，内容全靠插件来「添家具」。

你安装的每一个插件，就像给电视盒子插上一张新的内容卡：有的负责提供电影资源，有的负责字幕，有的负责同步你另一个平台的观看记录。插件装得越多，首页的栏目、推荐位、资源入口就越多，应用才真正「活」起来。

换句话说：装插件这件事，才是玩转 NuvioMobile 的真正起点。

插件到底是「什么东西」，一句话说清楚

在动手之前，先用 30 秒建立正确的心理模型。

每个插件本质上是一个跑在别人服务器上的小服务，它对外只提供一个叫manifest.json的「说明书」文件。这个文件里写明了插件叫什么、提供哪些内容类型（电影、剧集、字幕……）、能提供哪些资源。

NuvioMobile 做的事情很简单：读取这份说明书 → 按说明去拉内容 → 展示给你。所以「安装插件」这个操作，核心其实就一句话——把 manifest 文件的网络地址告诉应用。

如果你好奇应用内部是怎么解析这份说明书的，可以去项目源码里看composeApp/src/commonMain/kotlin/com/nuvio/app/features/addons/AddonManifestParser.kt，代码不长，注释风格也清晰，适合当入门读物。

出发前的 5 分钟：先把应用本体装到设备上

这一步简单，但不少人会卡在「找不到官方下载渠道」。

Android 用户：

1. 打开应用官网的 Releases 页面，下载最新版 APK；
2. 手机上允许「安装未知来源应用」的权限提示；
3. 点击安装包完成安装。

iOS 用户：

1. 通过 TestFlight 加入测试计划；
2. 等待 TestFlight 自动安装；
3. 首次打开时按系统提示信任开发者证书即可。

小提醒：Android 上建议下载Full 完整版，它额外内置了插件脚本运行时，部分进阶功能只有完整版才有。安装包的区分在文件名里通常能直接看出来。

三分钟上手：插件安装的两条官方路径

现在进入正题。NuvioMobile 给了你两种安装插件的方式，我建议你两条都学会，因为不同场景下谁更方便真不一定。

路径 A：手填链接，稳扎稳打

这是最通用、最不容易出错的方式，尤其适合你在电脑上已经找到了某个插件的 manifest 地址的情况。

1. 打开 NuvioMobile，进入设置 → 插件管理；
2. 找到输入框，粘贴插件的 manifest 完整链接（形如https://xxx/manifest.json）；
3. 点击「安装插件」，应用会先校验链接，再弹出确认窗口；
4. 看到「安装成功」提示后，插件立刻生效。

整个过程不超过 10 秒。应用在校验时会顺便把插件的名称、版本、资源类型都拉回来展示，所以你装的是什么、能干什么，一眼就能确认，不会「装了个寂寞」。

路径 B：浏览器点一下 stremio:// 链接

很多插件官网或导航站提供的是stremio://开头的安装链接。NuvioMobile 原生支持这种协议，处理起来非常顺滑：

1. 在手机浏览器里找到 stremio:// 安装链接；
2. 点击它，系统会弹窗询问用哪个应用打开；
3. 选择 NuvioMobile；
4. 应用自动进入插件安装确认页，点确认即完成。

这背后其实是应用内置的链接桥接逻辑在帮忙——它会把stremio://链接自动转换成对应的https://链接再走一遍标准安装流程。想了解实现细节的，可以翻源码composeApp/src/commonMain/kotlin/com/nuvio/app/core/deeplink/AppUrlBridge.kt，里面有完整的协议解析逻辑。

两条路径怎么选？一张表看懂

对比维度	手填链接（路径 A）	stremio:// 链接（路径 B）
适用场景	你已经知道确切地址	网页上一键点击
操作步骤	复制 → 粘贴 → 确认	点击 → 选应用 → 确认
出错概率	低（地址手打易错）	更低（不会打错字）
推荐指数	⭐⭐⭐⭐⭐	⭐⭐⭐⭐

我的建议是：平时以路径 A 为主，遇到导航站上的现成链接就用路径 B。两种方式安装出来的插件没有任何区别，看习惯选。

装完只是开始：插件管理界面里藏着的四个实用功能

插件装上之后，回到「插件管理」页面，你会看到一个总览卡片和已安装插件列表。别急着走，这里面的操作能极大影响你的使用体验。

1. 总览统计：卡片会显示你装了几个插件、几个处于启用状态、一共贡献了多少个内容栏目。这个数字是诊断问题的第一线索——如果显示「0 个活跃」，大概率是插件没启用。
2. 启用/禁用开关：每个插件右边都有个开关。这个功能特别好用——你不需要删除插件，只需要临时关掉它，比如某个插件的源不太稳定时，先关掉，过几天再开回来，配置都还在。
3. 排序调整：列表里的插件可以上下移动。排序 = 优先级，排在越上面的插件，在提供同名资源时越容易被优先采用。常用插件往前提，冷门的往后放，播什么资源都能「抢先吃到好源」。
4. 刷新与配置：个别插件带有「配置」按钮（说明它的说明书里标记了可配置项），点开可以设置账号或偏好；「刷新」按钮则用于强制重新拉取插件的最新版本信息。

这些交互都对应源码里的AddonsScreen.kt界面逻辑，感兴趣的话可以直接在composeApp/src/commonMain/kotlin/com/nuvio/app/features/addons/目录下翻到它。

换手机不重装：插件配置的云端同步

这可能是最容易被忽略、但幸福感最强的一个功能。

NuvioMobile 支持按登录账号同步插件配置。也就是说：

1. 登录账号后，你安装的插件列表、启停状态、排列顺序都会被同步到云端；
2. 换新设备、或重新安装应用后，只要登录同一个账号，插件配置就会自动恢复；
3. 同步是按「档案（Profile）」隔离的，如果你有多个观影档案，每个档案的插件配置互不干扰。

换个说法：手机丢了不可怕，账号在，插件配置就在。

如果你在同步后遇到插件「消失」的情况，先别急着重装，检查一下当前登录的是不是原来的账号——这能救回 90% 的「插件不见了」问题。

进阶一步：自己写个最小插件，彻底搞懂原理

如果你属于「想知其所以然」的那类人，这里有一个只保留核心逻辑的最小示例。它会帮你理解「说明书 + 数据」这个模型到底是怎么运转的。

const { addonBuilder, serveHTTP } = require('stremio-addon-sdk') // 1. 声明插件的基本信息：它是给谁用的、能提供什么 const builder = new addonBuilder({ id: 'org.demo.basic', // 插件唯一编号 version: '1.0.0', // 版本号，改动后记得升 name: '演示插件', // 显示在插件列表里的名字 resources: ['stream'], // 能力：只提供播放流 types: ['movie'], // 适用内容类型：仅电影 idPrefixes: ['tt'] // 认识以 tt 开头的影视 ID }) // 2. 当用户点击某部电影时，这里负责返回能播的地址 builder.defineStreamHandler(function (args) { if (args.type === 'movie' && args.id === 'tt1254207') { return Promise.resolve({ streams: [{ url: 'https://example.com/video.mp4', title: '演示资源' }] }) } return Promise.resolve({ streams: [] }) }) // 3. 启动本地服务，暴露 manifest.json serveHTTP(builder.getInterface(), { port: 7000 })

把这段代码存成addon.js，在装有 Node.js 的电脑上运行node addon.js，然后回到 NuvioMobile，用路径 A 填入http://localhost:7000/manifest.json，你的第一个「自研插件」就上线了。

顺带一提：NuvioMobile 的 Full 完整版自带一套 JS 插件运行时，源码位于composeApp/src/fullCommonMain/kotlin/com/nuvio/app/features/plugins/runtime/，它对 WebAssembly、JS 绑定、网络桥接都有完整封装，是研究移动端轻量插件机制的好素材。

常见翻车现场：四个高频问题对症下药

插件安装失败？

先看网络，再查地址。检查链接是不是完整的https://开头、末尾有没有带manifest.json。输入框下方如果出现红色提示，通常就是格式问题。

装完但首页没出现新内容？

回到插件管理页，确认开关是开启状态，再确认插件本身声明了对应的内容类型（比如它只支持电影，你就别指望剧集栏目出现它的资源）。

同一个资源总被质量差的源抢先？

去插件列表调整排序，把口碑好的插件往上挪。排序直接影响源的选取优先级。

换设备后配置没同步回来？

登录同一个账号，然后到插件管理页下拉刷新，或点右上角的刷新按钮手动拉取一次。

---

核心要点速览

• NuvioMobile 是「空房子」，插件才是「家具」，安装插件才是应用的真正起点；
• 安装插件只有两条路：手填 manifest 链接，或直接点 stremio:// 协议链接；
• 插件管理页里的开关、排序、刷新、配置四个功能，请务必都用一遍；
• 插件配置按账号云端同步，换手机前先确认登录状态；
• 想进阶就自己写个最小插件，10 行代码就能跑通整个流程。

工具已经备齐，路径也都探明了。现在就去装两个插件试试——等你看到首页第一次出现整整齐齐的推荐栏目时，就会明白什么叫「花半小时，受益一整年」。动手吧 🎬

【免费下载链接】NuvioMobileOfficial Nuvio Mobile Repository项目地址: https://gitcode.com/gh_mirrors/nu/NuvioMobile