hongguo-drama

下载与安装

当前正式版：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.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.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. 下次从「我的剧库」或「观看记录」接着看；下载进度、失败重试和整剧合并在「下载管理」。

6.4

• 跟随系统、简体中文、English可切换并记忆；切换不重新挂载播放器，来源标题及简介保持原文。
• 补齐英文界面、完整句式及Mac原生菜单；代理设置前置，连通测试保持严格TLS并有独立12秒取消。
• 延续6.3取源、缓存与软件解码；本次明确授权先发桌面四平台，TV继续开发。
• 已正式发布桌面四平台；双Mac签名／公证／装订，Windows未签名，真实下载、静音播放和语言验收范围见6.4说明。未替换本机正式安装。

6.3

• 可选DramaBox公开目录、搜索、分集、播放与下载；默认关闭，受来源权限和网络地区限制。ReelShort仍为实验适配器。
• 满足画质时优先兼容编码，复用完整同集缓存及已有准备任务，减少重复转换。
• Mac arm64首次必要ByteVC2转换使用硬件H.264编码；本机真实137秒1080p样本平均33.83秒降至15.72秒，体积约增加53%，画质指标高于旧方案。其他硬件不外推。
• 详情、验收和本轮四平台状态见6.3说明。

6.2

• 优化切集画面交接、旧帧等待恢复及显示尺寸抓帧；暂停重载保持暂停，软件解码暂停状态更清晰。
• 转码排队与执行分开显示，预缓存接管立即同步进度；修复取源终止码丢失后无效降档。
• 修复观看记录只有第1、3、4季时，将缺失第2季误当作续作的问题；旧缓存、红点和系统通知采用同一最高已看季边界。
• 有可见更新的组优先显示，保留组内季序和筛选；读取提醒后恢复最近观看顺序。
• 本轮四平台发行，Android TV另行推进；#100切集转换和#114上游注册拒绝尚未确认修复。
• 构建、签名、公证、发行和验证边界见6.2说明。

6.1

• 播放器支持「从本集下载至末集」，跳过已完成、已排队和锁定集数。
• 「解码方式 → 软件解码（CPU）」可在应用内直接软解 H.264/H.265，并记住选择。
• 新增 Linux x64 AppImage；原生 Ubuntu 构建与启动检查通过，实际播放验证边界见发行说明。
• 修复搜索联想列表随页面滚动悬留。
• 代码、实际测试和环境限制见 6.1 说明。

6.0

• ByteVC2 兼容转换共用单进程队列，解码与编码各限2线程，避免下载和预缓存叠加占满CPU。
• 排队时当前播放优先；切到预缓存分集提升原任务优先级，降档后保持前台优先，不重复下载或转码。
• 保留后续两集预缓存、画质选择、切集保帧与自动连播；取消时清掉排队任务和未完成输出。
• 6.0 已正式发布；冻结时源码记录见 6.0说明，最终发行状态以正式发行页为准。

5.9

• 统一公开版本5.9、内部版本5.9.0、三端产物命名与当前发行资料，保留历史版本记录。
• 修复自动切集时旧画面持续遮挡；首帧回调过早到达后继续等待有效新帧。
• 同组续作提示汇总去重，保留真实新集红点；点击续作不误清原剧的新集提醒。
• 自动预缓存有界尝试1080P、720P及兼容片源，固定画质不自动降档，明确拒绝后停止重试。
• 构建、签名、公证及三端验收状态见 5.9发行说明。

5.8 下载、切集与详情改进

• 修复部分剧集明确未加密的片源被误判为缺少密钥；保留身份、时长、尺寸与地址校验。
• 匿名注册失败或 App 明确拒绝时，暂停尚未开始的红果队列，保留任务供手动重试；不承诺解除百集上游限制。
• 同剧切集保留旧画面至新视频首帧；网络准备仍可能等待。
• 播放区域双击进入／退出全屏；空格短按播放暂停、长按临时2倍速，可在设置中分别改键。
• 详情海报放大，补真实剧情简介，长简介可展开收起；已下载本集可用系统默认视频播放器打开。
• 三端已正式发布，完成签名、公证和必要验收。状态与边界见 5.8说明。

5.7 播放兼容与观看体验

