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

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

当前正式版：3.4。三端发行资产已公开并核对远端摘要，双 Mac 应用及 DMG 已签名、公证与装订；Windows EXE 未签名。上一正式版为 3.3。按设备下载一个文件即可，无需另装 Node.js、Homebrew 或 FFmpeg。

查看最新正式版 · 3.4 更新说明与源码 · SHA256 校验文件

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

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

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

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

• 红果指定清晰度不可用或下载失败时，自动尝试更低清晰度；下载管理显示降级提示和实际下载画质。
• 已有文件保留；取消、磁盘权限和本地媒体工具错误不会触发降级，不改变第三方来源的策略。
• Mac 的「视图」放大、缩小和实际大小会保存选择，调整窗口、切换横竖布局或重新启动后继续生效。
• 3.3 三端发行已完成；字号只随手动缩放调整，拖动窗口不改变字号。构建、公证与真实媒体验收边界见 3.3 说明。

• 热播推荐保留会话片单；切换分类或返回页面时先显示已有内容，再更新片单。原生目录缓存延长至 120 秒，主动刷新仍重新请求。
• 刷新超时、失败或返回空列表时保留已有片单，显示可重试提示；更新完成后保留仍在片单中的选中剧集。
• 切换来源、修改来源配置或取消更新后，旧请求返回不会覆盖当前选择或触发旧剧播放。
• 发现页已有海报时使用紧凑错误提示，保留分类、分页及海报可见。
• 3.2 三端发行已完成；验证范围与限制见 3.2 说明。

• 增加手动查找下一季入口，列出同来源、同剧名的更高季数候选，确认后再播放。
• 改善跨来源结果相关性；主剧名搜索优先补缺失季，手动及后台续作检查优先补当前季之后的缺失季，每次最多两条补搜。
• 删除下载文件保留在线播放会话；单任务、单集、自动清理及整剧清理共用归属检查，保护共用文件。占用统计、分集列表与合并按同一归属识别；保存失败保留记录并展示实际释放空间，正在合并的剧明确提示跳过。
• 清理会取消目标失败任务的自动重试，并保存取消状态；文件未能删除而保留记录时也不会在当前会话自动重下。取消状态保存失败会明确提示。
• 代理测试使用表单对应路由，手动代理不受环境绕过规则干扰；明确系统模式的接口／浏览器范围。
• 收藏与观看记录续作优先使用本地档案；缺档案使用稳定错误码回退。
• 播放页恢复常用开关，新增下载本集与后5／10集；横屏缩小时整体等比例缩放，保持行列。
• 三端正式发行已完成，验证范围与限制见 3.1 说明。

• 强制直连与关闭代理时清理继承的 ALL_PROXY；切回系统模式恢复启动时的代理环境。
• 清理下载记录后，“删除全部已下载”仍能找到并清理合集。
• 收藏与上新优先打开本机已登记剧集，仅缺少档案时联网解析。
• 鼠标移出播放器后回到原位置，播放控件正常显示。
• 保留 2.9 的时间轴弹幕、观看记录与播放器改进。详情见 3.0 说明。

• 新增按视频播放时间点显示的弹幕，可在“时间轴弹幕”与原有“本集评论”之间切换，保留显示设置和屏蔽词。
• 弹幕获取、请求签名和时间轴实现参考并移植自 dawei233/hongguo-drama，固定来源提交 c884fab6c6e36ad38173e251738b9b35f958383f，沿用 GPL-3.0 许可，保留原作者说明。
• 使用的是非公开分时接口，上游变化时可能失效，不能保证与手机端数量完全一致；失败可切换为本集评论。
• 弹幕不足时轮播已滚出的真实内容，新到点内容优先；快进、后退保留在屏弹幕。鼠标停住 1 秒隐藏控件与指针。
• 观看记录支持逐条移除与全部／未看完／已看完筛选，收藏增加海报，搜索历史可逐条删除。
• 改进播放取源、剧库管理和看完缓存清理。详细变更与验收边界见 2.9 说明。

• 底栏已显示时，快进／回退及长按重复触发会重新计算 2 秒自动隐藏时间，避免操作中途消失。
• 底栏已隐藏时，默认或自定义快进／回退、长按及松键仍保持隐藏；移动鼠标可正常唤出。
• 保留全屏按钮焦点清理与上一集／下一集行为。变更与验证范围见 2.8 更新说明。

• 播放控件已隐藏时，默认方向键和自定义快进／回退快捷键不再唤出底栏；长按重复触发和松开按键保持一致。
• 修复进入全屏后隐藏按钮残留焦点，避免后续快捷键因焦点移动而重新显示控件。
• 移动鼠标仍可正常显示播放控件。变更范围与验收边界见 2.7 更新说明。

