故障排查手册：扫不出歌、歌词找不到、设备不显示

出了问题先别慌——这款播放器的问题九成落在下面几类里。每类给按命中率排序的排查清单；都不管用时还有「最后一节」。

收藏扫不出新文件

最高频问题，完整排查顺序在 收藏扫描与更新，此处给速记版：等增量扫描 → 手动触发扫描 → 确认文件在收藏目录内 → 检查标签可读性 → 重启全量重扫。90% 的「新歌不出现」倒在第三步：文件在下载目录没挪进收藏。

歌词找不到

歌词 applet 依赖歌词脚本提供的来源，排查顺序：

1. 确认联网——离线状态歌词功能整体不可用；
2. 确认脚本：设置里看歌词脚本是否已安装并启用——默认来源（如 lyrics.ovh，3.0 起替代失效的老歌词站）覆盖主流歌曲；
3. 换源：冷门歌、中文歌在默认源没有的话，装别的歌词脚本试——不同源覆盖面差异很大（脚本管理见 脚本系统）；
4. 手动补：applet 支持直接编辑歌词，自补一次长期显示；
5. 认命边界：极冷门曲目任何源都没有——数据源问题不是播放器问题。

外接设备不显示

设备问题的排查顺序见 iPod、MTP 与 U 盘设备怎么管理：先看系统挂载（文件管理器里能不能看到）→ 再看有没有加入播放器的管理范围 → iPod 特有的是数据库识别问题（等挂载完成再刷新）。系统里都看不到的设备，播放器必然看不到——这是分界线。

播放异常（跳过/无声/卡顿）

1. 换播放器试同一文件：排除文件损坏——文件坏了解决办法是重新获取文件；
2. 查格式支持：DRM 内容、3.3 起移除的 RealMedia/Audible 属于「本来就不支持」，见 支持的音频格式；
3. 查 GStreamer 插件：缺解码器的补插件（Flatpak 版通常自带）；
4. 音量类：检查 ReplayGain 与音量设置——增益兜底行为在 3.3 变过，见 ReplayGain 是什么；
5. 动态模式跳歌：动态播放列表的规则组合出了空匹配时行为异常，先退回纯随机规则验证（biases 规则详解 的排查节）。

崩溃与闪退

1. 先升级：3.x 各版本修复了大量崩溃类 bug（3.1 修过封面管理器线程崩溃、3.2 修过收藏过滤崩溃）——旧版本遇崩，先升到当前版再说；
2. 记录场景：升级后仍崩的话，记住操作场景（打开什么界面、点了什么）；
3. 上报：项目用 KDE 的 bug 跟踪系统（bugs.kde.org 的 amarok 产品）——崩溃报告与复现步骤对开发者的价值极大，这个项目近年正需要这样的帮助。

通用恢复手段

• 配置重置：界面改乱、设置异常时，配置对话框里逐项恢复默认（快捷键有专门的「恢复默认」按钮）；
• 数据安全：评分与统计在数据库里，重装/重置前备份配置与数据目录——这是唯一真正的「不可再生资产」（评分与播放统计）；
• 重启大法：玄学但有效——扫描状态卡住、界面显示异常，重启应用解决一大半。

去哪问

官方渠道三处：KDE 社区论坛的帮助区、bug 跟踪系统、项目博客的评论区。问之前先在 新手常见问题 过一遍——高频问题基本都有现成答案。