hongguo-drama README

项目的 README,来自 github.com/jackotom/hongguo-drama。合并为一个 markdown 文件:README.md。

红果短剧桌面版图标

红果短剧 · 桌面与NAS

发现好剧,接着上次看。搜索、播放、下载、追剧与合并导出,在一个桌面应用里完成。

最新公开版本 macOS 13 或更新版本 Apple 芯片 Mac、Intel Mac、Windows x64 与 Linux x64 GPL-3.0 许可证

下载与安装 · 完整功能 · 界面与演示 · 常见问题 · 贡献与致谢 · 反馈问题

下载与安装

当前正式版:7.6(内部7.6.0,桌面构建7.6.1)。本轮集中修复下载与合并数据安全、并发进度覆盖、双击选集冲突、删除误操作和代理边界;统一发行双Mac、Windows x64与Linux x64 AppImage。

7.6已于2026-11-18 18:17:30(Asia/Shanghai)公开并设Latest;23份正式附件、远端SHA256与匿名下载入口均已核对,最终状态以7.6记录为准。

平台 7.6正式附件 验收状态
Apple芯片Mac,macOS 13+ DMG 已签名、公证、装订
Intel Mac,macOS 13+ DMG 已签名、公证、装订;实体Intel未验
Windows x64 安装版 · 便携EXE · 便携ZIP EXE未签名;真实下载、播放及安装升级在GitHub Windows虚拟机通过
Linux x64 AppImage 赋予执行权限后运行;CI虚拟机验收

7.6正式发行页 · SHA256 · 精确源码。实际状态见7.6记录。上游部分网页片源仍可能404、只提供预览或超时,不保证所有内容永久可播。

Android手机APK/Android TV版: 请前往 N3urda/hongguoTV 下载。该项目独立维护;版本、兼容性与测试状态以该项目发布页为准,不计入本项目的四平台附件或验收。

7.5 历史下载与发行说明

7.5历史发行包与验收回执见7.5发行页及7.5记录;历史签名、公证和平台验收不替代7.6结果。

7.4 历史下载与发行说明

7.4历史发行包与验收回执见7.4发行页及7.4记录;历史签名和验收结果不代表7.6通过。

7.3 历史下载与发行说明

历史正式版:7.3(内部7.3.0,桌面构建7.3.1)。新增可配置的 S / D 倍速调节,并加强下载文件身份、媒体地址、NAS 目录和 Docker 队列保护。完整回执见7.3记录。

7.2 历史下载与发行说明

历史正式版:7.2(内部7.2.0,桌面构建7.2.1)。修复外置exFAT下载身份误判、仅移除记录受阻,以及本地组件故障造成的无效重复下载;保留文件安全校验。原五平台正式包与TV开发补充包已公开;#151中文字幕未实现。验证与限制见7.2回执。

7.1 历史下载与发行说明

历史正式版:7.1(内部7.1.0,桌面构建7.1.2)。新增高性能显卡转换选项,修复下载恢复/重试顺序与临时文件冲突,升级依赖并补齐完整贡献致谢。五类平台已统一公开;验证与性能边界见7.1回执。

以下为7.1正式下载。Mac已签名、公证、装订;Windows EXE未签名。

平台 下载7.1 使用方式
Apple芯片Mac,macOS 13+ DMG 拖入应用程序;已签名、公证、装订
Intel Mac,macOS 13+ DMG 同上;验收仅Rosetta
Windows x64 安装版 · 便携EXE · 便携ZIP 安装版支持应用内更新;EXE未签名
Linux x64 AppImage 赋予执行权限;手动更新
Docker Linux amd64 / NAS 镜像 · 部署包 按部署文档设置令牌与挂载目录

7.1发行页 · SHA256 · 精确源码。实际状态见7.1正式回执。TV和手机保持独立,不包含在本轮五类产物中。上游部分网页片源仍可能404、只提供预览或超时,不保证所有内容永久可播。

7.0 历史下载与发行说明

历史正式版:7.0(内部7.0.0,桌面构建7.0.1)。7.0已于2026-11-11 21:41:46(Asia/Shanghai)正式公开并设Latest,内部7.0.0、桌面构建7.0.1,冻结源码3f5927d0d605ff7742fde8cbd1bb92ffe951b080。双Mac、Windows x64、Linux x64 AppImage、Docker amd64五类共25份正式附件;双Mac已签名、公证、装订,Windows EXE未签名且App真实下载队列未测,Intel仅Rosetta。未运行通用全量测试,未替换本机正式安装;TV与手机独立。见7.0正式回执。

平台 下载7.0 使用方式
Apple芯片Mac,macOS 13+ DMG 拖入应用程序;已签名、公证、装订
Intel Mac,macOS 13+ DMG 同上;验收仅Rosetta
Windows x64 安装版 · 便携EXE · 便携ZIP 安装版支持应用内更新;EXE未签名
Linux x64 AppImage 赋予执行权限;手动更新
Docker Linux amd64 / NAS 镜像 · 部署包 按部署文档设置令牌与挂载目录

7.0发行页 · SHA256 · 精确源码。TV和手机保持独立,不包含在本轮五类产物中。上游部分网页片源仍可能404、只提供预览或超时,不保证所有内容永久可播。

6.9 历史下载与升级说明

历史正式版:6.9(内部6.9.0,桌面构建6.9.4)。修复播放签名导致的取源空响应、兼容播放自动降档循环和观看记录分组,增加有界请求间隔。五类平台统一发行,详见6.9验证与限制。

平台 下载6.9 使用方式
Apple芯片Mac,macOS 13+ DMG 拖入应用程序;已签名、公证、装订
Intel Mac,macOS 13+ DMG 同上;验收仅Rosetta
Windows x64 安装版 · 便携EXE · 便携ZIP 安装版支持应用内更新;EXE未签名
Linux x64 AppImage 赋予执行权限;手动更新
Docker Linux amd64 / NAS 镜像 · 部署包 按部署文档设置令牌与挂载目录

6.9发行页 · SHA256 · 精确源码。TV和手机保持独立,不包含在本轮五类产物中。上游部分网页片源仍可能404、只提供预览或超时,不保证所有内容永久可播。

6.8 历史下载与升级说明

历史正式版:6.8(内部6.8.0,桌面构建6.8.2)。修复缓存下载误判、画中画等比缩放和原生窗口退出异常。五类平台统一发行,详见6.8验证与限制。

平台 下载6.8 使用方式
Apple芯片Mac,macOS 13+ DMG 拖入应用程序;已签名、公证、装订
Intel Mac,macOS 13+ DMG 同上;验收仅Rosetta
Windows x64 安装版 · 便携EXE · 便携ZIP 安装版支持应用内更新;EXE未签名
Linux x64 AppImage 赋予执行权限;手动更新
Docker Linux amd64 / NAS 镜像 · 部署包 按部署文档设置令牌与挂载目录

6.8发行页 · SHA256 · 精确源码。TV和手机保持独立,不包含在本轮五类产物中。上游部分网页片源仍可能404、只提供预览或超时,不保证所有内容永久可播。

