guoapp

<div align="center">

<img src="ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png" width="120" alt="红果鉴图标">

# 红果鉴

Flutter 多端独立短剧 / 影视应用，手机、平板、电脑和电视分别适配

[![Release](https://img.shields.io/github/v/release/Xanerix/guoapp?style=flat-square&color=3d4656)](../../releases)
[![License](https://img.shields.io/badge/license-GPL--3.0-3d4656?style=flat-square)](LICENSE)
![Flutter](https://img.shields.io/badge/Flutter-3.47.9-02569B?style=flat-square&logo=flutter&logoColor=white)
![Platforms](https://img.shields.io/badge/platform-Android%20%7C%20iOS%20%7C%20Windows%20%7C%20macOS-8fa3bc?style=flat-square)

[下载](#安装) · [功能](#功能) · [站源](#站源) · [隐私](#检查更新与使用统计) · [开发](#开发)

</div>

---

本项目改编自 [fish2018](https://github.com/fish2018) 的源码，分两个版本发布：

| 版本 | 站源 | 安装包前缀 |
| --- | --- | --- |
| **红果鉴** | 只含红果站源 | `hongguojian-` |
| **全站源版** | 含全部站源，可在设置里逐个开关 | `zhenguojian-` |

## 功能

### 界面与外观

- **导航**：发现 / 追剧 / 我的。手机用底栏，平板和电脑用侧栏（可收起），电视用顶部 Tab；宽屏的子页面在侧栏右侧打开。
- **界面模式**：自动识别、电视、手机、平板、窗口（只有电脑提供）；手动选定后不随窗口宽度切换。电视模式强制横屏，手机模式锁定竖屏。
- **主题**：跟随系统取色（Android 12+ 跟随壁纸，Windows 和 macOS 跟随强调色）或 6 个预设色板；浅色 / 深色 / 跟随系统。

### 浏览

- **发现**：站源名旁切换站源；分类 Tab 依次为推荐 / 全部 / 各榜单 / 各题材，榜单封面标出名次。第一个 Tab 顶部大卡片显示最近看过或推荐的剧。滑到底自动加载，下拉或「刷新」重新拉取当前分类。
- **搜索**：只搜当前站源，保留最近搜索；红果有输入联想。
- **详情**：封面模糊作底，显示集数、完结状态、分类、播放量、标签和简介；选集每组 30 集，落在续播那一集，看过的集变浅，VIP 集有标记。打开时后台预缓冲续播集。

### 播放

| 设备 | 体验 |
| --- | --- |
| 电脑 | 左边视频、右边选集栏，可宽屏、全屏；悬停弹出清晰度、倍速、音量；支持空格、Enter、方向键、M 等快捷键 |
| 手机 | 竖屏短剧沉浸式，上下翻页切集，左右滑快进快退，长按画面打开「播放设置」，长按左侧 2 倍速，可锁定。横屏视频竖拿时视频在上、简介 / 选集在下，转横屏自动全屏；全屏双击两侧快退 / 快进，左半屏上下滑调亮度，右半屏调音量 |
| 平板 | 横着拿同电脑，竖着拿同手机，全屏期间锁定横屏 |
| 电视 | 播控浮在画面上，隐藏时左右键快退 / 快进 10 秒；返回键依次关闭选项、收起播控、退出；换集回详情页选 |

所有设备通用：下一集提前缓冲，翻页和连播直接接上；倍速、清晰度和弹幕开关会记住。红果在线播放有弹幕，本地播放不加载。

### 追剧与记录

- **追剧**：只分追 / 不追。有新集的剧排在「有更新」并标出更新集数；可搜索、按站源筛选、多选取消。后台每 30 分钟检查一批未完结的追剧。
- **观看记录**：按今天 / 昨天 / 更早分段；可搜索、按站源筛选、多选删除，「清空」只清当前列出的记录。
- **我的**：用户卡、最近观看、下载概况和设置入口；底栏 / 侧栏图标显示正在下载的集数。

### 下载

- 详情页「下载选集」或播放页选集栏多选（点选、拖选、全选）。
- 下载页分「下载中」「已下载」，可单集或全部暂停 / 继续 / 重试；已下载按剧显示，可播放、删除、补齐缺集。
- 每集下载完自动转成普通 mp4（红果先解密，m3u8 合成一个文件），保存为 `下载目录/剧名/第 N 集.mp4`，可以直接拷出使用。
- 旧版下载的分集保持原样，旧版合并出的文件不再列出。电视端不提供下载。

### 设置、用户与备份

- **设置**：外观、播放、下载、站源、代理、用户、关于、诊断 8 组，改动立即保存；没有权限的项置灰并注明原因。
- **用户**：多用户独立保存追剧、记录和搜索，轻点即切换；管理员可添加、编辑、删除用户，设置能访问的站源和是否允许下载。
- **备份**：导出 / 恢复用户、追剧、观看记录和偏好设置（含主题色），已下载视频不受影响；旧版备份仍可导入。本地配置损坏时启动页可从备份恢复。

> [!NOTE]
> 画中画、画质增强、排序与筛选、剧集长按菜单、红果多季切换暂不提供。

## 站源

| 站源 | 内容 | 搜索 |
| --- | --- | --- |
| 红果 | 短剧、漫剧、AI 剧；推荐、榜单、题材 | 在线搜索，带输入联想 |
| 红果听书 | 听书、小说频道的有声书；逐章 mp4 音频 | 在线搜索 |
| 韩小圈 | 韩剧、韩国电影、综艺、动漫，多线路 | 在线搜索 |
| 鬼片 | 鬼片、电视剧、动漫，多线路 | 匹配站点 RSS 最新条目 |
| 青空 | 番剧、剧场动画、特摄 | 在线搜索 |
| 黄豆 | 精选短剧、榜单 | 只搜本机缓存 |
| 剧果 | 分类短剧 | 在线搜索 |
| 野果 | 分类短剧 | 在线搜索 |
| 帝果 | 分类视频 | 在线搜索 |
| 禁果短剧 | 推荐、热度、分类短剧 | 在线搜索 |
| 禁果 | 精选、最新、分类短剧 | 在线搜索 |
| 黑桃 | 分类、详情、分集 | 在线搜索 |
| 笔盒 | 最新视频、标签分类 | 在线搜索 |
| 黄果视频 / 黄果 AI / 黄果旧版 | 列表、分类及分集 | 只搜本机缓存 |

站源可用性、清晰度和区域限制取决于源站及网络；应用不解除源站 VIP 或其他授权限制。

## 安装

在 [Releases](../../releases) 下载对应平台的包：`hongguojian-` 开头的是红果鉴，`zhenguojian-` 开头的是全站源版。

| 平