Kotlin 0.8.0 · 安静连播与完整竖版海报

Kotlin 原生独立版，最低 Android 8.0。可直接覆盖安装旧正式版，保留本机记录，无需部署服务。

• 开播、手动换集和自动连播不再自动弹出进度条；暂停和快进等主动操作保留必要提示。
• 返回先收起进度条与控制面板，保持当前播放/暂停状态；再按一次才退出。取消选集保持原来的浮层可见性。
• 按接口原图展示完整竖版海报，约 7:10，解码与显示均保留比例，不再裁成近似方形。
• 重新设计首页、六列剧卡、选剧信息、焦点样式和两组设置面板；使用轻量原生控件，适配 720p 放大字体。

验证：73 项 JVM 测试通过、Release lint 0 错误/29 警告。最终签名包在 Android TV 模拟器实测第一集自动进入第二集无进度浮层、返回保留暂停与进度、六列焦点与 1.5 倍字体。保存证据检查 41 项通过。

源码提交：05331f83531f15db23ccfd55eb7ff84433797b9a

安装 hongguotv-kotlin-0.8.0-android8.apk，无需卸载旧正式版。另附源码 ZIP、验证 ZIP、SHA256SUMS。细节见源码中的 RELEASE_0.8.0.md。

尚未完成 Android 8 实体电视的芯片解码、音频、遥控器和长期稳定性验收；红果/抖音账号同步仍未接通。

发布提交的 GitHub CI 已通过：标签构建、分支构建。

Kotlin TV 0.7.0 · 低配电视性能与交互优化

Kotlin 原生独立版，最低 Android 8.0。直接覆盖安装旧正式版，保留本机记录，无需 Docker 或额外服务。

• 大剧库轻量浏览：收藏、历史、首页集合每页 20 部；首页各行限制数量，焦点预览缩为剧名与状态。
• 本机记录通过内存索引查询、后台合并写入；封面按显示尺寸解码，离开页面取消旧请求并释放旧视图。
• 普通换集复用播放器；下一集靠近片尾才准备，减少播放过程中的后台竞争。
• 首页确认即续播；播放中 ↓ 直接选集，↑ 打开简洁控制，列表返回与移除操作保留焦点。
• 修复部分低清晰度资源只有声音、没有视频的问题；优先兼容清晰度，必要时显示实际使用的「兼容资源」。

验证：73 项 JVM 测试通过、Release lint 0 错误/29 警告、40 项保存证据检查。正式 APK 连续 9 次换集均渲染首帧，网络超时后自动恢复成功。

同一模拟器的 500 收藏合成场景：收藏页 View 数 2625 → 132，单次 PSS 96,612 → 51,551 KiB；首页 PSS 未下降，不承诺全场景内存或速度比例。三组同集首帧对照：预加载 135–166 ms，普通加载 585–800 ms。三次保留缓存的冷进程 Activity 启动 166–338 ms。口径、截图与局限详见附件和源码 RELEASE_0.7.0.md。

源码提交：b65e7b549edc08a0fae1829a96b9a0089e99aada

安装 hongguotv-kotlin-0.7.0-android8.apk，同签名可覆盖安装，不要先卸载。另附源码 ZIP、验证 ZIP 和 SHA256SUMS。

Android 8 实体电视的芯片解码、音频、遥控器和长期稳定性仍需实机确认；红果/抖音账号同步尚未接通。

发布提交的 GitHub CI 已通过：标签构建、分支构建。

Kotlin 0.6.0 · 首页重组与快速换集

Kotlin 原生独立版，最低 Android 8.0。直接覆盖安装旧正式版，保留本机记录，无需 Docker 或额外服务。

• 首页重组：接着看、收藏有更新、稍后看、热门发现；上下切分区，左右选剧。
• 选剧更直观：焦点区展示剧名、集数/热度、题材、简介与观看状态；适配 720p 大字体。
• 剧卡快捷操作：长按确认/菜单键直接播放、收藏、稍后看、隐藏推荐；支持恢复隐藏，新增列表纳入备份。
• 启动和换集优化：首页/封面缓存、按视野加载、下一集准备与开头缓存；后台刷新不移动正在浏览的卡片。

