项目的 README,来自 github.com/jackotom/hongguo-drama。合并为一个 markdown 文件:README.md。
发现好剧,接着上次看。搜索、播放、下载、追剧与合并导出,在一个桌面应用里完成。
下载与安装 · 完整功能 · 界面与演示 · 常见问题 · 贡献与致谢 · 反馈问题
当前正式版: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.3(内部7.3.0,桌面构建7.3.1)。新增可配置的 S / D 倍速调节,并加强下载文件身份、媒体地址、NAS 目录和 Docker 队列保护。完整回执见7.3记录。
历史正式版:7.2(内部7.2.0,桌面构建7.2.1)。修复外置exFAT下载身份误判、仅移除记录受阻,以及本地组件故障造成的无效重复下载;保留文件安全校验。原五平台正式包与TV开发补充包已公开;#151中文字幕未实现。验证与限制见7.2回执。
历史正式版: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.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.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.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.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.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后按部署文档配置令牌和挂载目录 |
小窗唤醒区域入口:设置 → 小窗模式:隐藏后唤醒区域;也可在小窗顶部点击“设置唤醒区域”。支持拖动、缩放、百分比及全窗/右侧窄条预设。
Mac和Windows安装版保留应用内更新入口;完整6.4→6.5自动更新尚未实测,也可退出旧程序后手动安装。便携版请保留同目录data资料。Docker需备份任务和视频目录后重新导入/创建容器;不会自动配置公网访问。媒体可用范围和画质仍由来源平台决定。
历史正式版: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 校验文件
data 后手动替换;1.75 及更早版本需要手动安装。data 文件夹,移动程序时请连同该文件夹一起保留。安装版与便携版不能同时运行(同一应用只允许一个实例);更换版本前请先退出正在运行的窗口。latest*.yml 和 .blockmap 供更新程序使用;source 文件和 GitHub 自动生成的 Source code 是源码,不能直接运行。历史正式版: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 校验文件
data 后手动替换;1.75 及更早版本需要手动安装。data 文件夹,移动程序时请连同该文件夹一起保留。安装版与便携版不能同时运行(同一应用只允许一个实例);更换版本前请先退出正在运行的窗口。latest*.yml 和 .blockmap 供更新程序使用;source 文件和 GitHub 自动生成的 Source code 是源码,不能直接运行。本项目是社区维护的开源修改版,不是红果、西饭、河马或DramaBox的官方客户端,也未获平台官方背书。不提供付费分集解锁;剧集、清晰度和可用范围取决于来源平台。
历史正式版: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 解压后运行同一程序,后续仍需手动替换 |
data,并保留原系统资料目录作为迁移备份。video_tab;精确匹配分集,保留取消、超时、画质和加密安全校验。修复了已知问题
三端5.1已正式发布;下载和验证范围见 5.1说明。
4.3 在「设置」上方新增独立「登录管理」。使用手机红果 App 扫描网页登录二维码,登录后可读取当前账号最近 50 部 APP 观看记录,并按剧名搜索。只有从登录管理页点击记录才会进入播放器;原「观看记录」仍只显示本机记录。
登录态使用系统安全存储加密,和普通设置、观看历史及备份分开保存。本版不上传本机历史,也不把 APP 记录批量导入本机。外部账号扫码和真实记录映射仍需实机验收,详见 4.3说明。
4.2 修复低分辨率首集把后续高清分集压成 480P 的问题。快速和兼容合并会按每段视频的原始分辨率拼接,例如前10秒1080P、后10秒720P;低清片段不会拖低高清片段。高质量分辨率合并会在开始前检查实际已下载文件,只有全部达到1080P才启动。
合并弹窗写清三种方式。软件只在合并前检查一次,完成后不再读取或复查输出视频。三种方式都保留原文件,只合并已下载分集,也不会把低清视频变成真高清。左侧导航不能拖选文字,右侧正文仍可选中复制。验证范围与发行边界见 4.2说明。
jayeeliu 的 PR #61,详见下方贡献者记录。4.0 已正式发布,包含以下功能;验证范围见 4.0 说明。
day)与“版本更新前不再提醒”(version);抑制期间不读取普通远程文件,版本变化解除抑制,独立关闭开关仍保留。vipai.pro。本机测试包已确认邮箱复制成功提示。video 元素,不额外下载或开启第二路在线会话;退出小窗后返回应用内播放。官网搜索支持补搜和加载更多;Windows 便携资料跟随程序,播放器新增全屏时间与分辨率信息。App 搜索为默认关闭的实验选项。修复内容及验收边界见 3.4 说明。
c884fab6c6e36ad38173e251738b9b35f958383f,沿用 GPL-3.0 许可,保留原作者说明。临时传输故障按 10、30、60 秒自动重试;下载管理显示等待状态、轮次和时间,支持立即重试或停止。详见 1.73 更新说明。
下载仍可能失败。 平台风控可能限制取址;App 取址已采用每次请求更换合成设备标识符的方式尝试绕过按设备限制,但不保证所有剧集可用或下载成功。失败任务会保留,可稍后重试。
本软件用于学习研究,建议体验后 24 小时内自行删除;请勿冒充官方或以虚假授权名义收费。开源权利义务以 GPLv3 为准。上述倡议不代表获得平台或版权方授权,也不构成免责承诺。
源码基于公开 v1.6,保留原播放恢复与三来源功能。公开发行与平台验证状态以发行页为准。详见 1.7 升级说明。
弹幕仅展示公开网页提供的部分评论,通常首屏约 15 条,读完不循环;不代表全部评论,也不支持发送或回复。完整改动和验证范围见 1.6 发行说明。
| 想做什么 | 主要功能 |
|---|---|
| 找剧 | 红果、西饭、河马统一搜索,分类、热播榜、分享链接解析 |
| 连续观看 | 在线与本地播放、断点续播、自动连播、倍速、后续两集预取与系统画中画 |
| 下载与导出 | 清晰度选择、批量下载、失败重试、合并 MP4 |
| 管理剧库 | 观看记录、本机收藏、新集提醒、下载文件与缓存清理 |
| 调整观看体验 | 横竖布局、置顶、小窗模式、系统画中画、主题、快捷键与画质增强 |
| 阅读评论 | 公开剧评、本集评论弹幕与本机屏蔽词 |
1-30、1,3,5、1,5,10-20 等范围。| 来源 | 已实现 | 当前边界 |
|---|---|---|
| 红果 | 目录、题材、四类热播榜、搜索、分享链接 / ID 解析、可用分集播放下载 | 网页未提供片源时尝试补充取址,结果仍以来源实际返回为准。 |
| 西饭 | 独立目录、题材、分页、搜索、已开放分集播放下载 | 热播榜尚未接入;锁定分集保留标记并跳过。 |
| 河马 | 官网目录、题材、前后翻页、搜索、完整分集列表、明确免费分集播放下载 | 收费或状态不明的分集锁定,不提供解锁。 |
三个来源的文件按来源与剧名分目录保存。“漫画”是图文阅读内容;要播放视频请选“漫剧”。片源、清晰度及可用分集取决于平台,软件不承诺固定 1080p 或全集可用。
S / D 每次调节的幅度可在「设置 → 播放快捷键」中选择 0.25×、0.5×、0.75× 或 1×。优先选择兼容性较好的 H.264 片源,同编码内再优先清晰度;可能低于 HEVC 片源的最高分辨率。软件转码可能更慢,来源服务异常仍可能导致播放失败。
在线播放不保存到下载目录,但部分片源会先准备临时媒体文件并在使用后清理;兼容转码另有磁盘缓存。因此“在线”不代表完全不占磁盘。
Esc 退出。全屏或竖屏播放时,控制条闲置约 2 秒自动隐藏,移动鼠标或操作非切集快捷键后重新显示;暂停、拖动进度条、打开菜单或键盘焦点停在控件上时保持可见。自动连播及上一集、下一集快捷键切集时,已隐藏的控制条保持隐藏,不再短暂弹出。| 画面模式 | 效果 | 适合场景 |
|---|---|---|
| 适应窗口(默认) | 按可用宽高等比缩放,完整显示画面 | 希望人物、字幕和画面边缘都能看全。 |
| 保持宽度 | 按可用宽度等比缩放;只缩短窗口高度时,画面不跟着变小,上下超出部分居中裁剪 | 希望调整窗口高度时保持画面大小;注意边缘字幕或人物可能被裁掉。 |
追剧检查仅在应用运行时执行,不承诺退出后提醒或实时推送。观看记录保存在本机,不提供跨设备同步。
片源的“1080P”标签可能与实际尺寸不符,也不代表上游母版质量;不保证每部剧或每一集都有 1080P。“重新排队 / 重试”不等于从已下载字节续传,锁定集不能加入下载队列。
在「下载管理」选择剧名后点「合并整部剧」,无需勾选任务;「我的剧库」也提供合并入口。候选列表只显示仍有本地可合并分集的剧,在线播放记录不会混入;仅删除任务记录但保留文件时,仍可合并。
| 模式 | 处理方式 |
|---|---|
| 智能快速合并 | 编码参数一致时直接拼接;不一致时按需要处理音视频,混合编码可能需要转码。 |
| 兼容合并(H.264) | 导出 H.264/AAC;已兼容分集尽量直接拼接,仅处理不匹配部分。 |
显示阶段、进度、耗时及可用的处理速度 / 预计剩余时间,支持取消、打开输出所在文件夹和移除合并记录。两种方式都保留原始分集;仅合并已下载分集,不会自动补齐缺集。转码并非无损,用时取决于内容和设备。
HTTP_PROXY / HTTPS_PROXY 等环境变量,不保证识别所有系统代理或 PAC;一次测试成功不代表全部片源可访问。公开评论仅供阅读,弹幕通常只有公开网页首屏约 15 条,读完不会循环。当前不提供手机号登录、手机账号收藏/点赞/历史同步、弹幕发送或回复。
| 按键 | 操作 |
|---|---|
空格 |
播放 / 暂停 |
← / → |
后退 / 前进 5 秒 |
↑ / ↓ |
上一集 / 下一集 |
A |
开启 / 关闭连播 |
S / D |
按设置步长降低 / 提高倍速(默认 0.25×) |
F |
切换全屏 |
Esc |
退出竖屏填满窗口状态,或关闭当前菜单 / 弹窗 |
以上为默认键位,可在「设置」中点击修改,支持单键或 Shift 组合,并检查冲突、恢复默认;S / D 的调速步长也在同一区域设置。输入框、菜单和弹窗操作不会误触播放器快捷键。