• ByteVC2片源先转换为兼容视频，保留原H.264／HEVC优先级；准备期间显示进度并支持取消。
• 确认同剧后去掉重复提示，独立显示不拆散余组；观看记录操作分两行，完成标记移到时间行。
• 音量、静音与常用倍速跨视频／重启保存，默认音量50%；长按临时2倍不覆盖偏好。
• App明确拒绝取源时停止无效自动重试；百集后失效及上游恢复时间仍未证实。
• 三端已正式发布；本轮构建、签名、公证及验收见 5.7说明。

5.6 播放交互与登录恢复

• 双击画面切换全屏，控制条一键下一集。
• 长按快进键临时2倍速，松开恢复；短按仍前进5秒。
• 登录确认不再被匿名设备注册失败阻断，注册失败遵守冷却并回显错误。
• ByteVC2独占片源明确提示不兼容；#95所报剧集当前仍无法播放。
• 三端发行与验证边界见 5.6说明。三端已正式发布，Mac已签名、公证与装订；Windows EXE未签名。

5.5 播放恢复与下载整理

• 播放取源独立注册匿名身份，修复连续切集和批量下载复用失效身份的问题。内联片源缺少解密信息时，仅有界尝试经身份、完整时长、实际画质、加密和地址校验的备用接口。
• 修复 NAS 挂载变化下的删除安全、分集资料冲突、暂停保存失败与合并磁盘空间预检。代理密码改用本机系统安全存储。
• 不再新建分集 NFO，保留整剧封面、简介和 tvshow.nfo；NAS 可自动创建剧名文件夹，普通下载可在设置中开启整剧资料。
• 新增直接查看当前集公开评论和本机分集小红心，收藏与小红心明确只保存在本机。来源未提供的评论不补造，平台公开点赞数保持来源原值。
• 5.5 已正式发布。完成三端构建与文件完整性核对、双 Mac 签名/公证/装订；按用户要求未重跑功能、单元、集成、桌面及硬件测试。详见 5.5说明。

5.4 恢复播放与下载

• 新增同局域网 DLNA 电视搜索、单集投屏、播放/暂停/停止；需要电视支持相应视频格式。
• 观看记录按明确季号分组、展开折叠，支持人工确认同剧与移出分组，并显示已看完标记。
• 移除剧库记录时清理该剧播放缓存，保留下载文件和其他剧缓存。
• 修复扫码取消后的异步登录写入；增加使用官网登录入口。取源失败时不再提示无效转码操作；恢复播放请求签名，改善取源超时和空响应重试。
• 5.4 已正式发布；真实下载与静音播放、三端构建和安装检查已通过。真实手机授权、实体电视和实体 Intel/Windows/GPU 仍待实测，见 5.4 说明。

5.3 下载到 NAS

• 「我的剧库」底部新增「下载到 NAS」，先挂载共享目录，再为每部剧选择独立文件夹。
• 新下载直接写入所选目录；视频、封面、简介、剧集及分集 NFO 同层保存，不再追加目录。
• 分集按「剧名 S01E001.mp4」命名；已有本地视频保留原文件并安全复制，已有 NAS 视频复用、缺失资料补齐。
• 下载管理打开正确保存目录；目录断开、同名冲突或活动下载改路径时给出提示；直接 NAS 视频不参与看完自动删。
• 资料按来源实际提供，独立保存而非内嵌 MP4；实体 NAS 和媒体库识别尚未实测。
• 5.3已正式发布；三端下载和验证范围见 5.3说明。

5.2 macOS 窗口恢复

• 重启应用或关闭主窗口后从 Dock 重开，恢复普通主窗口的位置和大小。
• 最大化、全屏、最小化、隐身小窗和竖屏布局不覆盖普通窗口记录，启动仍为普通窗口。
• 原显示器不在时回默认位置和大小；同屏可用区域缩小时，窗口保持在屏幕内。
• 正常退出时保存；崩溃或强制退出不保证保存本次调整。
• 5.2已正式发布；三端下载与验证范围见 5.2说明。

5.1 更新说明

修复了已知问题

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

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

