家里如果有电视盒子,大概率装过 TVBox——那个填一条配置订阅地址,就能同时搜几十个影视站、还能看直播的安卓应用。好用是好用,可它长在电视上:遥控器按半天、搜个片名一格一格点、想看个剧还得守在客厅。

TVBox Desktop 干的事很直接:把 TVBox 那套"配置订阅 + 多站聚合搜索 + 多线路选集"搬到了 Windows 电脑上。 订阅格式完全通用,你在盒子上用的那条配置地址,粘进来照样能用。但界面是给键盘鼠标重新做的——纯白极简、宽屏铺满、一屏全是海报。

我用了一阵子,最直观的感受是:不是"把手机 App 放大到显示器",而是真的按电脑的用法重写了一一遍。 下面细说。

它到底是个什么

一句话:基于 Electron 44 + React 19 + TypeScript 写的 Windows 影视聚合客户端,MIT 协议开源,作者 hgtuj5688,2026 年 9 月底发布第一个完整版 v0.1.0,目前 680+ 星。

它自己不含任何影视内容,本质是一个"壳":你给它配置订阅地址,它按订阅去找站点、搜索、拿详情、播。跟安卓 TVBox 的关系是"同一套生态,不同的客户端"——吃的是同样的 JSON 订阅格式,而且 A、B 两种常见方言都认。

有意思的一点:这个项目像是"一个人认真做完的东西"。自检脚本 npm run selftest 跑了 177 项端到端断言,CHANGELOG 里连"翻页后列表重排"“进度条被 0/0 覆盖"这类很细的用户反馈都逐条记了怎么修。这种文档密度在同类小工具里不多见。

它最拿得出手的几个功能

1. 装完就有内容,不用自己满网找订阅

这是我最欣赏的一个设计。很多聚合播放器第一道坎就是"订阅从哪来”,作者索性内置了一份实测存活的公开源:5 个苹果 CMS 采集站 + 1 路公开直播源 + 5 条首页内容位。首次启动自动装好并同步一次,打开就是首页五排海报、搜索框回车能同时搜这 5 个站、直播页 540 多个频道。

不想要了在"设置 → 配置源"里删掉,删干净后重启也不会自己冒出来。

2. 多站聚合搜索 + 同名合并

搜一个片名,它并发去所有可用站点搜,结果流式一条一条推回来,不用等全部跑完。更关键的是同名合并:不同站点上的同一部剧合成一张卡,卡上标"3 个源",鼠标悬停能看到是哪几个站。

同一站点对同一部剧常返回好几条(不同清晰度、方言版),它会按"有海报 > 有备注 > 有评分,同分取名字短的"每站只留最有信息量的一条。所以卡片不会顶着"庆余年第二季粤语"这种奇怪后缀。

还有个别名剥离逻辑挺聪明:庆余年,全世界都以为我是废物太子(庆余年之大凉太子爷) 和没有括号的那条会合并;但括号里是 第61-81集、特别篇 这种分季分集信息时会保留,避免把第一季和第二季搞混。

3. 自动挑能播的那条线路,这是真痛点

采集站有个祖传坑:第 1 条线路经常是"网页分享页"而不是真正的 m3u8。别的播放器直接把这地址丢进播放器,结果就是黑屏。

TVBox Desktop 的处理是三步走:

  • 本来就是直链(m3u8 / mp4 / flv / ts…)→ 直接放;
  • 是网页地址 → 先自己读一遍那个页面,十有八九是个 DPlayer 壳,地址明文写在 const vid = '…' 里,抓出来就完事(实测 1.2–2.4 秒);
  • 还读不出来 → 才按排行去问解析接口,失败的往下轮询,战绩分开记,越用越准。

而且它不假装成功:实在换不出来,会把每一条路子分别为什么失败都写在播放器上,而不是转圈转到你怀疑人生。

4. 一键转外部播放器,还帮你找播放器在哪

内嵌播放器是 ArtPlayer + hls.js,日常够用。碰上浏览器内核放不了的格式,点"外部播放器"就唤起本机的 PotPlayer / mpv / VLC。

贴心的是设置页有个"检测本机播放器":扫常见安装路径、扫 PATH、还会去问注册表里 .mkv / .mp4 的默认打开方式——绿色版或者装在 D:\某处\ 的播放器就是这么被找到的。检测结果每条都带"用这个"按钮,点一下就填好路径。

