kuoluoss / zhenguojian

# 真果鉴
多站源短剧浏览与在线播放应用，Android 手机版。基于开源项目 Topkill/guoapp3 二次开发与改版。
当前版本：**0.7.15+75** ｜ 平台：Android 8.0+（arm64-v8a） ｜ 下载最新版
---
## 一、这是什么
一款聚合多个短剧站源的客户端：浏览、搜索、详情、选集、在线播放、下载与合并，**全部在手机本地完成**，不依赖任何自建服务器或中转。
- **站源解析**：设备端直接请求各站源接口，不经过第三方中转。
- **数据存储**：剧库、追剧、观看历史、下载记录都保存在本机。
- **账号**：没有云端账号，不需要登录；只有本机用户与权限管理。
## 二、本次更新（0.7.15）
- **修复：连播本剧切集后，会闪一下上一集最后一帧**
 - 原因：动画一结束就复位画面，但切集要先保存进度再换片源，这段空档播放器还在显示上一集；
 - 现在：画面先停在屏幕外（纯黑），**等新集真正就绪再复位**，10 秒兜底防止一直黑屏。
上一版 0.7.14：连播本剧切集跟手动画。更早版本见 Releases。
## 三、快速开始
1. 从 Releases 下载 `zhenguojian- -arm64-v8a.apk`。
2. 手机上安装（需允许「安装未知来源应用」）。
3. 打开即用；之后有新版本时，App 内会提示更新。
要求：**Android 8.0 及以上、64 位（arm64-v8a）**。
若安装提示 `INSTALL_FAILED_NO_MATCHING_ABIS`，表示设备架构与安装包不匹配。
## 四、功能一览
| 模块 | 能力 |
| --- | --- |
| 浏览 | 首页竖滑刷剧；发现页分类、榜单、排序与筛选（名称 / 季号 / 上线日期 / 热度 / 播放量、连载状态）；VIP 过滤（仅黄豆） |
| 搜索 | 红果联网搜索 + 联想；黄剧在线搜索；其余站源在已加载内容内筛选 |
| 推荐 | 仅红果：真人剧 / 漫剧 / AI 剧，可刷新、可继续刷 |
| 详情与选集 | 剧集资料、追剧、每 50 集一组翻页、输入集数跳转 |
| 播放 | 竖滑切集、双击暂停、长按 3 倍速、预加载下一集、清晰度 / 倍速 / 选集、全屏横屏手势 |
| 剧库更新 | 自动更新（可关闭）+ 手动一键更新；补集数与简介；超时自动分批续跑 |
| 下载与合并 | 批量下载、暂停 / 继续 / 重试、合并成分集视频、本地播放 |
| Emby 导出 | 生成 Emby 可识别的目录结构与海报 |
| 局域网 | 追剧同步、推送播放（把一台设备正在看的内容推到另一台） |
| 用户与权限 | 本机多用户、按用户开放站源与下载权限 |
| 外观 | 浅色 / 深色 / 跟随系统 |
## 五、手势速查
### 竖屏（手机）
| 操作 | 效果 |
| --- | --- |
| 上滑 / 下滑 | 下一集 / 上一集（首页为下一部 / 上一部剧） |
| 单击 | 显示 / 隐藏控件 |
| 双击 | 播放 / 暂停 |
| 长按 | 3 倍速，松开恢复 |
| 顶部约 60px 内滑动 | 交给系统（拉通知栏），不切集 |
### 全屏横屏（0.7.2 新增）
| 操作 | 效果 |
| --- | --- |
| 左右滑动 | 调整进度（拖动时显示目标时间，松手生效） |
| 左侧 1/3 上下滑 | 画面亮度 |
| 右侧 1/3 上下滑 | 音量 |
| 中间 1/3 上下滑 | 上一集 / 下一集 |
| 单击 / 双击 / 长按 | 与竖屏一致 |
说明：亮度是**画面亮度**，不改手机系统亮度；音量是**应用内音量**，不是系统媒体音量。
### 电脑（Windows 版，源码保留）
播放画面获焦时：空格播放 / 暂停，左方向键后退 5 秒，右方向键轻按前进 5 秒、长按临时 3 倍速，上下方向键调音量，M 静音，F / F11 全屏，Esc 退出全屏或返回。
## 六、站源
| 站源 | 说明 |
| --- | --- |
| 红果 | 官方 App 接口；推荐流分真人剧 / 漫剧 / AI 剧；支持联网搜索与联想 |
| 黄豆 | 目录分页；支持 VIP 标记过滤 |
| 黄剧 | 目录 + 在线搜索 |
| 黄果剧场 | 原「黄果视频」，域名 `huangguoai.fit`；直连较慢，走代理更快 |
| 黄果 AI | 多镜像域名；稳定性受站点限流影响 |
| 黄果旧版 | 直连正常；代理出口 IP 可能触发限流 |
- 站源在「站源管理」里勾选；勾选多个时首页混合随机。
- **剧类筛选只在只选红果时可用** —— 只有红果提供这套分类，其它源没有对应维度。
## 七、常见问题
**Q：为什么剧库更新要很久？**
A：更新需要逐部复查详情。红果 2600 多部约 11 分钟、黄果 AI 2200 多部约 18 分钟，而单轮上限 10 分钟，所以会分批续跑。0.7.1 已把后台自动更新改为 2 小时间隔、可关闭；手动更新仍可随时执行。
**Q：黄果几个源有时更新失败？**
A：属网络可达性问题，不是解析错误 —— 黄果视频走 IPv6 且无备用域名，黄果 AI 的镜像域名会被重置。换网络或开代理后重试通常能恢复。
**Q：调了亮度，手机屏幕亮度没变？**
A：设计如此。只调整视频画面亮度，不动系统亮度，退出播放器后手机亮度不受影响。
**Q：为什么只提供 64 位安装包？**
A：目标设备（手机与投影仪）均为 arm64。32 位构建脚本保留，但不再发版。
**Q：支持电视 / 电脑吗？**
A：Android TV 适配已暂停（遥控导航能力随老播放器一并移除，日后重新实现）；Windows 版源码保留但当前不构建、不交付。
**Q：需要登录吗？**
A：不需要。没有云端账号；本机用户管理只用于区分不同使用者与权限。
## 八、平台状态
| 平台 | 状态 |
| --- | --- |
| Android 手机（arm64-v8a） | **当前交付**，持续发版 |
| Android TV | 暂停（代码保留，不删除） |
| Windows x64 | 源码保留，暂停构建 |
| iOS | 未实施（工程与构建脚本保留） |
## 九、当前待办
- Android TV 重新适配（遥控焦点与电视布局，需重新实现而非复用旧播放器）。
- Windows / iOS 平台恢复构建与验收。
- 黄果三源网络可达性优化（等用户实测后确定修复范围）。
## 十、开发与构建
环境：Flutter `3.47.4`、Dart `3.12+`、Go `1.24.1+`、Python `3.10+`；Android 需 JDK 17、SDK 36、NDK `28.2.13676358`。
 [code] 
- **必须在纯英文路径下构建**（中文路径会导致工具链失败）。
- 构建时不要设 HTTP 代理；访问 GitHub 时才需要代理。
- 产物在 `dist/android/`，`SHA256SUMS.txt` 为