| 免费用户福利小苹果影视 | 最新TVBox免费接口地址源 |
TVBox Desktop 是一款纯白极简的 Windows 影视聚合客户端(Electron + React + TypeScript 构建)。它的聚合搜索功能让你一个关键词同时搜多个影视站:输入片名按回车,程序就会并发查询所有启用的影视源,把各站结果边返回边显示,再按片名自动合并成一张卡片。本文带你从零上手,10 分钟内跑通「搜片 → 选源 → 播放」全链路。
![图片[1]-TVBox Desktop 电脑桌面版本 聚合搜索使用指南:一个关键词同时搜多个影视站,完整教程-159e资源网](https://www.159e.cn/wp-content/uploads/2026/11/1795085590-nTk25A7D.png)
聚合搜索是什么?和网页搜索有什么区别
网页搜索只查一个站点;TVBox Desktop 的聚合搜索则一次查遍你配置的所有可用影视源,核心行为有四个:
并发查询,边搜边出:主进程用并发池同时请求各站点,每有一个站点返回就立刻刷新界面,右上角实时显示「正在搜索 4/5」,不用干等。
同名自动合并:同一部剧在多个站点都有时,会按归一化片名合成一张卡,卡片下方标「N 个源」,悬停能看到具体是哪些站点。
解说内容过滤:默认挡住「XX解说 / 一口气看完」这类二创短片,页面副标题会写明「已挡掉 N 条解说」。
单站失败不影响全局:某个站点超时或改版失效,只会在底部折叠区「N 个站点没有返回结果(点开看原因)」里如实说明,其余站点照常出结果。
整段逻辑集中在 search.ts(并发池、流式回报、可取消),结果合并则在 useApp.ts 的 mergeResults() 里完成。
搜索前准备:内置订阅与影视源测试
提示:聚合搜索不内置任何影视内容,内容全部来自你自己添加的配置订阅(兼容安卓 TVBox 的 JSON 订阅格式)。
第一步:添加一份配置源
![图片[2]-TVBox Desktop 电脑桌面版本 聚合搜索使用指南:一个关键词同时搜多个影视站,完整教程-159e资源网](https://www.159e.cn/wp-content/uploads/2026/11/1795085591-s5UvuyZv.png)
首次启动时,首启页会提供「公开可用源(苹果CMS 采集站)」内置订阅——5 个实测存活的公开采集接口,点一下「添加」即可。它的内容与仓库里的 public-sources.json 一致,添加后会落盘到 data\presets\,换机器也能继续用。
当然你也可以填自己的订阅地址或本地 JSON 文件,订阅格式规范见 功能框架.txt。
第二步:在「影视源」页测试站点
聚合搜索只查询已启用且可搜索的站点,哪些站能跑搜索,先看「影视源」页:
![图片[3]-TVBox Desktop 电脑桌面版本 聚合搜索使用指南:一个关键词同时搜多个影视站,完整教程-159e资源网](https://www.159e.cn/wp-content/uploads/2026/11/1795085591-oItalKAa.png)
每个站点右侧的「测试」按钮会实打发一次请求,绿点 + 毫秒数是连通,红点「失败」说明接口挂了。
站点类型标签决定能力:苹果CMS 支持搜索 + 分类浏览,网页规则仅支持搜索,Spider 类型需要 jar/dex,桌面端跑不了会自动灰显跳过(实现见 sites.ts)。
开关可以直接禁用某个慢站或坏站,被禁用的站点不参与聚合搜索。
聚合搜索三步走:从关键词到播放
第 1 步:顶部搜索框输入关键词,按回车
顶部搜索框提示「搜索影片、剧集、动漫…(回车聚合全部站点)」,这就是聚合搜索的入口(见 TopBar.tsx):
输入片名,如「庆余年」;
按 Enter,界面跳到「聚合搜索」页并自动开搜;
也可以先在搜索页里换词,点「搜索」按钮重新发起。
第 2 步:看进度,结果陆续出现
搜索过程中页面右上角显示「正在搜索 N/M」,某站返回后它的卡片就出现一批。CMS 站点走 ac=detail 接口,一次请求就带回播放线路信息,所以搜索结果里已经藏着「第几集、哪条线路」的线索,点进详情不用再猜。
第 3 步:点卡片进详情页,选集播放
详情页有独立的「选择片源」区块,列出这部片在每个站点上的条目,点「切换」就换源继续看,播放页也能随时切;
「立即播放」会自动挑一条看起来是直链的线路,网页分享地址会现场解析成真播放地址。
读懂搜索结果页:站点筛选、合并与过滤
搜索结果页有几个高频操作:
元素 作用
「全部站点 / 站点名 + 数字」标签 按站点筛选结果,绿点 = 搜索成功,红点 = 失败;数字是该站命中的条数
卡片下方「N 个源」 该片在几个站点上都有,悬停查看具体站点,点进详情可切换
「过滤解说 N」按钮 一键开关解说过滤,N 是被挡掉的条数
「清空结果」 清空当前搜索结果,回到分类浏览模式
底部「N 个站点没有返回结果」 点开能看到每个失败站点的具体原因(超时、接口返回异常、规则失效等)
一个细节:同一站点搜到同一部剧的多个版本(不同清晰度/语种)时,每站只保留信息量最足的一条,避免「庆余年第二季粤语」这类后缀占位。
进阶设置:调大并发数,让聚合搜索更快
在「设置 → 通用」里有两个和搜索直接相关的参数:
![图片[4]-TVBox Desktop 电脑桌面版本 聚合搜索使用指南:一个关键词同时搜多个影视站,完整教程-159e资源网](https://www.159e.cn/wp-content/uploads/2026/11/1795085591-FLbQPLTg.png)
聚合搜索并发数(1–32,默认 8):同时请求的站点数。站点多、网络好时可适当调大,但过大可能把部分站点打限流;
请求超时(秒)(3–120,默认 20):单个站点的等待上限。慢站多就调大,想快速跳过坏站就调小;
站点级也可以单独设 timeout 和 searchable 字段(写在订阅 JSON 里),优先级高于全局设置。
常见问题速查
Q:为什么某个站点搜不到结果? 先点「影视源」页的「测试」确认接口是否存活;再回到搜索结果页底部展开「N 个站点没有返回结果」看具体报错。公开采集站随时可能失效,删掉或禁用即可。
Q:搜索范围能只查部分站点吗? 能。在订阅 JSON 里给站点设 “searchable”: 0 或 “enabled”: false,该站就被排除出聚合搜索;也可以在影视源页直接关掉开关。
Q:输入新关键词时,旧的搜索会被取消吗? 会。每次发起新搜索,上一批请求拿到取消令牌后自行停止(cancelSearch()),不会出现两批结果混在一起的情况。
Q:每个站点最多返回多少条? 默认每站 30 条(DEFAULT_LIMIT),合并去重后按「这条有几个源」排序,覆盖站点多的卡片排在前面。
小结
TVBox Desktop 的聚合搜索把「多站逐个搜、结果来回切」压缩成了「一个关键词、一页结果、多源合并、直接播放」:
首启添加内置订阅(或自己的 TVBox 配置源);
「影视源」页测试并启用可搜索站点;
顶部搜索框输入关键词回车,边搜边出结果;
点卡片进详情选集,不满意就在片源列表里一键换源。
下载地址
2、本站一切资源不代表本站立场,并不代表本站赞同其观点和对其真实性负责。本站一律禁止以任何方式发布或转载任何违法的相关信息,访客发现请向站长举报,本站资源仅供学习与参考,请勿用于商业用途以及违法使用。
3、本站大部分下载资源收集于网络,该资源仅供学习和研究传播,版权归原作者所有,若为付费资源,大家请在下载后24小时内自觉删除,一切关于该资源商业行为与站长及159e资源网(www.159e.cn)无关。
4、请勿将该软件进行商业交易、转载、商业用途等行为,该软件只为研究、学习所提供,若作商业用途,请到原网站购买,由于未及时购买和付费发生的侵权行为,与本站无关,该软件使用后发生的一切责任和问题与站长及159e资源网(www.159e.cn)无关。
5、本站所有资源都来源于网络收集或转载!如果侵犯了您的权益,请及时告知我们,我们即刻处理!本网站的文章部分内容可能来源于网络,仅供大家学习与参考,如有侵权,请联系我们予以删除!如本站不慎侵犯您的版权请联系我们,我们将及时处理,并撤下相关内容!(E-mail:334635982@qq.com)。












暂无评论内容