什么是数据源：TVBox 如何从空白壳到满屏节目

一个比喻：壳 + 管道 = 完整体验

想象 TVBox 是一个空的净水机外壳——里面有水管、滤芯、龙头，但没有水源。数据源接口就是接进来的管道。接上管道，水（内容）就源源不断流进来；换一根管道（换源），水的来源就变了；管道断了（源失效），净水机就什么也出不来。

这个比喻里：

• TVBox 本体 = 外壳 + 内部管路 + 龙头（播放器框架）
• 数据源接口 = 进水管道（数据从哪来）
• 影视内容 = 水（最终用户看到的东西）

数据源接口长什么样

从用户角度看，数据源接口通常就是一个 URL，比如：

• 一个 JSON 接口地址：https://example.com/api/tv.json
• 一个 m3u 直播源地址：https://example.com/live.m3u
• 一个 JS 爬虫脚本地址：https://example.com/spider.js

也可能是一个本地文件路径（如果接口是本地维护的），或者直接粘贴一段 JSON 文本。

接口接进来之后发生了什么

用户添加一个接口地址后，TVBox 会：

1. 请求接口：向那个 URL 发 HTTP 请求；
2. 解析响应：根据接口类型（JSON / JS / m3u）用对应的解析器解析响应内容；
3. 填充界面：把解析出的分类、剧集、频道渲染到首页和分类页；
4. 缓存数据：短时间内的分类和详情请求可以复用缓存，加快加载速度。

整个过程对用户透明——你只需要填一个地址，TVBox 负责后面所有事。

源和源之间的关系

一个活跃的配置通常同时接入多个源：

• 源 A 覆盖国产剧；
• 源 B 覆盖美剧日剧；
• 源 C 是 m3u 直播源，提供电视频道。

TVBox 会把所有源的分类去重合并，所有可播放的线路汇总成同一个剧集的多个播放线路——这就是「聚合模式」的来源（详见聚合模式详解）。

源会失效

数据源的可用性取决于源提供方的维护：

• 有些开源接口长期稳定运行数月甚至数年；
• 有些第三方接口随时可能被封或自己下线；
• 爬虫源如果目标网站改版，会在几天内失效。

没有永远有效的源。好的习惯是手里常备 3~5 个不同的源，一个挂了换另一个。

下一页

概念清楚了，接下来第一步是把接口地址加进去——TVBox 设置里具体怎么操作。