红果桌面版 1.0.18 与 hongguo-drama 2.3：升级步骤及故障检查

红果桌面版 1.0.18 与 hongguo-drama 2.3：升级步骤及故障检查

本文面向已经安装过渠道有数红果桌面版 1.0.13，或 jackotom 的 hongguo-drama 1.73 的电脑用户，固定说明 v1.0.18 与 v2.3 的迁移方法。两者是独立社区项目，升级前先识别应用、系统和安装方式，再处理程序文件；本文依据官方版本资料整理，没有安装运行软件。

先建立对应关系：项目、系统、包类型

渠道有数红果桌面版本次介绍 Windows 10、11 x64 的 1.0.18 setup。仓库中的 Mac beta、TV 属于其他独立版本，不并入这条升级路径。README 留有旧版入口，选包时以本次固定发行版本为准，不能仅凭文件都叫“红果”就互相替换。

hongguo-drama 2.3 支持 macOS 13+ 的 Apple Silicon、Intel Mac，以及 Windows x64。Mac 分 arm64、x64 DMG；Windows 有 setup 安装版和便携 EXE、ZIP。媒体工具已内置，普通使用不需要额外配置开发环境。

两个项目分别保存本机观看记录，也不会自动接上手机红果 App 的账号历史。若同时更换项目和安装方式，应先分清记录属于哪款应用，避免把另一款软件的空剧库当成升级丢失。

图示为渠道有数红果桌面版 1.0.2 的发现页，可用于识别项目和原有布局，不展示 1.0.18 的修复结果。

升级前：记录路径，结束旧进程，保留数据

先记下旧版本、程序文件位置、实际下载目录和正在看的剧集。资料、程序和视频可能位于不同目录，尤其是便携版，不应为了换一个程序文件直接删除整个文件夹。

完整退出旧应用后再更换。渠道有数的主窗口关闭后可能仍留在托盘，需要从通知区域退出；hongguo-drama 也应先结束旧应用，再进行替换。已完成的视频、本机历史、收藏和设置先保留，等新版本启动后逐项核对。

渠道有数的发行记录包含从 1.0.17 升级后的资料保留验收，但并未据此证明 1.0.13 在所有设备上都能直接升级成功。因此，下面的检查步骤也适用于从更早旧版迁移的人，不能省掉启动后的资料核对。

替换程序：分别处理三种情况

渠道有数 Windows 版

运行 1.0.18 的 x64 setup，按向导完成。安装器会复用已有 WebView2，缺失时联网补齐；接近完成时仍在补环境，应等待当前安装结束，不同时启动多个安装器。

完成后从对应入口启动，确认版本为 1.0.18，再检查旧收藏、历史和设置。首先复查原来报错的搜索或榜单，然后进入详情选一集播放；先确认程序已更新，再讨论修复是否生效。

hongguo-drama Windows 版

从 1.73 或更早版本升级，需要先手动安装一次。选择 setup 就按安装向导操作；继续使用便携 EXE，则手动换程序文件；ZIP 先解压，再从解压后的目录运行。

从旧便携版改为安装版，安装器不会替换原目录里的便携文件。旧快捷方式若仍指向原 EXE，启动的还是旧版。此时先检查入口和文件路径，不要因为安装向导成功结束，就直接断定当前运行的是 2.3。

后续 Mac 和 Windows 安装版支持应用内下载更新，下载完成由用户点击重启安装，便携版仍手动替换。关闭提示不等于取消正在下载的更新，也不表示应用会静默替你安装。

hongguo-drama Mac 版

确认 macOS 版本达到 13，再按芯片选 DMG：M 系列为 arm64，Intel 为 x64。退出旧应用，将 DMG 内的应用拖入“应用程序”替换，随后从“应用程序”启动。

如果版本没有变化，先检查是否还在打开旧磁盘映像或旧位置的副本，再核对本机记录与视频目录。不能用旧版的 Mac 签名、公证状态替代本版结论；两个项目的 Windows 程序也仍未配置发布者代码签名，系统提示时应核对文件来源并保留防护。

验证第一层：搜索与片单

渠道有数 1.0.18 明确修复了搜索空结果、热榜加载失败、播放地址解析异常与部分 HEIC 封面显示为空白。可使用完整剧名检查搜索，再分别刷新热播、真人、漫剧或 AI 榜单，区分条目没出现、图片没显示和选中后无法播放。

榜单支持刷新、加载更多及过滤夹入的推荐条目。黑暗模式在旧 1.0.13 已有，仍从“设置 → 外观”调整；地址失效重取、下载恢复和离线观看是当前保留能力，本次未把其首次加入时间全部核实，不一起标成 1.0.18 新增。

hongguo-drama 2.3 将红果分类、热播榜请求放到同一浏览器网络会话，跟随应用设置的系统、直连或自定义代理，并处理相应认证。检查时先确认当前网络模式，再看分类与榜单能否返回，避免只改设置却没有对照同一入口。

