跳转到内容
ECHO Next 文档
⌂ 回到首页

设置与排障

排障先缩小范围，再改设置。别一上来清库、重装、删配置，或同时改一堆开关——那样很难知道真正原因。

先对现象找入口（见下表）。这页写更新、播放、远程和上报时要带什么。

现象先看
导入看不到、没声音、搜不到、专辑拆开、歌词对不上常见卡点
歌听起来变快、变慢、变调为什么我的歌曲变速了
输出模式、独占、ASIO、DSD 相关音频输出
远程库连不上、能浏览不能播远程与在线源
具体某个设置项是干什么的设置教程

上报前请截图并发报告

Section titled “上报前请截图并发报告”

反馈问题请尽量同时提供：

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

更新异常

Section titled “更新异常”

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

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

播放异常

Section titled “播放异常”

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

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

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

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

曲库异常

Section titled “曲库异常”

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

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

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

远程源和在线源异常

Section titled “远程源和在线源异常”

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

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

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

设置恢复

Section titled “设置恢复”

设置改乱了？优先恢复相关模块，别直接清空所有数据：

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