主题

版本更新 ​

安全提示

请务必通过官方渠道获取瓜子音乐的安装包和更新：

  • 官网下载：guazi.fun
  • 客户端内置更新：设置 -> 关于 -> 检测更新

从非官方渠道（第三方下载站、网盘分享、聊天群文件等）获取的安装包可能被篡改，存在捆绑恶意程序、植入广告、窃取账号信息等风险。瓜子音乐不会通过 QQ 群文件、私人网盘等非官方方式分发安装包。

如不确定文件来源，请对照官网公布的版本号和文件大小进行核实。

自动更新检查 ​

瓜子音乐启动 5 秒后会自动检查是否有新版本发布（静默检查）。如果有可用更新：

  1. 主界面弹窗提示发现新版本
  2. 显示新版本的改进内容
  3. 你可以选择立即更新或稍后提醒

静默检查规则

启动时的静默检查会尊重以下 localStorage 设置：

  • m7_no_update_remind：不再提醒更新
  • m7_skip_version：跳过指定版本

但**用户手动「检测更新」**不受上述限制，每次都会真正请求。

如果选择稍后提醒，该版本不会在本次会话中再次提示，但下次启动仍会检查。

跨版本跳过

如果某个版本你暂时不想更新，可以在更新弹窗中选择跳过此版本。跳过期间不会再次提醒该版本的更新。当有更新的版本发布时，仍会收到提醒。

手动检查更新 ​

  1. 进入 设置 -> 关于
  2. 点击 检测更新 按钮
  3. 系统会强制检查最新版本（不受跳过版本限制）
  4. 如果有新版本，会弹出更新弹窗

推荐操作

如果你听说发布了新版本但没收到提示，可以手动检查更新。手动检查会绕过所有"跳过"和"不再提醒"设置，每次都真正请求服务器。

更新流程 ​

  1. 在更新弹窗中点击 立即更新
  2. 程序会自动下载最新安装包
  3. 下载完成后，点击安装
  4. 程序自动关闭并启动安装程序
  5. 安装完成后重新启动瓜子音乐

更新过程注意

  • 更新过程中请勿关机或断网，以免造成文件损坏
  • 安装包下载速度取决于网络，通常 1-3 分钟
  • 如果下载失败，可以从 官网 手动下载安装包覆盖安装

更新日志 ​

新版本发布时会附带更新日志，说明：

  • ✨ 新增了哪些功能
  • 🐛 修复了哪些问题
  • 💅 改进了哪些体验

你可以在更新弹窗中查看完整的更新日志内容。

在线更新日志

访问 官网更新日志 可以查看所有历史版本的更新记录。

并发检查防护 ​

  • 使用 checkingRef 防止并发检查导致第二次无反应
  • 多次点击「检测更新」只会触发一次实际请求

常见问题 ​

更新后设置丢失？ ​

  • 正常情况下更新不会影响你的设置、收藏和歌单数据
  • 这些数据存储在独立的用户数据目录中，与程序文件分离
  • 如果出现异常，可以重新登录账号并通过云端同步恢复
  • 详见 账号与云端同步

更新失败？ ​

  • 检查磁盘空间是否充足（至少需要 500MB）
  • 检查网络连接是否正常
  • 关闭杀毒软件后重试（部分杀软会拦截更新程序）
  • 尝试退出瓜子音乐后，从 官网 手动下载最新版本覆盖安装
  • 覆盖安装不会丢失数据

不想收到某个版本的更新提醒？ ​

  • 在更新弹窗中选择 跳过此版本
  • 跳过期间该版本不会再次提醒
  • 当有更新的版本发布时，仍会收到提醒
  • 也可以勾选「不再提醒更新」完全关闭自动提醒

更新检查一直转圈？ ​

  • 检查网络连接
  • 服务器可能暂时不可达，稍后再试
  • 防火墙可能拦截了更新检查请求
  • 使用 checkingRef 防并发，重复点击不会触发新请求

如何查看当前版本号？ ​

  • 进入 设置 -> 关于 即可查看当前版本号
  • 也可以在官网对比最新版本号，判断是否需要更新