5. 电视直播,而且会做线路体检

支持 m3u 和 txt 两套直播源语法,跨源同名频道合并成一张卡多线路。虎牙、抖音这类平台直播用房间号(huya://10188)登记,点开时才换真地址,不怕链接过期。

作者实测那批公开源里约 27% 的地址拉不起来、32% 的频道一条能播的都没有,所以做的不是"继续加源",而是把已有线路用起来:进分组后台预热、点开时懒体检(只读 4KB 判活就断开)、整组全死链的频道默认藏起来、播放中途失败自动换下一条。

6. 分类浏览会做"祖先链归并"

各站的分类树五花八门,它拉下来后沿祖先链归并成大类和子分类——“记录片"归到纪录片、“短剧"从连续剧里拆出来,子分类里明显不合适的那棵子树整块丢掉。最终归并出 7 个大类,浏览起来不至于一屏二十个奇怪分类名。

7. AI 剧情总结(可选,用不用随你)

播放页有个 AI 总结区块,点了才请求,Key 只存在主进程、只存本机。两个模式:“看一遍再总结”(每 20 秒抽一帧,约 70 帧发给模型,会照实引用画面上的硬字幕)和"只看资料”(纯文本推断,不确定会如实说不知道)。

短板作者自己写得很坦白:没有声音,带硬字幕的片读得准,不带字幕的只能描述画面,而且抽帧会把整集缓冲一遍。属于"有比没有好”,别当主要功能用。

和同类方案比,它好在哪

方案一句话总结最适合的场景
TVBox Desktop电脑端 TVBox 壳,宽屏 + 键鼠重构,装完即用Windows 上想在显示器前追剧、多站找片
安卓 TVBox(盒子/手机)生态最成熟,配置源最多躺在客厅用遥控器看
FongMi / 影视仓安卓端老牌,TV 端体验打磨久电视盒子重度用户
网页版聚合站什么都不用装临时看一眼、不想装软件

简单分工:客厅用盒子,电脑前用 TVBox Desktop,两条腿走路,订阅还是同一份。

下载地址

认准官方 Release 页:

  • GitHub Releases(唯一官方渠道):https://github.com/hgtuj5688/tvbox-desktop/releases/latest
  • 项目主页:https://github.com/hgtuj5688/tvbox-desktop

当前版本 v0.1.0,只有 Windows x64 两个文件,选一个就行:

文件大小用途
TVBox.Desktop-0.1.0-x64.exe约 115 MB安装版(推荐),一路下一步,建开始菜单和桌面快捷方式,可在"应用和功能"卸载
TVBox.Desktop-0.1.0-x64.zip约 158 MB免安装版,解压到任意目录直接跑,适合放 U 盘或不想写注册表的人

两个必须知道的点:

  • 没有代码签名证书,首次运行 Windows SmartScreen 会拦一下(“Windows 已保护你的电脑”)。点"更多信息"→“仍要运行"就行,这不是病毒提示,只是作者没买签名证书。
  • 别装到 C:\Program Files。程序是"便携形态”,配置、收藏、历史都写在程序同级的 data\ 里,装到需要管理员权限的目录会写不进去,配置会退回系统用户目录(能用,但不清爽)。

安装和使用,五步走

第一步:装。 双击 exe 一路下一步;或者解压 zip 到 D:\TVBox 这种自己的目录,直接跑 TVBox Desktop.exe。装完第一次运行记得过一下 SmartScreen。

第二步:等它自己同步。 首次启动会自动装好内置的"公开可用源"并同步一次。等首页出现五排海报,说明通了。这一步失败了先别急着怀疑软件,多半是网络到那些采集站不通。

第三步:搜片。 顶部搜索框输片名回车,会同时搜所有可用站点。结果一条条往外冒,同名影片自动合并成一张卡。想排除掉"XX解说"“一口气看完"这类二创,搜索页有"过滤解说"按钮(默认就是开的)。

第四步:选集播放。 点进详情,先看"选择片源”——这部片在几个站有,各自什么情况,当前这条标"正在看",点"切换"就换源。下面选线路:默认会自动选中第一条看起来是直链的线路,点"立即播放"。如果线路是网页地址,你会看到播放器上盖一层"正在换播放地址…",换完下面会写明是靠哪条路换出来的、花了多久。

第五步:直播。 左侧"电视直播"进去,按分组浏览频道。整组都是死链的频道默认藏起来了,这是好事,别以为软件漏源了。

几个让体验好一截的技巧

1. 自己加订阅,别只用内置那 5 个站。 内置源只是"上手能跑",片源覆盖有限。在"设置 → 配置源"里贴你自己常用的订阅地址(URL 或本地 JSON 文件都行),支持 A/B 两种方言。加完点"全部同步",去"影视源"页面逐条测连通性——把响应慢的和挂掉的禁用掉,聚合搜索会快很多。

2. 记住 data\ 这个目录。 配置源、站点覆盖、设置、收藏、观看历史全在里面:

<TVBox Desktop.exe 所在目录>\
  data\
    settings.json     应用设置
    sources.json      配置源
    sites.json        站点本地覆盖
    parses.json       手动加的解析接口
    session\          Chromium 缓存

卸载的时候这个目录会一起被删掉,收藏和历史全没。想留着就先整个复制出来。反过来这也是优点——换电脑把整个程序目录拷走,配置全跟着走,比重新配一遍舒服太多。

3. 播放页可以直接换片源。 不用退回搜索页。播放页侧栏顶部有"片源"区块,列出这部片在各站的条目,点一下就换过去继续看。如果这条线路加载慢,就在这儿换源,比等缓冲快。

4. 装个本地播放器,然后让它自己找。 去"设置"点"检测本机播放器",扫到 PotPlayer / mpv / VLC 就直接"用这个"填上。参数模板里 {url} 是播放地址、{title} 是片名,想全屏启动就填 --fullscreen {url}。内嵌播放器搞不定的格式(比如某些 mkv),外部播放器一把过。

5. 解析接口别乱加。 作者刻意没内置任何第三方公开解析接口,理由很实在——实测大部分已经失效,要么 403 要么跳 meta refresh,真实地址由前端 wasm 现算,HTTP 根本拿不到。你自己加的接口在设置页可以"测一下"(拿腾讯剧集页当靶子),type=0(需要浏览器嗅探的)目前不支持,只支持 type=1/2。加越多不一定越好,失败的会沉底但也会拖慢换址。

6. 直播卡就换线路,别开新源。 同名的频道已经在"一张卡多线路"里了,点进去换线路比到处找新直播源有效。软件的线路体检会告诉你哪条活、哪条死。

7. 想折腾源码的话,国内网络要先指镜像。 clone 下来 npm install 时 Electron 二进制大概率下不来,先设 ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/;打包还要设 ELECTRON_BUILDER_BINARIES_MIRROR。这是国内开发 Electron 的通用坑,不是这个项目的问题。

说点实话:它的短板

  • 只支持桌面端能跑的站点类型:苹果 CMS(type 3/4)和网页规则站(type 1)。安卓那套需要 jar/dex 的 spider(type 0)跑不了,界面上会灰显并写明原因。所以你订阅里如果有大量 type 0 站点,这里用不上。
  • 只有 Windows x64,没有 mac / Linux 版,也没有 ARM 版。
  • 首页内容位比较简单:每行按"最近更新"或指定分类拉一页,最多 24 条,没有"换一批"。
  • 项目很新(2026 年 9 月底首发,最后一次代码推送也在同期),后续更新节奏不确定,别把它当成会长期维护的基础设施。
  • 内置的公开源随时可能失效——这不是软件的问题,是这类采集站本身的生命周期就这样。

一点个人使用感受

我平时找片的路子是:先在电脑上搜,找到能播的源,再拿电视盒子去看。以前这一步得开浏览器、切好几个聚合站、复制链接、扔进播放器试,来回折腾。现在打开 TVBox Desktop,输片名,看哪张卡片上源多,点进去直接播——想投屏就换外部播放器。

它真正解决的不是"能不能看",而是"找片这件事的摩擦"。换源那套自动挑直链、读分享页、失败轮询解析接口的逻辑,是把以前要手动试好几遍的活儿变成了默认行为,这个价值比界面好看重要得多。

至于该用哪个:客厅躺沙发上用安卓 TVBox 或 FongMi,坐在电脑前就用它,订阅还是同一份 JSON,两头同步一下配置就行。反正这类工具都只是壳,内容始终来自你自己添加的订阅——软件本身不含任何影视资源,也不托管任何视频。请通过正规渠道观看正版内容,下载学习可以,别传播、别商用。

工具是中性的,怎么用在自己手里。