6.7 历史下载与升级说明

历史正式版:6.7(内部6.7.0)。修复6.6播放接口空响应后的取源问题,整合#133签名video_tab方案。双Mac、Windows、Linux和Docker统一发行,详见6.7验证与限制。

平台 下载6.7 使用方式
Apple芯片Mac,macOS 13+ DMG 拖入应用程序;已签名、公证、装订
Intel Mac,macOS 13+ DMG 同上;验收仅Rosetta
Windows x64 安装版 · 便携EXE · 便携ZIP 安装版支持应用内更新;EXE未签名
Linux x64 AppImage 赋予执行权限;手动更新
Docker Linux amd64 / NAS 镜像 · 部署包 按部署文档设置令牌与挂载目录

6.7发行页 · SHA256 · 精确源码。TV和手机保持独立,不包含在本轮五类产物中。上游部分网页片源仍可能404、只提供预览或超时,不保证所有内容永久可播。

6.5 历史下载与升级说明

历史正式版:6.5(内部6.5.0)。新增Docker Web/API与NAS批量下载合并,小窗自定义唤醒区域、窗口内全屏和重复弹幕聚合。双Mac、Windows、Linux、Docker同版发布,Docker替代TV。详见6.5说明。

平台 下载6.5 使用方式
Apple芯片Mac,macOS 13+ DMG 拖入应用程序;已签名、公证、装订
Intel Mac,macOS 13+ DMG 同上;本轮仅Rosetta启动验收
Windows x64 安装版 · 便携EXE · 便携ZIP 安装版支持应用内更新;EXE未签名
Linux x64 AppImage 赋予执行权限;手动更新
Docker Linux amd64 / NAS 镜像 · 部署包 docker load后按部署文档配置令牌和挂载目录

6.5发行页 · SHA256 · 精确源码

小窗唤醒区域入口:设置 → 小窗模式:隐藏后唤醒区域;也可在小窗顶部点击“设置唤醒区域”。支持拖动、缩放、百分比及全窗/右侧窄条预设。

Mac和Windows安装版保留应用内更新入口;完整6.4→6.5自动更新尚未实测,也可退出旧程序后手动安装。便携版请保留同目录data资料。Docker需备份任务和视频目录后重新导入/创建容器;不会自动配置公网访问。媒体可用范围和画质仍由来源平台决定。

6.4 历史下载与升级说明

历史正式版:6.4(内部 6.4.0)。新增跟随系统/简体中文/English选择与记忆,修复英文文案、Mac菜单和代理连通测试超时。双Mac已签名、公证和装订;Windows EXE未签名,Linux以CPU软件解码完成两集真实下载与静音播放验收。本次发布桌面四平台,TV继续开发、候选不公开。见 6.4说明。

按设备下载一个安装文件即可;其余源码、更新清单和校验文件供对应用途使用。

设备 下载 6.4 安装方式
Apple 芯片 Mac(M 系列),macOS 13+ 下载 DMG 打开 DMG,拖入「应用程序」后启动;后续支持应用内更新
Intel Mac,macOS 13+ 下载 DMG 打开 DMG,拖入「应用程序」后启动;后续支持应用内更新
Windows x64(推荐安装版) 下载安装版 EXE 按向导安装,后续支持应用内更新
Windows x64(便携版) 下载便携 EXE · 下载便携 ZIP 直接运行 EXE;ZIP 解压后运行同一程序,后续仍需手动替换
Linux x64 下载 AppImage 赋予执行权限后运行;需支持 Chromium 沙箱,解码问题可选择 CPU 软件模式;手动更新

查看已发布正式版 · 6.4发行说明 · 6.4发行页 · SHA256 校验文件

  • 升级到 6.4:安装版保留应用内更新入口;完整6.3到6.4应用内更新尚未实测;也可退出旧程序后替换 Mac 应用或运行 Windows 安装包。便携版保留同目录的 data 后手动替换;1.75 及更早版本需要手动安装。
  • 后续更新:Mac 与 Windows 安装版可在应用内下载新版,下载完成后由你点击重启安装,不强制升级。Windows 便携版继续通过发行页下载并手动替换。
  • Mac:6.4双架构 App 与 DMG 均已完成 Developer ID 签名、Apple 公证 Accepted 和票据装订。无需全局关闭 Gatekeeper;公证不等于 App Store 审核或内容授权。
  • Windows:安装版和便携版 EXE 尚未签名,可能出现系统安全提示。请核对官方下载来源;便携版首次启动会展开临时运行文件。安装版沿用原用户资料目录;3.4 起便携版把设置和下载记录放在程序目录的 data 文件夹,移动程序时请连同该文件夹一起保留。安装版与便携版不能同时运行(同一应用只允许一个实例);更换版本前请先退出正在运行的窗口。
  • 普通使用只需上表安装文件:发行页中的 Mac 更新 ZIP、latest*.yml 和 .blockmap 供更新程序使用;source 文件和 GitHub 自动生成的 Source code 是源码,不能直接运行。
6.3 历史下载与升级说明

历史正式版:6.3(内部 6.3.0)。新增可选DramaBox公开来源、减少重复ByteVC2转换,并加速Mac Apple Silicon首次转换。双Mac已签名、公证和装订;Windows EXE未签名,Linux以CPU软件解码完成真实播放验收。本次按明确授权发布桌面四平台,TV候选不公开。见 6.3说明。

按设备下载一个安装文件即可;其余源码、更新清单和校验文件供对应用途使用。

设备 下载 6.3 安装方式
Apple 芯片 Mac(M 系列),macOS 13+ 下载 DMG 打开 DMG,拖入「应用程序」后启动;后续支持应用内更新
Intel Mac,macOS 13+ 下载 DMG 打开 DMG,拖入「应用程序」后启动;后续支持应用内更新
Windows x64(推荐安装版) 下载安装版 EXE 按向导安装,后续支持应用内更新
Windows x64(便携版) 下载便携 EXE · 下载便携 ZIP 直接运行 EXE;ZIP 解压后运行同一程序,后续仍需手动替换
Linux x64 下载 AppImage 赋予执行权限后运行;需支持 Chromium 沙箱,解码问题可选择 CPU 软件模式;手动更新

查看已发布正式版 · 6.3发行说明 · 6.3发行页 · SHA256 校验文件

  • 升级到 6.3:安装版保留应用内更新入口;完整6.2到6.3应用内更新尚未实测;也可退出旧程序后替换 Mac 应用或运行 Windows 安装包。便携版保留同目录的 data 后手动替换;1.75 及更早版本需要手动安装。
  • 后续更新:Mac 与 Windows 安装版可在应用内下载新版,下载完成后由你点击重启安装,不强制升级。Windows 便携版继续通过发行页下载并手动替换。
  • Mac:6.3双架构 App 与 DMG 均已完成 Developer ID 签名、Apple 公证 Accepted 和票据装订。无需全局关闭 Gatekeeper;公证不等于 App Store 审核或内容授权。
  • Windows:安装版和便携版 EXE 尚未签名,可能出现系统安全提示。请核对官方下载来源;便携版首次启动会展开临时运行文件。安装版沿用原用户资料目录;3.4 起便携版把设置和下载记录放在程序目录的 data 文件夹,移动程序时请连同该文件夹一起保留。安装版与便携版不能同时运行(同一应用只允许一个实例);更换版本前请先退出正在运行的窗口。
  • 普通使用只需上表安装文件:发行页中的 Mac 更新 ZIP、latest*.yml 和 .blockmap 供更新程序使用;source 文件和 GitHub 自动生成的 Source code 是源码,不能直接运行。

