HongGuo 是面向 macOS 的红果短剧客户端，支持 Apple Silicon（M 系列）Mac。使用原生 SwiftUI 界面，提供经典、映幕、青序三套深浅主题，支持独立播放、离线下载、MP4 导出、收藏续播、本机追更与原生演员作品页。
⬇ 下载 Mac 安装包 ｜ 三步安装 ｜ 安装说明 ｜ 全部版本
macOS 14+ · Apple Silicon（M 系列）· v0.8.10 · 154.0 MiB。点击上方直接下载 .dmg，无需进入 Releases 查找文件，也不用下载 Source code 压缩包。
| 项目 | 说明 |
|---|---|
| 当前版本 | v0.8.10 |
| 系统 | macOS 14 或更新版本 |
| 芯片 | Apple Silicon，M 系列芯片；目前不支持 Intel Mac |
| 安装包 | HongGuo-Mac-0.8.10-arm64.dmg，约 154.0 MiB |
| 运行环境 | 已内置 Python、Java 及所需组件，无需自行配置 |
| 手机依赖 | 不需要连接手机或运行安卓模拟器 |
| 网络 | 浏览、在线播放与下载需要联网；已完成的下载可离线播放 |
| 签名 | 临时签名，尚未经过 Apple 公证 |
本仓库用于分发安装包、说明和截图，不是完整源码仓库，也不在仓库中托管剧集文件。
修复滚动或切换榜单后，一排剧集有标题却一直显示“加载失败”的问题。现在滚回卡片时会重新加载封面。如果卡片还在屏幕上，图片请求意外取消后会自动再试一次。
- 恢复剧名和演员搜索：适配官网新的搜索接口，支持上一页、下一页；搜索结果中的演员可直接打开软件内的作品页。
- 修复片源连接失败：更新播放请求签名，每次取源建立新的临时游客身份，解决旧请求返回空数据和身份复用后切集失败的问题。
- 恢复播放与下载链路：在线播放、预加载、自动下一集和离线下载共用修复后的取源方式；空响应时最多尝试一次备用地址。
- 保留原有体验：经典、映幕、青序三套深浅主题、SwiftUI 原生结构、演员作品页、收藏、观看记录及离线视频继续保留。
0.8.3 及之后版本可在应用菜单 → 检查更新… 中下载，确认后重启安装。0.8.2 及更早版本请手动下载安装包。
- 原生演员作品页：显示演员头像、简介、作品数量和按上新时间排列的剧集卡片；点击作品直接进入软件内的详情、选集和播放器。
- 更好找的入口：首页“继续观看”和“观看记录”新增“演员与作品”，剧集演员卡片显示姓名、饰演角色和查看作品入口。
- 修复作品窗口关闭：统一弹窗尺寸，关闭按钮保持完整可见；支持 Esc 逐层返回，适配较小窗口。
- 保留现有功能：复用三套主题、收藏与播放流程，并包含 0.8.5 的连接恢复和连续切集修复。
使用路径：首页或观看记录 → 演员与作品 → 选择演员 → 点击作品。演员资料来自公开页面，可能未收录全部作品。0.8.9 也可从搜索结果中的演员入口进入。
0.8.3 及之后版本可在应用菜单 → 检查更新… 中下载，确认后重启安装。0.8.2 及更早版本请手动下载安装包。
- 修复游客连接失效：包含 0.8.4 的播放修复，不再依赖固定的共享游客身份；按需建立并复用匿名连接，覆盖在线播放、预加载与离线下载。
- 失效后自动恢复：取流返回空响应时，可在限频范围内刷新连接并重试，恢复本次出现的第 63 集到第 64 集切换失败。
- 修复快速切集等待：建立或刷新连接时切换集数，不再被误判为注册失败而等待一分钟；正常网络失败仍保留重试间隔。
- 保留原有体验：经典、映幕、青序三套深浅主题、SwiftUI 原生界面、收藏续播、离线下载和软件更新继续可用。
0.8.3 / 0.8.4 可在应用菜单 → 检查更新… 中下载，确认后重启安装。0.8.2 及更早版本请手动下载安装包。
- 自动检查并下载：启动及运行期间约每六小时检查本项目 GitHub 正式版，在后台下载并显示进度，支持取消和重试。
- 确认后重启安装：下载准备好后点击“重启更新”，保留收藏、观看记录、主题设置和离线视频，并保存上一版应用备份。
- 手动检查入口：应用菜单 → 检查更新…，或设置 → 软件更新；自动检查和自动下载可分别关闭。
- 片源请求修复：包含 0.8.2 的修复，更新游客播放请求参数，解决部分剧集返回空响应、无法起播的问题。
- 兼容画质选择：排除当前播放器不支持的 ByteVC2 轨道，按实际可播放画质选择；播放、下载和画质菜单使用同一规则。
0.8.2 及更早版本请先手动安装本版；从 0.8.3 开始，可在软件内下载后确认重启更新。 自动更新只获取本项目已发布的版本，片源接口变化仍需先适配并发布修复版。
- 恢复播放与下载：修复旧播放接口返回空响应、无法获取视频的问题，更新在线播放和离线下载共用的取流请求。
- 保留最高可用画质：实测恢复 1080p 播放，清晰度切换、切集、预加载、续播及下载继续可用；实际可选画质以每集片源为准。
- 保留界面与数据：经典、映幕、青序三套深浅主题、SwiftUI 原生结构，以及本机收藏、观看记录和播放偏好保持原样。
- 三套主题：保留经典，新增映幕与青序。首页、剧集卡片、详情页和播放器保持原生 SwiftUI 结构；每套主题均支持浅色、深色和跟随系统。
- 离线下载与导出：按集数范围和清晰度下载，支持暂停、继续、失败重试、保存位置迁移和索引修复；已下载集数可分别导出 MP4 或按顺序无损合并。
- 更完整的播放控制：独立预加载开关、竖屏小窗、长按右方向键临时 2 倍速、暂停并隐藏、画面适应方式、播放防休眠与 H.264 / AAC 兼容播放。
- 找剧与追更：支持官网链接或剧集 ID、演员搜索、其他季候选、本机追更、推荐换一批和只读本集评论；应用内可检查 GitHub 正式版更新。
以下 12 张截图均于 2026-10-12 从 0.8.0 原生应用拍摄，使用独立演示数据；0.8.10 沿用这些页面的主题，新增的软件更新窗口和原生演员作品页未包含在以下截图中。片单、封面与画面会随内容服务变化。
| 浅色 | 深色 |
|---|---|
 |
 |
