桌面歌词不显示或显示歌曲名代替歌词
情况一：只有歌曲名没有歌词
Listen 1 正在播放，但歌词区域只显示歌曲名 + 歌手，没有逐行滚动的歌词文本。
可能原因与解决
原因 A：这首歌本来就没歌词
纯音乐、古典、BGM、器乐版曲目往往没有同步歌词。这是正常情况，不是 Listen 1 的 bug。
原因 B：版权平台不提供歌词接口
某些平台（如 Bilibili 的 UP 主原创、咪咕音乐的部分老歌）在公开接口里不提供歌词数据。Listen 1 拿不到就只能显示歌曲名。
原因 C：歌词 API 返回了但匹配失败
Listen 1 内部用歌曲名 + 歌手 + 专辑去各平台 API 查询歌词。如果匹配不上（比如某平台的歌手名是「周杰伦」，另一个平台是「Jay」），就会放弃显示歌词。
解决方法：手动在 Listen 1 设置 → 歌词里切换其他歌词平台，或关闭自动匹配让它用当前播放源的歌词。
原因 D：网络问题
歌词 API 也需要网络请求。如果网络不稳定，歌词请求超时也会失败。
情况二：桌面歌词浮窗不弹出
Listen 1 主界面的歌词区域有内容，但独立的桌面歌词浮窗不出来。
桌面版排查
- 检查设置是否开启：进入设置 → 歌词 → 确认「显示桌面歌词」已勾选
- 检查是否被其他窗口遮挡：桌面歌词默认位置在屏幕底部，可能被任务栏或其他全屏窗口挡住了
- 检查窗口置顶设置：桌面歌词的「始终置顶」是否开启。如果没开，切到其他应用后歌词会被覆盖
- 重启 Listen 1：Electron 的 BrowserWindow 偶尔会卡死
Chrome 插件版排查
桌面歌词在 Chrome 插件下限制很多：
- 需要固定标签页：Listen 1 插件窗口不能在后台。如果关闭了标签页，桌面歌词随之消失
- 需要「允许始终在所有网站上运行」权限：否则离开 Listen 1 页面就被停掉
- 部分浏览器禁止插件弹出独立窗口：最新版 Chrome 可能阻止插件创建独立 BrowserWindow，桌面歌词功能受限
情况三：歌词时间轴错位
歌词文字显示了，但比实际播放进度快几秒或慢几秒。
解决方法
- 切换歌词平台：同一首歌不同平台的歌词时间轴可能略有差异，换一个平台的歌词源试试
- 手动微调：部分版本在设置里提供了歌词时间轴偏移（毫秒级），可以微调对齐
- 更新到最新版本：旧版本的时间轴解析可能有已知 bug
情况四：歌词显示乱码
少数歌曲的歌词会出现乱码（如方块字、问号、乱序字符）。
这是因为歌词平台返回的编码格式与 Listen 1 内部解析不一致。目前没有通用解决方法，只能：
- 换另一个平台的歌词源
- 或等 Listen 1 新版本修复编码解析问题
关于翻译歌词
很多歌曲有双语歌词（原语种 + 中文翻译）。Listen 1 的官方版本目前只显示原语种歌词，不会自动显示翻译。
如果需要双语歌词，可以关注社区修改版，部分 Fork 增加了翻译歌词显示功能。