本项目是社区维护的开源修改版,不是红果、西饭、河马或DramaBox的官方客户端,也未获平台官方背书。不提供付费分集解锁;剧集、清晰度和可用范围取决于来源平台。

3.9 历史下载与升级说明

历史正式版:3.9(内部 3.9.0)。恢复 App 取流、播放与下载,完善当天新剧补搜、后续两集预取、系统画中画及小窗模式。Mac 已签名、公证;Windows EXE 未签名。三端发行与验收回执见 3.9 说明。按设备下载一个文件即可,无需另装 Node.js、Homebrew 或 FFmpeg。

设备 下载 3.9 安装方式
Apple 芯片 Mac(M 系列),macOS 13+ 下载 DMG 打开 DMG,拖入「应用程序」后启动;后续支持应用内更新
Intel Mac,macOS 13+ 下载 DMG 打开 DMG,拖入「应用程序」后启动;后续支持应用内更新
Windows x64(推荐安装版) 下载安装版 EXE 按向导安装,后续支持应用内更新
Windows x64(便携版) 下载便携 EXE · 下载便携 ZIP 直接运行 EXE;ZIP 解压后运行同一程序,后续仍需手动替换

3.9 更新说明与源码 · SHA256 校验文件

  • 升级到 3.9:3.8 安装版可通过应用内更新升级;1.75 及更早版本仍需手动安装一次。退出旧程序后替换 Mac 应用或运行 Windows 安装包;便携版升级时保留同目录的 data,并保留原系统资料目录作为迁移备份。

开始使用

  1. 打开「设置」,选择下载目录并保存。
  2. 在「发现短剧」浏览,或在「搜索与下载」输入剧名、红果分享链接或剧集 ID。
  3. 打开详情点「立即播放」,也可选择集数与清晰度加入下载队列。
  4. 下次从「我的剧库」或「观看记录」接着看;下载进度、失败重试和整剧合并在「下载管理」。

7.5(正式发布)

7.4

7.3

7.2

7.1

7.0(已正式发布)

6.9

6.8

6.7

6.6

6.5

6.4

6.3

6.2

6.1

6.0

5.9

5.8 下载、切集与详情改进

5.7 播放兼容与观看体验

5.6 播放交互与登录恢复

5.5 播放恢复与下载整理

5.4 恢复播放与下载

5.3 下载到 NAS

5.2 macOS 窗口恢复

5.1 更新说明

修复了已知问题

三端5.1已正式发布;下载和验证范围见 5.1说明。

5.0 观看记录记忆与疑似同剧提示

4.9 老电脑兼容、老板键与小窗修复

4.8 自动1080P优先与失败换档

4.7 下载重试与画中画修复

4.6 4K与宽窗口适配

4.5 发现页换一批

4.4 自带画中画、记录筛选与取源恢复

4.3 登录管理与 APP 观看记录

4.3 在「设置」上方新增独立「登录管理」。使用手机红果 App 扫描网页登录二维码,登录后可读取当前账号最近 50 部 APP 观看记录,并按剧名搜索。只有从登录管理页点击记录才会进入播放器;原「观看记录」仍只显示本机记录。

登录态使用系统安全存储加密,和普通设置、观看历史及备份分开保存。本版不上传本机历史,也不把 APP 记录批量导入本机。外部账号扫码和真实记录映射仍需实机验收,详见 4.3说明。

4.2 合集分辨率与合并方式

4.2 修复低分辨率首集把后续高清分集压成 480P 的问题。快速和兼容合并会按每段视频的原始分辨率拼接,例如前10秒1080P、后10秒720P;低清片段不会拖低高清片段。高质量分辨率合并会在开始前检查实际已下载文件,只有全部达到1080P才启动。

合并弹窗写清三种方式。软件只在合并前检查一次,完成后不再读取或复查输出视频。三种方式都保留原文件,只合并已下载分集,也不会把低清视频变成真高清。左侧导航不能拖选文字,右侧正文仍可选中复制。验证范围与发行边界见 4.2说明。

4.1 随下载导出文字数据

4.0 远程公告与搜索故障回退

4.0 已正式发布,包含以下功能;验证范围见 4.0 说明。

3.9 播放恢复、搜索、双集预取与窗口模式

3.8 搜索当天新剧

3.7 观看记录检测

3.6 分集拉取提速

3.5 目录双线与分页恢复

3.4 搜索与资料安全

官网搜索支持补搜和加载更多;Windows 便携资料跟随程序,播放器新增全屏时间与分辨率信息。App 搜索为默认关闭的实验选项。修复内容及验收边界见 3.4 说明。

3.3 下载降级与 Mac 界面缩放

3.2 片单缓存与刷新恢复

3.1 查找下一季与审计修复

3.0 代理与本地播放管理修复

2.9 时间轴弹幕与观看体验

2.8 快进回退时延续可见控件计时

2.7 快进回退时保持控件隐藏

2.6 全屏播放体验

2.5 播放与任务恢复修复

2.4 播放、缓存与安全修复

播放取源与连播优化

2.3 红果网络与热播换源修复

2.2 播放控件与启动修复

2.1 更新检测与下载修复

2.0 代理与历史下载修复

1.80 应用内下载安装更新

1.75 安全与稳定性改进

1.74 播放画质与恢复修复

1.73 下载自动重试

临时传输故障按 10、30、60 秒自动重试;下载管理显示等待状态、轮次和时间,支持立即重试或停止。详见 1.73 更新说明。

1.72 播放与下载修复

1.71 布局更新

1.7 更新重点

下载仍可能失败。 平台风控可能限制取址;App 取址已采用每次请求更换合成设备标识符的方式尝试绕过按设备限制,但不保证所有剧集可用或下载成功。失败任务会保留,可稍后重试。

本软件用于学习研究,建议体验后 24 小时内自行删除;请勿冒充官方或以虚假授权名义收费。开源权利义务以 GPLv3 为准。上述倡议不代表获得平台或版权方授权,也不构成免责承诺。

源码基于公开 v1.6,保留原播放恢复与三来源功能。公开发行与平台验证状态以发行页为准。详见 1.7 升级说明。

1.6 更新重点

弹幕仅展示公开网页提供的部分评论,通常首屏约 15 条,读完不循环;不代表全部评论,也不支持发送或回复。完整改动和验证范围见 1.6 发行说明。

完整功能

