快速开始

这页给第一次打开 ECHO Next 的用户。目标不是一次把所有功能都学完，而是先确认三件事：能导入、能找到歌、能正常播放。

开始前准备

先准备一个小测试文件夹，例如：

D:\Music\Test

里面放 5 到 20 首你确定没坏的音乐文件，最好包含常见格式：

格式	为什么建议准备
MP3	最常见，适合确认基础播放
FLAC	常见无损，适合确认标签和封面
WAV / M4A	可选，用来确认更多格式

不要第一次就导入几十万文件的大目录。先用小文件夹把播放链路跑通，后面排查会轻松很多。

反馈与维护边界

ECHO Next 是开源项目，欢迎真实问题、复现步骤、日志、PR 和可验证的性能数据。为了让问题能被定位和修复，反馈前建议先准备这些信息：

需要提供	说明
复现步骤	从打开软件到出现问题，每一步尽量写清楚
日志或截图	崩溃、报错、播放失败、扫描失败都优先附日志
环境信息	系统版本、ECHO Next 版本、输出设备、驱动、曲库规模
文件或任务范围	是单首歌、某个文件夹、某类格式，还是完整曲库都异常
性能数据	卡顿、慢启动、扫描慢、内存高时，尽量提供可验证的数据

只写“我这里不行”、没有日志、没有环境、没有复现路径的问题，通常无法承诺修复。软件维护靠证据，不靠隔空猜测；如果你已经能定位问题，也欢迎直接提交 PR。

Windows 是主要支持平台。手机版在做，但不会给没有验收把握的日期。Linux 会保留基础构建和基础播放边界，请按 Linux 构建指南 自行构建和验证；暂时不承诺 arm64、Flatpak、Snap、JACK、PipeWire 原生后端、独占 bit-perfect HiFi 或大量性能优化。Linux 相关 issue 如果没有明确、可复现、对主线低风险的证据，可能不会进入优先修复队列。

macOS 暂不做官方包，也不承诺维护。作者没有稳定的 macOS 开发、签名和验收环境，不能把没法长期验证的包当作正式支持。

1. 下载并安装

1. 打开 下载页面。
2. 确认页面显示的是最新版本。
3. 如果你想核对发布源，可以打开 GitHub Releases。
4. 下载 Windows 安装包。
5. 安装并启动 ECHO Next。

下载和安装细节见 安装与下载。

2. 导入测试文件夹

1. 打开 ECHO Next。
2. 在左侧找到 导入文件夹。
3. 点击导入入口。
4. 在系统文件选择窗口里选中刚才准备的小文件夹。
5. 确认导入。
6. 等待扫描开始。
7. 扫描期间先不要同时启动下载器、远程同步或插件重任务。

正常情况下，导入后你应该能在 收件箱 或 歌曲 里看到这些新歌曲。

3. 检查曲库是否进来了

打开 歌曲，看这几项：

检查项	正常表现
标题	能看到歌曲名，不是一排空白
艺术家	大多数歌曲能显示艺术家
专辑	FLAC / MP3 标签正常时能显示专辑
时长	能看到歌曲时长
封面	有封面的文件能看到封面或默认占位

如果标题、艺术家、专辑全都不对，先检查源文件标签。ECHO 可以整理曲库，但不能凭空知道所有损坏或缺失的元数据。

4. 播放第一首歌

1. 在 歌曲 里找一首确定正常的 MP3。
2. 双击歌曲，或点击播放按钮。
3. 看底部播放器是否出现当前歌曲。
4. 看进度条是否向前走。
5. 听是否有声音。

判断结果：

现象	说明
进度条前进且有声音	基础播放正常
进度条前进但没声音	多半是输出设备或系统音量问题
进度条不动	可能是文件解码、播放引擎或路径问题
一播放就跳下一首	可能是文件损坏或解码失败

5. 没声音先这样排查

不要一上来清数据库。播放没声音通常和数据库无关。

按这个顺序检查：

1. Windows 系统音量没有静音。
2. ECHO Next 底部音量不是 0。
3. 当前输出设备是你正在用的耳机、音箱或 DAC。
4. 先切回 系统输出。
5. 如果你在 Windows 上想稳定播放，再试 WASAPI 共享输出。
6. 暂时关闭 EQ、ReplayGain、变速和其它 DSP。
7. 换一首确定正常的 MP3。
8. 重启 ECHO Next 再试一次。

如果这样仍然不行，再去看 音频输出。

6. 再导入完整曲库

小文件夹测试通过后，再导入完整曲库。

建议：

1. 确认音乐盘稳定在线。
2. 外置硬盘不要在扫描时拔掉。
3. NAS 或远程盘先确认网络稳定。
4. 先导入主要音乐根目录，不要把整个系统盘都扫进去。
5. 第一次扫描大曲库时耐心等待。
6. 扫描期间可以听歌，但不要同时开大量下载和远程全量索引。

首次扫描要读文件、标签、封面、时长和专辑信息。大曲库慢是正常的，只要状态还在推进，就先让它跑完。

7. 下一步看什么

已经做到	下一步
不知道“音源”该从哪导入	看 导入音源
能导入本地歌	看 用户教程
想整理专辑和标签	看 曲库管理
想调输出设备	看 音频输出
想调 EQ / DSP	看 EQ 指南
想接 WebDAV、Jellyfin、Emby	看 远程来源
想写插件或启用扩展	看 插件创作指南

最短路线

只想快点开始听歌，可以记住这条：

1. 下载最新安装包。
2. 导入一个小文件夹。
3. 打开 歌曲。
4. 播放一首 MP3。
5. 有声音后再导入完整曲库。
6. 输出异常先回到 系统输出。

先跑通，再折腾。这样最稳。