验证：56 项 JVM 测试、Release lint 0 错误、38 项保存的界面/行为证据。正式 APK 连续 9 次前后切集通过；三组同集对照，预加载 READY 149–175 ms，未预加载 723–1140 ms。缓存首页三次 298–406 ms，无缓存一次 853 ms。均为模拟器小样本，计时口径及边界见源码中的 RELEASE_0.6.0.md。

源码提交：1ec7bd2327b9574e4bdf956569efd21bcf9a83c7

Android 8 实体电视的芯片解码、音频和遥控器仍需实机确认；红果/抖音账号同步尚未接通。

安装 hongguotv-kotlin-0.6.0-android8.apk；同签名可覆盖安装，不要先卸载。另附源码 ZIP、验证 ZIP 和 SHA256SUMS。

发布提交的 GitHub CI 已通过：标签构建、分支构建。

红果 TV Kotlin 0.5.0 · 定时停止与记录迁移

Kotlin 原生独立版，最低 Android 8.0，可直接覆盖安装旧正式版并保留记录，无需 Docker 或额外服务。

• 定时停止：按 15/30/60/90 分钟或片尾/3/5 集停止，保存位置并拦截自动下一集。
• 手机备份与恢复：同一局域网扫码导出 JSON；上传后电视确认才合并收藏、观看记录和搜索，设置可选择恢复。
• 全局画面模式：完整画面、等比铺满、拉伸铺满，播放中生效并保存。
• 系统媒体控制：播放/暂停/上下集/定位/停止；修复加载中暂停和选集弹窗取消后误播放的问题。

验证：50 项 JVM 测试、Release lint（0 错误）、29 项保存的 UI 断言；Android TV 模拟器验证播放、定时停止、实际 HTTP 备份恢复、720p 大字体与遥控器操作。验证 ZIP 包含截图、测试报告和各批 APK 哈希。源码提交：5877776a47b936ebb866d3ce29d9f8070ac8e6d8

Android 8 实体电视的解码/音频及真实手机扫码仍需实机确认。备份是本机数据迁移；红果/抖音登录和平台记录同步尚未接通。

下载 hongguotv-kotlin-0.5.0-android8.apk 安装；签名沿用旧版，不要先卸载。源码、验证包及 SHA256SUMS 一并提供。

发布提交的 GitHub CI 已通过：标签构建、分支构建。

Kotlin TV 0.4.0 · 播放恢复、追剧更新与全局配置

单 APK，最低 Android 8.0，无需 Docker 或另行部署服务。基于远程 7d76463，发布提交 3c2acd7080a2a53897dc4ba9a710e4d8800e8c45。

本版完成

• 播放故障恢复：联网恢复后重新获取播放地址，保留集数、位置和暂停状态；每集最多自动重试 3 次，支持立即重试、停止重试、改用 720P，退出前台取消自动重试。
• 播放中直接选集：侧边面板聚焦当前集，每组 20 集，支持数字跳转；定位后确认播放，取消恢复原状态和焦点。
• 首页一键续播：最近 3 部追剧直接进入播放，按剧集 ID 匹配进度，已播完本集则继续下一集。
• 收藏剧更新提示：前台自动检查超过一小时未检查的收藏，也可手动刷新；首次建立基准，此后显示新增集数和当前总集数。查看详情后清除新增提示，失败保留上次结果。
• 全局默认配置：480P / 720P / 1080P，0.75 / 1 / 1.25 / 1.5 / 1.75 / 2×。换集、换剧、重启后生效；播放菜单中修改也保存为全局默认。实际画质取决于片源提供的档位。

安装

直接下载 hongguotv-kotlin-0.4.0-android8.apk，同一正式签名可覆盖安装旧版并保留记录。不要先卸载。包名 com.hongguotv.nativeapp，versionCode 4。