想做什么 主要功能
找剧 红果、西饭、河马统一搜索,分类、热播榜、分享链接解析
连续观看 在线与本地播放、断点续播、自动连播、倍速、后续两集预取与系统画中画
下载与导出 清晰度选择、批量下载、失败重试、合并 MP4
管理剧库 观看记录、本机收藏、新集提醒、下载文件与缓存清理
调整观看体验 横竖布局、置顶、小窗模式、系统画中画、主题、快捷键与画质增强
阅读评论 公开剧评、本集评论弹幕与本机屏蔽词
展开功能详情与使用限制

1. 找剧:三个来源,一次搜索

  • 全部来源搜索:默认同时查询红果、西饭和河马,结果标明来源;也可切换单一来源。某个来源失败时,仍显示其他来源的结果。
  • 发现目录:海报、剧名、集数、题材筛选、分页浏览和刷新片单;详情展示完整分集及下载状态。
  • 红果分类与热播榜:真人剧、漫剧、AI 剧;综合、真人、漫剧、AI 四类榜单,显示来源提供的排名与热度。
  • 红果链接 / ID 解析:粘贴分享链接或输入剧集 ID,获取详情后播放或选集下载。
  • 详情直接播放:无需先下载整部剧;未下载的可用分集尝试在线播放。
  • 选集更灵活:单选、多选、全选、反选、取消全选;快捷选前 10 集、前 30 集、后 30 集;支持 1-30、1,3,5、1,5,10-20 等范围。
来源 已实现 当前边界
红果 目录、题材、四类热播榜、搜索、分享链接 / ID 解析、可用分集播放下载 网页未提供片源时尝试补充取址,结果仍以来源实际返回为准。
西饭 独立目录、题材、分页、搜索、已开放分集播放下载 热播榜尚未接入;锁定分集保留标记并跳过。
河马 官网目录、题材、前后翻页、搜索、完整分集列表、明确免费分集播放下载 收费或状态不明的分集锁定,不提供解锁。

三个来源的文件按来源与剧名分目录保存。“漫画”是图文阅读内容;要播放视频请选“漫剧”。片源、清晰度及可用分集取决于平台,软件不承诺固定 1080p 或全集可用。

2. 播放:在线、本地与连续观看

  • 本地优先:已下载分集直接播放本地文件,未下载且未锁定分集尝试在线播放;双击未下载分集可加入下载队列。
  • 基本控制:点击画面或按钮播放 / 暂停,拖动进度条,查看时间,调整音量与静音。
  • 缓存后续 2 集:在「我的剧库」连播按钮左侧开关,默认开启并记住选择;当前集开始播放就最多预缓存后续两集可在线播放的内容,跳过已下载和锁定分集。切到下一集时会保留更后一集的预取结果;预取失败会释放名额并在 15 秒后重试。会提前使用网络流量,关闭开关可取消全部后台预缓存。
  • 自动连播:默认开启,可随时关闭;自动切换下一集,跳过锁定分集,本地与在线分集可衔接播放。
  • 断点续播:按剧保存集数和播放位置,从剧库或观看记录接着看;切换到应用内其他页面,仍可继续播放并保存进度。
  • 0.25×–4× 倍速:共 16 档。右下角倍速数字是独立按钮,每点增加 0.25×,4× 后回到 1×;三点菜单可直接选档,切集与连播保持当前倍速。S / D 每次调节的幅度可在「设置 → 播放快捷键」中选择 0.25×、0.5×、0.75× 或 1×。
  • 兼容播放:默认开启兼容模式;解码失败、黑屏有声时尝试转为 H.264,也可手动「转码后播放」。显示转码进度,支持取消和清理缓存。
  • 高性能转换(7.1):桌面「解码方式 → 高性能显卡快速解码(老电脑请勿使用)」默认关闭。开启后优先用显卡编码H.264;ByteVC2仍由CPU解码,4线程、单队列。Mac尝试VideoToolbox,Windows依次尝试NVIDIA NVENC与AMD AMF(VCE/VCN),Linux尝试NVIDIA NVENC;实际输入试编码出帧,不支持或失败时明确提示并回退CPU。不是所有格式的GPU硬解,也不保证所有独显支持;实体NVIDIA和AMD尚未在本项目发行验收中实跑。本轮M5样本未提速且文件更大,见性能与验收记录。
  • 失败恢复:可取消准备、重试本集、重新连接片源或尝试兼容转码。地址过期或传输中断时有限次刷新取址,不无限重试;硬件转码失败时尝试软件转码。

优先选择兼容性较好的 H.264 片源,同编码内再优先清晰度;可能低于 HEVC 片源的最高分辨率。软件转码可能更慢,来源服务异常仍可能导致播放失败。

在线播放不保存到下载目录,但部分片源会先准备临时媒体文件并在使用后清理;兼容转码另有磁盘缓存。因此“在线”不代表完全不占磁盘。

3. 画面与窗口:横屏、竖屏和专注观看

  • 横屏版 / 竖屏版:从顶部切换布局;切回横屏时恢复此前窗口尺寸与位置。
  • 窗口置顶:一键置顶 / 取消置顶,方便边工作边看。
  • 系统画中画:播放控制条一键弹出原生悬浮小窗;小窗继续使用当前播放元素,可拖动、置顶、暂停与关闭,自动连播和切换清晰度时保持小窗,切换虚拟桌面后继续播放。小窗位置与跨桌面行为由系统管理。
  • 小窗模式:顶部「小窗模式」把主窗口缩为 400×600 的置顶窗口并保持播放;在 Electron 支持工作区 API 的平台上设为所有虚拟桌面可见。鼠标移开时暂停并隐藏,移回继续,Esc、Dock 或窗口菜单可恢复。
  • 右侧一体选集:竖屏模式下,选集栏随窗口展开或收起,减少对视频的遮挡。
  • 隐藏管理按钮:收起不常用操作,让播放区更简洁。
  • 去掉播放器边框:竖屏下去掉播放区周围留白与圆角;这是播放器布局效果,不是移除系统窗口边框。
  • 全屏:横屏使用视频全屏;竖屏填满当前窗口,Esc 退出。全屏或竖屏播放时,控制条闲置约 2 秒自动隐藏,移动鼠标或操作非切集快捷键后重新显示;暂停、拖动进度条、打开菜单或键盘焦点停在控件上时保持可见。自动连播及上一集、下一集快捷键切集时,已隐藏的控制条保持隐藏,不再短暂弹出。
  • 画面模式:在播放器三点菜单切换,每部剧独立记忆,切换保留播放进度。
画面模式 效果 适合场景
适应窗口(默认) 按可用宽高等比缩放,完整显示画面 希望人物、字幕和画面边缘都能看全。
保持宽度 按可用宽度等比缩放;只缩短窗口高度时,画面不跟着变小,上下超出部分居中裁剪 希望调整窗口高度时保持画面大小;注意边缘字幕或人物可能被裁掉。

