WebHomeTV 是基于 FongMi / CatVod 生态增强维护的 Android 影音播放器壳子。
它不内置内容，不分发 JSON，而是提供一个更好用的壳子，帮助用户：
- 导入自己的点播 / 直播 / 壁纸配置
- 使用 WebHome 自定义首页
- 管理多个配置
- 在手机和电视之间同步配置与状态
- 继续观看、收藏、历史跨设备迁移
一句话：
这是一个“让用户自带配置更容易导入、管理和迁移”的播放器壳子。
| 能力 | 说明 |
|---|---|
| 配置导入增强 | 导入前预检，失败不覆盖当前配置，支持 URL / 文件 / assets |
| 配置管理 | 支持查看当前配置、历史配置、来源类型、最后使用时间 |
| 一键同步 | 局域网同步配置、历史、收藏、WebHome、设置、登录态等壳子状态 |
| 登录态学习 | 学习 Cookie / 登录态文件路径，供一键同步跨设备迁移网盘登录态 |
| 最近设备记忆 | 一键同步会记住上次设备，下次优先选中 |
| 继续观看 / 收藏 | 强化继续观看、收藏恢复与配置缺失时的回退路径 |
| 播放连续性 | 换源、换集、解析播放后保持进度与倍速等播放状态一致 |
| 多内核播放 | 支持 EXO / IJK / MPV 切换，默认 EXO |
| 协议兼容 | 已接入 Force、JianPian、Thunder、TVBus 等 FongMi 协议扩展 |
| 家庭过滤 | 按标签/关键词屏蔽不适合电视客厅展示的内容，并隐藏配置中心里的指定来源项 |
| 网盘检测 | 检测网盘分享链接有效性，WebHome 与本地 HTTP 均可调用（可关闭） |
| CSP 预热与兼容 | 配置加载后预初始化 Jar CSP，并隔离插件自带 protobuf，减少首次打开和版本冲突 |
| 多语言与界面 | 支持英文、简体中文、繁体中文切换，手机端可调界面缩放 |
| 播放记录同步管理 | 管理本机写入、远端同步和 Webhook，上报凭据在备份中自动脱敏并禁用 |
| MPV 配置管理 | 管理 mpv.conf、input.conf 和脚本 profile；安全导入、历史回滚，脚本默认禁用 |
| 搜索相关性 | 搜索结果按关键词匹配度过滤和排序，减少与关键词无关的结果 |
| WebHome 首页 | 每个 CSP 站点都可以配置独立网页首页 |
| Native SDK | 网页可通过 window.fm 调用受信任范围内的 App 原生播放、搜索、请求、缓存等能力 |
| 内嵌 VOD 播放 | WebHome 网页可把剧集数据直接交给播放器（player.playVodInline），无需站点接口即可开播 |
| 局域网遥控 | 管理页查看播放状态与进度，配对后控制本机或远端设备，保留同步、文件、调试能力 |
| 公网遥控（自托管） | HTTPS 中转、限时配对、设备撤销，WebSocket / HTTP 轮询；默认关闭，仅开放搜索、推送和播放控制 |
| 弹幕开关 | 电视/手机设置总开关与播放页显示状态一致；关闭后换集、切内核、云搜或外部注入都不会隐式开启 |
| 播放控制增强 | 播放中重播、EXO/IJK/MPV 内核切换、0.1x–5x 倍速微调、章节选择、播放 OSD 与错误阶段提示 |
| 字幕与解码 | 字幕样式高级设置、双字幕、音视频解码偏好、音频直通与 Dolby Vision 输出策略 |
| 直播增强 | 失败自动换源、自定义 EPG 源与频道信息 |
| 预加载设置 | 按内核配置预加载开关、线程、缓存大小与预加载时长，并自动预加载下一集 |
| 弹幕与集数 | 弹幕密度/样式增强、集数标题紧凑显示 |
| 内置壁纸 | 27 款内置设计壁纸，可在设置中循环切换 |
| 安全加固 | 本地 HTTP 写操作强制 token、SSRF 拦截、CORS 白名单、路径遍历/XXE/DoS 防护 |
| 发布与数据保护 | Release 签名缺失会中止构建，数据库异常恢复前保留失败库副本 |
| Android 兼容性 | 跟进官方 FongMi api37，目标 SDK 更新到 37 |
| 自动更新 | 多源更新，适配不同网络环境 |
最新版本：v5.13.0
项目主页（GitHub Pages）：https://motao123.github.io/webtv/
下载地址：
推荐 APK：
| 设备类型 | 推荐 APK |
|---|---|
| Android TV / 不确定架构 | leanback-universal.apk |
| Android TV / 新电视盒子 | leanback-arm64_v8a.apk |
| Android TV / 老盒子 | leanback-armeabi_v7a.apk |
| Android 手机 / 不确定架构 | mobile-universal.apk |
| Android 手机 / 新设备 | mobile-arm64_v8a.apk |
| Android 手机 / 老设备 | mobile-armeabi_v7a.apk |
不确定 CPU 架构时，优先下载对应设备的
universal通用包。
安装后先导入你自己的配置源。
常见方式：
- 粘贴配置 URL
- 选择本地配置文件
- 通过局域网同步从另一台设备导入
可导入的配置类型：
- 点播配置
- 直播配置
- 壁纸配置
项目本身不附带内容源，用户需要自行准备合法可用的 JSON / 配置地址。
适合这些用户：
- 已经有自己的 TVBox / FongMi / CatVod 配置源
- 想在电视端使用 WebHome 自定义首页
- 想把手机和电视上的配置、历史、收藏同步起来
- 想把播放器壳子和内容源彻底分离
不适合这些用户：
- 希望安装后自带影视内容
- 希望仓库直接提供 JSON / 站源
- 导入前预检
- 导入失败不覆盖当前配置
- 查看当前配置 / 历史配置
- 显示来源类型和最后使用时间
- 删除配置前提示关联影响
可同步的壳子状态包括：
- 配置与站源
- 本地脚本 / Jar 数据
- WebHome 数据
- 搜索记录
- 继续观看
- 收藏
- 应用设置
- 登录态（Cookie / 登录态文件路径）
- 在增强功能中打开「登录态学习」
- 开始学习 → 完成网盘登录 → 返回完成学习
- 可管理已选路径与待确认候选，并预览文件内容
- 一键同步勾选「登录态」即可跨设备迁移
- 记录最近观看进度
- 收藏内容可跨配置恢复
- 配置缺失时提供回退路径
- 在增强功能中开启
- 使用关键词屏蔽不适合电视端首页展示的内容
- 适用于原生首页 / 分类 / 搜索等内容流
- WebHome 页面也可以通过
fm.config()读取过滤策略并自行配合隐藏
- 站点可配置独立网页首页
- 支持透明背景
- 支持网页与原生能力联动
- 可通过
window.fm调用搜索、播放、请求、缓存等能力
从 App 的「设置 → 增强功能 → 管理页面」取得访问地址，在同一局域网的手机或电脑浏览器中打开。实际端口由 App 分配，请使用 App 显示的完整地址，不要固定假定为 9978。
- 保留文件管理、一键同步、调试日志及配置管理。
- 查看播放状态、标题和进度，发送播放、暂停、停止、上下集、循环及重播命令。
- 远端设备需要单独配对；发现设备不等于获得控制权限。
- 管理地址与配对凭据属于敏感信息，请勿公开分享；App 进程重启后局域网凭据可能失效，需要重新配对。
这与局域网管理是两套连接方式：公网遥控由电视主动连接你部署的 HTTPS 中转服务，不需要、也不应把 App 的本地管理端口暴露到公网。
- 按中转服务部署说明部署独立服务并配置 HTTPS。
- 在手机或电视的远程遥控设置中填写服务地址，主动启用连接；默认不开启。
- 在被控设备生成限时配对码，在中转服务网页控制台输入配对码完成绑定。
- 在网页中选择设备，执行搜索、推送 HTTP/HTTPS 播放地址、播放控制或读取当前播放状态。
- 不再使用时撤销设备授权；配对码仅可使用一次，控制凭据不要分享给其他人。
连接优先使用 WebSocket，并提供 HTTP 轮询回退。命令有有效期和重复执行保护；设备离线、App 被强制停止或没有活动播放器时，控制可能无法执行。命令已接受不代表已经开始播放，应以返回结果和播放状态为准。
本版不开放远程安装 APK、任意文件访问、登录态提取或网络代理，也不包含完整云同步与离线下载。服务端程序随源码提供，仓库不提供公共遥控服务器。
常用能力：
| 能力 | 说明 |
|---|---|
fm.req(url, options) |
原生请求，绕过普通浏览器 CORS 限制 |
fm.res(url, options) |
生成本地资源网关地址 |
fm.play(url, title, options) |
播放直链或 push:// 地址 |
fm.vod(siteKey, vodId, title, pic) |
打开原生详情 / 播放链路 |
fm.search(keyword, { direct }) |
调用原生搜索 |
fm.openLive() / fm.openKeep() / fm.openSetting() |
打开原生页面 |
fm.history() |
读取最近观看记录 |
fm.config() |
获取当前配置与家庭过滤状态 |
fm.site() |
获取当前站点信息 |
fm.cache |
本地缓存能力 |
fm.back() / fm.reload() |
处理返回与刷新 |
更完整说明见文档。
如果你是开发者，建议先看：
- WebHome 首页配置
- Native SDK
- 配置导入与管理逻辑
- 本地管理页与同步逻辑
环境要求：
- JDK 21
- Android SDK 37
- 仓库内置
gradlew
常用构建命令：
bash gradlew :app:assembleMobileUniversalRelease
bash gradlew :app:assembleMobileArm64_v8aRelease
bash gradlew :app:assembleMobileArmeabi_v7aRelease
bash gradlew :app:assembleLeanbackUniversalRelease
bash gradlew :app:assembleLeanbackArm64_v8aRelease
bash gradlew :app:assembleLeanbackArmeabi_v7aReleaseGitHub Actions 支持手动触发，也会在推送 v* 标签时自动构建六个 APK 并创建 Release。
App 内更新入口：
设置 → 版本检查
更新策略：
- 检查到新版本后下载 APK
- 下载完成后交给系统安装器
- 如果自动安装失败，APK 会导出到 Downloads 目录，用户可手动安装
针对代码安全审计结果，v5.6.0 修复了以下高危项：
- 本地 HTTP 认证：管理/写操作端点（
/manage、/file、/upload、/action、/debug、/cache、/pan/check、播放进度 API 等）现在即使来自本机回环地址也强制要求服务器 token；播放记录/进度端点纳入 token 保护范围。 - DNS rebinding 防护：回环请求校验
Host头必须为127.0.0.1/localhost/::1。 - SSRF 防护：WebResource 网关禁用自动重定向并逐跳校验；Webhook、网盘检测、WebHome 扩展加载、MPV HLS 代理均拒绝私有/回环/链路本地地址。
- CORS 收紧：播放进度/记录/网盘检测接口不再反射任意 Origin，仅对本地回环 Origin 允许携带凭据。
- 路径遍历防护：
file://播放入口拒绝目录穿越与应用私有目录，仅接受媒体扩展名。 - XXE 防护：XML 结果解析拒绝
DOCTYPE/ENTITY。 - DoS 防护：DLNA 服务器与播放进度 API 对请求行、消息体大小设置上限。
- 信息泄露防护：
site.info桥接方法不再对非受信页面开放；pan.play对非受信页面要求播放确认并限制为 http/https。 - Python 依赖下载：HTTPS 强制校验证书，并限制重定向跳数。
已知可接受风险（记录在案）：
- 迅雷网盘签名密钥内嵌于客户端，属客户端签名固有限制，无法真正隐藏。
- 直播/媒体源普遍使用明文 HTTP，无法全局禁用；配置源与更新服务器已强制 HTTPS。
- Android
addJavascriptInterface无法按 iframe 区分信任来源，跨源 iframe 信任边界为平台限制。
v5.11.0 追加（基于全面代码审计）：
/m3u8代理目标强制公网校验，端点纳入 IP 保护清单；/webResource禁止被外部页面 iframe，CORS 白名单收紧到精确端口。- WebHome 桥的敏感读取方法要求主帧 bridgeToken（缓解跨源 iframe 冒用受信身份）。
- 登录态同步档案改为 AES-GCM 加密传输（密钥=对端配对 token）；同步请求统一要求配对码认证。
- 连接时私网 DNS 过滤（封堵 DNS 重绑定 TOCTOU），私网判定补齐 CGNAT/198.18/NAT64 网段。
本仓库只提供技术实现和播放器壳子能力：
- 不内置影视内容
- 不维护站源
- 不分发 JSON
- 不提供内容接口
所有内容来源都应由用户自行配置，并确保合法合规。