hongguoTV

项目概述

红果短剧是一个非官方多端短剧客户端，提供 Web、Windows 桌面与 Android TV 三端实现，各端内置内容获取与播放处理，收藏、历史、搜索与偏好保存在本地，可选连接家庭共享服务双向同步。三端共享同一个内容引擎（签名、解密、取流），引擎同时运行在 Node 与 QuickJS 两种宿主中。发布产物全部免环境开箱即用，无需安装 Node.js 或任何运行时。

项目	内容
平台	Web、Windows 10+、Android TV 5.1+
技术栈	React、Electron、Kotlin、Media3、Node.js
本地服务端口	8788（被占用自动递增）
许可	GPL-3.0

一套内容引擎跑三端，电视大屏和电脑桌面都能追剧。

主要功能

• 三端覆盖：Web、Windows 桌面与 Android TV 三端客户端，同一引擎实现
• 桌面端：Electron 壳，提供 x64 与 arm64 安装包及免安装便携版
• TV 端：Kotlin 加 Media3 原生实现，适配遥控器操作，Android 5.1 起四架构通用
• Web 服务端：六平台产物内置 Node 运行时，解压运行 start 脚本即可
• 家庭共享：可选共享服务用同一远程地址与家庭密钥双向同步收藏与历史
• 本地数据：收藏、历史、搜索与偏好保存在本地，更新程序不覆盖数据
• 链路诊断：npm run diagnose 分层定位问题在上游还是本地，给出可操作建议
• 质量门禁：144 项 Node 测试加 32 项 TV 单元测试，发布前有真实取流的播放冒烟检查

适用人群

• 短剧观众
• Android TV 用户
• 家庭多设备用户
• Windows 桌面用户

快速上手

1. 到 Releases 下载对应平台产物：Windows 选 setup 或 portable，TV 装 APK，Web 解压运行 start 脚本
2. Windows 与 TV 端直接打开即用，无需任何环境
3. 想多端同步时，部署家庭共享服务端并在各端填写同一地址与家庭密钥
4. 端口被占用时自动递增并在日志打印实际端口，也可用 HG_PORT 指定固定端口

核心优势

• 免环境产物：所有发布产物内置运行时，下载即用
• 三端同引擎：内容引擎唯一实现打包进三端，行为一致便于维护
• 真实取流门禁：单元测试全绿不等于能播放，发布前冒烟测试真实取流验证

系统要求

项目	要求
Web / Windows	Windows 10+、Linux、macOS（产物内置运行时）
Android TV	Android 5.1（API 22）以上，四架构通用
家庭共享服务	任意平台 tar.gz，端口 8791
构建环境	Node.js 22.13+、JDK 17、Android SDK 35（自行构建时）

注意事项

• 非官方客户端：与内容平台无关联，请遵守当地法律法规与平台服务条款
• TV 端限制：TV 端历史仅支持查看与续播，完整管理请用桌面或 Web 端
• 端口自动递增：8788 被占用时依次向后尝试最多 11 次，日志中打印实际端口