jackotom/hongguo-drama · 上手攻略

  • 仓库：jackotom/hongguo-drama
  • 链接：https://github.com/jackotom/hongguo-drama
  • 分类：engineering / app / trending
  • 作者：spark
  • 更新：2026-10-13

是什么

hongguo-drama 是一款基于 Electron + React + Node.js 的桌面短剧应用，主打“红果 / 西饭 / 河马”三来源的短剧统一搜索、在线播放、本地下载、追剧管理与整剧合并导出。当前正式版为 1.6，源代码配置版本 1.6.0（README 原文），仓库由 hongguo-drama-mac 更名而来，沿用上游 GPL-3.0 协议。它是社区维护的开源修改版，不是红果、河马、西饭的官方客户端，也未获官方背书。

解决什么问题

  • 短剧分散在三个平台，普通用户逐个 App 切换体验差。
  • 想在 Mac（Apple Silicon / Intel）和 Windows 上统一搜索、下载与追剧，避免装一堆客户端。
  • 想把零散剧集合并成单个 MP4，方便归档 / 离线分享。
  • 默认下载工具不一定能拿到 1080P 真实片源，作者的方案提供“自动（兼容优先）/ 1080P / 720P”三档清晰度选择，不静默降级。
  • 提供桌面侧发热、底部弹幕、自动连播、断点续播、画质增强等“追剧体验”增强。

快速安装

Apple Silicon Mac（macOS 13+）

  1. 下载 DMG：Hongguo-1.6-mac-arm64.dmg（来自 1.6 发行页）。
  2. 打开 DMG，把「红果短剧」拖入「应用程序」后启动。
  3. macOS 1.6 包已完成 Developer ID 签名、Apple 公证与票据装订，无需全局关闭 Gatekeeper。

Intel Mac（macOS 13+）

  1. 下载 Hongguo-1.6-mac-x64.dmg。
  2. 同样拖入「应用程序」启动，签名 / 公证同上。

Windows x64

  1. 下载 EXE：hongguo-downloader-1.6.0-win-x64.exe，或便携 ZIP：hongguo-downloader-1.6.0-win-x64.zip。
  2. ⚠️ EXE 尚未签名，可能出现系统安全提示；便携版直接运行 EXE 即可。
  3. 用户资料目录：%APPDATA%\hongguo-downloader\（Mac 在 ~/Library/Application Support/hongguo-downloader/）。

更新旧版：先退出应用，再替换程序，保留用户资料目录。应用只提示更新，不自动下载或安装。

核心用法

找剧

  • 默认同时查询红果、西饭、河马，结果标明来源；也可切换单一来源。
  • 粘红果分享链接或输入剧集 ID → 自动解析 → 选集播放 / 下载。
  • 红果分类：真人剧 / 漫剧 / AI 剧；热播榜分综合 / 真人 / 漫剧 / AI 四类（只展示来源平台提供的排名，非个性化）。

播放

  • “在线 / 本地”自动路由：已下载分集直接播本地；未下载且未锁定尝试在线。
  • 快捷键默认（可改）：←/→ 前后 5 秒、↑/↓ 切集、空格 暂停、A 开关连播、S/D ±0.25 倍速、F 全屏、Esc 退竖屏。
  • 兼容模式：默认开启；黑屏有声或解码失败时尝试转 H.264；支持「转码后播放」并显示进度。
  • 自动连播 + 下一集预缓存（默认开）：当前集开始播放就预缓存下一可播放集，关闭后取消后台预缓存。
  • 倍速：0.25×–4× 共 16 档，右下角独立按钮，每点增加 0.25×。

下载与合并

下载清晰度：自动（兼容优先）/ 1080P / 720P
并发数：1–10，默认 3（设置后生效；高并发可能触发来源限流）
状态：等待中 / 下载中 / 已完成 / 失败 / 已停止
  • 合并整剧：在「下载管理」选剧名 → 点「合并整部剧」，无需勾选任务；「我的剧库」也提供合并入口。
  • 两种合并模式：
  • 智能快速合并：编码参数一致直接拼接，不一致再处理。
  • 兼容合并（H.264）：导出 H.264/AAC，混合编码才转码。
  • 仅合并已下载分集，不会自动补齐缺集；转码非无损。