• 全屏顶部显示剧名和当前集，随播放控件显示与隐藏。
• 底部增加悬浮选集网格，可直接切换分集；清晰度菜单沿用现有取源能力。
• 清晰度受来源、当前分集和本地文件限制；菜单说明适用范围，不承诺来源未提供的高清片源。
• 历史状态与限制见 2.6 更新说明。资产可用性与正式发布状态以发行页为准。

• 再次合并自动生成新文件名；清理遗留合并临时文件，退出时等待下载收尾。
• 后台搜索与可见窗口分开，限制远程页面权限。
• 按真实视频编码恢复媒体信息，避免将 H.264 片源误标为 HEVC。
• 分集加载失败可直接重试；兼容模式与自动删除设置保存失败时显示原因。
• 有下载运行时，也可恢复其它暂停或失败任务；已下载更新安装失败后可再次安装。
• 修正标题年份被误识别成季数的问题。详见 2.5 发行说明。

• 离开剧库暂停播放，返回时保留进度；新下载剧集和空间统计按需刷新。
• 减少下载管理和等待播放时的重复目录扫描，修复失败回退持续轮询。
• 收紧分享链接与转码缓存参数校验，保护活动缓存和退出清理。
• 修复保存恢复后更新仍受阻的问题，升级重定向安全依赖。
• 详见 2.4 发行说明。

• 兼容官网新的播放页路径，保留分集身份校验，避免错误拒绝正常片源。
• App 与旧接口媒体请求默认不附网页 Referer，403 时切换请求头重试一次。
• 在线取源和预缓存下一集不再反复扫描整个下载目录，减少慢磁盘造成的播放阻塞。
• 补充 Windows 便携版手动升级步骤，避免仍从旧快捷方式启动。
• 详见 2.4 发行说明。

• 红果分类与热播榜统一使用应用浏览器网络通道，跟随应用中的系统、直连或自定义代理设置，避免目录请求与浏览器网络配置不一致。
• 热播推荐新增来源选择。红果不可用时，可切换西饭、河马或已启用的自定义源；其它来源展示实际目录，不冒充热播排名。
• 换源会取消等待旧片单和旧剧解析，避免迟到结果覆盖当前来源；保留摇一摇和剧库播放入口。
• 详见 2.3 发行说明。

• 播放时鼠标移出播放区域，进度条与控制按钮立即开始隐藏；暂停、拖拽、菜单和键盘操作保留可见入口。
• 启动时不再遍历全部历史下载目录，避免慢外置盘或网络盘扫描拖住主窗口。未登记的本地视频可在“下载管理 → 展开工具 → 扫描下载目录”补登记，分集播放仍按需查找。
• 网络初始化增加等待上限，启动失败显示具体阶段，方便反馈。
• 保留更新下载的取消、重试、手动下载与应用代理支持。
• 详见 2.2 发行说明。

• 更新检测增加官方备用通道，GitHub API 限流或超时后仍可查询稳定新版。
• 应用内更新下载跟随设置中的代理，支持代理认证；切换代理后重新建立连接。
• 下载中可以取消，取消后可重试；手动下载入口随时可用。
• 下载完成仍由你决定是否重启安装。已安装的旧版本不会自动获得本轮检测修复；旧版检测失败时，可直接下载本版安装包。
• 本轮验证及边界见 2.1 发行说明。

• 切换下载目录后，已登记的历史视频仍可定位与兼容转码。
• 代理密码保存、清除立即刷新，普通设置保存不重放密码；IPv6 地址和认证匹配已修正。
• 窗口、关于面板、发行标签和下载文件名统一使用两段版本 2.0。
• 双 Mac 隔离替换及 Windows 真实官方 1.80 安装版升级检查通过；设置、观看记录保留。详见 2.0 发行说明。

• Mac 与 Windows 安装版新增应用内下载更新，显示下载进度；完成后由你点击重启安装。
• 保留官方下载页入口，网络失败可重试；Windows 便携版继续手动下载，不会静默转换成安装版。
• 原有用户资料位置不变，沿用设置、观看记录和下载目录；不要求清空数据或重新下载剧集。
• 1.75 及更早版本需手动安装一次 1.80，之后才使用新版更新入口。具体验证范围见本版发行说明。

• 搜索加载与页面读取共用超时，卡住后可以继续搜索；慢加载也会读取已有结果。
• 加强窗口隔离、页面跳转和应用接口来源检查；页面异常时可重新加载恢复。
• 本地数据替换前同步落盘，减少纯播放时的重复目录扫描，下载与连载上新仍会刷新。
• 限制单次整集缓冲读取，保留下载后播放；后续版本按整数段判断新旧。详见 1.75 更新说明。