4. 观看记录与追剧提醒

  • 独立「观看记录」页,真正开始播放后才计入,按最近观看排序。
  • 显示封面、剧名、集数、播放时间点及最近观看时间,点击继续观看。
  • 支持手动「检查更新」;应用运行期间每部剧约 6 小时检查一次新集,列表较多时分批处理,以红点和新增集数提醒。
  • 约每天检查同来源、同名且季数更高的疑似续作,并直接打开;该功能可单独关闭,名称匹配可能误报或漏报。
  • 系统通知默认关闭,可在设置中开启;仍需系统允许通知。

追剧检查仅在应用运行时执行,不承诺退出后提醒或实时推送。观看记录保存在本机,不提供跨设备同步。

5. 下载队列:批量保存与失败恢复

  • 下载清晰度:自动(兼容优先)、1080P、720P,可保存默认值。按视频实际尺寸选源,保存前再次检查。红果片源所选画质不可用或下载失败时尝试更低清晰度,并显示提示。不会放大冒充高清;只有更高分辨率时保留原分辨率,不降采样。
  • 任务独立保存选择:修改默认清晰度不改变已有任务的普通重试;已有低清文件保留,不自动覆盖。清晰度选项仅影响下载,不改变在线播放策略。
  • 单集或批量加入队列,显示等待中、下载中、已完成、失败、已停止状态,以及下载进度、已接收 / 总字节数和失败原因。
  • 支持全部开始、全部暂停、单任务停止、重试失败、选中失败项及重试选中;停止的任务可重新排队。
  • 1–10 个并发下载,默认 3,在设置保存后生效;较高并发可能触发来源限流。
  • 下载列表按剧组织并分页;跨页全选、取消全选、选择保留与批量删除。
  • 删除前确认:默认仅删除任务记录,可勾选同时删除本地文件;可清空已完成记录。
  • 一键打开任务文件夹;扫描下载目录,补登记符合应用目录与命名规则的已有文件。

片源的“1080P”标签可能与实际尺寸不符,也不代表上游母版质量;不保证每部剧或每一集都有 1080P。“重新排队 / 重试”不等于从已下载字节续传,锁定集不能加入下载队列。

6. 合并导出:多集合成一个 MP4

在「下载管理」选择剧名后点「合并整部剧」,无需勾选任务;「我的剧库」也提供合并入口。候选列表只显示仍有本地可合并分集的剧,在线播放记录不会混入;仅删除任务记录但保留文件时,仍可合并。

模式 处理方式
智能快速合并 编码参数一致时直接拼接;不一致时按需要处理音视频,混合编码可能需要转码。
兼容合并(H.264) 导出 H.264/AAC;已兼容分集尽量直接拼接,仅处理不匹配部分。

显示阶段、进度、耗时及可用的处理速度 / 预计剩余时间,支持取消、打开输出所在文件夹和移除合并记录。两种方式都保留原始分集;仅合并已下载分集,不会自动补齐缺集。转码并非无损,用时取决于内容和设备。

7. 我的剧库与空间清理

  • 搜索、切换已登记短剧,查看集数、下载数量和文件占用,下载尚未完成的可用分集。
  • 从剧库列表移除但保留文件;恢复已移除的剧;批量清理没有本地下载的剧。
  • 删除单部剧或全部已下载文件,保留剧集信息,之后仍可尝试在线播放或重新下载。
  • 分别清理在线播放缓存与兼容转码缓存。
  • 可选「看完自动删」:一集播放结束后删除该集本地文件,默认关闭。需要长期保留视频时不要开启。

8. 设置、网络与软件更新

  • 下载位置:选择文件夹或手动填写目录。
  • 命名规则:支持「剧名」「集数」「标题」变量,以及“剧名_第N集”“剧名_第N集_标题”预设;保留独立集号以避免覆盖。
  • 代理配置:开关、跟随系统 / 环境变量、手动 HTTP/HTTPS 代理、强制直连;支持地址端口、常见端口预设及可选认证信息。
  • 代理测试:可在保存前测试草稿配置,保存后生效。当前“跟随系统”主进程读取 HTTP_PROXY / HTTPS_PROXY 等环境变量,不保证识别所有系统代理或 PAC;一次测试成功不代表全部片源可访问。
  • 提醒开关:分别控制新集检查、疑似续作、系统通知和自动检测软件更新。
  • 软件更新提示:默认开启;启动及运行期间每 6 小时检查 GitHub 正式新版。右上角提醒可关闭,也可取消自动检测并保存;网络失败不阻止使用旧版。
  • Mac 与 Windows 安装版可从更新提醒下载新版,查看进度,下载完成后点击重启安装;也可从设置中检查更新。不经点击,不自动下载或在退出时安装。
  • Windows 便携版使用官方下载页入口,退出后手动替换;更新失败不会要求清空原资料。所有版本均保留发行页入口,不强制升级。

9. 外观、收藏与评论

  • 外观与窗口:浅色、深色或跟随系统;小窗模式在鼠标移开时暂停并隐藏,移回继续,可通过 Esc、Dock 或窗口菜单恢复主窗口;系统画中画用于跨应用和虚拟桌面继续观看。
  • 找剧辅助:本机搜索历史联想、公开热播榜、已完结或更新中筛选;未知状态不冒充已完结,热播榜不是账号个性化推荐。
  • 公开剧评与本集弹幕:查看来源提供的评分、整剧剧评和单集评论节选。弹幕可调不透明度、字号、速度、区域和密度,也可隐藏入口;默认开启常见敏感词过滤,可添加本机屏蔽词,无法识别所有变体。
  • 本机收藏与上新:收藏仅保存在本机;「收藏与上新」按已浏览剧集的首次公开日期整理,不是完整的未来上新排期。
  • 画质增强:原画、可调锐化、Anime4K CNNx2M 2× 增强。Anime4K 面向动漫,支持不高于 1080p 的输入;真人画面可能偏平滑,不兼容或处理持续过慢时恢复原画,不改变下载文件。
  • 分享链接:用户主动点击后读取分享链接;公开剧集可复制官方分享页链接。

公开评论仅供阅读,弹幕通常只有公开网页首屏约 15 条,读完不会循环。当前不提供手机号登录、手机账号收藏/点赞/历史同步、弹幕发送或回复。

播放快捷键

按键 操作
空格 播放 / 暂停
← / → 后退 / 前进 5 秒
↑ / ↓ 上一集 / 下一集
A 开启 / 关闭连播
S / D 按设置步长降低 / 提高倍速(默认 0.25×)
F 切换全屏
Esc 退出竖屏填满窗口状态,或关闭当前菜单 / 弹窗

以上为默认键位,可在「设置」中点击修改,支持单键或 Shift 组合,并检查冲突、恢复默认;S / D 的调速步长也在同一区域设置。输入框、菜单和弹窗操作不会误触播放器快捷键。

界面与演示

红果短剧 1.6:热播推荐与公开榜单

macOS 1.6 正式版实拍:热播推荐页面。截图中的片单与热度为截取时的公开榜单内容,会随来源更新。

观看 3 分钟功能介绍(基于 1.3,未包含后续更新)

https://github.com/user-attachments/assets/b95f4f60-b57c-495f-a30e-62ac2b0bda11