热播推荐也可切换西饭、河马或已启用自定义源。只有红果提供热播排名，其他来源是目录；换源会取消旧片单和旧剧解析，避免迟到结果覆盖新选择。不同来源没有同剧保证，目录请求修复也不代表所有媒体地址已经可用。

验证第二层：播放、画质与窗口行为

目录可见却某一集不能播放，应记录来源、完整剧名、集数与提示，再用其他可用剧集对照。hongguo-drama 的“搜索与下载”支持剧名、红果分享链接或剧集 ID，搜索结果会标明来源；详情里的播放与保存队列是不同路径，不必先保存整部剧才能开始看。

从 1.73 升级的人需要注意，红果在线播放从 1.74 起已有独立的 720P／1080P 选择，切集、缓存和恢复会保持。下载默认画质的自动、720P、1080P 是另一组设置，不能替代在线选择，也不能让缺少对应片源的分集自动变成高清。

2.2 调整了播放器控件隐藏：鼠标移出播放区或切换应用时立即开始淡出，暂停、菜单、拖动和键盘操作等情形保留控件。检查这一行为时，不要把它和播放黑屏、解码卡顿或网络中断混为一项修复。

小窗、置顶、横竖布局和 0.25—4 倍速仍可使用，自动连播也可以关闭。下一集预缓存会使用网络；如果只是想验证当前一集，先确认当前分集的播放与画质，不必同时开启更多保存任务。

图示为 hongguo-drama 1.6 的导航布局，不展示 2.3 新换源控件，也不能据此验证本次修复结果。

验证第三层：剧库、文件路径和队列

hongguo-drama 后续版本支持更改目录后定位已经登记过的文件，但修改下载目录不等于把磁盘上的视频全部移动。2.2 起启动时不再全量扫描历史目录，未登记的旧视频可用“下载管理 → 展开工具 → 扫描下载目录”补登记。

剧库里没有条目时，先检查原文件是否仍在、目录是否选对，再决定是否扫描或重新保存。清理列表、删除任务记录和删除视频不是同一个动作，“看完自动删”默认关闭，不需要为升级主动打开。

队列默认并发三，可在一到十之间调整，更高并发可能遇到来源限流。红果传输中断在即时恢复失败后，最多追加三轮，间隔 10、30、60 秒；取源暂不可用则按 3、8、15 分钟等待，两类情况共用三轮次数。

下载管理能查看等待重试、轮次和预计时间，也能立即重试或停止。它保留原画质并保护已完成文件，但不能一概宣称失败任务会按原字节续传。磁盘满、无写入权限或安全拦截，应先处理这些原因，反复等待网络重试不能解决目录权限问题。

已有本地分集可合并 MP4，原分集保留，缺集不会自动补齐。需要兼容 H.264 转码时会多占用时间与空间，不能称为无损拼接。在线播放也可能产生临时文件，检查容量时应一起考虑缓存与待合并文件。

核对旧版操作习惯与网络初始化

渠道有数默认 Ctrl+Shift+B 会隐藏窗口并暂停，恢复后保留位置和倍速；原来手动暂停的内容，恢复窗口后仍应暂停。可以用这项旧操作核对设置是否仍符合自己的习惯，快捷键也可在设置中调整，不能把隐藏窗口与完整退出程序混淆。

播放器右侧“查找其他季”会按标题给出候选，需要核对完整剧名、季数与版本。选中后从对应条目第一集开始，候选也可能不齐；它不能替你判断剧情进度，更不能当作自动把本机历史迁移到新条目的操作。原来正在看的剧，应从历史或剧库确认续播位置后再切换。

hongguo-drama 的网络初始化也有时间和失败边界：初始化超时后会报告失败阶段并退出该流程，不能假定会悄悄改用直连。应用更新检测后续还加入过备用官方地址等处理，但检测更新、下载更新与安装是分开的，看到提示不能直接作为安装完成证据。

追剧检查需要应用运行，新集检查与续季查找也有各自周期，不能当成退出后仍在运行的即时服务。升级后先确认通知设置、应用运行状态和原剧条目，避免把暂时没有提醒当成目录请求修复无效。

服务未就绪与反馈信息

渠道有数提示播放服务未就绪时，先等约一分钟，再到“设置 → 播放服务”检查连接。仍未连接，从通知区域托盘退出后重开；只关窗口不算完整退出，检查入口也不等于重启服务。

反馈问题时保留项目名称、完整版本、系统与架构、安装版或便携版、启动文件位置，以及错误发生在搜索、目录、取址、播放还是保存。再补充其他剧集是否可用、重开后是否复现，比只写“新版不能用”更方便定位。

两款软件都不会同步手机账号历史；hongguo-drama 明确不提供付费分集解锁。hongguo-drama 的追剧检查仅在应用运行时执行，系统通知默认关闭；软件许可也不等于剧集再传播授权。

2.3 固定说明未完成本轮实际视频播放验收，实体 Windows、Intel Mac、干净环境 Gatekeeper 与长期播放仍有未覆盖项，本文不把这些情况写成已通过实测。

获取更新包

百度网盘下载

提取码：5mm6

夸克网盘下载