Repository navigation
Releases
HongGuo 红果短剧 Mac 客户端 v0.8.10 · 修复热播榜封面加载失败
HongGuo 红果短剧 Mac 客户端 v0.8.10
下载 Mac 安装包(154.0 MiB) · macOS 14 或更高版本 · Apple Silicon(M 系列)
修复热播榜封面加载失败。 旧版在滚动或切换榜单时,有时会把取消的图片请求显示成“加载失败”,滚回卡片后仍看不到封面。现在卡片重新出现时会重新加载。如果卡片仍在屏幕上,图片请求意外取消后会自动重试一次。
已用真人剧榜首页的 20 张封面验证下载和解码,并在安装版确认原先连续失败的第 13 至 20 名全部正常显示。70 组本地自动化检查通过。
如何更新
0.8.3 及之后版本可在应用菜单选择“检查更新…”,或前往“设置 → 软件更新”。下载完成后点击“重启更新”。手动安装时,先退出旧版,打开上方 DMG,将 HongGuo.app 拖入“应用程序”并替换。安装说明
HongGuo 红果短剧 Mac 客户端 v0.8.9|搜索与播放修复
HongGuo 红果短剧 Mac 客户端 v0.8.9
搜索与播放修复 · macOS 14+ · Apple Silicon(M 系列)· 155.4 MiB
本次更新
- 恢复剧名与演员搜索:官网搜索结果已改用新的接口,本版恢复搜索及真实分页;点击搜索结果中的演员,可在软件内查看作品并进入剧集详情。
- 修复播放取源失败:更新请求签名,每次取源建立新的临时游客身份,解决旧请求返回空数据、复用身份后再次播放或切集失败的问题。
- 同步修复预加载与下载:在线播放、自动下一集、预加载和离线下载共用新取源方式;空响应时最多尝试一次备用地址,取消操作不会阻塞新的取源请求。
- 保留界面与数据:沿用经典、映幕、青序三套深浅主题、SwiftUI 原生结构、演员作品页和现有播放控制。收藏、观看记录、主题偏好及已完成的离线视频继续保留。
安装与更新
0.8.3 及之后版本可从应用菜单 → 检查更新…,或设置 → 软件更新下载本版,确认后重启安装。自动下载不会自行重启。
0.8.2 及更早版本请手动下载 .dmg,完全退出旧版,将 HongGuo.app 拖入 Applications / 应用程序并替换。
安装包适用于 macOS 14+、Apple Silicon Mac,已内置 Python、Java 及所需组件。GitHub 自动生成的 Source code 压缩包不是 Mac 安装包。应用使用临时签名,尚未经过 Apple 公证,详见安装说明。
验证与已知限制
2026-11-05 完成 69 组离线检查、17 组真实播放器检查、13 组联网功能检查,全部通过。正式包签名、DMG 完整性及本机安装检查通过。
- 实网验证首页、分类、四个榜单、漫画,以及演员搜索的首页、第二页、末页和原生作品页。
- 实际画面验证 1080P 播放、清晰度切换、自动下一集、预加载、续播和快速切集。
- 下载验证边播边下载、暂停后继续、MP4 导出合并、离线播放及迁移后续播。
- 正式安装版确认“梁雯晶”25 部作品 →《双面美人谋君心》72 集详情,Esc 可逐层返回。
没有 AirPlay 接收设备,本次仅验证接口,未验证实际投放;未逐一目视验收所有主题或在其他 Mac 上测试。公开演员资料可能未收录全部作品,实际片源与清晰度以服务返回为准。未来上游再次变更协议时,仍需适配并发布新版。
HongGuo 红果短剧 Mac 客户端 v0.8.8
HongGuo 红果短剧 Mac 客户端 v0.8.8
原生演员作品页 · 窗口关闭修复 · macOS 14+ · Apple Silicon(M 系列)· 154.0 MiB
本次更新
- 演员作品留在软件里:使用原生 SwiftUI 页面显示演员头像、简介、作品数量与剧集卡片;点击作品直接打开本机详情、选集和播放器,复用收藏功能。
- 新增“演员与作品”入口:从首页继续观看或观看记录直接查看本剧演员;演员卡片显示姓名和饰演角色。
- 修复关闭按钮被裁掉:作品窗口采用统一尺寸,适配小窗口;顶部“× 关闭”和 Esc 均可逐层返回。
- 保留主题和播放能力:沿用经典、映幕、青序三套深浅主题与 SwiftUI 原生结构,包含 0.8.5 的播放连接恢复和连续切集修复。
使用路径:首页或观看记录 → 演员与作品 → 选择演员 → 点击作品 → 开始观看。
安装与更新
0.8.3 及之后版本可从应用菜单 → 检查更新…,或设置 → 软件更新下载本版,确认后重启安装。自动下载不会自行重启。
0.8.2 及更早版本请手动下载 .dmg,完全退出旧版,将 HongGuo.app 拖入 Applications / 应用程序并替换。收藏、观看记录、主题和离线视频继续保留。
当前安装包适用于 macOS 14+、Apple Silicon Mac,已内置 Python、Java 及所需组件。GitHub 自动生成的 Source code 压缩包不是 Mac 安装包。应用使用临时签名,尚未经过 Apple 公证,详见安装说明。
验证与已知限制
9 组相关回归通过,覆盖演员资料、身份校验、作品排序、去重、空列表和异常响应;正式包编译、签名、DMG 完整性及本机安装检查通过。
实测《今天有朵云爱我》演员列表 → 余茵 66 部作品 →《皎皎入砚心》74 集原生详情 → 1080P 播放成功。经典深浅外观、正常与紧凑窗口、关闭按钮和 Esc 逐层返回均通过。
本次未重跑全套播放回归或逐一目视验收所有主题。演员资料来自公开页面,可能未收录全部作品。当前官网搜索请求未返回预期片单数据,请先从剧集的“演员与作品”进入;搜索结果中的演员入口尚未完成实网验收。
HongGuo 红果短剧 Mac 客户端 v0.8.5
HongGuo 红果短剧 Mac 客户端 v0.8.5
播放连接恢复 · 连续切集修复 · macOS 14+ · Apple Silicon(M 系列)· 155.2 MiB
⬇ 下载 Mac 安装包 · 安装与完整说明 · 界面截图
本次更新
- 修复播放连接失效:包含 0.8.4 的修复,不再依赖固定的共享游客身份;按需注册匿名连接,在各工作进程内复用。解决本次《今天有朵云爱我》第 63 集结束后第 64 集切换失败的问题,播放和离线下载共用修复。
- 失效连接自动恢复:片源返回空响应时,在限频范围内刷新连接并重试;明确的 HTTP 或业务拒绝不会触发身份刷新。
- 修复快速切集等待一分钟:首次建立连接或刷新期间切换集数,取消旧请求后可立即处理新请求;真实网络和注册失败仍保留重试间隔。
- 保留现有功能与数据:三套深浅主题、SwiftUI 原生界面、画质与倍速、收藏续播、预加载、离线下载和应用内更新保持原有方式。
安装与更新
0.8.3 / 0.8.4 用户:打开应用菜单 → 检查更新…,或设置 → 软件更新,下载完成后点击“重启更新”并确认。自动检查和后台下载已开启时也会发现本版;安装需要你确认,不会自行重启。
0.8.2 及更早版本或首次安装:下载 .dmg,完全退出旧版,把 HongGuo.app 拖入 Applications / 应用程序并替换,再从应用程序启动。收藏、观看记录、偏好和离线视频继续保留。
应用内更新需要安装位置可写;从 DMG 运行时请先拖到“应用程序”。确认更新会保存观看进度并暂停未完成的剧集下载,更新后可手动继续。上一版备份保存在 ~/Library/Application Support/HongGuo/Updates/Previous.app。
本页只提供 DMG 安装包,不附带哈希文件。GitHub 自动生成的 Source code 压缩包不是 Mac 安装包。安装包已内置所需运行环境,仅支持 macOS 14+、Apple Silicon Mac,采用临时签名,尚未经过 Apple 公证,详见安装说明。
验证结果
2026-10-30 在 Apple Silicon / macOS 26.6.2 上完成:
- 65 组离线单元、组件和安装回归通过;连接中断后重试及真实后台进程取消注册后的恢复测试通过。
- 《今天有朵云爱我》全部 66 集取得有效 1080p 片源,同一身份复用正常;将已失效身份放入隔离测试进程后,真实取流自动恢复第 64 集。
- 原生播放器以 1.25× 倍速连续完整播放第 61~66 集,共 10 分 39 秒,开启预加载,同时完成另外两集离线下载。各集自然结束并自动切换,无快进或人工重试。
- 正式应用签名、DMG 完整性、本机安装启动及第 64 集画面检查通过。
66 集取流检查不代表逐集完整播放。未在其他 Mac 或 macOS 版本验证,AirPlay 接收端投放与更长时间的耐久测试尚未完成。未来片源接口变更或服务不可用仍可能需要适配;应用更新只获取本项目已发布的版本,不会自动同步上游代码。
匿名连接注册适配参考 hongguo-drama 的播放身份实现。适配源码、来源说明及 GPL-3.0 许可证随应用提供,不读取账号 Cookie 或登录票据。
HongGuo 红果短剧 Mac 客户端 v0.8.3
HongGuo 红果短剧 Mac 客户端 v0.8.3
自动下载更新 · 播放修复 · macOS 14+ · Apple Silicon(M 系列)· 156.4 MiB
⬇ 下载 Mac 安装包 · 安装与完整说明 · 界面截图
本次更新
- 自动检查并下载新版:启动及运行期间约每六小时检查本项目 GitHub 正式版,后台下载,显示进度,支持取消和失败重试;两个自动选项可分别关闭。
- 确认后重启更新:下载准备好后点击“重启更新”,确认后退出、替换并重新打开。保留收藏、观看记录、主题、播放偏好和离线视频,并保存上一版应用备份。替换或重新打开失败时恢复旧版。
- 手动更新入口:应用菜单新增“检查更新…”和独立更新窗口,设置页也可手动检查、下载及安装。
- 修复部分剧集无法播放:包含 0.8.2 的片源修复,更新游客取流参数,解决旧请求返回空响应的问题;播放和离线下载共用修复。
- 改进画质兼容性:统一排除当前媒体组件不支持的 ByteVC2 轨道,按实际可播放画质选择,避免部分低画质导致准备失败。
- 保留现有体验:经典、映幕、青序三套深浅主题及 SwiftUI 原生结构保持不变。
安装与更新
0.8.2 及更早版本请先手动安装本版。 下载 .dmg,完全退出旧版,将 HongGuo.app 拖入 Applications / 应用程序并替换,再从应用程序启动。本机数据继续保留。
从 0.8.3 开始,可通过应用菜单 → 检查更新…,或设置 → 软件更新完成后续更新。自动下载不会自动重启;确认安装时会保存进度、暂停未完成的剧集下载。应用需要位于有写入权限的目录,从 DMG 运行时请先安装到“应用程序”。上一版备份位于 ~/Library/Application Support/HongGuo/Updates/Previous.app。
当前安装包仅支持 Apple Silicon Mac,已内置 Python、Java 及所需组件。GitHub 自动生成的 Source code 压缩包不是 Mac 安装包。应用采用临时签名,尚未经过 Apple 公证,详见安装说明。
验证与使用说明
2026-10-28 通过 60 组离线单元、组件及安装测试;真实 GitHub 下载、连续进度显示、校验、准备和重开后的下载包复用验证通过。覆盖取消、失败限频、损坏包拒绝、版本比较、实际 DMG 替换和启动失败回退,安装包签名、镜像完整性及本机菜单与更新窗口检查通过。0.8.2 的片源修复已对《今天有朵云爱我》第 3、4 集实测 1080p 播放、切集、视频音频解码和下载。
0.8.3 未重跑全套在线播放与综合功能测试,未在其他 Mac 上验证,AirPlay 接收端投放仍未验证。片源、搜索范围和评论正文取决于第三方服务。
软件更新只获取本项目已发布的版本。 上游接口变化仍需先适配并发布修复版,不会直接同步其他项目代码。
游客请求字段参考 hongguoTV 10 月 27 日播放修复,本项目独立实现适配。组件来源与许可证继续保留在应用包内。
HongGuo 红果短剧 Mac 客户端 v0.8.1
HongGuo 红果短剧 Mac 客户端 v0.8.1
播放源修复 · macOS 14+ · Apple Silicon(M 系列)· 155.0 MiB
⬇ 下载 Mac 安装包 · 安装与完整说明 · 界面截图
本次更新
- 恢复播放与下载:修复旧播放接口返回空响应、无法获取视频的问题,更新在线播放和离线下载共用的取流请求。
- 保持最高可用画质:实测恢复 1080p 播放,保留手动清晰度切换、切集、预加载、续播和下载续传。每集提供的画质以实际片源为准。
- 保留现有体验:经典、映幕、青序三套深浅主题与 SwiftUI 原生结构保持不变,继续支持独立播放器、离线剧库和 MP4 导出合并。
安装与更新
下载 .dmg,完全退出旧版,将 HongGuo.app 拖入 Applications / 应用程序并替换,再从应用程序启动。本机收藏、观看记录、下载及设置继续保留。
已内置 Python、Java 及所需组件。当前安装包仅支持 Apple Silicon Mac;GitHub 自动生成的 Source code 压缩包不是 Mac 安装包。应用采用临时签名,尚未经过 Apple 公证,详见安装说明。
验证与使用说明
2026-10-17 在 Apple Silicon / macOS 26.6.2 上通过四组自动化回归,覆盖真实 1080p 出画、清晰度切换、切集与续播、边播放边下载、离线播放、MP4 导出与无损合并、失败切集回退、兼容转码和防休眠。安装包签名、镜像完整性和安装启动检查通过。
完整搜索接口不可用时仍回退到官网结果;单集评论目前可能只返回数量而没有正文。AirPlay 本次仅验证接口,未验证接收端投放。片源可用性取决于上游服务。
取流请求字段参考 hongguoTV 的近期播放修复,本项目独立实现适配。组件来源与许可证继续保留在应用包内。
HongGuo 红果短剧 Mac 客户端 v0.8.0
HongGuo 红果短剧 Mac 客户端 v0.8.0
macOS 14+ · Apple Silicon(M 系列)· 155.0 MiB
⬇ 下载 Mac 安装包 · 安装与完整说明 · 全部界面截图
本次更新
- 映幕与青序主题:保留经典,新增两套视觉风格。首页、剧集卡片、详情和播放器保持 SwiftUI 原生结构,兼顾深浅外观。
- 离线下载与 MP4 导出:支持范围选集、清晰度、暂停/续传、重试、目录迁移和索引修复;可分别导出或按集数无损合并。
- 播放与恢复:下一集预加载单独控制;竖屏小窗、临时 2 倍速、暂停并隐藏、画面模式、防休眠、兼容转码,以及失败切集回退。
- 找剧与追更:官网链接/ID、演员搜索、其他季候选、本机追更、推荐换一批、只读本集评论和正式版更新提醒。
- 文档与截图:更新全部功能说明,重新拍摄 12 张最新版截图,展示三套主题及详情、播放器、分类和离线选集。
界面预览
| 青序 · 浅色 | 映幕 · 深色 |
|---|---|
![]() |
![]() |
安装与更新
下载 .dmg,退出旧版,把 HongGuo.app 拖入 Applications 并替换。本机收藏、观看记录和播放偏好继续保留,重要数据可先在设置导出备份。已内置运行环境,不必另装 Python 或 Java。Source code 压缩包不是安装包。
当前只提供 Apple Silicon 版本。应用采用临时签名,尚未经过 Apple 公证;若系统阻止打开,请核对来源后使用“隐私与安全性”中的系统打开入口,无需关闭系统安全防护。
验证与限制
已通过自动化回归、六种主题/外观设置页渲染与滚动、签名及 DMG 校验;测试环境为 Apple Silicon / macOS 26.6.2。覆盖真实在线/离线播放、下载续传、MP4 导出合并、切集恢复与偏好记忆。
AirPlay 配置、接口及调用链已验证,但系统选择器显示与实际投放尚未确认;未完成其他系统版本和长时间耐久测试。账号登录、手机云同步、评论发布和会员体系尚未接入。内容可用性依赖第三方服务。
第三方内容、封面、商标与组件归各自权利人所有。免责声明与权利说明。
HongGuo for macOS v0.4.18(非官方)
HongGuo for macOS v0.4.18(非官方)
适用于 macOS 14+ / Apple Silicon(M 系列芯片)。
⬇ 下载 Mac 安装包(148.6 MiB) | 三步安装 | 安装说明
Important
本项目不是红果官方产品,与红果及其关联主体无隶属、合作或背书关系。第三方内容、封面、商标及组件归各权利人所有。更换名称、图标或免费发布不代表取得内容及服务授权,也不当然免责。请先阅读 免责声明与权利说明。
下载与安装
点击上方入口即可下载 HongGuo-Mac-0.4.18-arm64.dmg(约 148.6 MiB),退出旧版后,把 HongGuo.app 拖入 Applications 并替换。旧版若名为「红果短剧.app」,先改为「HongGuo.app」再替换,避免两个入口。
- 收藏、记录与播放偏好保留,建议重要数据先从设置导出备份。
- 内置所需运行环境,不必另装 Python / Java,不依赖手机或安卓模拟器。
- 暂不支持 Intel Mac;自动生成的
Source code文件不是安装包。 - 应用采用临时签名,尚未经过 Apple 公证。系统阻止打开时,请核对下载来源后使用「隐私与安全性」中的系统打开入口,无需关闭系统安全防护。
功能与支持范围
- 内容浏览:发现、分类、热播榜、搜索、漫画公开章节、剧集详情与分组选集。
- 独立播放:最高可用画质、手动切换清晰度、倍速与音量记忆、可设置步长的方向键操作、自动连播、续播、全屏、置顶和定时停止。
- 收藏与记录:本机收藏、追剧状态、观看记录和 JSON 备份。
- 外观与个性化:浅色 / 深色 / 跟随系统,线框侧栏与细条悬浮滚动条,自定义应用名称与图标、保存、恢复默认和生成定制 App。
账号登录、手机云同步、发评论、关注、会员与离线下载尚未接入。 片源、可用清晰度、搜索范围与播放可用性取决于第三方服务,不保证所有剧集始终可播。
界面截图
主界面外观
| 浅色模式 | 深色模式 |
|---|---|
![]() |
![]() |
主界面可自由切换浅色与深色。以下为单独的功能截图,视频播放窗口始终使用深色背景。
分类与筛选 · 深色模式
剧集详情与选集 · 深色模式
独立播放窗口 · 固定深色
截图用于展示客户端界面,片单、封面与画面会随内容服务变化。
完整使用说明与常见问题 · 问题反馈 · 免责声明