3 分钟,从三来源搜索、链接解析讲到播放续看、下载合并、横竖屏与画面模式,再展示 1.3 的主题、快捷键、隐身小窗、热播推荐、公开剧评、本机收藏与日历、画质增强和更新提醒。

视频使用 1.3 正式前端和隔离的演示资料;播放器画面为短剧封面演示,集数、榜单、评分、评论与日期不代表真实平台数据。

下载三分钟介绍视频(1080p,约6 MB)

常见问题

为什么有些分集锁定、加载失败或清晰度不同?

片源和可用范围由来源服务决定;西饭锁定集、河马收费或状态不明集会保留锁定。应用不提供解锁或广告奖励接口,不承诺付费内容可用。来源接口可能变化,过去能用不保证一直可用。

下载失败、目录加载不出来怎么办?

先检查网络与来源平台,再检查代理开关和模式,适当降低并发,使用「重试失败」或重新加载目录。黑屏有声可尝试兼容模式。

视频、设置和记录存在哪里?

视频保存在设置中的下载目录,按来源与剧名组织。设置、任务及观看记录默认位于:

自行指定用户资料目录时以指定位置为准。移除剧库条目、删除任务记录、删除视频和清理缓存是不同操作,请核对确认框。

怎样在应用内更新?

先手动安装一次最新版。之后,Mac 与 Windows 安装版发现新版时可点击下载,完成后再点击重启安装;Windows 便携版仍通过发行页手动下载。软件不会强制更新,也不会因为普通退出而自动安装已下载的版本。关闭提醒或自动检测后,旧版仍可继续使用;来源服务变化仍可能影响功能。

Windows 下载新版后,为什么仍显示旧版本?

先退出所有正在运行的红果短剧,再运行最新版文件名以 -setup.exe 结尾的安装包,完成后从安装程序生成的快捷方式启动。不要继续使用指向旧便携版的桌面或任务栏入口。设置页显示的版本号才是当前运行版本。

继续使用便携版时:单文件便携 EXE 请放回原文件夹,保留同目录的 data 文件夹后再运行;ZIP 版解压到新文件夹后,先把旧文件夹的 data 复制过去,或直接覆盖原文件夹中的程序文件。只运行新文件夹里的 EXE 而丢掉 data,会显示空记录或回退到系统目录里的旧记录。确认版本正确后,再更新自己的快捷方式。无需清空整个系统 Temp、应用资料目录或下载的视频。若仍显示旧版,请反馈实际启动文件名和设置页版本号,隐去个人路径。

自行构建也有签名和公证吗?

源码默认 Mac 构建使用 ad-hoc 签名,不会自动使用开发者证书或提交公证。正式 Mac 包的 Developer ID 签名与公证是独立发行步骤;Windows 包当前未签名。无需为本应用全局关闭 Gatekeeper。

如何反馈问题?

到 Issues 提供应用版本、操作系统与芯片类型、来源、复现步骤和错误提示。截图与日志请移除账号信息、Cookie、代理凭据及个人文件路径。

版本与验证范围

7.5为当前源码/发行目标,内部7.5.0、候选构建7.5.2。本轮明确只发行Mac双架构与Windows,TV和手机独立。实际签名、平台验收、附件摘要和限制以7.5记录为准。

7.2 TV开发补充包已于2026-11-13 16:08:18(Asia/Shanghai)追加公开,版本7.2/code70200,沿用公开6.6 TV签名证书;TV源码冻结2aa068f496f78114389d94c41b83dde877b174ce。新增APK、精确TV源码和独立SHA256清单三份附件,现共28份正式附件;原25份桌面/Docker附件与原v7.2标签不变。构建、签名连续性、Manifest/包内容、定向源码检查及三附件匿名完整下载摘要核对通过。TV实机未测试,请用户自行测试;安装、启动、实际遥控、播放和覆盖升级均未验证。 手机保持独立,本机正式应用未替换。详见TV补充回执。以下首发五平台记录保持。

7.2已于2026-11-13 15:32:56(Asia/Shanghai)正式公开并设Latest,内部7.2.0、桌面构建7.2.1,冻结源码26a926f03f5038257e14b932b4762aab2f537ee9。双Mac、Windows x64、Linux x64 AppImage、Docker amd64五类共25份正式附件,远端大小/SHA256、三份清单与10个匿名下载入口已核对;113个实际上传分段已清理。双Mac本轮新签名、公证、装订;Windows EXE未签名,Intel仅Rosetta。#150与#153修复保留文件安全校验;#151中文字幕未实现。定向检查与必要平台验收通过,通用全量源码CI未全绿,具体失败及平台实测边界见发行回执。未替换本机正式安装;TV与手机独立。完整范围见7.2回执。以下保留历史记录,不作为本版验收。

7.1已于2026-11-12 14:10:02(Asia/Shanghai)正式公开并设Latest,内部7.1.0、桌面构建7.1.2,冻结源码bdab9d6158e07524f234f88c1168f20baa2cd507。双Mac、Windows x64、Linux x64 AppImage、Docker amd64五类共25份正式附件,远端大小/SHA256、三份清单及匿名下载入口已核对;119个临时分段已清理。双Mac新签名、公证、装订;Windows EXE未签名,Intel仅Rosetta,NVIDIA实体未验。高性能模式功能通过,M5本轮样本未提速且文件更大。未替换本机正式安装;TV与手机独立。完整范围见7.1回执。以下保留历史记录,不作为本版验收。

4.1(内部 4.1.0,标签 v4.1)已正式发布,包含内置来源全局开关与文字导出。文字导出候选阶段的整剧验证结果为 80 个视频 completed、合计 241881712 字节;弹幕 80 份、386 条,其中 3 份为空;评论 25 份、307 条;剧评 1 份、4 条。另 55 集评论本次来源未开放,未生成空文件或误取其他集,网络与写盘实际失败为 0。该整剧原始资料随旧工作区回收而丢失,数值来自此前已观察的聊天回执,不作为本轮重新下载或播放的证据。加入来源开关后重新构建三端,204 项单元、91 项平台检查、Windows 安装及升级检查通过;Mac 完成签名、公证及装订,16 项附件摘要与大小一致。详见 4.1 说明。

4.0(内部 4.0.0)已于 2026-10-27 18:07(Asia/Shanghai)正式发布,标签 v4.0。冻结源码 c8d9acb61ea8c4b2ca8df543b94ac0d56fdd3451;三端 16 项附件的远端 SHA256 与大小逐项匹配。双 Mac App 与 DMG 已完成 Developer ID 签名、Apple 公证 Accepted 和装订,只读挂载验证通过。Windows CI 40484301307 的便携媒体、安装、重装及真实 1.80 升级资料保留检查通过;EXE 未签名。 已有回归记录:179 项单元测试、91 项平台检查通过。x64 包在 Rosetta 下启动并显示 4.0;本机已安装签名、公证并装订的 arm64 4.0,安装期间资料不变,包内源码匹配,已确认最新邮箱复制成功及永久关闭公告正文显示。 本轮未重做真实两集下载或完整在线播放,不沿用 3.9 的真实播放与人工听音证据。Windows 媒体检查使用 CI 测试素材;未覆盖实体 Intel Mac、实体 Windows、干净 Gatekeeper、长期播放及完整应用内跨版本更新。 详细回执见 4.0 说明。以下 3.9 及更早版本历史保持原样。