• “检查更新”旁的检测范围、“隐藏同剧低季”会记住本机选择，重新打开页面及应用后恢复。
• 支持第9季、10季、中文数字及括号内季号等明确写法；同来源、同剧名的明确季号继续正常归组。
• 裸数字后缀、标题中间换数字、中英文数字变化和轻微改名只显示“疑似同剧（仅提示）”。
• 疑似项不会进入隐藏、批量归组、更新红点或系统通知；点击核对也不会清除原剧更新标记。
• 同一剧号后续改为明确季名时，新标题覆盖旧疑似缓存，转入确定续作后可正常清除更新标记。
• 大幅改名仍可能漏提示；标题相近不能证明作品关系，不同记录和视频不会被删除。
• 5.0 已正式发布，三端下载和最终验收回执见 5.0说明。

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

• 新增“老电脑（H.264优先）”：优先兼容片源，开启兼容模式时对已知 H.265 片源提前转码，减少先黑屏再失败的情况。
• 修复 Mac 自带画中画、隐身小窗导致整个应用 Dock 图标消失的问题。
• 设置新增可录入组合键的老板键：全局暂停并隐藏所有播放窗口，Mac同时隐藏Dock；再次按键恢复窗口与图标，保持暂停。
• 4.9 为上一正式版；历史验收与限制见 4.9说明。

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

• 在线播放选择「自动（1080P优先）」时，先尝试1080P，失败后依次尝试720P和兼容片源；切换时保留播放进度及暂停状态。
• 解码不兼容时，先尝试当前画质的兼容播放与一次缓存重建，仍失败再换档；关闭兼容模式时直接换档。
• 换集、手动重试和后续分集预取重新优先1080P；每轮尝试次数有限，避免反复切换。
• 手动指定720P或1080P仍保持固定画质，已有本地文件不强制重下；实际可用画质取决于来源。详见 4.8说明。

4.7 下载重试与画中画修复

• 下载提交失败后，「重试本集」可以重新提交；提示按真实任务状态显示，避免失败后仍提示「本集已尝试下载」。
• 自带画中画显示在主窗口所在屏幕的右下角，并聚焦、保持置顶；保留尺寸记忆。
• 修复拖动本地视频进度时旧读取取消引发的异常；首次匿名设备注册失败后可在短暂冷却后重新尝试。详见 4.7说明。

4.6 4K与宽窗口适配

• 发现页和搜索页充分使用窗口宽度，海报按可用空间排列；设置中可单独选择小、标准、大、特大海报。
• 界面默认100%缩放，不因4K屏或全屏自动放大；手动缩放支持50%–200%，并保存偏好。
• 窄窗口页头自动换行，矮窗口侧栏可滚动。详见 4.6说明。

4.5 发现页换一批

• 「换一批」读取当前来源、目录线路和题材的真实下一页，保留来源顺序。
• 重复点击真人剧、漫剧、AI剧或题材按钮也会换批；切回分类继续上次位置，到末页后重新开始。
• 综合、真人、漫剧、AI四个热播榜保持热度顺序，重复点击当前榜单不换批；翻页失败保留旧片单并重试同一页。详见 4.5说明。

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

• 设置可选择「系统原生／应用自带」画中画，默认使用自带小窗；小窗显示剧名、记忆尺寸，返回主窗口保留进度和播放状态。
• 观看记录新增「隐藏同剧低季」，只影响显示和计数，保留其他季记录及视频文件。
• App取源返回空响应时，在时间预算和冷却限制内更新一次匿名设备并重试，不更换登录账号。
• 独立账号入口统一为「红果账号」，扫码登录与APP观看记录功能保留。详见 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 随下载导出文字数据

• 在「搜索与下载」选择红果短剧，按需勾选「弹幕」「评论」「剧评」，再点击下载选中集数。
• 每集弹幕、评论分别保存为 JSON，使用实际视频任务的目录和文件名前缀；整剧剧评保存一份。已有视频任务可通过再次提交补导出，新设置不会改变旧任务的文字保存位置。
• 文字在后台导出，单项失败不阻塞视频下载。结果区显示成功、跳过、失败与部分数据份数；完成先到、修改勾选或旧任务迟到均不会覆盖当前任务结果。
• 完整 JSON 保留；翻页中断的弹幕标记为部分数据，再次提交可重试补齐，失败保留原文件。
• 仅支持红果来源；评论、剧评只含官网公开可读部分，不承诺全量。功能源于 jayeeliu 的 PR #61，详见下方贡献者记录。

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

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

