WebHomeTV全版本

它到底是什么来头

WebHomeTV 的出身很清晰：基于 FongMi/CatVod 开源生态二开​，重点往四个方向增强：

• WebHome 自定义首页​：首页不再是固定的 XML 布局，而是可以用 HTML/CSS/JS 写的网页
• App Native SDK​：网页通过 window.fongmi（简写 window.fm）调用 App 原生能力
• 网盘链接检测与播放​：内置阿里云盘 / 夸克等网盘分享链接的有效性检测+citation:1]
• Nostr/TMDB 推荐首页​：去中心化的内容推荐机制

💡 一句话定性：它不是在和 Taka、俊于竞争”谁是更好的壳子”，而是在回答”​能不能让电视 App 的首页像网页一样可编程​”这个问题。

所以把 WebHomeTV 排进这个系列是有意义的——它代表了 TVBox/CatVod 生态的下一个进化方向​：从”配接口看片”进化到”用网页技术栈定制首页”。

2026 年 6 月的最新版本

WebHomeTV 有两个并行活跃的版本线，都是由开发者 fish2018​ 维护：

⚠️ 版本号看起来长是因为带了 sdk 版本和构建时间戳——v5.5.2才是真正的语义版本号，202606102257是构建时间。认准前面的 v5.5.2 就好。

近期重点更新（2026年5月底至6月初）集中在几个方向：沉浸式首页体验升级、浏览器远程管理页、Proxy 壳代理、电视端界面与遥控优化、登录态学习与同步、局域网一键同步​。下面挑真正影响体验的讲。

它强在哪几个地方

🌐 WebHome：首页变成了一张网页

这是 WebHomeTV 的灵魂特性。传统 TVBox 系软件的首页是固定的 XML 布局，想改？改 Java 代码重新编译。

WebHomeTV 的做法是：首页就是一个 WebView，加载你指定的 HTML 页面​。这意味着：

• 轮播推荐、分类卡片、瀑布流、搜索框——随便你用前端技术栈怎么布局
• 每个 CSP 站点可以配独立首页​，切源即切首页
• 支持透明背景渲染​，HTML 半透明 + App 壁纸透出，能做出类似 Netflix 的沉浸式质感
• 电视端遥控器焦点、方向键、返回键都已经做了适配

json

{
  "key": "Nostr推荐",
  "name": "Nostr推荐",
  "type": 3,
  "api": "csp_Nostr",
  "homePage": "./nostr.html"
}

配置文件里加一个 homePage字段就这么简单。

🔌 Native SDK：网页能调 App 原生能力

这是 WebHome 天花板的真正来源。App 往 WebView 里注入了 window.fongmi（简写 window.fm），网页可以直接调用：

举个例子——你想在首页做一个”继续观看”卡片，直接 fm.history()就能拿到数据，不需要自己维护存储。

📡 一键同步：多设备数据互通

这个功能对”家里好几台设备”的用户是杀手级的：

• 局域网设备自动发现​：同 WiFi 下手机和电视互相看见
• 按需同步​：接口配置、历史记录、收藏夹、搜索记录、WebHome 缓存——想同步什么勾什么
• 自定义目录​：除了默认的 /sdcard/TV、/sdcard/TVBox, 还能自己指定目录同步
• 实时进度显示​：传输文件数、大小、速度一目了然

💡 给父母家装一台电视盒、自己手机上也装一个——老人的观看历史自动同步过来，不用再听”这个台怎么没了”的电话。

💻 浏览器远程管理（重磅新功能）

这是 2026 年 6 月刚上的大招——在电脑浏览器里直接管理电视/手机上的配置​：

• 支持本机管理和远程管理双模式，局域网内任意设备都能成为管理终端
• 文件管理​：上传、新建目录、删除、下载、多文件/目录打包下载
• 一键同步目录​：可视化树形勾选同步目录，自动识别已配置服务的本地路径
• Proxy 代理规则编辑​：浏览器里直接改代理规则，即时生效
• 远程搜索与推送​：浏览器里搜资源，一键推送到电视播放

📌 对于电视端操作不便的场景，这个远程管理页基本把”蹲在电视机前按遥控器半小时”这件事消灭了。

⚡ 网盘链接检测 + 播放

内置网盘分享链接有效性检测​，支持阿里云盘、夸克等主流网盘分享链接的检测和播放链路接入。fm.pan.check()批量检测、fm.pan.play()直接播放，绕过了”复制链接 → 打开网盘 App → 转存 → 再回来”的繁琐流程。

🔒 安全加固

不是一般二开版会考虑的事，但 WebHomeTV 做了：

• WebHome Bridge 安全分级​：仅可信 origin 能使用完整 Native 能力
• Token 鉴权 + IP 访问控制​：本地 HTTP 服务不会裸奔在局域网里
• 远程依赖 JAR 首次加载确认 + hash 校验​：防止恶意 jar 注入
• TLS 加固​：网络通信层面的防护

配置上去

和 FongMi 原版一样，WebHomeTV 的点播配置路径和接口生态完全兼容​：

1. 打开 WebHomeTV → 首页右上角 设置（齿轮）
2. 点击 点播​ 栏
3. 粘贴接口地址 → 确定
4. 返回首页，等加载完

💡 加了 WebHome 字段的配置，切换后会自动加载对应的 HTML 首页；普通配置则走经典的 FongMi 界面，向下兼容无压力。

适配 TVBox / FongMi 生态的通用接口