macOS 1.6 正式版实拍:热播推荐页面。截图中的片单与热度为截取时的公开榜单内容,会随来源更新。
https://github.com/user-attachments/assets/b95f4f60-b57c-495f-a30e-62ac2b0bda11
3 分钟,从三来源搜索、链接解析讲到播放续看、下载合并、横竖屏与画面模式,再展示 1.3 的主题、快捷键、隐身小窗、热播推荐、公开剧评、本机收藏与日历、画质增强和更新提醒。
视频使用 1.3 正式前端和隔离的演示资料;播放器画面为短剧封面演示,集数、榜单、评分、评论与日期不代表真实平台数据。
片源和可用范围由来源服务决定;西饭锁定集、河马收费或状态不明集会保留锁定。应用不提供解锁或广告奖励接口,不承诺付费内容可用。来源接口可能变化,过去能用不保证一直可用。
先检查网络与来源平台,再检查代理开关和模式,适当降低并发,使用「重试失败」或重新加载目录。黑屏有声可尝试兼容模式。
视频保存在设置中的下载目录,按来源与剧名组织。设置、任务及观看记录默认位于:
~/Library/Application Support/hongguo-downloader/%APPDATA%\hongguo-downloader\data\(单文件便携 EXE 和解压即用版相同)自行指定用户资料目录时以指定位置为准。移除剧库条目、删除任务记录、删除视频和清理缓存是不同操作,请核对确认框。
先手动安装一次最新版。之后,Mac 与 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 标签保留首发历史。
应用使用 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 另以发行页中的名称提供 |
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 x64 上构建安装版或便携 EXE,需准备匹配的 FFmpeg / FFprobe;完整依赖、媒体工具源码与构建命令见 三平台发行与 Windows 构建说明。云端工作流同时生成 NSIS 安装版、更新清单与便携版。自行构建不会自动获得代码签名。
感谢所有代码贡献者与问题反馈者。完整贡献记录与问题编号已核对至 2026-11-15,包含历史开放/已关闭的全部 12 个 PR 和 137 个 Issue。
| 贡献者 | 实际贡献 |
|---|---|
| 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。未合并的方案也保留提交致谢,不代表已经采用。
@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 提交者和问题反馈者致谢。
本项目延续上游的 GPL-3.0 许可,并保留修改与来源声明。Mac 分支自 2026-10-07 开始适配,详细变更见 NOTICE,组件许可见 第三方声明。
感谢以下项目提供的基础工作与参考:
开源许可适用于软件,不授予剧集内容的再分发权。安装包不包含剧集媒体;作品版权归原平台及创作者所有。请仅处理你有权访问、下载或备份的内容,遵守平台条款与相关法律,勿用于未经授权的传播或商业盗版。平台接口可能调整,某次验证通过不保证后续片源持续可用。