桌面歌词窗口不显示的排查步骤

症状

设置中已勾选「启用桌面歌词」，但播放歌曲时桌面歌词窗口不出现。

v5.1.0 已修复的问题

v5.1.0 更新日志中有明确修复：

修复桌面歌词窗口首次打开无歌词问题

如果你用的是旧版本，先升级到 v5.1.0 或更新。v5.1.0 还修复了歌词 IPC 高频调用、歌词缓存 IPC 通道未接入初始化、歌词组件卸载时 groupFadeTimer 未清理导致内存泄漏等多个歌词相关问题。

排查步骤（按顺序尝试）

第一步：确认设置已开启

设置 → 歌词 → 「启用桌面歌词」开关 = 已开启。

如果开启了但还是没有，继续第二步。

第二步：应用重启

先完全退出 AlgerMusicPlayer（托盘右键 → 退出，不是关闭窗口），然后重新启动。

v5.1.0 修复了一些初始化时序问题，重启能解决大部分偶发问题。

第三步：检查窗口层级

桌面歌词是 always-on-top 窗口，理论上应该在所有窗口之上。如果还是看不到：

• 检查是否被其他全屏应用遮挡（如游戏、全屏视频播放器）
• 试试用 Win + D 显示桌面看看窗口是否在那里
• 有时窗口被意外拖到屏幕边缘外，可以：设置 → 歌词 → 重置窗口位置

第四步：权限问题（安卓端）

安卓 6.0 及以上系统需要手动授予「悬浮窗显示」权限。如果 AlgerMusicPlayer 没这个权限，桌面歌词无法显示。

Windows / macOS 端不需要额外权限，系统默认允许 Electron 应用创建置顶窗口。

第五步：系统 DPI 缩放

Windows 高 DPI 缩放（125% / 150% / 200%）可能导致窗口位置计算异常。试试：

1. 把 Windows 显示缩放调回 100%
2. 重启 AlgerMusicPlayer
3. 如果恢复正常，可以在 AlgerMusicPlayer 快捷方式属性 → 兼容性 → 勾选「高 DPI 缩放执行」

第六步：重装

以上都不行 → 卸载 AlgerMusicPlayer → 手动删除用户数据目录 → 重新安装最新版。

临时替代方案

急着想用歌词可以先开沉浸式歌词（点击播放歌曲的专辑封面进入），这个功能在应用内部，不依赖独立窗口权限。