| 浅色 | 深色 |
|---|---|
 |
 |
| 浅色 | 深色 |
|---|---|
 |
 |
| 映幕 · 深色 | 青序 · 浅色 |
|---|---|
 |
 |
| 映幕 · 深色 | 青序 · 浅色 |
|---|---|
 |
 |
映幕、青序的播放控件随深浅外观切换，视频画布始终保持黑色。
| 分类 · 映幕深色 | 范围下载 · 青序浅色 |
|---|---|
 |
 |
| 场景 | 当前支持 |
|---|---|
| 发现内容 | 发现页、分类、真人剧 / 漫剧 / AI 剧筛选、热播榜 |
| 搜索 | 剧名、演员、搜索结果分页、官网详情 / 播放链接、剧集 ID、最近搜索；演员作品可从搜索结果或剧集详情进入 |
| 查看详情 | 剧情简介、演员资料与短评、原生演员作品列表、分组选集、其他季候选、复制链接 |
| 独立播放 | 上一集 / 下一集、自动连播、独立预加载开关、续播、竖屏小窗与集数跳转 |
| 画质 | 默认选择片源提供的最高可用清晰度，支持手动切换，切换时保留进度 |
| 播放控制 | 点击暂停、进度、音量 / 静音、全屏、置顶、定时停止、暂停并隐藏、长按临时倍速 |
| 倍速 | 0.75×、1×、1.25×、1.5×、2×；选择后自动保存 |
| 快进快退 | 方向键操作；步长可选 5、10、15、30、60 秒 |
| 播放偏好 | 倍速、音量、静音、快进步长和自动连播设置保存在本机 |
| 收藏与记录 | 我的收藏、想看 / 在看 / 已看状态、观看记录、续播、收藏筛选与排序 |
| 备份 | 收藏、观看记录、追更、推荐偏好与漫画进度支持 JSON 导出、导入合并；不含视频文件 |
| 漫画 | 漫画列表、公开章节阅读、本机阅读进度 |
| 外观 | 经典 / 映幕 / 青序三套主题，均支持浅色、深色和跟随系统 |
| 个性化 | 自定义名称和图标、恢复默认、生成定制 App |
| 离线下载 | 范围选集、画质选择、暂停 / 继续、断点续传、失败重试、迁移、扫描与索引修复 |
| 视频导出 | 所选已下载集数分别导出 MP4，或按集数无损合并；保留原文件 |
| 本机追更 | 关注新增集数与疑似新季、手动检查、可选系统通知 |
| 故障恢复 | 失败切集回退、重试、重启播放组件、H.264 / AAC 兼容转码和本次运行诊断 |
| 软件更新 | 自动检查、后台下载、进度与取消、手动检查、确认后重启安装；保留上一版备份 |
播放中约 1.5 秒无操作后隐藏控制栏；暂停、加载、选集或拖动时保留操作入口。经典播放器保持深色；映幕、青序的控件随外观变化，视频画布始终黑色。画中画是否可用取决于片源与 WebKit 支持。
- 下载：点击下载 HongGuo Mac 安装包。
- 安装：打开
.dmg，把 HongGuo.app 拖入 Applications / 应用程序。已有旧版时，先完全退出，再选择替换。 - 启动：从「应用程序」打开 HongGuo。
当前安装包仅支持 macOS 14+、Apple Silicon（M 系列芯片），不支持 Intel Mac。无需另装 Python、Java 或安卓模拟器。Release 自动生成的 Source code 压缩包不是 Mac 安装包。
旧版名称若仍是「红果短剧.app」，先将旧 App 改名为「HongGuo.app」再替换，避免保留两个入口。替换应用会沿用本机收藏、观看记录和播放偏好；重要数据可先在「设置 → 我的数据」导出备份。
如果 macOS 阻止打开，请先核对下载来源，再在「系统设置 → 隐私与安全性」使用系统提供的「仍要打开」入口。无需关闭系统安全防护。
0.8.3 起默认开启“自动检查更新”和“自动下载新版本”。应用运行时约每六小时检查一次；下载期间不打断播放，完成后由你点击“重启更新”并确认安装。也可以随时从应用菜单 → 检查更新… 手动检查、下载和安装。
确认安装会保存观看进度并退出，未完成的剧集下载暂停，更新后可手动继续。应用需要放在有写入权限的位置；从 DMG 运行时，请先拖到“应用程序”。替换或重新打开失败时恢复旧版，上一版备份位于 ~/Library/Application Support/HongGuo/Updates/Previous.app。
更新只来自本项目 GitHub 正式发行版，不会直接同步其他上游项目的代码，也不会自动修复尚未适配的接口变化。
| 操作 | 快捷键 / 入口 |
|---|---|
| 搜索 | ⌘ F |
| 播放 / 暂停 | 单击视频、空格或 ⌘ P |
| 快退 / 快进 | ← / →，也支持 ⌘ ← / ⌘ → |
| 增加 / 减少音量 | ↑ / ↓，每次 5% |
| 静音 / 恢复声音 | ⇧ ⌘ M |
| 全屏 / 退出全屏 | 播放器全屏按钮或 ⌃ ⌘ F |
| 快进步长 | 设置 → 观看偏好，或播放器「更多」 |
| 清晰度 | 播放器底部清晰度菜单 |
| 倍速 | 播放器底部倍速菜单；设置内也可指定默认速度 |
| 选集 | 播放器右侧列表按钮，或剧集详情的选集区域 |
| 演员作品 | 首页或观看记录 → 演员与作品；也可从剧集详情的演员标签进入 |
| 外观 / 主题 | 右上角太阳 / 月亮、调色板按钮，或设置 → 外观 |
| 暂停并隐藏 | ⌘ B |
| 临时 2 倍速 | 播放时长按右方向键，松开恢复原倍速 |
| 离线下载 | 详情页 → 离线下载；侧栏管理任务 |
| 软件更新 | 应用菜单 → 检查更新…，或设置 → 软件更新 |
| 备份 | 设置 → 我的数据 → 导出备份 / 导入 |
方向键在播放窗口内生效；输入集数时保留正常的文字编辑行为。完整快捷操作也可在「设置 → 快捷操作」查看。
打开 设置 → 名称与图标：
- 输入 1–24 个字符的名称。
- 选择 PNG、JPEG 或 ICNS 图标，文件不超过 20 MB。
- 点击「保存」。界面名称、窗口标题和运行中的 Dock 图标立即更新，重启后仍会保留。
- 「默认图标」可重新选用 HG 图标；「恢复默认」会恢复 HongGuo 名称及默认图标。
若需要 Finder 和 Dock 显示的应用名称一起改变，点击「生成定制 App…」，选择一个尚未使用的保存位置。成功后退出原 App，从新 App 启动，再将新 App 移入 Applications。定制 App 携带所选名称与图标，并沿用原来的收藏、记录与播放偏好；不会覆盖已有应用或改写正在运行的 App。
Dock 若固定了旧入口，请移除旧入口并固定新 App。安装后续发行包后，可再次生成定制 App。自定义名称或图标不会改变第三方内容的权利与许可。
收藏、观看记录、漫画进度、追更与偏好保存在本机。备份导入会合并收藏和记录，并尽量保留较新的观看进度。离线视频单独保存在下载目录，不包含在 JSON 备份中。
目前尚未接入红果账号登录和手机云同步。 「个人账号」入口不表示已经实现官方账号体系。评论发布、官方账号关注与会员体系尚未接入。本机“关注更新”只保存本地追更状态。详情短评和本集评论为只读，来源可能只提供数量而没有正文；应用会显示实际限制。
为什么某一集播放失败或加载较慢？
请先更新到 0.8.10，其中包含 0.8.9 对播放的修复，解决了已复现的请求签名变化、游客身份复用失效和取源空响应问题。片源、网络和第三方服务的可用性会变化。可重试当前集，或尝试其他可用清晰度。默认最高画质可能需要更多带宽；本项目不承诺所有剧集始终可播。
为什么最高画质不是固定 1080P / 4K？
“最高”指当前片源提供的最高可用档位。不同剧集可选档位可能不同，不会把低分辨率画面标成更高画质。
搜索内容不全怎么办？
0.8.9 已适配新的搜索接口，可用“下一页”继续查看结果。结果范围以服务返回为准；可以尝试缩短关键词，或点击演员查看公开作品列表，也可从分类与热播榜查找。
更新后收藏会丢失吗？
正常替换 App 会保留本机数据。更新前可先导出收藏与记录备份；若迁移到另一台 Mac，可再导入。备份不包含剧集视频或官方账号信息。
为什么 Dock 仍显示旧名称或旧图标？
先退出旧 App，再从新 App 启动；若 Dock 固定的是旧文件，移除旧入口后重新固定。只修改界面名称时，Finder 文件名不会跟着改变，需要使用「生成定制 App」。
是否支持 Intel Mac、Windows 或离线观看？
这个发行包仅面向 Apple Silicon Mac，不支持 Intel 或 Windows。已下载完成的视频支持离线播放；普通收藏或历史入口仍可联网，离线观看请使用“离线下载”中的播放入口。
- 在详情页选择下载清晰度和集数，可输入
1-20,25,30-40。暂停或退出会保留当前集的未完成文件；来源支持时续传，不支持或文件变化时重新下载。重启后手动继续队列。 - 保存位置迁移会先复制再切换，原目录保留为备份。索引修复和目录扫描用于恢复保留的本地视频记录。
- 导出需选择同一部剧的已完成集数，每集只选一个清晰度。无损合并按集数排序；不同编码无法直接合并时，可分别导出 MP4。
- 兼容播放将当前集转为 H.264 / AAC，不改原下载文件；转码可取消，临时副本在关闭播放器后清理。无法修复损坏或缺失的源文件。
- 追更仅在应用运行时检查。其他季按剧名匹配，可能遗漏或误匹配；开启系统通知为可选项。
0.8.10 于 2026-11-06 通过 70 组本地自动化检查。真人剧榜首页的 20 张封面均已下载并解码，在安装版滚动到榜单底部后，原先失败的第 13 至 20 名均已显示封面。
0.8.9 于 2026-11-05 在 Apple Silicon Mac 上通过 69 组离线检查、17 组真实播放器检查、13 组联网功能检查，覆盖搜索解析、分页、请求签名、异常响应、安装替换与回退。正式包签名、DMG 完整性及本机安装检查通过。
实网确认首页、分类、四个榜单和漫画正常；“梁雯晶”搜索首页、第二页、末页及原生演员作品可用。播放器验证 1080P 起播、清晰度切换、预加载、自动下一集、续播与快速切集；下载验证边播边下载、暂停后继续、MP4 导出合并及离线续播。正式安装版另行确认“梁雯晶”25 部作品 →《双面美人谋君心》72 集详情，以及 Esc 逐层返回。
本次未逐一目视验收所有主题，也未在其他 Mac 上测试。演员资料来自公开页面，可能未收录全部作品；片源协议未来变化时仍需适配。
以下为此前版本的验证记录，不代表旧版在当前接口下仍可使用：
0.8.8 于 2026-10-30 通过 9 组相关回归，覆盖演员资料、身份校验、作品排序与去重、空列表和异常响应。实测余茵 66 部作品 →《皎皎入砚心》74 集原生详情 → 1080P 播放成功；经典深浅外观、正常与紧凑作品窗口、关闭按钮和 Esc 逐层返回均通过。
0.8.5 于 2026-10-30 在 Apple Silicon / macOS 26.6.2 上通过 65 组离线单元、组件和安装回归；补充的连接中断重试与后台进程取消测试通过。对《今天有朵云爱我》全部 66 集取得有效 1080p 片源，同一匿名身份复用正常；模拟装入已失效身份后，真实取流自动恢复。
原生播放器以 1.25× 倍速连续完整播放第 61～66 集，共 10 分 39 秒，验证自然结束后自动切集、预加载，以及同时完成另外两集离线下载；无快进或人工重试。66 集取流检查不代表逐集完整播放。0.8.5 正式包签名、DMG 完整性、本机安装启动及第 64 集画面已确认。
0.8.3 于 2026-10-28 在 Apple Silicon / macOS 26.6.2 上通过 60 组离线单元、组件和安装测试，以及真实 GitHub 下载、校验、准备和重开后的下载包复用验证。更新测试覆盖手动与自动检查、取消、失败限频、损坏包拒绝、版本比较、实际 DMG 替换与启动失败回退；菜单、更新窗口和本机安装启动已确认。
0.8.3 包含 0.8.2 中对《今天有朵云爱我》第 3、4 集完成的真实 1080p 播放、切集、视频音频解码与下载修复。0.8.3 未重跑全套在线播放与综合功能测试；此前 0.8.1 的完整回归结果如下。
0.8.1 于 2026-10-17 在 Apple Silicon / macOS 26.6.2 上通过四组自动化回归，覆盖真实 1080p 在线播放、清晰度切换与切集、预加载和续播、并行播放与下载、离线播放、MP4 导出与合并、失败切集回退、兼容转码、画面模式、防休眠及播放偏好。新增接口测试覆盖批量请求、缓存、异常响应和剧集匹配；安装包签名、镜像完整性及安装启动检查通过。三套主题深浅设置页的原生渲染与滚动沿用 0.8.0 的验证结果。
AirPlay 的配置、接口与调用链已验证；系统设备选择器实际显示和接收端投放尚未完成确认。尚未完成其他 macOS 版本及长时间耐久测试。片源、画质、搜索范围和评论正文取决于第三方服务。
Mac 界面使用 SwiftUI + WebKit。桌面播放方案参考 hongguo-desktop-releases，后端来源为其公开发行组件及 zhangbaio/hongguo。组件来源说明与原有许可证保留在应用包的 Contents/Resources/Backend/PROVENANCE.md、Backend/licenses 及运行环境目录中。本项目不重新许可第三方组件或内容。
0.8.1 的取流请求字段参考 hongguoTV 的近期播放修复，在本项目中独立实现 Python 适配，复用现有播放与下载流程。
0.8.2 / 0.8.3 的游客播放参数参考 hongguoTV 10 月 27 日修复，未引入其客户端代码、账号 Cookie 或登录票据。该固定共享身份已在 0.8.4 / 0.8.5 中替换。
0.8.4 / 0.8.5 的匿名连接注册适配参考 hongguo-drama 的播放身份实现，Python 适配源码及 GPL-3.0 许可证随应用提供。不使用账号 Cookie 或登录票据，连接身份只保留在工作进程内存中。未来接口协议变化仍需适配并发布新版。
0.8.9 的搜索接口与播放签名适配参考 hongguo-drama 5.8 的公开实现。Python 签名适配通过 24 组完整请求对照，复用已内置的运行环境；相应源码、来源说明与 GPL-3.0 许可证随应用提供。
遇到问题请在 Issues 提供 macOS 版本、芯片型号、应用版本、复现步骤和错误提示。播放问题可附剧名及集数；截图请避开个人信息，无需提交密码、验证码或账号凭证。
权利人反馈与处理方式请见 免责声明与权利说明。