• 普通、紧急远程公告各有独立关闭开关，升级后保留；自动提醒关闭时不读取对应通道。公告显示 30 秒自动收起，关闭当前弹窗不改变免提醒偏好。
• 普通公告正文已说明：可在「设置 → 公告通知」永久关闭普通或紧急公告，软件升级后仍保持关闭；需要时可点击「查看当前公告」手动查看。
• 紧急公告优先，每 5 分钟检查；同一 ID 自动提醒永久一次，跨天、重启、升级不重复，前提是本机已读记录成功保存且保留。新 ID 可再次提醒。
• 普通公告支持“今日打开不再提醒”（day）与“版本更新前不再提醒”（version）；抑制期间不读取普通远程文件，版本变化解除抑制，独立关闭开关仍保留。
• 设置页「查看当前公告」手动重新读取，即使自动提醒关闭、普通免提醒生效或紧急 ID 已读也可查看；不改开关和免提醒偏好。
• 三处交互：GitHub 反馈在系统浏览器打开网页；邮箱点击复制地址并显示“邮箱已复制”，失败时提示手动复制；AI 服务购买说明整段链接打开 vipai.pro。本机测试包已确认邮箱复制成功提示。
• 纳入四项审核修复：关闭再开启丢弃旧请求迟到结果；公告跟随全屏与焦点且不重复记已读、不重置 30 秒计时；普通开关不重置紧急 5 分钟时钟；公告文件使用真实解析器校验且不绑定固定正文。
• 搜索 #60：官网出现 503／502 等故障时自动尝试带注册匿名身份与原签名的 App 搜索，分页沿用同一通道；已有故障回退、分页和真实搜索样本通过记录。未取得报告者的具体关键词与网络环境，不能保证所有地区或作品可用。完整范围与验证边界见 4.0 说明。

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

• 放宽当天新剧补搜：官网没有同名结果或接口异常时，App 真人剧与 AI 剧上新目录默认各翻两页，最多使用 200 条候选、返回 20 条补搜结果，繁忙日的新剧更不容易落在首屏之外。
• 修复下一集预取失败后一直占着名额、没有重试的问题；失败会立即释放本次请求，15 秒后随播放进度重试，切到该集时不必重新等待下载。
• 预取升级为最多后续两集：跳过锁定、已下载和本地可播分集；从第一集切到第二集时保留第三集的已准备结果，并在新位置继续补齐后续窗口。
• 播放控制条新增「画中画」按钮：使用系统原生悬浮小窗继续播放，窗口可拖动、置顶、暂停与关闭；自动连播或切换清晰度时不再主动关闭小窗。
• 画中画复用当前 video 元素，不额外下载或开启第二路在线会话；退出小窗后返回应用内播放。
• 全屏按钮与小窗模式并存：横屏进入播放器全屏，竖屏填满当前窗口；「小窗模式」把主窗口缩为置顶小窗，鼠标移开自动暂停隐藏，移回继续，可用 Esc、Dock 或窗口菜单恢复。
• 系统画中画的默认位置、置顶和跨虚拟桌面行为由操作系统管理；不支持画中画的环境会给出提示。

3.8 搜索当天新剧

• 官网搜索没有同名结果、接口 502，或短剧名被更长的老剧名遮蔽时，自动从 App 近 7 天上新目录补搜当天新剧。
• 补搜结果显示「今日上新」/「App 新剧」标记；官网已有精确同名结果时不额外请求 App。
• 补搜失败不影响官网结果；加载更多仍固定官网通道，不会把补搜结果混进下一页。
• App 搜索实验开关仍默认关闭；本次补搜读取 App 分类目录，不需要开启该开关。
• 边界：每类最多取前 50 条、缓存 60 秒；App 目录接口偶发失败时仍以官网结果为准。

3.7 观看记录检测

