TVBox Desktop 电脑桌面版本 聚合搜索使用指南:一个关键词同时搜多个影视站,完整教程

免费用户福利小苹果影视 9.9元VIP黄金会员 解锁网站所有收费资源 最新TVBox免费接口地址源

TVBox Desktop 是一款纯白极简的 Windows 影视聚合客户端(Electron + React + TypeScript 构建)。它的聚合搜索功能让你一个关键词同时搜多个影视站:输入片名按回车,程序就会并发查询所有启用的影视源,把各站结果边返回边显示,再按片名自动合并成一张卡片。本文带你从零上手,10 分钟内跑通「搜片 → 选源 → 播放」全链路。

图片[1]-TVBox Desktop 电脑桌面版本 聚合搜索使用指南:一个关键词同时搜多个影视站,完整教程-159e资源网

聚合搜索是什么?和网页搜索有什么区别
网页搜索只查一个站点;TVBox Desktop 的聚合搜索则一次查遍你配置的所有可用影视源,核心行为有四个:

并发查询,边搜边出:主进程用并发池同时请求各站点,每有一个站点返回就立刻刷新界面,右上角实时显示「正在搜索 4/5」,不用干等。
同名自动合并:同一部剧在多个站点都有时,会按归一化片名合成一张卡,卡片下方标「N 个源」,悬停能看到具体是哪些站点。
解说内容过滤:默认挡住「XX解说 / 一口气看完」这类二创短片,页面副标题会写明「已挡掉 N 条解说」。
单站失败不影响全局:某个站点超时或改版失效,只会在底部折叠区「N 个站点没有返回结果(点开看原因)」里如实说明,其余站点照常出结果。
整段逻辑集中在 search.ts(并发池、流式回报、可取消),结果合并则在 useApp.ts 的 mergeResults() 里完成。

搜索前准备:内置订阅与影视源测试
提示:聚合搜索不内置任何影视内容,内容全部来自你自己添加的配置订阅(兼容安卓 TVBox 的 JSON 订阅格式)。

第一步:添加一份配置源

图片[2]-TVBox Desktop 电脑桌面版本 聚合搜索使用指南:一个关键词同时搜多个影视站,完整教程-159e资源网
首次启动时,首启页会提供「公开可用源(苹果CMS 采集站)」内置订阅——5 个实测存活的公开采集接口,点一下「添加」即可。它的内容与仓库里的 public-sources.json 一致,添加后会落盘到 data\presets\,换机器也能继续用。

当然你也可以填自己的订阅地址或本地 JSON 文件,订阅格式规范见 功能框架.txt。

第二步:在「影视源」页测试站点
聚合搜索只查询已启用且可搜索的站点,哪些站能跑搜索,先看「影视源」页:

图片[3]-TVBox Desktop 电脑桌面版本 聚合搜索使用指南:一个关键词同时搜多个影视站,完整教程-159e资源网

每个站点右侧的「测试」按钮会实打发一次请求,绿点 + 毫秒数是连通,红点「失败」说明接口挂了。
站点类型标签决定能力:苹果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资源网

聚合搜索并发数(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 配置源);
「影视源」页测试并启用可搜索站点;
顶部搜索框输入关键词回车,边搜边出结果;
点卡片进详情选集,不满意就在片源列表里一键换源。

下载地址

© 版权声明
THE END
喜欢就支持一下吧
点赞7赞赏 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容