1. 找剧：三个来源，一次搜索

• 全部来源搜索：默认同时查询红果、西饭和河马，结果标明来源；也可切换单一来源。某个来源失败时，仍显示其他来源的结果。
• 发现目录：海报、剧名、集数、题材筛选、分页浏览和刷新片单；详情展示完整分集及下载状态。
• 红果分类与热播榜：真人剧、漫剧、AI 剧；综合、真人、漫剧、AI 四类榜单，显示来源提供的排名与热度。
• 红果链接 / ID 解析：粘贴分享链接或输入剧集 ID，获取详情后播放或选集下载。
• 详情直接播放：无需先下载整部剧；未下载的可用分集尝试在线播放。
• 选集更灵活：单选、多选、全选、反选、取消全选；快捷选前 10 集、前 30 集、后 30 集；支持 1-30、1,3,5、1,5,10-20 等范围。

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

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

• 本地优先：已下载分集直接播放本地文件，未下载且未锁定分集尝试在线播放；双击未下载分集可加入下载队列。
• 基本控制：点击画面或按钮播放 / 暂停，拖动进度条，查看时间，调整音量与静音。
• 缓存下一集：在「我的剧库」连播按钮左侧开关，默认开启并记住选择；当前集开始播放就预缓存下一可播放集，切集后继续缓存后一集。已下载或锁定分集不重复缓存；会提前使用网络流量，关闭开关可取消后台预缓存。
• 自动连播：默认开启，可随时关闭；自动切换下一集，跳过锁定分集，本地与在线分集可衔接播放。
• 断点续播：按剧保存集数和播放位置，从剧库或观看记录接着看；切换到应用内其他页面，仍可继续播放并保存进度。
• 0.25×–4× 倍速：共 16 档。右下角倍速数字是独立按钮，每点增加 0.25×，4× 后回到 1×；三点菜单可直接选档，切集与连播保持当前倍速。
• 兼容播放：默认开启兼容模式；解码失败、黑屏有声时尝试转为 H.264，也可手动「转码后播放」。显示转码进度，支持取消和清理缓存。
• 失败恢复：可取消准备、重试本集、重新连接片源或尝试兼容转码。地址过期或传输中断时有限次刷新取址，不无限重试；硬件转码失败时尝试软件转码。

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

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

• 横屏版 / 竖屏版：从顶部切换布局；切回横屏时恢复此前窗口尺寸与位置。
• 窗口置顶：一键置顶 / 取消置顶，方便边工作边看。
• 右侧一体选集：竖屏模式下，选集栏随窗口展开或收起，减少对视频的遮挡。
• 隐藏管理按钮：收起不常用操作，让播放区更简洁。
• 去掉播放器边框：竖屏下去掉播放区周围留白与圆角；这是播放器布局效果，不是移除系统窗口边框。
• 全屏：横屏使用视频全屏；竖屏填满当前窗口，Esc 退出。全屏或竖屏播放时，控制条闲置约 2 秒自动隐藏，移动鼠标或操作非切集快捷键后重新显示；暂停、拖动进度条、打开菜单或键盘焦点停在控件上时保持可见。自动连播及上一集、下一集快捷键切集时，已隐藏的控制条保持隐藏，不再短暂弹出。
• 画面模式：在播放器三点菜单切换，每部剧独立记忆，切换保留播放进度。

4. 观看记录与追剧提醒

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

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

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

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

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

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

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

7. 我的剧库与空间清理

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

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

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

9. 外观、收藏与评论

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

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

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

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

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

| 版本 | 主要变化 | 详细记录 | |---|---|---| | 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 --x64 --publish never。

构建会验证已有 FFmpeg / FFprobe 缓存；缺少匹配缓存时，从固定且经过 SHA256 校验的 FFmpeg/x264 源码编译，然后生成前端、指定架构应用和 DMG。首次构建需联网获取依赖和源码，编译可能耗时数分钟。

| 用途 | 命令或产物 | |---|---| | 开发模式 | npm run dev | | 仅生成 Mac 应用 | npm run build:mac:dir | | 应用产物 | dist/mac-arm64/红果短剧.app、dist/mac/红果短剧.app | | DMG | dist/红果短剧-<版本>-mac-arm64.dmg 或 dist/红果短剧-<版本>-mac-x64.dmg；版本取自 package.json |

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 许可全文