ECHO 文档
ECHO Next 不是一个空壳播放器。它是一套面向本地音乐库的桌面音乐工作台：负责扫描和整理你的本地文件，稳定播放不同格式的音乐，管理歌词、MV、远程来源、下载任务、插件扩展，并把音频输出链路尽量讲清楚。
这份文档给实际使用者看。你不需要先理解代码结构，也不需要知道所有音频术语；先按“安装、导入、播放、排查”的路径跑通，再逐步了解 HiFi 输出、DSP、远程曲库和插件。
如果是功能使用问题，请优先看这份文档和对应页面；安装、导入、播放、输出、插件、主题和常见排查都已经按使用场景整理好了。现在人工智能这么强大，如果实在不会操作，也可以把相关文档链接、你的系统环境和遇到的问题交给人工智能辅助理解。
常用 AI 助手入口：豆包 / DeepSeek / ChatGPT / Claude
| 你现在想做什么 | 推荐入口 |
|---|---|
| 下载并安装 ECHO Next | 安装与下载 |
| 第一次打开软件，不知道先点哪里 | 快速开始 |
| 想系统看完整使用教程 | 用户教程 |
| 想导入、整理、维护本地曲库 | 曲库管理 |
| 想调输出设备、WASAPI、ASIO、bit-perfect | 音频输出 |
| 想理解 EQ、DSP、削波和 Headroom | EQ 指南 |
| 想连接 WebDAV、Jellyfin、Emby 等来源 | 远程来源 |
| 想写插件或看权限边界 | 插件创作指南 |
ECHO Next 关注什么
Section titled “ECHO Next 关注什么”本地曲库优先
Section titled “本地曲库优先”ECHO Next 的核心是你的本地音乐文件。它会把文件夹、歌曲标签、专辑、艺术家、封面、歌词和播放记录组织起来，让大曲库不只是“能打开”，而是能长期管理。
在线搜索、远程来源、下载器和网络元数据都是扩展能力。它们可以补充曲库，但不应该替代本地音乐库本身。
播放稳定优先
Section titled “播放稳定优先”播放器最重要的是稳定发声。扫描、封面缓存、远程同步、下载和插件任务都应该围绕播放体验服务，而不是抢走播放链路。
如果你遇到无声、爆音、半速、卡顿、切歌失败，先看 快速开始 和 音频输出 里的基础排查，不要一上来重建数据库。
输出可解释优先
Section titled “输出可解释优先”ECHO Next 会尽量说清楚当前声音有没有被处理：EQ、ReplayGain、变速、声道工具、重采样、WASAPI 共享输出都会影响 bit-perfect 判断。你可以选择更好听，也可以选择更原生，但界面不应该把处理过的声音伪装成原生直通。
常用文档路径
Section titled “常用文档路径”| 场景 | 文档 |
|---|---|
| 安装、下载、GitHub Release | 安装与下载 |
| 首次导入一个小曲库 | 快速开始 |
| 日常使用完整教程 | 用户教程 |
| 本地曲库、文件夹、标签整理 | 曲库管理 |
| 远程音乐库 | 远程来源 |
| Spotify 登录相关 | Spotify OAuth 配置 |
| 音频输出、设备、模式 | 音频输出 |
| EQ / DSP 工作台 | EQ 指南 |
| 插件和权限 | 插件创作指南 |
| 主题和外观 | AI 主题生成指南 |
| 常见故障 | 设置与排障 和 常见问题 |
| 工程构建和维护 | 工程文档 |
新用户建议路线
Section titled “新用户建议路线”- 先看 安装与下载，确认你拿到的是最新版本。
- 按 快速开始 导入一个小文件夹，不要一上来扫完整大盘。
- 确认能播放、能看到封面、能搜索歌曲。
- 再导入完整曲库。
- 需要更高级输出时，再看 音频输出 和 EQ 指南。
- 需要在线能力时，再配置 远程来源、下载器或插件。
如果你只想快速上手，不想读很多说明，直接从 快速开始 开始就行。