• 每条观看记录新增单独「检测」按钮；失败只影响这一条，可立即重试。
• 同一来源、同一基础剧名按剧族归组：最高季只做一次续作搜索，低季复用候选；每季自己的新集仍独立检查，避免低季补更被漏掉。
• 批量检测支持「全部记录／仅最高季／仅未看完／排除已看完低季」；已看完的低季自动检测降到每 24 小时一次。
• 单条分集检查限时 10 秒，批量总预算 90 秒，按剧族和记录有限并发；显示当前进度，超出预算的记录保留为“继续检查”。
• 分集更新失败与续作搜索失败分开显示；续作搜索结果短期缓存，失败后短暂冷却，避免连续撞同一个坏节点。

3.6 分集拉取提速

• 官网分集页优先走可信 DNS，避开会挂起的 CDN 边缘；首次只等 1.5 秒，0.6 秒未回就并行再开一组。
• 重试同时走可信／普通 DNS 的 player 与 detail；备用接口 200 空响应自动重试，不再直接失败。
• 真实 10 部剧集样本全部成功，0.49–1.21 秒，平均 0.81 秒；预览 UI 实测 0.75–1.12 秒。
• 上游仍可能偶发断连；不承诺每部剧每次必然秒开。详见 3.6 说明。

3.5 目录双线与分页恢复

• 发现短剧与热播推荐提供「App（快速）／官网」，默认 App、各自记忆选择；两条线路独立缓存，加载失败后可手动切换，不混入另一条线路的片单。
• 推荐刷新不再破坏发现页后续分页。失败、取消、超时和切题材保留真实页码；旧分页失效时明确提示刷新回首页。
• 搜索按来源逐步显示已返回结果，慢来源不再遮住已有片单；推荐显示 App 剧情简介。
• 对已核实的西饭元数据冲突仅隐藏错误分集副标题，保留剧集编号、文件、资料及播放映射；不据此确认上游影片身份。
• App 或官网仍可能间歇超时，不承诺永久可用或官网一定更快。改动、验证与发行边界见 3.5 说明。

3.4 搜索与资料安全

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

3.3 下载降级与 Mac 界面缩放

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

3.2 片单缓存与刷新恢复

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

3.1 查找下一季与审计修复

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

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

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

2.9 时间轴弹幕与观看体验

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

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

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

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

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

2.6 全屏播放体验

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

2.5 播放与任务恢复修复

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

2.4 播放、缓存与安全修复

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

播放取源与连播优化

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

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

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

2.2 播放控件与启动修复

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

2.1 更新检测与下载修复

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

2.0 代理与历史下载修复

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

1.80 应用内下载安装更新

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

1.75 安全与稳定性改进

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

1.74 播放画质与恢复修复

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

1.73 下载自动重试

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

1.72 播放与下载修复

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

1.71 布局更新

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

1.7 更新重点

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

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

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

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

1.6 更新重点

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

弹幕仅展示公开网页提供的部分评论，通常首屏约 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×；三点菜单可直接选档，切集与连播保持当前倍速。
• 兼容播放：默认开启兼容模式；解码失败、黑屏有声时尝试转为 H.264，也可手动「转码后播放」。显示转码进度，支持取消和清理缓存。
• 失败恢复：可取消准备、重试本集、重新连接片源或尝试兼容转码。地址过期或传输中断时有限次刷新取址，不无限重试；硬件转码失败时尝试软件转码。

优先选择兼容性较好的 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 组合，并检查冲突、恢复默认。输入框、菜单和弹窗操作不会误触播放器快捷键。

界面与演示

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

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

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

下载三分钟介绍视频（1080p，约6 MB）

常见问题

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

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

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

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

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

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

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

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

怎样在应用内更新？

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

Windows 下载新版后，为什么仍显示旧版本？

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

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

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

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

如何反馈问题？

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

版本与验证范围

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 版

应用使用 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 来源、源码校验值与构建说明
• 准确版本与构建配置
• FFmpeg 源码构建脚本
• FFmpeg GPLv3 许可全文 · x264 许可全文

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

从源码构建 Windows 版

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

贡献者

4.1

• jayeeliu：通过 PR #61 提出并提供随批量下载导出弹幕、评论、剧评 JSON 的初始实现。4.1 在审查基础上重新接入实际视频任务路径，修复异步结果与部分弹幕重试问题；原 PR 未直接合并，保留其功能贡献署名。

上游、许可证与使用边界

本项目延续上游的 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：桌面运行、界面和媒体处理组件，许可详情见上述声明。

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