• 红果在线播放可独立选择 720P／1080P，切集、缓存和恢复保持选择，不静默降级。
• 评论状态提示不再挡住画面；下载等待重试与最终失败分别显示，保留具体错误。
• 修复画质标签误导选流、指定画质缓存未复用，以及 Windows 带引号路径漏查 FFmpeg。
• 保留剧库与已下载文件。详见 1.74 更新说明；真实片源可用性仍取决于上游。

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

• 普通横屏播放时，控制条无操作约两秒后隐藏；暂停、菜单、拖动和键盘焦点仍可正常使用。
• 官网及自定义片源复用经过安全检查的连接，减少分段播放重复建连；代理与直连分开。
• 指定清晰度下载遇到临时网络错误，可按既有上限延迟重试，保持原画质，不无限重试。
• 保留 1.71 布局。详见 1.72 更新说明；上游不可用或明确画质缺失仍可能失败。

• 我的剧库的下载清晰度说明移到标题下、操作按钮上方；竖屏时随管理面板展开。
• 热播推荐四个榜单与“摇一摇”分散排布，旧试用包更新后生效。
• 保留原有剧库、下载和设置。详见 1.71 更新说明。

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

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

• 取址遭遇临时拒绝时，按 3、8、15 分钟最多延迟重试三次；可暂停或停止，不无限重试。
• 修复本地资料读取失败后的覆盖风险、多实例争抢资料、合并期间误删分集、合并选中旧记录，以及下载完成前的视频有效性检查。
• 修复下载回复晚到后跳集、暂停状态在同集换源后丢失、返回剧库重复执行旧点播指令。完整预缓存可经质量检查后保存，减少重复取流。
• 热播推荐保留四种榜单，新增“摇一摇”短剧签筒。支持全部来源、单来源随机，避免连续抽到同部，结果在统一剧库播放。
• 设置新增自定义播放源：支持苹果 CMS V10 JSON API 的目录、搜索、详情与选集，以及明确 MP4/M3U8 直链的播放和下载。已启用来源加入发现、全部搜索和摇一摇。
• M3U8 仅支持点播；先将清单、分片和密钥逐项检查并准备到本地，再播放或保存为 MP4。支持普通与 AES-128 HLS，不支持直播、DRM、解析网页、远程插件和付费解锁。
• 自定义源可测试、启停、编辑和删除；删除配置不删除本地视频。沿用现有代理设置，代理端最终 DNS 由用户所选代理负责。

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

• 下载清晰度可选：自动（兼容优先）、1080P、720P；按实际分辨率选源，不静默降级。
• 本集评论弹幕：可调字号、速度、不透明度、区域和密度，支持本机屏蔽词。
• 播放与下载恢复：地址失效或传输中断时，有限次刷新取址并尝试备用片源；文件完整并通过校验后才标记下载完成。

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

以上为默认键位，可在「设置」中点击修改，支持单键或 Shift 组合，并检查冲突、恢复默认。输入框、菜单和弹窗操作不会误触播放器快捷键。

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

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

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

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

• macOS：~/Library/Application Support/hongguo-downloader/
• Windows 安装版：%APPDATA%\hongguo-downloader\
• Windows 便携版（3.4 起）：程序所在目录的 data\（单文件便携 EXE 和解压即用版相同）

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

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

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

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

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

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

当前正式版为 3.4（内部 3.4.0），搜索、便携资料与安全修复及验收边界见 3.4 说明。冻结源码 241ada2d604ce65dc15d3c4df3686716ece61865；16 项附件的远端摘要和大小已核对，双 Mac 已签名、公证与装订，Windows EXE 未签名。本轮 Windows CI 通过；随机真实两集的下载、播放、定位、全屏与切集已验，最终签名包已隔离启动/退出。音轨解码通过，未将其等同于人工听感确认；App 搜索仍是默认关闭的实验选项。

上一正式版 3.3（内部 3.3.0）的下载降级与 Mac 界面缩放记录见 3.3 说明。以下保留其历史验收结果，不代替 3.4 验收。

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 覆盖升级记录；这些历史结果不代替后续版本验收，也不代表实体电脑完整覆盖。

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

尚未覆盖：实体 Intel Mac、实体 Windows、启用 Gatekeeper 的干净系统、完整应用内更新流程及长期播放；没有覆盖本机正式安装。 也未覆盖全部显卡与 Windows 真实网络弹幕；云端检查和公证不能代替所有设备与网络环境的实测。

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

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

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

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

• 327044572/hongguo-downloader：原始上游项目。
• zhenyong97/hongguo-downloader：本次 Mac 移植的直接基础。
• woshishiq1/drpys 与 N3urda/hongguoTV：App 片源相关算法来源；准确提交与修改说明见 算法来源声明。
• Hululu007/drpy-node：西饭接口路径与返回结构参考；本项目独立编写适配器。
• Electron、React、FFmpeg 与 x264：桌面运行、界面和媒体处理组件，许可详情见上述声明。

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