3.9(内部 3.9.0)已于 2026-10-27 14:15(Asia/Shanghai)正式发布,标签 v3.9。冻结源码 4a88f2ea597101a5c2e92f2ab564afee9c5167e0;三端 16 项附件的远端 SHA256 与大小逐项匹配。双 Mac App 与 DMG 已完成 Developer ID 签名、Apple 公证 Accepted 和装订。Windows CI 40458538824 的便携播放、安装、重装与真实 1.80 升级资料保留通过;EXE 未签名。 真实两集下载、播放和切集通过,声音由用户确认正常;本机已安装正式签名包。验证细节和未验范围见 3.9 说明。

上一正式版 3.8(内部 3.8.0),搜索当天新剧的补搜改动及验收边界见 3.8 说明。冻结源码 528c716a085dc4e3323ebd0aec7fb96815bc6523;16 项附件的远端摘要和大小已核对,双 Mac 已签名、公证与装订,Windows EXE 未签名。Windows CI 通过:便携播放、安装启动、同版本重装和真实 1.80 → 3.8 升级资料保留。

更早正式版 3.7(内部 3.7.0),观看记录检测改进及验收边界见 3.7 说明。冻结源码 85920561b68e0d5cc6ef10f5e6c2c33e96659f09;16 项附件的远端摘要和大小已核对,双 Mac 已签名、公证与装订,Windows EXE 未签名。Windows CI 通过:便携播放、安装启动、同版本重装和真实 1.80 → 3.7 升级资料保留。

上一正式版 3.6(内部 3.6.0),分集提速、目录双线与分页修复及发行边界见 3.6 说明。冻结源码 887862f449b87c56a01b565c849057756266d5a5;其 16 项附件、签名、公证和 Windows CI 结果保持不变。

上一正式版 3.5(内部 3.5.0),目录双线、分页恢复与发行边界见 3.5 说明。冻结源码 34bdc9eabdd81ce42c6ed6a23516b245fe44d93e;其 16 项附件、签名、公证和 Windows CI 结果保持不变。

更早正式版 3.4(内部 3.4.0),搜索、便携资料与安全修复及验收边界见 3.4 说明。App 搜索仍是默认关闭的实验选项。

更早正式版 3.3(内部 3.3.0)的下载降级与 Mac 界面缩放记录见 3.3 说明。以下保留其历史验收结果,不代替 3.6 验收。

3.3 安装包、对应源码与校验文件见 3.3 发行页。三端 16 项资产已公开并核对远端 SHA256;双 Mac 应用与 DMG 已完成 Developer ID 签名、Apple 公证 Accepted 和装订;Windows CI 安装、重装、跨版本升级与便携媒体检查通过,EXE 未签名。 Windows 构建记录:本轮 CI。

冻结源码 1f152862ac9bc23f0a2ad2340a32ad7a62a4aaec;后续文档提交不改变 v3.3 标签及已发布安装包、更新包和对应源码包的字节。 源码候选随机真实两集下载与播放、快进/回退、全屏、切集及受控 720P 降级通过,用户确认声音正常。最终已签名 arm64 包隔离启动、90% 缩放、恢复 100% 与正常退出通过;未在最终包重复真实播放。

更早正式版 3.2 的片单缓存、刷新恢复与验证记录保留于 3.2 说明 和 3.2 发行页。其冻结源码 fe110c68f9e2a1eceb059be222901d2d37926a5d 及已发布资产保持不变;3.2 未覆盖本机正式安装,更早变更见 3.1 说明。此前 2.1 已有 Mac 隔离启动、更新下载与合成版本原生重启,以及 Windows CI 的新装、重装和真实 1.80 覆盖升级记录;这些历史结果不代替后续版本验收,也不代表实体电脑完整覆盖。

本版不宣称修复批量下载黑屏或闪退反馈;相关问题仍需要对应设备与复现场景核实。

4.0 验证边界:本轮未重做真实两集下载或完整在线播放,不沿用 3.9 的真实播放与人工听音证据。Windows 媒体检查使用 CI 测试素材;未覆盖实体 Intel Mac、实体 Windows、干净 Gatekeeper、长期播放及完整应用内跨版本更新。

历史版本与旧版升级提示
版本 主要变化 详细记录
1.6 下载清晰度、本集弹幕、播放与下载恢复 发行说明
1.5 片源兼容、播放失败恢复、全屏切集控制条优化 发行说明
1.4 修复合并候选混入在线播放记录、文件删除后候选残留 发行说明
1.3 主题、快捷键、隐身小窗、公开剧评、本机收藏与画质增强 发行说明
1.2 按剧记忆画面模式、正式新版提醒 版本记录

仓库曾从 hongguo-drama-mac 更名为 hongguo-drama。如果仍使用更名前的 1.2 安装包,请从本页手动下载当前正式版替换一次;应用标识与用户资料位置保持不变。1.2 修订版的精确源码见该版发行附件,原 v1.2 标签保留首发历史。

从源码构建 Mac 版

展开构建步骤、产物位置与 FFmpeg 对应源码说明

应用使用 Electron + React + Node.js。构建需要 Node.js 22.12 或更新版本、npm、Apple Command Line Tools、pkg-config,以及可用的 make、git、curl。构建脚本不会自动安装这些系统依赖。

git clone https://github.com/jackotom/hongguo-drama.git
cd hongguo-drama
npm ci
npm run build:mac

上述默认命令在 Apple Silicon 上构建两种 Mac 架构。Intel 构建机请先运行 node scripts/setup-ffmpeg-mac.js x64 和 npm run build:react,再运行 npx electron-builder --mac dmg zip --x64 --publish never。

构建会验证已有 FFmpeg / FFprobe 缓存;缺少匹配缓存时,从固定且经过 SHA256 校验的 FFmpeg/x264 源码编译,然后生成前端、指定架构应用、DMG 和 ZIP。首次构建需联网获取依赖和源码,编译可能耗时数分钟。默认 ZIP 只是构建产物,不能直接作为官方签名更新包发布;正式发行需在签名、公证和装订后重新生成 ZIP 与更新清单。

用途 命令或产物
开发模式 npm run dev
仅生成 Mac 应用 npm run build:mac:dir
应用产物 dist/mac-arm64/红果短剧.app、dist/mac/红果短剧.app
DMG / ZIP dist/hongguo-downloader-<版本>-mac-<架构>.dmg 与 .zip;公开版本使用两段,内部格式见 package.json。正式 DMG 另以发行页中的名称提供

FFmpeg 的准确对应源码

