guoapp-tvos

项目概述

红果 tvOS 由 lukaschan 维护，是红果鉴、真果鉴生态里的 Apple TV 原生端，从上游 Xanerix/guoapp 拆分而来：与主仓库共享 Go 核心和 DuanjuRequest JSON 协议，界面用 SwiftUI 独立编写。视频播放不走 AVPlayer 而用 MPVKit（libmpv），因为红果源视频带 CENC 加密，密钥要经 FFmpeg demuxer 选项直传解码器。它分两个版本，功能完全相同，区别只在站源范围：红果鉴只收红果站源，真果鉴收全部站源。

一台 Apple TV 加一个侧载 IPA，客厅大屏直接追短剧。

项目	内容
平台	Apple TV（tvOS）
技术栈	SwiftUI + Go 核心 + MPVKit
版本分支	红果鉴（仅红果源）、真果鉴（全部源）
播放内核	libmpv（mpv 0.41.0、FFmpeg n9.0.2、libplacebo v7.360.1）
许可证	未标注，播放组件 MPVKit 为 LGPL-3.0

主要功能

• 浏览与搜索：首页推荐、关键词搜索、剧集详情与选集
• 追剧与进度：追剧收藏、观看进度、最近观看记录
• 自动连播：一集播完自动接上下一集
• 红果榜单：直接浏览红果站内榜单
• 清晰度与倍速：清晰度在设置里调整、下次打开剧集生效，倍速支持播放中实时切换

遥控器操作

• 刷新首页：在「首页」按「播放/暂停」键手动刷新
• 实时倍速：播放中按「↑」放慢、「↓」加快
• 删除记录：在「最近观看」按「播放/暂停」键删除该条记录

适用人群

• 用 Apple TV 追红果短剧的用户
• 偏好大屏观影、遥控器操作的电视党
• 已在用上游 guoapp、想要原生 tvOS 版的用户

安装与签名

1. 到仓库 Releases 下载对应版本 IPA，tag 形如 tvos-v0.2.74-84，红果鉴与真果鉴各一个
2. IPA 为未签名包，需在 Mac 上用 Xcode 签名后安装到 Apple TV
3. 聚合第三方源站的应用上架 App Store 有合规风险，获取途径为侧载或 TestFlight

系统要求

项目	要求
设备	运行 tvOS 的 Apple TV
安装	Mac 上的 Xcode 侧载签名，或 TestFlight
网络	需可访问红果源站

注意事项

• 存储限制：tvOS 沙盒只开放 Caches 与 tmp 可写，追剧和观看进度存在 Caches，系统存储吃紧时可能被清理
• 未移植功能：下载与局域网互联暂未提供
• 弹幕不可用：弹幕界面已预留但尚未修复
• 源站依赖：内容来自第三方源站，接口变化可能影响播放