hongguo-drama-linux

项目概述

红果短剧终于有了开箱即用的 Linux 桌面版：hongguo-drama-linux 是由 yxt02 在 jackotom/hongguo-drama 基础上持续开发的独立项目，面向 Linux x86_64 分发，短剧搜索、在线播放、本地下载和续播全在本地完成，FFmpeg 与运行时已包含在安装包中，无需 Node.js。GPL-3.0 许可证，当前版本 1.74.9。

默认先转 H.264 兼容格式再播，不必等黑屏才手动转码。

项目	内容
定位	红果短剧非官方 Linux 桌面客户端
技术栈	Electron + Vite，内置 FFmpeg
平台	Linux x86_64（安装到 ~/.local/opt/hongguo-drama，免 sudo）
高清取源	默认 App 最高可用画质，可指定 1080p / 720p（按实际尺寸校验）
许可证	GPL-3.0，上游 jackotom/hongguo-drama

下载与安装

1. 从最新发行版下载 hongguo-drama-版本号-linux-x64.tar.gz，同时提供源码包与 SHA256SUMS.txt
2. sha256sum --ignore-missing -c SHA256SUMS.txt 核对安装包
3. 解压后运行 红果短剧.sh（启动器处理部分发行版的 Chromium 沙箱兼容问题，不建议直接跑 app 内二进制）
4. 运行 install.sh 添加应用菜单入口与 hongguo 命令

日常观看

功能	使用方式
找剧	浏览分类、搜索剧名，或粘贴分享链接与剧集 ID
高清取源	默认优先 App 最高可用画质，也可指定 1080p / 720p
兼容播放	默认准备 H.264 兼容格式后播放
续播	每部剧、每一季分别保存集数和播放位置
自动缓存	保留当前集及前后各 5 集，移出窗口的自动缓存会清理
批量下载	下载后续未完成集，跳过已完成、已排队和锁定集
连续播放	自动下一集、倍速、全屏与画面调节
托盘	点 X 完全退出，或最小化到托盘继续运行

实际清晰度以来源返回为准：部分分集标 1080p 实际只有 640×360，程序按尺寸校验并显示原因，不自动降级；转码不会把低清素材变成高清。

自动切季

打开一部剧后，应用在后台查找同一来源的其他季，直接显示在剧名下方，点击即可切换。支持某部剧1、某部剧一、第一季/第二部、Season 2、S3、全角括号数字等标题形式；各季独立续播，标题匹配过滤其他剧名与跨来源条目。季关系来自标题识别可能误判，不规范的标题可用「修正季信息」手动指定。

H.264 兼容与更新

• 转码策略：保持源视频尺寸，复用有效兼容缓存，串行提前准备附近集数；播放器内「本剧：兼容解码 → 恢复自动」可只为当前剧切回自动解码且被记住
• 一键更新：设置 → 检测更新 → 一键更新并重启；下载完整目录包，核对 SHA256 与版本，原位替换，失败恢复旧版并保留 .previous 备份；应用目录之外的观看记录、设置与手动下载不被覆盖；终端可执行 hongguo --update --restart
• 旧版升级：下载解压新版后运行 升级现有安装.sh，自动关闭旧程序替换，无需卸载
• 验证：46 项播放回归、Linux 打包及完整原位更新检查通过；Linux 发布工作流执行测试、打包与更新包检查后发布安装包、源码及校验文件