never88gone / THLRedGuo

# 糖葫芦Haw (THLRedLook)
> ⚠️ **免责声明 (Disclaimer)**：
> 1. **仅供学习研究**：本项目仅供编程技术交流、Flutter 跨平台与 Apple tvOS 原生应用架构研究使用，严禁用于任何商业牟利或侵权用途；
> 2. **纯客户端工具，无内容存储**：本项目为纯本地端侧播放器工具，无需注册登录即可直接使用；开发者不搭建、不运营任何流媒体服务器，不提供、不存储、不分发任何音视频资源；
> 3. **网络数据版权归属**：应用中所有可访问的数据源均来源于第三方网络公开平台，其版权与知识产权均归原版权方所有，请自觉支持正版内容；
> 4. **责任限制**：用户使用本软件及自配数据源产生的一切法律责任及版权纠纷均由使用者自行承担，与本项目及其代码贡献者无关。
**糖葫芦Haw**（工程标识：`THLRedLook`，包名 / Application ID：`com.never88gone.redlook`）是一款基于 **Flutter + Apple tvOS 原生** 打造的全平台独立流媒体与短剧聚合应用。
应用内无需注册任何账号、无需登录，打开即用。数据解析、高清播放、弹幕呈现与离线下载均在设备本地端侧闭环完成，无需搭建任何远程中转或中心化代理服务，带来极速的启动体验、数据私密性与全平台一致的使用感受。
---
## 📲 官方公测与交流反馈
- **🍏 Apple TestFlight 官方公测**：立即加入 TestFlight 公测 (iOS / iPadOS / tvOS)
 > 覆盖 iOS (iPhone / iPad) 与 Apple tvOS 客厅大屏版，点击链接即可通过苹果官方 TestFlight 一键安装并接收版本更新。
- **💬 Telegram 官方交流与反馈**：https://t.me/tanghulutvos （频道 / 群组：`@tanghulutvos`）
 > 欢迎加入 Telegram 官方交流群获取最新动态、交流反馈与建议。
---
## 界面预览
### 🖥️ 桌面端宽屏与分栏视窗 (Windows / macOS)
| 桌面端宽屏分栏全景 | 桌面端高清播放与选集 |
| :---: | :---: |
| | |
### 📱 移动端核心观影体验 (iOS / Android)
| 首页发现与分类 | 搜索与关键词联想 | 热播短剧排行榜 |
| :---: | :---: | :---: |
| | | |
| 剧集详情与选集 | 竖屏沉浸式播放 | 横屏全屏影院模式 |
| :---: | :---: | :---: |
| | | |
### 🗂️ 追剧、历史、离线缓存与插件管理
| 我的追剧收藏 | 最近观看 | 离线下载管理 | JS 数据源插件管理 |
| :---: | :---: | :---: | :---: |
| | | | |
### 🔒 隐私安全与私密保险箱
| 九宫格手势锁 | 隐私模式与私密设置 | 独立私密短剧库 |
| :---: | :---: | :---: |
| | | |
### 📺 Apple tvOS 客厅大屏原生端
| tvOS 首页瀑布流 | tvOS 剧集详情与选集 |
| :---: | :---: |
| | |
| tvOS 热播排行榜 | tvOS 全屏播放与控制层 |
| :---: | :---: |
| | |
---
## 平台支持矩阵
应用深度适配移动端、桌面端与客厅大屏，覆盖以下操作系统与形态：
| 平台 | 形态与特性 | 构建与交付产物 |
| :--- | :--- | :--- |
| **Android** | 适配手机与折叠屏，支持竖屏短剧滑动手势、画中画（PiP）浮窗、arm64-v8a / armeabi-v7a / x86_64 三架构 | 原生 Flutter + NDK 编译，输出 APK / AAB |
| **Android TV** | 自动识别大屏电视模式，锁定横屏影院布局，完整适配遥控器方向键与焦点移动 | 共用 Flutter 源码，自适应电视 UI 布局 |
| **iOS** | 适配 iPhone / iPad，支持深色模式自适应、原生手势返回与后台低功耗下载 | Xcode 编译签名，输出 IPA 归档；支持 Apple TestFlight 一键安装 |
| **macOS** | 桌面端大屏响应式三栏/分栏布局，键盘方向键与快捷键全面支持 | macOS App / PKG 安装包 |
| **Windows** | 基于 `media_kit` / libmpv 硬件解码，集成专属 Shader 画质增强滤镜 | 独立免安装绿色包 / 便携目录（含完整 DLL 与运行环境） |
| **Apple tvOS** | 独立原生工程（`tvos/`），纯 SwiftUI + Siri Remote 焦点引擎 + AVKit 原生渲染打造，具备完整客厅大屏交互与原生影院体验 | 独立 Xcode 工程，输出 tvOS IPA；支持 Apple TestFlight 一键安装 |
---
## 核心功能介绍
### 📺 首页探索与热播排行
- **发现页（Flutter / tvOS）**：直接读取红果手机 App「找剧」的全部、真人剧、漫剧、AI剧分类与数据；瀑布流滚动自动加载下一页，失败后可重试；
- **手机版短剧榜单**：读取手机 App 返回的总榜与真人剧、漫剧、AI 剧分类榜，保留官方排序和指标。
### 🔍 智能搜索与联想
- **手机版搜索与联想**：使用红果手机 App 搜索接口，支持游标分页；空输入展示官方“猜你想搜”，输入关键字展示官方搜索联想；
- **本地搜索历史**：自动记录搜索词，支持一键点击历史词快捷重新检索或清理历史。
### 🎬 剧集详情与系列多季
- **完整剧集信息展布**：清晰展示短剧海报封面、总集数、剧情简介与评分信息；
- **系列多季聚拢展示**：优先使用红果 App 系列剧接口，按官方季号展示并切换；未上线季显示待上线状态，接口不可用时回退搜索匹配。
### ⚡ 影院级视听与播放控制
- **清晰度智能与手动切换**：支持 1080P 超清、720P 高清与 360P 标清平滑切换，优先播放最高清画质；
- **实时弹幕互动**：弹幕随播放时间轴滚动渲染，支持在播放菜单中随时开启或关闭弹幕；
- **多种播放手势与偏好**：
 - **手机竖屏**：手指上下滑动快速换集，长按屏幕任意位置触发 3 倍速快进，轻点启停；
 - **横屏模式**：屏幕左侧上下滑动调节亮度，右侧上下滑动调节音量，左右滑动快进/后退；
 - **连播与预热**：支持在播放菜单中自由开启或关闭“自动连播”；开启下一集预加载，片尾秒开切集；
- **统一全景选集浮层**：弹出浮层支持多季切换、正序/倒序排列与完整平滑滚动，横屏播放下选集顺畅不遮挡。
### 🗂️ 我的追剧与播放历史
- **一键追剧收藏**：在详情页或播放器中点击“加入追剧”即可收藏，方便随时