Listen 1 版本更新检查与旧数据迁移

怎么检查最新版本

方法一：GitHub Release 页面

Listen 1 的四个产品线分别在各自仓库的 Releases 页面发布新版本：

建议收藏这些页面，每隔一两个月手动打开看看有没有新 release。

方法二：在 Listen 1 内查看

部分版本在设置 → 「关于」页面有版本号显示。可以手动对比 GitHub 上的最新 tag。

更新频率

Listen 1 是社区驱动的开源项目，没有固定的发布节奏：

• 大版本更新（功能新增、架构调整）：3~6 个月一次
• 小版本更新（bug 修复、适配平台接口变动）：1~2 个月一次
• 紧急修复（某个平台播放接口突然失效）：随时可能发新版本

V2.9.0 是最近一次比较重要的更新（引入自动切换播放源）。截至 2025 年 6 月，桌面版最新版本号在 2.x 系列。

桌面版更新步骤

Windows

1. 下载最新版本的 ZIP 压缩包
2. 关闭正在运行的 Listen 1（右键任务栏图标 → 退出，或任务管理器强制结束）
3. 将旧版本目录整个备份（重命名为 Listen1_backup）
4. 把新版本 ZIP 解压到原位置（或新位置）
5. 运行新的 Listen1.exe

macOS

1. 下载最新 DMG
2. 双击挂载镜像
3. 把 Listen 1 图标拖到 Applications 文件夹，覆盖旧版本
4. 运行新版本

Linux

• AppImage：直接下载新 AppImage，替换旧文件
• Flatpak：flatpak update io.github.listen1.Listen1
• Debian/Ubuntu：sudo dpkg -i 新版本.deb

浏览器插件更新

Chrome

1. 去 chrome://extensions/
2. 确保开发者模式已开启
3. 点击扩展管理页右上角的「更新」按钮刷新全部扩展
4. 如果是手动加载的扩展，需要下载新版本后重新加载

Firefox

• 手动加载的扩展需要重新加载新版本 XPI 文件
• 或在 about:addons 里点击齿轮 → 检查更新

升级后旧数据能不能保留

桌面版：大概率能

Listen 1 的用户数据存在独立目录，与程序分离：

不删除这个目录，升级后歌单、收藏、登录状态都会保留。

插件版：需要注意

Chrome / Firefox 扩展的存储与浏览器绑定，升级扩展本身不会清除数据。但如果：

• 手动清除了扩展数据
• 换了浏览器 / 换了浏览器配置文件
• 浏览器升级后 localStorage 被重置

数据会丢失。建议在升级前用「手动导出 JSON」做一次备份。

升级失败怎么办

覆盖安装后启动崩溃

1. 完全卸载新版本（删除程序文件）
2. 备份用户数据目录
3. 重新安装旧版本
4. 如果旧版本也崩溃了，说明用户数据有问题，用 Gist 备份恢复或手动导出的 JSON 恢复

新版本有新功能用不了

新版桌面版有时需要用户接受新的权限或数据迁移协议。首次打开新版时留意弹出的提示框。

想要回退旧版本

旧版本安装包在 GitHub Release 页面的 tag 历史里可以找到。下载旧版本覆盖安装即可。用户数据目录保持不动就不会丢歌单。

更新前的准备

升级前建议做两件事：

1. 检查 Gist 同步：确保歌单和收藏已经备份到云端
2. 手动导出 JSON：双重保险，以防升级过程中数据丢失