一站式 Stremio 资源聚合：StreamVision 三步部署，从多源筛选、排序策略到 Debrid 磁链加速
【免费下载链接】torrentio-scraper项目地址: https://gitcode.com/GitHub_Trending/to/torrentio-scraper
在 Stremio 里找一个能看的资源，很多人都有过这样的经历：单个插件返回的条目参差不齐，种子数少、画质杂、磁链点开后半天没动静，只能换一个源再试一次。StreamVision（项目名 torrentio-scraper）就是一个基于 Torrentio 的 Stremio 资源聚合插件，它把多个 torrent 源的条目集中起来，经过筛选、排序后再下发给播放器，让"搜索一次，拿到可用结果"成为常态。
一分钟看懂 StreamVision
StreamVision 是一个自托管的 Stremio 插件服务，核心链路分四步：Stremio 发出播放请求 → 插件从数据库聚合多个源（YTS、EZTV、1337x 等 25 个 provider）的条目 → 按源、画质、体积等条件筛选 → 按种子数与画质策略排序后下发。接入 Debrid 服务后，它还会把磁链解析成直连下载链接。对使用者来说，整个过程就是"输入片名，拿到排好序的结果"。
首次部署：三步跑通聚合服务
准备环境与克隆仓库
先确认本机已安装 Node.js（项目基于 Express 运行，任意近期 LTS 版本即可）。然后克隆代码仓库：
git clone https://gitcode.com/GitHub_Trending/to/torrentio-scraper安装依赖（Node.js + npm install）
插件本体位于addon目录，进入后安装依赖：
cd torrentio-scraper/addon npm install依赖里包含了各 Debrid 服务的 SDK（real-debrid-api、premiumize-api、all-debrid-api 等）以及缓存、限流相关库，一次安装即可覆盖后续全部功能。
启动服务并接入 Stremio
启动命令只有一条：
npm start服务默认监听 7000 端口，控制台会打印出插件访问地址。打开 Stremio 的 Addon 管理页，把http://localhost:7000/manifest.json作为 URL 添加即可。如果部署在服务器上，把 Stremio 端的地址换成服务器的公网地址；项目也提供了 addon/Dockerfile，可用 Docker 方式部署。
按使用流程走读核心能力
多源搜索与聚合
功能点：你搜索某部影片时，插件会按 IMDB ID 从本地数据库拉取所有相关条目，覆盖电影、剧集和动漫，条目里已经带有来源、画质、体积、种子数等解析好的字段。适用场景：一次搜索拿到全部候选，省去在多个站点之间来回切换。代码位置：addon/lib/repository.js 定义了 torrent、file、subtitle 三张数据表及按 IMDB ID / Kitsu ID 查询的接口；可选源清单在 addon/lib/filter.js 的Providers中维护。
按种子数/大小/上传日期筛选
功能点：聚合结果会依次经过三级过滤器：按来源（provider）、按画质（qualityfilter，如排除 Cam/SCR、只保留 4K 或 Dolby Vision）、按体积上限（sizefilter，区分电影和剧集的取法不同）。种子数与上传日期则是数据侧预排序字段——数据库里存有uploadDate，种子数从条目标题解析，作为后续排序的输入。适用场景：手机流量有限时限制体积；看日更动漫时排除低画质源。代码位置：筛选逻辑集中在 addon/lib/filter.js 的applyFilters中，三个过滤器按filterByProvider → filterByQuality → filterBySize顺序串联。
排序策略如何生效
功能点：插件内置 4 种排序策略：先画质再种子数（quality，默认）、先画质再体积（qualitysize）、纯种子数（seeders）、纯体积（size）。其中"种子数"排序并非无脑取前 N：它先识别出种子数 ≥ 5 的"健康条目"，健康条目足够多就只返回健康条目，不足时才放宽到种子数 ≥ 1 的条目并限量兜底。适用场景：默认策略适合大多数情况；想要最快开下时用 seeders 策略；在意存储时用 size 策略。代码位置：addon/lib/sort.js，阈值常量（如HEALTHY_SEEDERS = 5）直接写在文件头部，行为一目了然。
磁链优化
功能点：原始条目自带的 tracker 列表往往有限，插件会在生成磁链时合并一份社区维护的最优 tracker 列表；对动漫源额外补充动漫专用 tracker，对俄罗斯源（Rutracker 等）单独补充 tracker 并改用 DHT 解析，最后把dht:节点也写进 stream 的 sources 字段。适用场景：同一资源，tracker 越全，客户端连上 peers 的速度越快，这也是"磁链加速配置"中最基础的一环。代码位置：addon/lib/magnetHelper.js 的getMagnetLink负责编码磁链，enrichStreamSources负责按源类型追加 tracker。
接入 Debrid 服务（Real-Debrid、Premiumize 等）加速直连
功能点：如果不想本地挂种或等 DHT，可以在配置里填入 Debrid 服务的 API token，插件会把磁链提交给 Debrid 解析成直连 HTTP 链接，Stremio 端即可边下边播。项目共集成 9 家服务：Real-Debrid、Premiumize、AllDebrid、DebridLink、EasyDebrid、OffCloud、TorBox、Put.io、Highway。每家服务配了独立模块，并用熔断器（circuit breaker）监控解析成功率，某家服务持续失败时会自动降级而不是卡住整个请求。适用场景：家庭带宽有限、或需要回看剧集时，直连体验明显好于纯 P2P。代码位置：addon/moch/ 目录，各服务一个文件，addon/moch/circuitBreaker.js 实现熔断逻辑。
配置项速览：让行为贴合你的习惯
所有行为都通过 URL 路径里的参数串控制，形如key=value|key=value，例如providers=yts,eztv|qualityfilter=scr,cam|sort=seeders。解析逻辑在 addon/lib/configuration.js 的parseConfiguration中，数组类参数（provider、画质、语言）用逗号分隔。文件里还内置了两套预配置（lite和brazuca），分别对应"精简源 + 排除低画质"和"葡语内容"场景，说明参数组合的实际效果，可以参考它的写法再自定义。常用项就四类：providers（开哪些源）、qualityfilter（排除哪些画质）、sizefilter（体积上限）、sort（排序策略），加上各 Debrid 服务的 token 键。
常见问题速查
- 结果加载慢怎么办：插件对查询结果有缓存（默认 1 小时），首查慢属正常；若某片长期无结果，优先选种子数更高的条目，或接入 Debrid 绕过本地网络瓶颈。
- 资源库多久更新一次：条目数据由上游爬虫任务写入数据库，插件侧按缓存过期时间逐步刷新；重启服务（
npm start）会立即重建部分缓存，可以手动触发一轮。 - 磁链点了没反应：确认插件已成功拉取最优 tracker 列表（启动日志会打印 "Retrieved best trackers"）；动漫和俄语源走的是专属 tracker 列表，仍无响应时检查客户端是否开启了 DHT。
- Debrid 解析失败或频繁超时：先核对 API token 是否填对（有长度与字符校验），再看是否触发了该服务的速率限制；熔断器生效期间该服务会被自动跳过，稍后恢复。
小结
StreamVision 把"多源搜索、条件筛选、健康度排序、磁链增强、Debrid 直连"整合在一条请求链路里，部署只需三步，行为全部可以通过 URL 参数调整。对于想自建一套可控资源聚合服务的 Stremio 用户，它是目前结构清晰、便于按模块阅读的参考实现。后续如果想加源或调整排序规则，从filter.js和sort.js入手即可，改动范围都很收敛。
【免费下载链接】torrentio-scraper项目地址: https://gitcode.com/GitHub_Trending/to/torrentio-scraper
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
