zhenguo-app

项目概述

这是一条按轮次交卷的开发线：zhenguo-app 是红果鉴/真果鉴 Flutter 多端短剧应用的主仓库（原名「短剧库 APP」），站源请求、解析、下载和播放均在设备上完成。README 逐版本记录每轮修复与验证（0.2.183+2196 为当前快照，最近正式版 v0.2.171），从 Go 核心取样 FFmpeg 独立复核到合成数据回归，验证过程全部公开。

站源协议下沉 Go 核心，每轮修复附验证证据。

项目	内容
定位	Flutter 多端独立短剧应用（Android / iOS / Windows / Android TV）
技术栈	Flutter + Go 1.24.1 设备端原生核心（FFI）
双变体	红果鉴（仅红果）/ 真果鉴（--all-sources，35 个站源）
当前快照	0.2.183+2196（待 iOS 设备复验），正式版 v0.2.171
特殊版本	Android 6 兼容版（android6 标签独立构建）

本轮工程亮点

• 分辨率识别选高清：小苹果源此前沿用源站返回顺序，现于播放计划生成前限量读取视频编码参数，识别 MP4、HLS/MPEG-TS 中 H.264/HEVC 分辨率（支持 AES-128 HLS 与 MP4 尾部元数据，用 mediacommon/v2 解析 SPS）；并发最多 4 条、整轮最多 6 秒、单次读取最多 256KB，失败标注分辨率未知，不按线路名补造画质
• Range 响应头修复：设备内转发此前遗漏 Content-Range、Accept-Ranges、ETag 等响应头，播放器无法判断文件总长与续读条件；现统一保留到缓冲与流式两条路径
• 小苹果与蜜果迁入 Go 核心：小苹果二进制 Protobuf 请求加 RSA/AES/RRSP 签名解密；蜜果握手与挑战验证自动获取会话密钥，过期或 401 自动重握手一次
• 真实接口对比验证：红果 App 分类目录改用完整 App 请求签名后，一轮从头扫描收录 3194 部，真人剧/漫剧/AI 剧分别读取 67/44/83 页

站源与功能面

• 站源矩阵：真果鉴覆盖红果、黄豆、剧果、野果、帝果、小苹果、蜜果及果系站源共 35 个；绿色模式仅显示获准的普通站源
• 直播：央视频适配更新到 YSP Live v9.5，支持按日期查看节目单并点击回看；默认红果鉴隐藏直播，在「关于红果鉴」输入 Shineyue 激活，真果鉴默认显示
• 弹幕：兼容弹弹play API，可添加多个数据源并选默认源，弹幕设置并入圆圈「弹」字按钮菜单
• 诊断报告：统一脱敏诊断模型，手机/Windows 可查看复制，Android TV 默认显示限长摘要二维码（最多 8 条、1800 字节，不携带错误原文）
• 追剧与历史：想看/在看/已看/有更新筛选，红果已追剧发现新季进入有更新；每 5 秒记录真实进度，按用户独立保存

双包与兼容版

• 包名分离：红果鉴为 com.duanju.duanju_app，真果鉴为 com.duanju.duanju_app.zhenguojian，使用不同固定签名，可在同一手机并存
• Android 6 兼容版：仅在 android6 前缀正式标签时构建，包名 com.duanju.duanju_app.android6，用旧版 Flutter/Gradle 与 API 23 原生核心；保留在线播放，不提供下载、本地合并与局域网发现
• CI 策略：普通提交只生成两版 Android 与 IPA 测试包；Windows 与 Android 6 兼容版仅在正式标签触发，构建结果以 GitHub Actions 为准
• 验证纪律：开发验证使用合成数据并禁用远程图片；Dart 分析无错误或警告，192 个 Dart 文件格式检查，Go 双版本全量测试与 22 项构建脚本检查纳入流程