追剧与观看记录

  • “我的剧库 / 观看记录”记录真正的播放起点，按最近观看排序，不混淆在线 / 本地。
  • “新集提醒”：每部剧约 6 小时检查一次新集，列表多时分批处理；运行期才执行，退出不推送。
  • “疑似续作”：每天检查同来源、同名且季数更高的可能续作，可单独关闭；名称匹配可能误报 / 漏报。
  • 系统通知默认关闭，可在「设置」中开启（仍需系统允许通知）。

设置 / 代理 / 画质增强

  • 下载目录 + 命名规则（支持 剧名、集数、标题 变量 + 预设）。
  • 代理：跟随系统 / 环境变量 / 手动 HTTP-HTTPS / 强制直连，含端口预设 + 可选认证；保存前可测试。
  • 画质增强：原画 / 可调锐化 / Anime4K CNNx2M 2× 增强（⚠️ Anime4K 面向动漫，最高支持 1080p 输入，真人画面可能偏平滑）。

典型适用场景

  • 追剧党：三平台不想装三个 App，红果 / 西饭 / 河马统一搜索 + 合并下载。
  • 下载收藏党：批量选集 + 整剧合并 MP4，本地归档。
  • Mac 用户：希望在不关 Gatekeeper 的前提下用一款干净桌面 App（Apple Silicon + Intel 都覆盖）。
  • 开发者：想研究 Electron 桌面 App + 多来源爬虫 + 视频合并 + Apple 公证流水线的端到端示例。

坑与注意

  • ⚠️ 不提供付费分集解锁：收费 / 锁定 / 状态不明的分集会保留锁定；不接入账号、不承诺全集可用。
  • ⚠️ Windows EXE 尚未签名：首次启动可能 SmartScreen 警告，请核对下载来源；首次启动会生成临时运行文件。
  • ⚠️ 1080P 标签可能与实际尺寸不符：作者原文明示“片源的『1080P』标签可能与实际尺寸不符，也不代表上游母版质量”。选择“1080P”时若来源未提供，会提示而非静默降级。
  • ⚠️ 弹幕不循环、不支持发送：默认展示公开网页首屏约 15 条；可调字号、速度、密度、屏蔽词；不支持回复弹幕。
  • ⚠️ 追剧检查只在运行时执行：退出后不提醒，不跨设备同步观看记录。
  • ⚠️ 来源接口会变化：过去能用不代表一直可用；遇到故障先检查网络 / 代理 / 并发数。
  • ⚠️ 从源码构建需 Node.js 22.12+、pkg-config、make、curl；不会自动安装系统依赖；Mac 包内置 FFmpeg 9.0.2 + x264 b35605ace3ddf7c1a5d67a2eb553f034aef41d55（GPLv3-or-later，重新分发需附完整对应源码）。
  • ⚠️ 本项目不是官方客户端：不提供账号登录 / 付费解锁 / 跨设备同步。

与同类对比

维度 hongguo-drama 单平台官方 App 通用视频下载器
多来源统一搜索 ✅ 三来源 ❌ ❌
整剧合并 MP4 ✅ 智能 + 兼容 ❌ ❌
桌面 GUI + 横跨屏 ✅ 部分 ❌
本地优先 ✅（下载 / 缓存） 部分 部分
付费解锁 ❌ 显式不支持 ✅ ❌
跨设备同步 ❌ ✅ ❌
开源 ✅ GPL-3.0 ❌ 部分

一句话推荐结论

如果你的核心需求是桌面端统一搜索 + 批量合并下载国产短剧，且能接受“不带账号、不解锁付费、来源接口会变”的边界，hongguo-drama 1.6 是当前 macOS / Windows 上少有的、开源 + Apple 公证齐全的多源短剧客户端；否则建议直接用单平台官方 App + 通用下载工具组合。