Mac 包内置的 FFmpeg / FFprobe 基于 FFmpeg 9.0.2 与 x264 b35605ace3ddf7c1a5d67a2eb553f034aef41d55 的未修改源码编译。此构建为 GPLv3-or-later,仅静态链接 x264,保留 VideoToolbox,未启用 nonfree;动态依赖仅为 macOS 系统库,不依赖使用者的 Homebrew 环境。

各版本的 Release 附有应用源码 ZIP以及独立的 FFmpeg/x264 完整对应源码包,后者包含准确源码归档、构建脚本、清单与许可文本。请按需要的应用版本与平台选择对应附件。只下载 GitHub 自动生成的项目源码归档,不能代替这一媒体工具对应源码包。

FFmpeg 二进制不提交到 Git。重新分发编译包时,请按 GPL 要求同时提供完整对应源码及构建材料。

从源码构建 Windows 版

在 Windows x64 上构建安装版或便携 EXE,需准备匹配的 FFmpeg / FFprobe;完整依赖、媒体工具源码与构建命令见 三平台发行与 Windows 构建说明。云端工作流同时生成 NSIS 安装版、更新清单与便携版。自行构建不会自动获得代码签名。

贡献者

感谢所有代码贡献者与问题反馈者。完整贡献记录与问题编号已核对至 2026-11-15,包含历史开放/已关闭的全部 12 个 PR 和 137 个 Issue。

7.5 播放恢复特别鸣谢

贡献者 实际贡献
N3urda(NANA) 维护上游 hongguoTV,提交并组织 PR #60 的播放恢复发行。
ermilylu 纯 Kotlin Android v5 签名核心、合成向量及上游播放验证的公开 Git 作者;本项目 7.5 据此移植纯 JavaScript 实现。账号尚未关联,保留原始署名。
WEP-56 在 Issue #162 提供上游 PR 线索,帮助定位播放恢复方案。

以上按实际贡献致谢。GitHub 右侧 Contributors 由提交历史与账号关联自动生成,此名单不改变提交作者或统计。

代码提交作者: @jackotom、@ZainCheung。

PR 提交者(10 位): @aaaasssddfgh、@anupam-orbis、@ceco3000、@jackotom、@jayeeliu、@j2-cuong、@jjay5520、@roytjus、@xinbaojian、@ZainCheung。未合并的方案也保留提交致谢,不代表已经采用。

展开全部 82 位问题反馈者

@96827123 · @adfnaa · @AguoofAlishan · @airwenlee · @allenyip-blip · @bigbaibai-luis · @breadxuqiqi · @buer052594 · @caolixiang · @ccicc-ccicc · @ceco3000 · @ceylog · @changyidong · @chenchihcu · @CloudPeakBAI · @coffeefreehans · @darkj2k · @dcxa521gi · @diaobugou · @dickyluo · @eq1024 · @Freeze7749 · @fzyifeng · @GGreyCat · @gugugaga-doro · @GuoJiKaiHehe · @hongminzheng · @huihui278 · @Ifover · @kanonso · @ken6678831-man · @kingport · @leo1300177 · @licongy · @lqg5522 · @LTRltr · @lzy139822 · @macvip · @MaxeWang123 · @midpoint · @Mono-dev07 · @Mrjoker818 · @mydance-wj · @n2ryx · @Noisercontrollers · @perlist · @ppsbbs · @r5kc · @RuningLittleSnail · @Ryan-zyg · @ryancq1982 · @s7c6vr9hsh-pixel · @shara2006 · @superterry-svg · @SysuJayce · @sza253 · @Tangkage · @tt555-1 · @TTroia · @VictorLee2077 · @Wan-ZL · @wangfujie · @wgsjjj · @winddriver · @wms888 · @wuhai007007 · @wwxiaoo · @xiaobai-chun · @xiaobutx · @xinbaojian · @Xinran123757 · @xutengyang · @yetonggo · @yeuemfantasy · @yidasanqian · @yujian0222 · @yyyyyy1111wq · @ZainCheung · @zhangyibin8111 · @Zhengs2009 · @zouyelin · @ZZQ2417536071

页面列示的历史协作账号: @cursoragent。来源与统计边界见完整名单。

GitHub 右侧 Contributors 按真实提交历史自动生成;本节单独向 PR 提交者和问题反馈者致谢。

7.1

4.1

上游、许可证与使用边界

本项目延续上游的 GPL-3.0 许可,并保留修改与来源声明。Mac 分支自 2026-10-07 开始适配,详细变更见 NOTICE,组件许可见 第三方声明。

感谢以下项目提供的基础工作与参考:

开源许可适用于软件,不授予剧集内容的再分发权。安装包不包含剧集媒体;作品版权归原平台及创作者所有。请仅处理你有权访问、下载或备份的内容,遵守平台条款与相关法律,勿用于未经授权的传播或商业盗版。平台接口可能调整,某次验证通过不保证后续片源持续可用。

hongguo-drama (jackotom/hongguo-drama)

正在搜索数据库…

这是什么?一款桌面应用,适用于 macOS、Windows 和 Linux,用于观看红果短剧平台的内容。你可以在一个地方搜索、播放、下载和追踪剧集,还能合并并导出分集。这是一个基于 GPL-3.0 许可证的社区项目。
怎么让它运行起来?从发布页面下载适合你系统的文件:Mac 用 DMG(支持 Apple Silicon 或 Intel,需 macOS 13+),Windows 用安装版或便携版 EXE,Linux 用 AppImage。在 Linux 上,先给 AppImage 添加执行权限。然后打开设置,选择下载文件夹并保存。
还需要先安装别的东西吗?不需要。README 中说明每台设备只需一个文件即可,无需单独安装 Node.js、Homebrew 或 FFmpeg。
每一集都能一直播放吗?不能保证。部分上游网页来源可能返回 404 错误、只显示预览或超时,因此内容无法保证一直可以播放。能否播放取决于来源平台。
它能在哪些系统上运行?搭载 Apple 芯片或 Intel 处理器的 Mac(macOS 13+)、Windows x64 和 Linux x64 AppImage。Windows 的 EXE 文件未签名,运行时可能会弹出安全提示;Mac 版本已签名并完成公证。
没有网络也能观看吗?已下载的剧集可以离线观看:它们会保存在本地,并可用你默认的视频播放器打开。在线播放仍需要网络连接和可用的上游来源。
能一次性下载整部剧吗?播放器中有“从本集下载到最后一集”的选项。已完成、已在排队或已锁定的剧集会被跳过。
这是红果短剧的官方应用吗?不是。这是一个开源的、由社区维护的修改版本,并非红果、西番、Hippo 或 DramaBox 的官方客户端。它不提供付费解锁剧集的功能。
有安卓或安卓电视版本吗?有,但它是一个独立的项目。安卓 APK 和电视版构建由 N3urda/hongguoTV 维护,不包含在本应用的发布版本中。
可以在 NAS 上运行吗?早期版本(如 6.5 和 7.1)提供了用于 NAS 的 Docker Web/API 镜像,并支持批量下载。当前 7.6 的下载表中只列出了桌面版本。
作者
jackotom
大小
9.3 MB
星标
2.3K
时长
1个月
提交 · 90 天