| 设备完全看不到 MusicBee |
检查 Windows 防火墙的私有和公共网络；插件端口（默认为 9779）必须可达。防火墙更改后重启 MusicBee。 |
| 树状图中缺少某个源（播客、广播、收件箱…） |
它可能被隐藏了。在视图选项卡上，勾选该节点并确保其可见复选框已选中。 |
| 节点以错误的形状浏览 |
在视图选项卡上应用不同的发现路径 — 例如，播放列表选择扁平曲目，音乐筛选器选择专辑艺术家 → 专辑 → 曲目。 |
| 设备能看到 MusicBee 但无法播放任何曲目 |
设备的配置文件可能不正确，或者强制原生流已关闭且转码失败。在该设备的配置文件上勾选强制原生流并重试。 |
| 音频播放为静电声 / 白噪音 |
在该设备的配置文件上尝试强制 PCM 流使用小端序。如果这没有帮助，请尝试不使用 RAW PCM。 |
| 曲目之间有间隙 |
真正的无缝播放会在支持 NextURI 的设备上自动运行。如果您仍然听到间隙，则设备要么不支持它，要么其实现存在错误 — 回退到输出为连续流（保证无缝播放，但曲目信息和下一曲/上一曲控制将停止工作）。 |
| EQ / DSP / ReplayGain “不起作用” |
该设备已开启强制原生流 — 它优先于这些功能。在该设备的配置文件上取消勾选强制原生流。请参阅是否转码。 |
| 现代（2020 年及以后）设备忽略 MusicBee 的控制 |
针对声明为 MediaRenderer:2/3 的设备的修复在此分支中；它应该有效。如果无效，请捕获调试日志并提交问题。 |
| 插件已加载但无法打开配置 |
检查 MusicBee 的 ErrorLog.dat — 插件可能在加载时崩溃。删除插件的设置文件并重新配置通常可以解决此问题。 |
| 非英语语言 |
插件支持多种语言并遵循 MusicBee 的语言设置；此帮助页面目前仅提供英文版本，后续将提供翻译。 |