设置与排障

排障时先缩小范围，再改设置。不要一上来清库、重装、删除配置或同时改很多开关；那样很难判断真正原因。

上报前请截图并发报告

如果你要反馈问题，请尽量同时提供：

• 当前页面截图，尤其是错误提示、播放状态、输出设备、扫描进度或远程源状态。
• ECHO 版本号、系统版本、安装渠道和问题发生时间。
• 你正在做的操作步骤，例如导入文件夹、切换输出、扫描远程源、播放某个格式。
• 音频文件格式、采样率、位深、输出模式和设备型号。
• 如果页面里有诊断、日志、错误详情或复制报告按钮，请把报告一起发出。

截图和报告能让问题定位快很多。只说“不能用”“卡了”“没声音”通常不足以判断是设置、文件、驱动、网络还是程序问题。

更新异常

Windows 自动更新读取的是发布用的静态 feed，不是网页本身。先检查：

1. 你的网络能访问 GitHub Release 或当前下载镜像。
2. 当前版本号是否真的低于最新版本。
3. 杀毒软件、防火墙或公司网络是否拦截安装包。
4. 下载目录是否有权限、磁盘空间是否足够。

如果安装包下载失败，优先手动去下载页重新下载。不要为了更新问题删除曲库数据库。

播放异常

无声、爆音、半速、倍速、切歌失败或进度异常时，按这个顺序排查：

1. Windows 音量、默认输出设备和应用音量混音器。
2. ECHO 底部音量、静音状态和当前播放队列。
3. Settings -> Playback 里的输出模式，先切回 System 或 WASAPI Shared。
4. 暂时关闭 EQ、ReplayGain、变速、声道工具、重采样和自动混音。
5. 换一首确定正常的 MP3 或 FLAC。
6. 再尝试 WASAPI Exclusive、ASIO、DSD 或 HQPlayer 等高级路径。

如果歌曲听起来变慢、变快、变调，或你把 Windows 默认格式采样率拉得很高，请先看 为什么我的歌曲变速了。

第三方驱动、虚拟声卡和 ASIO 包装层不属于 ECHO 支持范围。包括但不限于 ASIO4ALL、FlexASIO、Voicemeeter、声卡厂商以外的改包驱动、系统级音效驱动和虚拟路由软件。它们可能可以工作，但 ECHO 不承诺兼容，也不会为这些驱动单独适配。

曲库异常

曲库问题通常先从小范围验证开始：

1. 新建一个只含 3 到 10 首歌的小文件夹。
2. 导入这个文件夹，确认扫描、封面、专辑分组和播放是否正常。
3. 再导入完整曲库。
4. 如果只有某张专辑显示错误，优先检查 album、albumArtist、曲序、碟号和封面标签。
5. 只有在明确需要时才执行全库重扫。

首次导入大曲库时卡顿、进度慢、CPU 或磁盘占用升高是正常现象。ECHO 需要读取文件、标签、封面、时长、编码信息并写入索引。导入期间不要同时运行大量下载、远程全量同步或其它重型后台任务。

远程源和在线源异常

远程源问题先区分三件事：

• 账号或地址是否能连上。
• 目录是否能浏览。
• 音频是否能实际播放。

WebDAV、Jellyfin、Emby、Subsonic、NAS、代理和校园/公司网络的兼容性会受服务器配置影响。远程源同步慢时，不要反复删除重建；先截图当前状态、保留错误信息，再尝试暂停、恢复或缩小同步范围。

设置恢复

如果设置改乱了，优先恢复相关模块，不要直接清空所有数据：

• 播放问题先恢复播放输出和 DSP 设置。
• 歌词问题先恢复歌词显示、在线歌词和偏移。
• 主题问题先切回默认主题。
• 曲库问题先暂停后台任务，再处理具体文件夹。

清库、删配置、重装属于最后手段。操作前请备份重要配置和本地曲库文件。