hongguoTV
当前分支提供 Kotlin 原生独立 APK：安装后联网即可使用，无需 Node / Docker。最低 Android 8.0，电视遥控器操作。
0.9.0 增加应用内更新：推送原生代码后自动同步至公开发布仓库、构建签名 APK；电视在浏览时检查并下载新版，确认系统安装即可，无需逐次传文件。播放中不检查，覆盖安装保留本机记录。见 自动更新说明。
原生工程位于 kotlin-tv/，包名 com.hongguotv.nativeapp，可与旧版并存。以下为保留的 React Native 版说明。
用于自家电视的非官方红果短剧客户端。首版采用 React Native TV + TypeScript，最低 Android 8.0（API 26）。电视负责界面和播放，独立 Node 服务负责内容接入与媒体分段处理，便于后续其他平台复用。
下载：v0.1.1 APK、源码及 Docker 部署包 · Docker 部署指南
当前功能
- 推荐、关键词搜索、分页、详情和选集。
- 遥控器焦点、方向键、确定键和返回键操作。
- 原比例播放、暂停、前后跳转、上下集及自动连播。
- 本地收藏、最近观看、断点续播。
- 服务地址 / 可选访问口令设置，连接检测及播放失败重试。
v0.1.1 改善 TV 焦点滚动、返回恢复、遥控器播放按键、安全边距与选集分组，见 本版交付说明。Android 8.0 的最低版本配置不等于目标电视已经验收；Apple TV 工程骨架保留，移动端和 Web 还未交付。
在电视上使用
-
在电脑或 NAS 安装 Node.js 22 或更新版本，在本目录运行：
npm ci npm run bridge -- --lan -
从 Release 下载 APK，拷贝到电视安装。本地构建产物为
outputs/hongguotv-0.1.1-android8.apk，也可以通过已连接的 ADB 安装：adb install -r outputs/hongguotv-0.1.1-android8.apk -
电视和服务所在设备连接同一家庭网络。在应用「设置」中输入启动日志显示的
http://电脑局域网IP:8787，选择「连接并保存」。电视上不能把127.0.0.1当成电脑地址。 -
进入推荐或搜索，打开剧集开始播放。观看期间内容服务需保持运行，电脑不能休眠。
首次启动默认没有内容服务地址，也不会用测试数据冒充真实内容。「测试播放器」仅播放明确标注的 Big Buck Bunny 公开样片。
服务默认仅监听 127.0.0.1；--lan 显式开放家庭网络访问。可通过 BRIDGE_TOKEN 设置访问口令，并在电视端填入相同值。此服务按家庭网络使用设计，未实现公网部署所需的完整访问控制。手机 / 浏览器不要假定可直接使用原生端的媒体和请求头配置。
独立服务部署
只部署服务时不需要安装 React Native 依赖：
npm ci --prefix server
node server/index.mjs --lan电脑 / NAS 可使用 Docker，从源码或 Release 的 Docker 部署包根目录执行：
cp .env.example .env
docker compose --env-file .env -f server/compose.yaml up -d --build也提供 ghcr.io/n3urda/hongguotv-bridge:0.1.1 的 AMD64 / ARM64 镜像，以及根目录的镜像部署 Compose；私有镜像登录、更新和排查见 Docker 部署指南。服务参数为 BRIDGE_HOST、PORT、BRIDGE_TOKEN；Node 进程不会自动读取 .env，应由 shell 或部署工具传入环境变量。
开发与验证
npm ci
npm run typecheck
npm test
npm run bridge
# 另一个终端：访问真实平台，结果写入 outputs/probe.json
npm run probe
# 需要 JDK 17、Android SDK 36、Build Tools 36.0.0、NDK 27.1.12297006
npm run build:androidbuild:android 生成包含 JavaScript 的 release APK，运行时不需要 Metro。首版使用本地开发签名供自用安装；签名文件被 Git 忽略，换机器构建需保留同一密钥才能直接覆盖已有安装。对外发布前应配置自己的正式签名。
服务 API 与部署边界见 接口说明。
项目资料
来源与许可证
项目与红果官方无关联。内容接口为非官方实现，平台变化可能导致失效；错误会明确显示，不会替换为虚假内容。
Node 服务使用固定提交的 drpys 源，保留原文件、GPL-3.0 许可证和来源记录，见 第三方说明。Android / tvOS 工程骨架源于 MIT 许可的 RN TV 模板。本项目代码按 GPL-3.0 提供，第三方部分保留各自许可。