SunGet · 系统与安装

SunGet 的自动更新是怎么工作的?如何手动检查更新?

SunGet 通过控制中心的可信更新通道检查新版本:地址为 https://cc.jilei.cc/updates/sunget/stable/{target}/{arch}/{current_version},只允许 HTTPS。客户端会校验更新包签名、SHA-256、大小、版本号与构建号单调递增,校验不通过就拒绝下载;下载中断最多自动重试 3 次。确认安装前会先安全暂停后台任务、保存视频库,安装完成后自动重启。启动后默认在后台延迟检查一次更新,之后可以在更新弹窗里手动检查;Windows 安装器以被动模式安装(不打断你正在做的事)。

WindowsmacOS适用版本:9.13

内容核验:

操作前准备

  • 机器能访问 https://cc.jilei.cc。

分步操作

  1. 手动检查更新

    打开“软件更新”弹窗选择检查更新,界面显示“正在连接 Control Center 并检查可信更新…”。

  2. 发现新版本

    有新版本时弹窗显示新版本号与说明;没有则提示“当前已是最新版本”。

  3. 确认安装

    点击立即更新后窗口收起,主界面顶部显示下载进度,依次经过“正在下载软件更新…”“下载完成,正在验证签名和文件完整性…”“签名和 SHA-256 校验通过,正在保存视频库…”“正在安装,SunGet 将自动重启…”。

  4. 重启完成

    安装完成后 SunGet 自动重启;若上次安装未完成,下次启动会提示“上次安装未完成,当前旧版本仍可使用,请重新检查更新”。

预期结果

进度条走完后 SunGet 自动重启到新版本;关于界面版本号与 build-metadata 显示一致。

异常与解决

提示“暂时无法检查更新,请确认网络连接后重试”

可能原因:无法连接控制中心更新地址。

解决方法:确认网络可访问 https://cc.jilei.cc 后重试;SunGet 其他功能不受影响。

更新下载中途失败

可能原因:网络波动导致下载中断。

解决方法:客户端会自动进行安全重试(最多 3 次);全部失败后可稍后直接再点一次更新。

提示“更新签名验证失败”

可能原因:更新包与服务端清单不一致。

解决方法:客户端已拒绝安装且旧版本保留不变;稍后重新检查更新即可,不要从第三方渠道拿安装包覆盖。

上次更新后版本没变

可能原因:安装或重启未完成。

解决方法:重新检查更新并再次安装;旧版本和用户数据保持不变。

注意事项

  • 跳过某个版本后,后台自动检查不会再提示该版本;手动检查更新仍会看到它。
  • 更新前正在进行的下载/识别任务会被安全暂停,浏览器抓取类任务需要重启后重新捕获。