想弄明白 TVBox，绕不开"接口"这两个字。
接口在 TVBox 里是一份 JSON 文本，通常挂在某个网址上，打开就能看到一大段结构化的配置。软件启动时会去读这份东西，从中知道自己该显示哪些内容源、该用什么方式处理视频地址、直播频道又从哪里来。打个不太精确但好用的比方：软件本体是躯干，接口是大脑。同一副躯干换上不同的接口，能力就完全不一样。
图中这一栏就是填接口的地方。它分了几个输入框，分别对应不同的东西：仓库地址、单条线路地址、以及直播源的地址。第一次上手容易在这里犯迷糊，把三种地址混着填。看完下面这段，再回头看这张图就清楚了。
这份 JSON 内部大致分四块，各司其职。站点部分定义了每一个内容源，每个源有名称、类型和地址；直播部分存放频道清单；解析部分负责处理那些不能直接播放、需要跳一次才拿得到的地址；剩下的是全局选项，控制播放内核、界面显示这类细节。
上面是设置页的全貌。上半部分和接口有关，下半部分是你自己在本机做的选择——播放器用哪个、解码走硬解还是软解、首页显示什么。这两类设置要分开看：接口决定"能不能找到片"，本机设置决定"找到了能不能顺畅播"。
内容源本身分三种。最常见的是采集站，它相当于一个影视数据库，你搜索时软件向它发请求，它返回片单和播放地址。第二种叫解析器，作用是绕过某些平台的试看限制，把只能看几分钟的链接换成能完整播放的地址。第三种是直播源，本质就是一份频道名加播放地址的清单，常见格式是 TXT 或 M3U，软件读它来生成直播列表。
还有一类东西叫 spider，一般叫爬虫模块。它是打包好的代码，专门处理采集站返回的数据。你可能会在配置里看到 csp_、js_、py_ 这样的前缀，代表三种不同的加载方式：前两种是编译好的模块或纯脚本，第三种需要软件支持运行 Python。模块的好处是把抓取和解析的逻辑都藏起来，你改不了也不用管；坏处也在这里，里面干了什么，你从外面看不出来。
再往上还有一层概念叫"多仓"。一份接口地址里可以塞很多条线路，逐条切换太麻烦，于是有人把多个接口打包成一个仓库，你先选仓库再选线路。这带来一个很实用的效果：某条线路挂了，直接换下一条，不用重新填地址。
这套机制也解释了为什么很多人推荐一次配两三个仓库。不是越多越好，而是要有备份——一个主用一个备用，主力挂了随手切过去，比临时满网找新地址省事得多。
把链路串起来，整个流程就清楚了。软件启动时先读接口配置；你搜索一个片名，软件拿着关键词去问配置里的每一个采集站；采集站返回可用的播放地址；如果这个地址需要解析，再交给解析器处理；处理完交给播放内核解码，画面这才出来。搜索时转圈的那几秒，基本都花在挨个请求采集站上。
明白了这条链路，很多故障就变得可以解释了：搜不到，多半是采集站挂了；能搜到却打不开，问题出在解析；有声音没画面，一般是播放内核和视频编码不对付；所有源都无效，通常说明该换接口了。后面的排障篇会把这几种情况拆开讲。
这也是为什么接口需要经常更新。它不是一个装好就一劳永逸的东西，而是一份随时可能失效的清单。你把它理解成一份"临时通行证"，而不是软件的组成部分，心态会摆得更正。
