ECHO 提问与排错指南

这页不是客套模板，而是为了让问题能被定位。ECHO 的问题如果只靠口头描述，通常没有排查价值；截图、报错、日志、版本、复现步骤才是证据。

如果你只是想快速知道“遇到问题到底该发什么”，先看 如何解决问题。

如果你要向维护者、开发者或 AI 提问，也建议先读外部参考：《别像弱智一样提问》。ECHO 文档不会复刻那篇文章全文，但采用同一个原则：不要让别人猜上下文，直接给事实、证据、复现步骤和你已经尝试过的内容。

先说结论

请先记住这几条：

• “某某功能怎么用”“某某怎么关掉”“为什么不能用”这类没有上下文的问题会被无视。
• 只说“卡了”“坏了”“闪退了”“没声音”“你自己看着修”没有意义。
• 口头论述是最没用的。请给截图、原始报错、日志、版本号和复现步骤。
• 如果你要反馈 bug，请先去 设置 -> 通用 打开控制台，然后把报错导出或复制出来。
• 不要一边描述一边猜根因。把你看到的事实给出来，判断交给排查的人。

先打开控制台并导出报错

遇到崩溃、白屏、按钮无效、播放异常、曲库扫描异常、远程源连接失败、插件异常时，先做这件事：

1. 打开 ECHO。
2. 进入 设置 -> 通用。
3. 打开控制台或调试控制台相关开关。
4. 回到出问题的页面，重新执行一次会触发问题的操作。
5. 在控制台里复制报错，或使用导出/复制报告功能把报错发出来。

如果只说“我这里报错了”，但不发报错原文，基本无法判断。报错里的文件名、错误码、请求地址、设备名、音频格式、扫描阶段都可能是关键线索。

会被无视的问题

下面这类问题信息量太低，不适合作为反馈：

不要这样问	为什么没用
xxx 功能怎么用？	不知道你在哪个页面、想完成什么、已经点到哪一步。
xxx 怎么关掉？	不知道你说的是设置项、弹窗、播放效果、插件、远程源还是系统行为。
ECHO 不能用。	“不能用”不是现象，无法判断是安装、网络、播放、曲库还是设置问题。
播放坏了。	没有文件格式、输出模式、设备、进度条状态和错误信息。
扫描卡死。	没有曲库规模、路径类型、卡住阶段和日志。
你们自己试一下。	你本机环境、文件、设备、账号、网络都可能不同，必须给复现条件。

如果确实是使用问题，请至少说明你想完成的结果。例如：“我想关闭桌面歌词”“我想关掉自动扫描”“我想让播放输出回到系统默认设备”。这比只问“怎么关”有用得多。

最小可用反馈模板

复制下面这段，把空白处补全。补不全也要写“未知”，不要留空。

ECHO 版本：
系统版本：
安装渠道：
问题页面/功能：

我想做什么：

复现步骤：
1.
2.
3.

预期结果：

实际结果：

错误提示/控制台报错：

我已经试过：

截图或录屏说明：

如果你想让 AI 帮你整理反馈，可以直接把上面内容发给 AI，并要求它“不要猜测根因，只整理事实、复现步骤和缺失信息”。

播放和音频问题必须补充

播放问题不要只说“没声音”。请补充：

• 输出设备，例如主板声卡、USB DAC、蓝牙耳机、HDMI、虚拟声卡。
• 输出模式，例如 System、WASAPI Shared、WASAPI Exclusive、ASIO、HQPlayer、DLNA。
• 文件类型和参数，例如 MP3、FLAC、DSD、采样率、位深、声道数。
• 进度条是否在走。
• Windows 其它播放器播放同一首歌是否正常。
• 是否开启 EQ、DSP、ReplayGain、变速、声道平衡、重采样、Crossfade 或 Automix。
• 控制台报错原文。

一个有用的描述应该像这样：

ECHO 版本：26.x.x
系统：Windows 11
输出设备：USB DAC，Windows 其它播放器正常
输出模式：WASAPI Exclusive
文件：本地 FLAC，44.1 kHz / 16-bit
现象：进度条会走，但没有声音
已尝试：切回 System 有声音；关闭 EQ/DSP 后仍无声
控制台报错：……

曲库和扫描问题必须补充

曲库问题请补充：

• 是首次导入、增量扫描、重扫，还是远程同步。
• 路径类型：本地 SSD、移动硬盘、NAS、WebDAV、Jellyfin、Emby、Subsonic、云盘。
• 大约多少首歌、多少张专辑。
• 卡在哪个阶段，例如枚举文件、读取标签、提取封面、写入索引。
• 是否存在超大封面、损坏文件、特殊字符路径、非常规标签。
• 控制台报错原文。

首次导入大曲库慢不一定是 bug。ECHO 需要读取标签、封面、时长、编码信息并写入索引。请先用 3 到 10 首歌的小文件夹验证基础功能，再反馈完整曲库的问题。

远程源、云盘和插件问题必须补充

远程相关问题请说明：

• 服务类型：WebDAV、Jellyfin、Emby、Subsonic、NAS、云盘、网络电台或插件。
• 是连接失败、目录打不开、搜索失败、还是能浏览但不能播放。
• 浏览器或其它客户端能否访问同一账号。
• 是否经过代理、公司网络、校园网、内网穿透或自签名证书。
• 控制台报错原文，尤其是 HTTP 状态码、请求地址、证书错误和鉴权错误。

不要要求 ECHO 或 AI 帮你绕过会员、版权、访问控制或平台限制。ECHO 不提供盗链、侵权来源、绕权下载或规避授权的支持。

提问时要区分事实和猜测

推荐写法：

确定事实：
- 我点击了“测试连接”。
- 页面显示“连接失败”。
- 控制台出现这段报错：……

我的猜测：
- 可能和证书有关，但不确定。

我需要：
- 请先根据报错判断最可能原因。
- 请按低风险到高风险给排查步骤。
- 不要建议删除曲库或重装，除非说明为什么必须这样做。

不推荐写法：

应该是 ECHO 的网络模块坏了，你们修一下。

排错顺序

安全排错优先，不要上来就清库、删配置或重装。

1. 记录当前现象，截图或录屏。
2. 打开 设置 -> 通用 的控制台，复现一次问题。
3. 导出或复制报错。
4. 用小范围样本复现，例如一首歌、一个小文件夹、一个远程目录。
5. 只改一个设置，再观察变化。
6. 最后才考虑重置、清缓存、重扫、重装。

如果问题涉及账号、曲库、数据库、插件配置或远程源，不要听到一个建议就立刻删除数据。先确认是否可撤销，必要时备份。

最短可用版本

赶时间时，至少发这段：

ECHO 版本：……
系统：……
问题页面/功能：……
我想做什么：……
实际发生了什么：……
复现步骤：……
设置 -> 通用 打开控制台后导出的报错：……
我已经试过：……
请按低风险到高风险排查，区分确定事实和推测原因。