私有仓库下载需登录有权限的 GitHub 账号。

验证

• 40 项 JVM 测试、25 条录制界面证据断言通过；Release lint 0 error / 19 warning。
• Android TV API 36 模拟器验证遥控器导航、720p / 1.5 倍字体、末组第 788 集选择、首页续播、配置跨重启保留。
• 实际网络故障注入得到 SocketTimeoutException，恢复联网后自动重试，回到原来的 00:07 暂停位置，480P / 1.5×。
• 收藏更新使用明确的合成旧基准 785 集，由正式 APK 从真实片源读取 788 集，验证新增 3 集、重启保留及查看清除；不声称测试期间平台实际新增三集。
• 最后将收藏更新说明改为两行并复核大字号显示；验证包逐项标注功能测试版与最终显示修复版的 APK 哈希。

Android 8.0 实体电视、音频及长时间播放尚待目标设备验收。红果登录与账号同步仍未接通；本版收藏更新提示基于本机收藏和内容详情，与账号同步不同。

发布文件

• APK：2,621,653 字节，SHA-256 6a63d73472ec0e608dcf7ecf07b6d0259c49cbe76cb0adbb0441cd46c7b99179。
• source.zip：对应发布提交的完整源码，Kotlin 项目位于 kotlin-tv/。
• verification.zip：构建、签名、测试报告、网络注入记录和 TV 截图/XML。
• SHA256SUMS：三个发布包的 SHA-256。

详细说明：0.4.0 交付记录。

发布提交的 GitHub CI 已通过：标签构建、分支构建。

Kotlin TV 0.3.0 · 集数跳转、手机输入与观看记录管理

单 APK，最低 Android 8.0，无需 Docker 或另行部署服务。基于最新远程 cdbc7ee 继续开发，发布提交 7d76463475365837e730cc62b46ff6160f09476c。

本版功能

• 遥控器数字面板跳转集数，定位后确认播放；无效输入提示、取消恢复焦点。
• 本机搜索历史：分类保存、去重、重搜、清空，重启保留。
• 手机扫码输入剧名：同一局域网的浏览器发送搜索词到电视，临时监听单次使用、最长 5 分钟，关闭弹窗或退后台即关闭；无需另外部署服务。
• 最近观看管理：删除单条、清空、标记整剧已看/恢复未看，收藏保留；已看剧集支持重新观看。
• 设置增加版本与更新二维码，打开 GitHub 发布页下载 APK。当前仓库为私有，需在浏览器登录有权限的 GitHub 账号；这是下载入口，不是自动更新器。
• 一并包含远程已有的漫剧/短剧筛选、漫剧热度排行榜和持久化倍速。

红果账号同步尚未实现

用户使用抖音账号登录红果。当前仍缺少经过验证的红果账号授权映射，以及收藏、历史和续播位置读写接口，尚不能将普通抖音登录等同于红果数据同步。本版没有登录或同步入口，也没有收集账号密码、验证码、Cookie 或令牌。接入调查及后续条件。

安装与文件

直接下载 hongguotv-kotlin-0.3.0-android8.apk，可使用原正式签名覆盖安装 0.2.0 / 0.2.1；不要先卸载，以免清除本机数据。包名 com.hongguotv.nativeapp，versionCode 3。

• APK：2,611,597 字节，SHA-256 5b0d68566bec950fe5850a1fa392fa6885c3c9f01be701ee5f2791e64551d5ef。
• source.zip：对应发布提交的完整仓库源码，原生项目在 kotlin-tv/。
• verification.zip：构建、签名、测试报告及最终 APK 的 39 组 TV 截图/XML。
• SHA256SUMS：三个发布包的 SHA-256。

验证范围

