平台登录过期 token 失效重新授权步骤
表现
- 之前能播放的歌突然不能播了
- 搜索结果变少或直接空了
- Listen 1 弹出红色提示「登录已过期，请重新授权」
token 为什么会过期
各平台的 OAuth access token 有生命周期：
| 平台 | token 有效期 | refresh token 有效期 |
|---|---|---|
| 网易云 | ~30 天 | ~90 天 |
| QQ 音乐 | ~15 天 | ~30 天 |
| 咪咕音乐 | ~30 天 | ~90 天 |
Listen 1 会尝试用 refresh token 自动续期，但如果 refresh token 也过期了，就需要用户重新授权。
重新授权步骤
方式一：从弹出提示重新授权
如果 Listen 1 直接弹出了过期提示：
- 点击提示框上的「重新授权」按钮
- 浏览器打开对应平台的授权页面
- 完成授权后返回 Listen 1
- 登录状态刷新，功能恢复
方式二：手动进入账号设置
如果没有自动提示：
- 进入 Listen 1 设置 → 账号 / 平台登录区域
- 找到显示「过期」或「需要重新授权」的平台
- 点击「重新登录」按钮
- 按提示完成授权流程
方式三：清除登录状态重来
如果上述两种方法都无效：
- 在 Listen 1 设置里找到该平台的登录信息
- 点击「退出登录」
- 清除 Listen 1 本地存储中的对应 token 文件
- 重新走完整登录流程
延长有效期的技巧
定期打开 Listen 1
Listen 1 每次启动时会尝试用 refresh token 续期。每周至少打开一次 Listen 1 并使用已登录的平台，就能避免 refresh token 也过期。
使用 Gist 同步登录状态
部分社区版本支持将 token 信息同步到 Gist（官方版本不支持）。如果你跨设备使用，可以关注这类增强版本。
各平台登录的常见坑
网易云登录
- 网易云最近增加了滑块验证，登录时如果弹出滑块，手动完成即可
- 同一账号同时在多个客户端登录可能触发风控，建议 Listen 1 登录后不在网易云 App 上频繁切换
QQ 音乐登录
- QQ 音乐使用微信扫码授权最方便
- 如果扫码后长时间没反应，确认 Listen 1 和微信都在运行
咪咕音乐登录
- 咪咕音乐账号绑定了中国移动手机号的话，验证码登录最快捷
- 登录后需要额外完成一次实名验证（法律要求），否则部分曲目仍受限
token 安全性
Listen 1 的登录 token 存在本地数据目录：
- Windows：
%APPDATA%\Listen1\Local Storage\ - macOS：
~/Library/Application Support/Listen1/ - Linux：
~/.config/Listen1/
清理本地数据目录会导致全部登录丢失，需要重新授权。但 token 不会被上传到任何外部服务器（GitHub Gist 备份也不包含 token）。