如何解决问题

遇到问题时，最重要的不是先猜原因，而是把现场保留下来。能解决问题的人需要看到完整界面、原始报错、复现步骤和你的环境信息。只给一小片截图，或者只说“这里不行”，基本等于让别人隔空算命。

先说结论

请按这个顺序准备信息：

1. 截图截完整：不要只截一个按钮、一个弹窗角落或一行红字。
2. 打开控制台：去 设置 -> 通用 打开控制台或调试控制台。
3. 复现一次问题：重新执行触发问题的操作。
4. 复制错误报告：把控制台报错、诊断报告或复制报告内容原样发出来。
5. 写清楚你做了什么：从打开页面到出现问题，每一步都写出来。

如果你只截图一小片，怕是世界上最聪明的 Claude Mythos 都无法解决。因为它看不到页面状态、看不到你点了什么、看不到报错来源，也不知道这是播放、曲库、网络、驱动、插件还是设置问题。

截图应该截什么

截图要能让别人知道“你在哪、你做了什么、软件现在是什么状态”。请尽量截完整窗口，而不是只截局部。

完整截图通常应该包含：

1. 当前页面标题或左侧导航。
2. 出错的区域。
3. 底部播放器状态，例如是否在播放、进度条是否走、音量是否静音。
4. 当前输出设备、输出模式、扫描进度、远程源状态或插件状态。
5. 弹窗、提示条、红色报错、空白区域或一直转圈的位置。
6. 如果问题和设置有关，请截到相关设置项，不要只截开关本身。

不推荐：

不要这样	为什么没用
只截一个红色感叹号	看不到它属于哪个页面、哪个功能。
只截“失败”两个字	不知道失败的是播放、扫描、登录、下载还是连接。
只截按钮	不知道按钮前后状态，也不知道你想完成什么。
只截聊天记录里的转述	转述会丢失错误码、路径、设备名和真实上下文。
只发“我这里也一样”	不知道你的系统、版本、设备和复现步骤是否一样。

如果涉及动态问题，例如闪退、卡顿、切歌失败、扫描进度卡住、MV 黑屏、远程源连接失败，录屏通常比截图更有用。

控制台报错比口头描述重要

很多问题表面看起来一样，真实原因完全不同。

比如“没声音”可能是：

1. 输出设备选错。
2. Windows 应用音量被静音。
3. WASAPI Exclusive 被其它播放器占用。
4. ASIO 驱动打开失败。
5. DSD 文件无法被当前输出链路处理。
6. DSP、ReplayGain、变速或声道设置导致异常。
7. 文件损坏或解码失败。

只说“没声音”没有排查价值。控制台里的错误码、设备名、文件路径、音频格式、请求地址、HTTP 状态码、插件名和堆栈信息，才是真正能定位问题的证据。

如何复制错误报告

遇到问题时请这样做：

1. 打开 ECHO。
2. 进入 设置 -> 通用。
3. 打开控制台、开发控制台或调试控制台相关选项。
4. 回到出问题的页面。
5. 重新执行一次会触发问题的操作。
6. 复制控制台里的报错原文，或使用页面里的复制诊断、导出报告、复制错误报告按钮。
7. 把复制出来的内容和完整截图一起发出。

如果报错很长，不要自己删改。可以折叠、打包、粘贴到文本文件里，但不要只截最后一行。很多时候真正有用的是第一条错误、错误前后的设备状态、请求 URL、文件路径或调用栈。

复现步骤要能让别人照着做

好的复现步骤应该像这样：

1. 打开 ECHO。
2. 进入 设置 -> 音频输出。
3. 输出模式选择 WASAPI Exclusive。
4. 设备选择 xxx USB DAC。
5. 播放这首 FLAC：文件名 / 格式 / 采样率。
6. 点击下一首后无声，进度条继续走。
7. 控制台出现这段报错：……

不好的复现步骤是：

我就正常用，然后它坏了。

“正常用”不是步骤。别人不知道你点了哪里、开了哪些设置、文件是什么格式、设备是什么、问题从什么时候开始。

一次只改一个变量

排查问题时，不要一边换输出模式、一边开 DSD、一边改 EQ、一边换驱动、一边重扫曲库。这样即使问题消失了，也不知道到底是哪一步起作用。

建议顺序：

1. 先保存完整截图和报错。
2. 只改一个设置。
3. 复现一次。
4. 记录结果。
5. 再改下一个设置。

播放问题先回到 System 或 WASAPI Shared。曲库问题先用 3 到 10 首歌的小文件夹复现。远程源问题先确认浏览器或原服务客户端能否访问。插件问题先禁用对应插件再看是否恢复。

不要先做高风险操作

这些操作通常不是第一步：

1. 删除数据库。
2. 清空曲库缓存。
3. 重装 ECHO。
4. 重装声卡驱动。
5. 删除插件目录。
6. 改系统权限、注册表或杀毒软件规则。

它们可能会破坏现场，让问题更难复现。除非你已经备份，或者有人根据日志明确说明为什么必须这样做，否则先不要动。

最小可用问题报告

赶时间时，至少复制这段填一下：

ECHO 版本：
Windows 版本：
问题页面：
我想做什么：
实际发生了什么：
复现步骤：
1.
2.
3.

完整截图：
控制台/错误报告：
我已经试过：

如果你想让 AI 帮你整理，也可以把上面内容发给 AI，并要求：

请不要猜测根因。请先整理确定事实、缺失信息、可能原因和低风险排查步骤。

最后一句

解决问题靠证据，不靠猜。完整截图、控制台报错、复现步骤、版本和环境信息，是让问题被快速定位的最低成本。信息越完整，修复越快；信息越碎，大家越只能围着一句“不能用”打转。