自动更新机制与手动升级步骤
更新策略总览
| 平台 | 更新方式 | 更新频率 |
|---|---|---|
| 桌面端（Win/macOS/Linux deb） | electron-updater 自动检测 | 有新版本即时提示 |
| Linux AppImage | 手动下载新版替换 | 跟随官方发版 |
| 安卓 | 手动下载 APK 覆盖安装 | 跟随官方发版 |
| 网页版 | 实时更新 | 每次访问即最新 |
桌面端自动更新（v5.1.0 起）
工作原理
v5.1.0 重构了自动更新系统，使用 electron-updater 替代之前的手动下载流程：
- 启动后定时请求 GitHub Releases API
- 有新版本时弹出通知，支持忽略该版本或立即更新
- 下载完成后重启应用完成更新
开启/关闭自动更新
设置 → 通用 → 勾选/取消「自动检查更新」。默认开启。
更新失败怎么办
如果自动更新报错：
- 检查网络连接（GitHub Releases 下载源是否可达）
- 手动去 GitHub Releases 页面下载最新版本覆盖安装
- 覆盖安装不会丢失设置和数据
手动升级步骤
桌面端手动升级与首次安装步骤相同：
- 关闭当前运行的 AlgerMusicPlayer
- 下载对应平台的最新版安装包
- 运行安装程序（.exe / .dmg / .deb）
- 覆盖安装（会自动卸载旧版本）
- 启动应用，之前的设置和歌单保留
版本兼容
- v5.x 系列内部数据格式兼容，直接覆盖即可
- 跨大版本（如 v4.x → v5.x）升级，建议先备份设置（导出 JSON），升级后如有异常可恢复
回滚
如果新版本有严重问题想要回滚：
- 去 GitHub Releases 找到上一版本
- 下载安装包覆盖安装
- v5.1.0 起 electron-updater 会跳过你手动降级的版本，直到后续新版本出现
开发预览版
官方没有单独的 Beta 通道，但有时在 GitHub Releases 的 prerelease 标签下会放预览版本。如果你想尝鲜可以手动下载，注意预览版可能有不稳定问题。