34 项 JVM 测试、30 条界面证据断言通过；Release lint 0 error / 13 warning。Android TV API 36 ARM64 模拟器验证了 1080p、720p 与 1.5 倍字体、方向键焦点、真实播放、倍速、排行榜返回和记录管理。手机输入通过 ADB 转发访问 APK 实际监听并提交中文搜索词，关闭窗口后监听停止。

Android 8.0 实体电视、实体手机与家庭路由连接、实际音频和长时间播放仍需目标设备验收。账号登录/同步不在通过项中。

发布提交的 GitHub CI 已通过：标签构建、分支构建。

hongguoTV v0.1.1 — TV 焦点与遥控器适配

电视展示与遥控器交互更新。继续采用 React Native TV，Android 8.0+，ARM32 / ARM64。

• 修复第二排卡片聚焦后被裁切、详情返回丢失位置、加载更多后丢焦点。
• 首页精简为一行导航，保留电视安全边距与两行剧名，增加续看入口。
• 详情默认聚焦播放，选集每 20 集分组，播放返回后定位当前集。
• 确认键直接播放/暂停；左右键跳转 10 秒，长按连续调整，松开停止。更多操作面板支持切集和返回选集。
• 搜索提交后聚焦结果；返回键逐级回到导航和电视桌面。

下载 hongguotv-0.1.1-android8.apk 覆盖安装即可，已确认与 v0.1.0 同签名；不要先卸载，原有设置、收藏和观看记录可保留。源码、Docker 部署包、验证证据和 SHA256SUMS 一并提供。

Docker 镜像：ghcr.io/n3urda/hongguotv-bridge:0.1.1，AMD64 / ARM64。使用已有 Compose 时将 .env 的 HONGGUOTV_VERSION 改为 0.1.1，执行 docker compose --env-file .env pull 和 docker compose --env-file .env up -d。私有镜像需登录 GHCR，也可用部署包从源码构建。服务协议保持兼容。

验证：12 项自动化测试、TypeScript、双 ARM APK 构建与签名校验通过；API 36 TV 模拟器验证了 720p / 1080p、1.3 倍字体、跨分页返回、末尾选集、单键暂停、长按快进释放和覆盖升级。容器发布由 GitHub Actions 完成 AMD64 / ARM64 构建与启动检查，ARM64 使用 QEMU。

实际 Android 8 电视、实际 4K 输出、厂商输入法、声音及长时间播放仍需目标设备验收；本次模拟器结果不能替代实机验证。

本版交付说明 · Docker 部署

hongguoTV v0.1.0 — Android TV + Docker

首个可安装版本：React Native TV 客户端连接独立内容服务，面向自家 Android 8.0 及以上电视。支持推荐、搜索、详情选集、遥控器操作、收藏、断点续播和自动下一集。

下载

• hongguotv-0.1.0-android8.apk：约 26 MiB，包含 ARM32 / ARM64 和 JS，无需 Metro；使用开发签名供个人侧载安装。
• hongguotv-0.1.0-source.zip：与版本标签一致的完整源码、锁文件和文档。
• hongguotv-0.1.0-docker.zip：独立内容服务、Dockerfile、Compose、示例环境变量与部署指南。
• hongguotv-0.1.0-evidence.zip：接口、媒体、APK、模拟器及容器验证记录。
• SHA256SUMS：以上四个文件的校验值。

Docker 快速部署

解压 Docker 部署包，在解压后的根目录执行：

cp .env.example .env
docker compose --env-file .env -f server/compose.yaml up -d --build

电视安装 APK，在「设置」填入 http://宿主机局域网IP:8787。服务设备需要保持在线；如在 .env 中设置了 BRIDGE_TOKEN，电视同步填写相同口令。

预构建镜像为 ghcr.io/n3urda/hongguotv-bridge:0.1.0，支持 linux/amd64 和 linux/arm64。私有镜像需要先登录 GHCR，再使用根目录 compose.yaml 拉取部署；源码构建方式不需要 GHCR 登录。

完整 Docker 指南 · 首版交付说明

验证与范围

