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

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

当前正式版：6.5（内部6.5.0）。新增Docker Web/API与NAS批量下载合并，小窗自定义唤醒区域、窗口内全屏和重复弹幕聚合。双Mac、Windows、Linux、Docker同版发布，Docker替代TV。详见6.5说明。

6.5发行页 · SHA256 · 精确源码

小窗唤醒区域入口：设置 → 小窗模式：隐藏后唤醒区域；也可在小窗顶部点击“设置唤醒区域”。支持拖动、缩放、百分比及全窗/右侧窄条预设。

Mac和Windows安装版保留应用内更新入口；完整6.4→6.5自动更新尚未实测，也可退出旧程序后手动安装。便携版请保留同目录data资料。Docker需备份任务和视频目录后重新导入/创建容器；不会自动配置公网访问。媒体可用范围和画质仍由来源平台决定。

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

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

• Docker Web/API支持搜索、NAS批量下载、分集合并与持久任务；Docker替代TV，双Mac、Windows、Linux、Docker五类产物同版发行。
• 小窗可自定义隐藏后唤醒区域的位置和大小，支持拖动、缩放、百分比与预设，设置重启保留。
• 横屏窗口内全屏保留弹幕与播放状态；相同弹幕聚合显示×N。
• 已正式发布，25附件及对应源码/SHA256齐备；实际验收与平台限制见6.5说明。

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

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

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

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

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

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

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

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

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

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

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

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

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

修复了已知问题

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

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

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

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

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

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

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

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

4.3 在「设置」上方新增独立「登录管理」。使用手机红果 App 扫描网页登录二维码，登录后可读取当前账号最近 50 部 APP 观看记录，并按剧名搜索。只有从登录管理页点击记录才会进入播放器；原「观看记录」仍只显示本机记录。

登录态使用系统安全存储加密，和普通设置、观看历史及备份分开保存。本版不上传本机历史，也不把 APP 记录批量导入本机。外部账号扫码和真实记录映射仍需实机验收，详见 4.3说明。

4.2 修复低分辨率首集把后续高清分集压成 480P 的问题。快速和兼容合并会按每段视频的原始分辨率拼接，例如前10秒1080P、后10秒720P；低清片段不会拖低高清片段。高质量分辨率合并会在开始前检查实际已下载文件，只有全部达到1080P才启动。

合并弹窗写清三种方式。软件只在合并前检查一次，完成后不再读取或复查输出视频。三种方式都保留原文件，只合并已下载分集，也不会把低清视频变成真高清。左侧导航不能拖选文字，右侧正文仍可选中复制。验证范围与发行边界见 4.2说明。

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

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

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

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

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

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

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

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

官网搜索支持补搜和加载更多；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、代理凭据及个人文件路径。

当前正式版为6.5。双Mac签名、公证、装订；Windows、Linux、Docker真实流程与小窗原生鼠标验收通过，完整边界见6.5回执。以下保留历史版本记录，不作为本版验收证据。

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、长期播放及完整应用内跨版本更新。

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 安装版、更新清单与便携版。自行构建不会自动获得代码签名。

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

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