首次启动的 Spotify 授权步骤

欢迎界面三项基础设置

首次打开 Lyricify 4 会依次让你选：

语言

• 建议设为简体中文，与 Spotify 设置保持一致。华语歌曲多的时候，这个设置会提高歌词自动搜索的准确度。
• 语言可以在设置里随时改，不会影响已登录的账号。

中文翻译显示

• 勾选后，当歌词库里这首歌同时有原文和中文翻译时，会并排显示。
• 注意：开启翻译模式后，歌词标记功能暂时不可用——这是已知的限制。

预设配置

• 默认：推荐的平衡配置，不做任何阉割
• 更好的性能：关闭部分动效和特效，适合低配电脑或 Apple Music 界面卡顿的用户
• 更好的质量：打开全部特效，可能在部分电脑上出现歌词滚动掉帧

选完点继续，就进入 Spotify 授权环节。

授权完整流程

1. Lyricify 自动在系统默认浏览器里打开 Spotify 登录 + 授权页面
2. 在浏览器里登录你的 Spotify 账号（如果还没登录的话）
3. 勾选同意授权项，点 "AGREE"
4. 授权页面会跳转到 http://127.0.0.1:766/callback?... 这一类本地回调地址
5. Lyricify 监听本地端口，捕获回调里的 code，换出 access token
6. 成功后浏览器标签页会显示 "成功！Spotify 授权成功"，可以关闭
7. 回到 Lyricify 窗口，应该出现 "成功连接 Spotify" 的提示；如果看到 "授权完成，请再等待几秒"，就是正在进行服务器注册，等几秒

浏览器登录不可用时的降级方案

某些网络环境下 Spotify 授权页打开极慢或完全打不开。此时可以：

1. 在已经登录了 Spotify 的本地浏览器中，手动访问授权地址（Lyricify 设置页有）
2. 登录并授权后，把浏览器地址栏里完整的回调 URL 复制出来
3. 粘贴到 Lyricify 弹窗里的文本框，点继续

URL 必须完整（包含所有 query 参数），少一截都会报 "INVALID_CLIENT: Invalid Redirect URI"。

授权失败最常见的三种情况

INVALID_CLIENT: Invalid Redirect URI Redirect URI 没逐字对上。Lyricify 默认要求 http://127.0.0.1:766/callback，如果你自己配置过自定义 API Client，一定要回到 Spotify Developer Dashboard 里确认 Redirect URI 是不是 127.0.0.1 而不是 localhost（Spotify 在 2025 年起拒绝 localhost）。详见 自定义 API Client。

授权页加载超时网络访问 Spotify OAuth 域名不通。检查网络设置、代理配置、DNS。校园网环境下可以换手机热点试。

没有看到 "成功" 提示浏览器登录完关得太快，Lyricify 还没拿到回调 URL。授权完成后等个 2-3 秒再关标签页。