• 类型检查和 9 项自动化测试通过；17 项真实内容与媒体探测通过。
• Android TV API 36 模拟器验证真实播放、遥控器、收藏持久化、续播和自动下一集。
• AMD64 / ARM64 镜像构建及容器启动、健康检查、端口映射、口令验证通过；ARM64 容器采用 QEMU 验证。
• 版本构建及镜像发布记录。

实际 Android 8.0 电视和用户 NAS 尚未连接验收；硬件解码、声音、长时间连播及家庭网络表现仍需实机确认。Apple TV 仅有工程骨架，其他平台尚未交付。内容服务依赖非官方接口，实现和 GPL-3.0 来源说明随源码提供。

镜像索引摘要：sha256:4e18a419f815e3e1c1ea1776107b2ae63b3b265f28b569d1a6e2cb030772bf9d。

Kotlin TV 0.2.1 · 遥控器焦点与大字号修复

修复上次电视交互检查发现的三处问题：

• 展开、收起简介后，焦点保留在简介按钮，连续按确认不会误启动播放。
• 切换清晰度、自动连播后，焦点保留在当前设置项。
• 卡片按字号自动调整高度；放大系统字体后，两行标题不再被裁切，同一行卡片与底部集数对齐。

下载 hongguotv-kotlin-0.2.1-android8.apk，直接覆盖安装 0.2.0 即可，保留本机收藏和观看记录。继续使用单 APK，无需部署服务。最低 Android 8.0 / API 26，包名 com.hongguotv.nativeapp，正式 APK 约 2.5 MB，与 0.2.0 使用同一发布签名。

最终签名 APK 已在 Android TV API 36 模拟器覆盖安装并复测：720p / 1080p 默认字号，720p 的 1.3 / 1.5 倍字号，连续按确认、大字号列表滚动、返回焦点恢复、真实 1080P 播放、暂停与快进。23 组截图及 XML、27 项交互断言随验证包交付。Android 8.0 实体电视的芯片解码、音频和长期播放仍需实机验证。

源码与交付说明 · GitHub CI 已通过

提交：7601b25a19e3befa50e1d7f85d5b080088cdb69a。

APK SHA-256：b83aebc10a3e1e790c5b729d835ffa9ac7490d2bce4d07fd56605952853b0e74。

其他附件是完整源码、验证证据及 SHA-256 校验和，无需安装。

Kotlin 0.2.0 · 独立电视 APK，无需部署服务

Kotlin 原生独立版：下载 APK 安装到电视，联网即可使用，无需部署 Node / Docker，也无需填写服务器地址。

• 最低 Android 8.0 / API 26，APK 约 2.5 MB。
• 推荐、搜索、分页、详情、20 集分组选集、收藏、最近观看、断点续播和自动连播。
• 原生 TV 焦点与遥控器操作；确认暂停/播放、左右跳转、向下打开播放菜单。
• Media3 原比例播放，支持 720P / 1080P 清晰度上限。
• 独立包名 com.hongguotv.nativeapp，应用显示为「红果 TV 原生版」，可与旧版并存；旧版收藏/历史不会自动迁移。

直接安装 hongguotv-kotlin-0.2.0-android8.apk。其余附件是源码、验证证据和校验和，不需要部署或安装。

已通过本地 JVM 测试、Android lint、正式签名安装，以及 Android TV API 36 模拟器真实播放和遥控器检查；覆盖 720p / 1080p 显示、收藏续播、跨页焦点恢复、后台暂停、网络错误重试。Android 8.0 实体电视的芯片解码、实际音频输出和长期播放仍需实机验收。

原生工程与构建说明 · 源码及许可证

GitHub CI 已通过，对应提交 826ca31e3c2910abd55817c1a75a77484088f19e。验证包包含 7 个 JVM 测试结果、21 项 UI 断言及 4 项补充运行检查。正式发布 APK SHA-256：a12ae6f447514b890778ebb8181092776bb08a224849010ace382c81a89ad72e。