ECHO NEXT 用户教程

这份教程默认面向中文用户，按“打开软件后要点哪里、看到什么算正常、出问题先查哪里”的方式写。

你不需要先懂工程架构。先会导入本地歌、会播放、会找歌、会换输出设备，再逐步了解歌词、MV、DSP、远程曲库、下载器和插件。

阅读方式

如果你是新用户，建议按顺序阅读：

1. 先看“第一次使用”。
2. 再看“本地曲库”和“播放控制”。
3. 已经能稳定播放后，再看“歌词”“MV”“音频输出与 HiFi”。
4. 最后再启用“远程来源”“流媒体搜索”“下载器”“插件”。

如果你只是想找某个页面怎么用，可以直接跳到对应章节。

中文界面速查

教程里优先使用中文页面名。少数保留英文的是音频协议、文件格式、插件权限或第三方工具名，例如 WASAPI、ASIO、FLAC、ReplayGain、FFmpeg、yt-dlp。

中文名称	你要找的入口或含义
导入文件夹	把本地音乐目录加入 ECHO NEXT
收件箱	看新导入、还没整理过的歌曲
歌曲	全部歌曲主列表，日常找歌从这里开始
专辑	专辑墙和专辑详情
艺术家	按艺术家浏览曲库
播放队列	临时播放顺序
歌单	长期保存的一组歌曲
收藏	快速标记喜欢的歌
播放历史	找回最近听过的内容
在线搜索	搜索流媒体候选
下载	管理下载任务
远程曲库	WebDAV、Jellyfin、Emby、Subsonic 等外部来源
局域网播放	DLNA、AirPlay 等局域网设备
设置 -> 播放	输出设备、WASAPI、ASIO、ReplayGain、播放链路
设置 -> EQ / DSP	均衡器、前级增益、DSP 处理状态

零基础照着做

这一节把用户当成第一次打开播放器的人来写。不要急着理解所有名词，先照着做一遍，能播放、能找到歌、能调输出，就算跑通。

先记住三个地方：

屏幕位置	你看它干什么
左侧菜单	决定你现在要做什么，例如导入、找歌、看专辑、改设置
中间列表	显示当前页面的内容，例如歌曲列表、专辑列表、下载任务
底部播放器	判断有没有真的开始播放：歌名、封面、进度条、音量都在这里看

新手最容易犯的错是“点到了歌，但没有播放”。选中一首歌只是选中，真正开始播放后，底部播放器会变成当前歌曲，进度条会动。

开始前先准备好

不要一上来就把整个硬盘扫进去。先准备一个小测试目录，把最基础链路跑通。

1. 在电脑上新建一个文件夹，例如 D:\Music\Test。
2. 放 3 到 10 首确定正常的歌进去。
3. 至少放一首普通 MP3。
4. 如果你有 FLAC，也放一首 FLAC。
5. 不要先放一堆特殊格式、损坏文件、网盘占位文件。
6. 如果歌在移动硬盘里，确认硬盘已经插好。
7. 如果歌在网盘同步目录里，确认文件真的已经下载到本机，不只是云端占位。

建议测试文件这样选：

文件类型	为什么适合测试
普通 MP3	最容易播放，用来确认基础声音链路
普通 FLAC	用来确认无损文件和标签读取
带封面的专辑曲目	用来确认封面和专辑显示
不要用超冷门格式	第一轮先证明软件能正常工作，不要先挑战边界

测试目录能正常播放以后，再导入完整曲库。这样出问题时你知道是“基础播放就不行”，还是“大曲库、特殊文件、设备设置”引起的。

五分钟跑通本地播放

目标：确认 ECHO NEXT 能扫描你的本地歌曲，并且能正常播放。

1. 准备一个小文件夹，例如 D:\Music\Test。
2. 往里面放几首你确定没坏的歌，最好包含 MP3 和 FLAC。
3. 打开 ECHO NEXT。
4. 先别动设置，先看左侧菜单。
5. 在左侧找到 导入文件夹。
6. 点击 导入文件夹。
7. 系统会弹出文件夹选择窗口。
8. 在窗口里找到你刚才准备的 D:\Music\Test。
9. 选中文件夹，不要只选中里面某一首歌。
10. 确认导入。
11. 回到 ECHO NEXT，等待扫描开始。
12. 扫描期间不要马上乱点危险设置，先让它把这几个文件扫完。
13. 如果界面显示正在扫描、正在读取、正在导入，都先等一下。
14. 打开 收件箱。
15. 看看刚才那几首歌有没有出现。
16. 打开 歌曲。
17. 在歌曲列表里找到其中一首普通 MP3。
18. 双击这首歌，或者点击播放按钮。
19. 看底部播放器是否显示当前歌曲。
20. 看进度条是否开始移动。
21. 看音量是不是大于 0。
22. 听耳机或音箱有没有声音。

正常结果：

位置	正常表现
收件箱	能看到新导入歌曲
歌曲	能看到歌曲标题、艺术家、时长
底部播放器	显示当前播放歌曲
进度条	播放后会向前走
音频输出	能听到声音

如果每一项都正常，你已经完成最重要的一步：本地导入和基础播放是通的。后面再研究歌词、MV、DSP、远程库都不急。

如果看不到刚才导入的歌，先按这个顺序查：

1. 你选的是不是文件夹，而不是某个空目录。
2. 文件夹里是不是确实有音频文件。
3. 文件是不是本机真实文件，不是网盘占位。
4. 扫描是不是还没结束。
5. 收件箱 和 歌曲 都看一遍。
6. 搜索框里是不是残留了关键词，把搜索框清空。
7. 文件后缀是不是常见音频格式，例如 MP3、FLAC、WAV、M4A。

如果没有声音，先不要重建数据库。按这个顺序排查：

1. 系统音量是不是静音。
2. ECHO NEXT 底部音量是不是太低。
3. 当前输出设备是不是你正在用的耳机或音箱。
4. 换一首确定正常的 MP3。
5. 到 设置 -> 播放 把输出模式切回 系统输出 或共享输出。
6. 关闭 EQ、ReplayGain、变速。
7. 再试播放。

如果进度条不动，优先怀疑文件、路径或解码；如果进度条在动但没声音，优先怀疑音量、输出设备或输出模式。不要把这两类问题混在一起乱改。

第一轮成功后检查什么

小测试目录能播放以后，再做四个简单检查。

1. 去 歌曲，确认标题、艺术家、时长大致正常。
2. 去 专辑，确认专辑有没有出现。
3. 点一首带封面的歌，确认底部播放器有没有封面。
4. 在 歌曲 搜索框里输入歌名的一部分，确认能搜到。

检查结果这样判断：

现象	说明	先做什么
歌能播，但标题乱码	多半是源文件标签编码或标签内容问题	先看同一文件在其它播放器里的信息
歌能播，但专辑拆成好几张	专辑名、专辑艺术家、碟号不统一	后面看“想整理一张专辑怎么做”
歌能播，但封面不对	文件内嵌封面或文件夹封面可能不统一	先别清缓存，先查源文件
搜不到歌	可能搜索词不对、扫描未完成、列表过滤未清空	清空搜索和筛选，再看 歌曲

这一轮的目标不是把曲库整理得完美，而是确认软件能正常读到文件、显示出来、播放出来。

第一次导入完整曲库

目标：把你的长期音乐目录加入 ECHO NEXT。

1. 先确认你的小文件夹测试已经正常。
2. 确认完整曲库所在磁盘稳定在线。
3. 如果是移动硬盘，确认盘符不会突然变化。
4. 如果是 NAS 或同步盘，确认网络稳定。
5. 确认你要导入的是音乐根目录，不是整个系统盘。
6. 不要把 C:\、下载缓存、游戏目录、软件目录一起扫进去。
7. 打开 导入文件夹 或 文件夹。
8. 选择完整音乐根目录，例如 D:\Music。
9. 开始导入。
10. 让扫描跑完第一轮。
11. 扫描时可以看 歌曲，但不要同时启动下载器和远程全量索引。
12. 扫描时电脑变忙是正常的，尤其是第一次读大量封面和标签。
13. 扫描结束后打开 专辑。
14. 检查专辑墙是否大致正确。
15. 打开 艺术家。
16. 检查艺术家有没有明显重复或乱码。
17. 打开 收件箱。
18. 检查新导入内容。
19. 先播放几首不同格式的歌。
20. 再开始整理标签、建歌单、开歌词和 MV。

如果第一次扫描很慢，不代表坏了。首次扫描要读文件、标签、封面、时长和专辑信息。大曲库就是会花时间。

完整曲库导入后，先别急着批量修。按这个顺序看：

先看什么	为什么
歌曲 数量	确认大致扫进来了
收件箱	确认新导入内容集中在哪里
专辑	看专辑是否明显拆分
艺术家	看艺术家是否乱码或重复
随机播放几首	确认不是只有测试目录能播

如果你有几万首歌，第一天只要完成“导入、能搜、能播、能看专辑”就够了。不要第一天就批量重写标签、清缓存、重建数据库、装插件、全量远程索引一起上。

每天听歌怎么用

最简单的日常流程：

1. 打开 ECHO NEXT。
2. 进 歌曲。
3. 用搜索框找歌，或者切到 专辑 找专辑。
4. 找到想听的歌。
5. 直接播放，或者右键加入队列。
6. 想临时排一批歌，就放 播放队列。
7. 想长期保存，就放 歌单。
8. 特别喜欢，就点收藏，之后在 收藏 里找。
9. 忘记刚才听了什么，就去 播放历史。

不要把所有东西都塞进队列。队列是临时的，播放列表才是长期保存。

想整理一张专辑怎么做

目标：让专辑显示正确，曲目顺序正确，封面正确。

1. 打开 专辑。
2. 搜索专辑名。
3. 如果同一张专辑出现多份，点进去看曲目。
4. 检查每首歌的“专辑名”是否一致。
5. 检查每首歌的“专辑艺术家”是否一致。
6. 检查“曲号”是否是 1、2、3 这样。
7. 多碟专辑检查“碟号”。
8. 如果信息错了，回到 歌曲。
9. 找到这些歌曲。
10. 右键编辑标签。
11. 改完后回到 专辑 看是否合并正确。
12. 如果封面错，检查文件内嵌封面或文件夹封面。

专辑整理优先看这几个字段：

字段	为什么重要
专辑名	决定专辑名称，对应标签字段 album
专辑艺术家	决定同名专辑是否应该归到一起，对应标签字段 albumArtist
曲号	决定曲目顺序，对应标签字段 trackNo
碟号	决定多碟顺序，对应标签字段 discNo
年份	决定发行年份显示，对应标签字段 year
封面	决定专辑墙观感

想做一个歌单怎么做

目标：把一批歌长期保存起来。

1. 打开 歌曲。
2. 搜索你想加入的歌曲。
3. 选中一首或多首。
4. 右键。
5. 选择加入播放列表。
6. 选择已有歌单，或者新建歌单。
7. 打开 歌单。
8. 找到这个歌单。
9. 检查歌曲是否都在里面。
10. 之后想听这个主题时，直接从 歌单 打开。

建议歌单分类：

歌单	用途
日常听	平时最常听
新歌待整理	刚导入还没确定是否保留
耳机测试	测低频、人声、声场、齿音
高解析测试	测 Hi-Res、DSD、不同采样率
夜间听	响度稳定、不吵
车载	适合路上听

想调音频输出怎么做

目标：先保证能听，再追求更高级输出。

1. 先用默认输出播放一首确定正常的歌。
2. 有声音后再进 设置 -> 播放。
3. 找到输出设备。
4. 如果你不确定选什么，先用 系统输出。
5. 如果想更稳定的 Windows 日常输出，试 WASAPI 共享输出。
6. 如果你明确想独占设备，再试 WASAPI 独占输出。
7. 如果你有专业声卡，再试 ASIO。
8. 每切一次输出模式，都播放同一首歌确认是否正常。
9. 出现异常就切回上一个正常模式。
10. 调输出时先关闭 EQ、ReplayGain、变速。

判断是否正常：

项目	正常表现
设备	能看到你要用的耳机、音箱或 DAC
播放	点播放后进度前进
声音	没爆音、没明显卡顿、没异常加速
状态	没有持续报错
切歌	上一首、下一首正常

想看歌词怎么做

1. 先播放一首歌。
2. 打开 歌词。
3. 看是否自动出现歌词。
4. 如果没有歌词，检查歌词来源设置。
5. 如果歌词整体早或晚，调整时间偏移。
6. 如果匹配错版本，手动选择候选。
7. 如果字体太小，到歌词设置调字号。
8. 如果背景复杂看不清，打开可读性增强或调颜色。

想看 MV 怎么做

1. 先播放一首歌。
2. 点击 MV 入口或打开 MV 相关页面。
3. 等待候选结果。
4. 先选最像官方 MV 的候选。
5. 如果自动候选不对，手动选择。
6. 如果有自定义 URL，就粘贴指定视频。
7. 如果高质量内嵌播放失败，尝试外部播放。
8. 如果 HEVC、HDR、Dolby Vision 不能播，这是编码支持问题，不一定是匹配问题。

想下载一首歌怎么做

1. 打开 下载。
2. 确认输出目录。
3. 搜索关键词，或者粘贴 URL。
4. 看搜索结果标题、时长、上传者是否符合预期。
5. 点击下载。
6. 查看任务状态。
7. 等待下载、提取音频、导入曲库。
8. 完成后去 收件箱 或 歌曲 检查。

下载前请确认内容来源合法。下载器依赖网络、平台策略、FFmpeg、yt-dlp 和本机环境，失败时先看工具状态和错误信息。

想添加远程音乐库怎么做

1. 打开 远程曲库。
2. 选择来源类型，例如 WebDAV、Jellyfin、Subsonic。
3. 填显示名称。
4. 填服务器地址。
5. 填账号、密码或 token。
6. 选择同步模式。
7. 先点测试连接。
8. 测试成功再保存。
9. 先用“仅浏览”或小范围索引试用。
10. 稳定后再建立索引。

不要一上来就对巨大远程库做重任务。先确认能连接、能浏览、能播放。

想启用插件怎么做

1. 打开 插件。
2. 先看插件名称和来源。
3. 打开插件详情。
4. 看它请求了哪些权限。
5. 如果有 settings:write、library:write、network，要特别谨慎。
6. 确认可信后再启用。
7. 启用后看活动摘要和日志。
8. 如果插件报错，先禁用。
9. 如果连续启动失败，宿主可能会隔离它。

新手建议先只试示例插件，不要直接启用来源不明的高权限插件。

看不懂界面时先这样判断

这一节专门给“我不知道现在发生了什么”的情况用。不要急，先判断你在哪个页面、正在做哪类事情。

先看左侧页面

你在左侧点到	说明
歌曲	你在看歌曲列表
专辑	你在看专辑
艺术家	你在看艺术家
文件夹	你在看本地导入目录
收件箱	你在看新导入歌曲
播放队列	你在看当前临时播放顺序
收藏	你在看收藏
播放历史	你在看播放历史
歌单	你在看长期歌单
在线搜索	你在搜在线内容
下载	你在下载
远程曲库	你在配置远程库
局域网播放	你在找局域网投放设备
插件	你在管理插件
设置	你在改全局设置

再看底部播放器

底部播放器显示的是当前播放状态。判断顺序：

1. 有没有歌曲标题。
2. 有没有封面。
3. 播放按钮是播放还是暂停。
4. 进度条有没有动。
5. 音量是不是太低。
6. 有没有错误提示。
7. 当前输出设备是不是正确。

如果列表里有歌，但底部播放器没变化，说明你可能只是选中了歌曲，还没有真正开始播放。

再看右键菜单

右键菜单能告诉你当前对象是什么。

右键对象	你可能看到
本地歌曲	编辑标签、打开文件夹、复制路径、删除
远程歌曲	加队列、播放、收藏，但本地文件操作会少
专辑	播放专辑、加入队列、编辑专辑标签、保存封面
队列歌曲	从队列移除、下一首播放
插件	启用、禁用、重载、查看日志

如果某个按钮没有出现，先想想：这个对象是不是远程的？是不是当前页面不支持？是不是没有选中内容？

再看状态文字

常见状态大概这样理解：

状态	含义	你要做什么
正在加载	页面或数据还在准备	等一下，不要连续猛点
正在扫描	曲库扫描任务正在跑	等扫描完成
已排队	任务还没开始	等任务轮到它
正在下载	下载任务正在跑	看进度和速度
正在导入曲库	下载结果正在写入曲库	完成后去 收件箱 看
失败	当前任务没有完成	点开错误或看日志
已取消	任务被你或系统取消	需要的话重新开始
文件不可用	找不到文件或远程资源	检查路径、磁盘、远程来源

如果你不知道该点哪里

按目标找入口：

目标	去哪里
我要导入本地歌	导入文件夹
我要找歌	歌曲
我要按专辑听	专辑
我要看新歌	收件箱
我要临时排歌	播放队列
我要做长期歌单	歌单
我要调声音输出	设置 -> 播放
我要调 EQ	设置 -> EQ / DSP
我要调歌词	设置 -> 歌词 或 歌词
我要看 MV	播放器的 MV 入口或 MV 设置
我要下载	下载
我要连远程库	远程曲库
我要改主题	设置 -> 外观
我要看日志	设置 -> 关于 或相关诊断入口
我要做危险修复	设置 -> 危险操作，先备份

新手不要乱动的地方

这些功能不是不能用，而是要知道自己在干什么。

功能	为什么要谨慎
删除歌曲	可能影响真实文件或曲库记录
重建数据库	会影响曲库索引、扫描状态和本地记录
清理缓存	封面、临时文件或下载结果可能需要重新生成
修改插件高风险权限	插件可能改设置、读网络、写曲库
改代理	会影响歌词、MV、流媒体、下载、网络元数据
改输出模式到独占或 ASIO	可能因为设备或驱动导致无声或失败
批量标签编辑	改错会让专辑、艺术家、搜索全部乱掉
全量远程索引	大远程库可能跑很久，也可能占网络

安全做法：

1. 先小范围试。
2. 看清楚会影响什么。
3. 能备份就备份。
4. 不确定就不要点危险按钮。
5. 出问题先恢复上一步，不要连续乱改。

常见目标的最短路径

我要播放一首本地歌

1. 歌曲。
2. 搜索歌名。
3. 找到歌曲。
4. 双击或点播放。
5. 看底部播放器。
6. 有声音就完成。

我要播放一整张专辑

1. 专辑。
2. 搜索专辑名。
3. 打开专辑。
4. 检查曲目顺序。
5. 点播放专辑，或右键专辑选择播放。

我要把几首歌排到下一首后面

1. 歌曲。
2. 选中歌曲。
3. 右键。
4. 选“下一首播放”或“加入队列”。
5. 去 播放队列 检查顺序。

我要把一首歌加入歌单

1. 歌曲。
2. 找到歌曲。
3. 右键。
4. 选择加入播放列表。
5. 选择歌单。
6. 去 歌单 检查。

我要修正歌名

1. 歌曲。
2. 找到歌曲。
3. 右键。
4. 选择编辑标签。
5. 修改标题。
6. 保存。
7. 搜索新标题确认。

我要修正专辑拆分

1. 专辑。
2. 找到被拆开的专辑。
3. 记住哪些曲目应该属于同一专辑。
4. 回到 歌曲。
5. 找到这些曲目。
6. 编辑标签。
7. 统一“专辑名”和“专辑艺术家”。
8. 保存。
9. 回到 专辑 检查是否合并。

我要换输出设备

1. 插好耳机、音箱或 DAC。
2. 确认系统能识别设备。
3. 打开 设置 -> 播放。
4. 找输出设备。
5. 选择目标设备。
6. 先用“系统输出”或“共享输出”测试。
7. 播放一首歌。
8. 正常后再考虑“独占输出”或 ASIO。

我要让声音别忽大忽小

1. 打开 设置 -> 播放。
2. 找 ReplayGain。
3. 开启相关响度处理。
4. 播放几首不同专辑的歌测试。
5. 如果你要 bit-perfect，就关掉 ReplayGain。

我要让歌词晚一点或早一点

1. 播放歌曲。
2. 打开 歌词。
3. 判断歌词是早了还是晚了。
4. 打开歌词设置。
5. 调整时间偏移。
6. 调一点就播放检查，不要一次调太大。
7. 保存后再听一遍副歌确认。

我要把视频当 MV 绑定

1. 播放歌曲。
2. 打开 MV 入口。
3. 搜索候选。
4. 找最正确的视频。
5. 如果候选没有，复制视频 URL。
6. 用自定义 URL 绑定。
7. 播放确认。
8. 高规格视频不能内嵌时用外部播放。

基本概念

ECHO NEXT 不是单纯的文件打开器。它更像一个本地音乐管理系统，核心由几层组成：

概念	说明
本地文件	你磁盘上的真实音频文件，例如 FLAC、MP3、WAV、M4A
曲库	ECHO NEXT 从文件中扫描出来的 SQLite 数据库
标签	文件里记录的标题、艺术家、专辑、年份、曲号、封面等元数据
封面缓存	为列表和专辑墙生成的轻量封面文件
队列	当前临时播放顺序
播放列表	用户长期保存的歌单
远程来源	WebDAV、Jellyfin、Emby、SMB、SSHFS、Subsonic 等外部音乐库
网络元数据	从网络来源找到的候选信息，只应该补缺，不应该覆盖高可信标签
音频输出	系统输出、WASAPI、ASIO、EQ、ReplayGain 等播放链路设置
插件	本地可编辑、受权限控制的扩展脚本

本地优先

ECHO NEXT 的中心是本地曲库。远程来源、流媒体搜索、下载器、网络元数据、插件都属于扩展能力。它们应该围绕本地听歌体验服务，而不是让播放器变成完全依赖在线平台的壳。

稳定优先

播放稳定比功能数量更重要。扫描、封面生成、远程补全、下载、插件、诊断窗口都不应该抢占播放链路。

可解释优先

音频输出、bit-perfect、EQ、ReplayGain、MV 候选回退、歌词匹配都要尽量说清楚当前状态。不要把被 DSP 处理过的声音伪装成 bit-perfect，也不要把网络候选当成绝对正确的元数据。

第一次使用

推荐路线

第一次使用时，不建议立刻导入完整大曲库。更稳的路线是：

1. 准备一个小文件夹，里面放 10 到 50 首常见格式的歌。
2. 打开 ECHO NEXT。
3. 用 导入文件夹 导入这个小文件夹。
4. 在 收件箱 查看新导入歌曲。
5. 在 歌曲 搜索、排序、播放几首歌。
6. 在 专辑 检查专辑和封面是否聚合正常。
7. 打开 歌词 和 MV 看候选是否可用。
8. 进入 设置 -> 播放 确认输出设备。
9. 如果这些都正常，再导入完整曲库。

这样做的好处是：如果扫描、播放、封面、输出、歌词、MV 里有任何一环不对，你能在小范围里定位，不会一开始就被几万首歌和多个后台任务拖住。

不建议一开始就做的事

不建议	原因
一次导入整个几十万文件目录	首次扫描会很慢，问题也难定位
同时开启远程库、下载器、插件、网络补全	多条后台链路叠在一起，不容易判断问题来源
外置硬盘没稳定连接就扫全库	容易产生缺失、不可访问、扫描失败等状态
歌词和 MV 不准就立刻认为程序坏了	自动匹配依赖元数据和网络来源，天然存在误差
播放异常时直接重建数据库	播放问题多数不需要动数据库

页面总览

页面	主要用途	最常用操作
导入文件夹	导入本地音乐文件夹	选择目录并开始扫描
文件夹	管理导入根目录	查看扫描状态、维护目录
收件箱	查看新扫描歌曲	检查新导入内容
歌曲	全曲库主列表	搜索、排序、播放、右键、标签编辑
专辑	专辑墙和专辑详情	按专辑播放、检查封面、整理专辑
艺术家	艺术家浏览	检查艺术家聚合
播放队列	当前播放队列	调整临时播放顺序
收藏	收藏歌曲	快速查看喜欢的歌
播放历史	播放历史	找回刚听过的内容
歌单	播放列表	管理长期歌单
歌词	沉浸式歌词页	看歌词、调偏移、看辅助文本
在线搜索	流媒体搜索	搜索单曲、专辑、歌手、歌单
下载	下载任务	URL 下载、搜索下载、导入曲库
远程曲库	远程来源	添加 WebDAV、Jellyfin、Subsonic 等
局域网播放	局域网播放	DLNA、AirPlay 等发现和连接
插件	插件管理	启用、禁用、查看权限和日志
设置	全局设置	播放、歌词、MV、EQ、外观、曲库、危险操作

本地曲库

本地曲库是 ECHO NEXT 的核心。曲库质量越好，搜索、专辑墙、歌词匹配、MV 匹配、播放列表和统计越可靠。

文件整理建议

推荐结构：

Music/
  Artist/
    2024 - Album Name/
      01 - Track.flac
      02 - Track.flac
      cover.jpg

不是必须这样放，但稳定的目录结构会减少后续整理成本。

建议：

1. 一个专辑文件夹里尽量放同一张专辑。
2. 同一张专辑的“专辑名”和“专辑艺术家”保持一致。
3. 多碟专辑写好“碟号”和“曲号”。
4. 不要把临时下载目录直接当长期曲库。
5. 外置硬盘和 NAS 路径尽量固定。
6. 文件名可以辅助识别，但不要只依赖文件名。

支持的常见音频格式

项目的文件关联包含大量格式，常见包括：

类型	示例
无损	FLAC、WAV、ALAC、AIFF、APE、WavPack
有损	MP3、AAC、M4A、OGG、Opus、WMA
DSD	DSF、DFF
视频或容器	MKV、MP4、MOV、WebM、MKA
其它	MPC、TAK、TTA、CAF、DTS、CUE

是否能顺利播放取决于解码工具、文件本身、封装方式和当前音频链路。

导入文件夹

入口

你可以通过这些入口导入：

1. 侧边栏 导入文件夹。
2. 文件夹 页面里的添加入口。
3. 设置 -> 曲库 里的文件夹管理区域。

导入时发生什么

导入文件夹后，ECHO NEXT 会：

1. 记录这个根目录。
2. 后台扫描目录。
3. 找出音频文件。
4. 读取嵌入式标签。
5. 读取或提取封面。
6. 写入曲库数据库。
7. 聚合专辑和艺术家。
8. 更新 歌曲、专辑、艺术家、收件箱 等页面。

扫描状态怎么看

扫描过程可能包含这些阶段：

阶段	含义
排队	等待扫描任务开始
发现文件	遍历目录，寻找音频文件
检查增量缓存	判断哪些文件没有变化
读取元数据	读取标题、艺术家、专辑、时长等
提取封面	读取嵌入封面或文件夹封面
整理专辑	聚合同一专辑和曲目顺序
写入数据库	保存扫描结果
完成	本轮扫描结束
失败 / 取消	本轮扫描未完成

大曲库导入建议

如果你的曲库很大：

1. 第一次扫描时保持磁盘在线。
2. 不要同时做大量下载、远程同步和插件批处理。
3. 扫描期间可以浏览，但尽量避免频繁切换大范围筛选。
4. 如果扫描失败，先看失败路径，不要直接重建数据库。
5. 后续扫描会尽量复用未变化文件，通常比首次快。

文件夹

文件夹 用来管理导入根目录。

适合做什么

1. 查看已经添加的音乐文件夹。
2. 添加新的根目录。
3. 判断某个目录是否还可访问。
4. 触发或观察扫描。
5. 检查哪些目录可能出错。

常见问题

现象	可能原因	建议
文件夹突然不可用	外置盘离线、盘符变化、权限变化	先恢复路径，不要急着删除
扫描很慢	首次扫描、大量封面、大量无损文件	等待完成，避免同时跑重任务
新文件没出现	没重新扫描、文件格式异常、路径不在根目录下	手动刷新或检查目录
重复出现歌曲	添加了父目录和子目录	保留一个根目录

收件箱

收件箱 是新导入内容的检查区。

适合场景

1. 刚下载了一批歌。
2. 刚复制了一张专辑。
3. 刚导入新文件夹。
4. 想快速筛查新增歌曲是否正常。

检查清单

检查项	看什么
标题	是否是正确歌名，不是文件名乱码
艺术家	是否统一
专辑	是否聚合到正确专辑
封面	是否显示正确封面
时长	是否异常为 0 或明显不对
播放	是否能正常播放
格式	是否符合预期

如果新导入内容质量很差，优先整理源文件标签，再重新读取或重新扫描。

歌曲列表

歌曲 是最重要的日常页面。找歌、播放、整理、排查，大多数都会经过这里。

搜索

搜索适合找：

1. 歌曲标题。
2. 艺术家。
3. 专辑。
4. 某些版本关键字。

建议：

1. 大曲库里优先搜索，不要纯靠滚动。
2. 搜索不到时检查标签，不要只看文件名。
3. 如果艺术家或专辑字段为空，搜索效果会下降。

排序

排序	适合用途
默认排序	日常浏览
创建时间正序 / 倒序	找新导入或旧导入
歌曲名 A-Z / Z-A	按标题整理
音乐时间短到长 / 长到短	找异常短音频、长音频、整轨
文件修改时间旧到新 / 新到旧	找最近改过的文件
歌曲质量 / 大小	找高规格或异常小文件
常听歌曲	找播放频率高的内容
随机排序	打散浏览
按艺术家	检查艺术家聚合
按专辑	检查专辑字段
最近更新	查看最近扫描变化

本地和远程来源切换

歌曲页可以在本地曲库和远程来源之间切换。区别是：

来源	能做什么	限制
本地	播放、编辑标签、打开文件夹、复制路径、删除、封面操作	依赖本地文件存在
远程	浏览、播放、加入队列、收藏、加入歌单	不一定能编辑标签或打开本地路径

如果你在远程歌曲上看不到某些右键操作，这是正常边界。

多选

多选适合：

1. 批量加入队列。
2. 批量加入播放列表。
3. 批量收藏。
4. 批量从队列移除。

不建议对大量文件一次性做高风险修改。尤其是删除、标签写入、重读标签这类动作，最好分批确认。

重复歌曲筛选

重复歌曲筛选适合清理：

1. 同一文件复制了多份。
2. 同一首歌不同码率。
3. 同一专辑重复导入。
4. 下载目录和正式曲库重复。

但这些不一定是重复：

1. 现场版。
2. Remaster。
3. Radio Edit。
4. Instrumental。
5. Cover。
6. 不同语言版本。
7. 专辑版和单曲版。

删除前至少对比路径、时长、码率、专辑和文件大小。

右键菜单

本地歌曲常见右键动作：

操作	说明	风险
加入播放列表	保存到长期歌单	低
下一首播放	插入到当前播放后	低
加入队列	加到队列末尾	低
收藏 / 取消收藏	改变喜欢状态	低
编辑标签	修改曲库或文件标签	中
重新读取嵌入式标签	用文件标签刷新曲库记录	中
打开 osu! timing	查看或调整 timing	低到中
跳到专辑	打开专辑详情	低
在文件夹中显示	打开系统文件夹	低
复制路径	复制本地路径	低
用系统打开	交给系统默认程序	低
复制歌名和艺术家	用于搜索或分享	低
复制 / 保存封面	导出封面素材	低
删除歌曲	删除或移除歌曲	高

标签编辑

标签编辑会影响曲库显示，某些情况下也可能写回文件标签。

建议字段规则：

字段	建议
歌名	只写歌曲标题，不要塞艺术家
艺术家	参与演唱或主要艺人
专辑名	同一张专辑保持一致
专辑艺术家	同一专辑尽量统一
年份	用发行年份，不要随意混入日期文本
曲号	曲号写数字
碟号	多碟专辑写碟号
风格	可以粗略，不要写太碎

歌曲列表排查

问题	先检查
歌找不到	是否导入目录、是否扫描完成、标签是否为空
标题乱码	源文件标签编码或文件名来源
专辑拆分	专辑名 / 专辑艺术家是否一致
封面不显示	文件是否有封面、文件夹是否有 cover/front 图片、缓存是否生成
播放失败	文件是否存在、格式是否可解码、输出设备是否正常
右键少选项	是否远程歌曲、是否当前上下文不支持

专辑墙

专辑 是按专辑浏览的主入口。

适合做什么

1. 按专辑听歌。
2. 检查专辑封面。
3. 整理多碟专辑。
4. 检查同名专辑是否混在一起。
5. 找缺失封面的专辑。
6. 将整张专辑加入队列或歌单。

专辑排序

专辑页支持标题、艺术家、创建时间、时长、文件修改时间、最近更新、随机等排序。常见用法：

目标	推荐排序
找最近加入的专辑	创建时间倒序或最近更新
检查标题	标题排序
检查艺术家	艺术家排序
随便听一张	随机
找异常专辑	时长排序

专辑详情

进入专辑详情后，重点看：

1. 曲目顺序是否正确。
2. 碟号是否正确。
3. 曲号是否完整。
4. 封面是否正确。
5. 艺术家和专辑艺术家是否符合预期。

专辑右键菜单

常见动作：

操作	用途
播放专辑	从头播放整张专辑
加入歌单	保存到长期播放列表
加入队列	临时加入播放顺序
收藏专辑	标记喜欢的专辑
编辑标签	修正专辑级信息
复制专辑信息	复制标题、艺术家等
复制 / 保存封面	处理封面
删除专辑	高风险，谨慎

专辑聚合错误

现象	可能原因	处理
一张专辑拆成多张	专辑名或专辑艺术家不一致	统一标签后重新读取
多个专辑混成一张	专辑名相同但专辑艺术家缺失	补专辑艺术家
曲目顺序错	曲号或碟号缺失	补曲号和碟号
封面错	单曲嵌入封面不同	统一封面或文件夹封面
年份不对	标签年份混乱	修正 year

艺术家

艺术家 适合检查艺术家聚合。

常见拆分原因：

1. Aimer 和 aimer。
2. YOASOBI 和 Yoasobi。
3. Artist feat. B 和 Artist / B。
4. 中文名和英文名混用。
5. 前后有空格。
6. 使用了不同标点。

建议先确定你希望使用哪种命名规则，再批量整理标签。

播放队列

队列是临时的播放顺序。

队列适合

1. 今天临时想听的一批歌。
2. 临时把搜索结果排在一起。
3. 测试不同格式或不同采样率。
4. 快速插入下一首。

队列不适合

1. 长期收藏。
2. 主题歌单。
3. 需要跨设备或长期维护的列表。

长期内容请使用 歌单。

使用建议

1. 临时听歌用队列。
2. 确定要长期保留时，再加入播放列表。
3. 测试音频设备时，可以建立一个专门播放列表，而不是每次手动排队。

收藏

收藏 是快速收藏。

适合：

1. 标记常听歌曲。
2. 临时收集喜欢的歌。
3. 从收藏里快速开始播放。

不适合：

1. 复杂分类。
2. 多主题整理。
3. 专辑级结构管理。

复杂整理请用播放列表。

播放历史

播放历史 记录播放过的内容。

适合：

1. 找回刚才听过但忘记收藏的歌。
2. 回看最近播放顺序。
3. 排查某首歌是否反复出问题。
4. 确认某次播放是否真的进入下一首。

歌单

播放列表适合长期整理。

推荐歌单类型

1. 日常精选。
2. 夜间听。
3. 工作背景。
4. 耳机测试。
5. 音箱测试。
6. 高解析测试。
7. 新专辑候选。
8. 车载同步。
9. 本地无损精选。
10. 某个艺人的精选。

队列和播放列表的区别

功能	适合
播放队列	临时播放顺序
歌单	长期保存和整理
收藏	快速标记喜欢
播放历史	找回播放记录

播放控制

底部播放器是全局播放控制区。

常见控件

1. 播放 / 暂停。
2. 上一首 / 下一首。
3. 进度条。
4. 音量。
5. 当前歌曲标题、艺术家和封面。
6. 队列入口。
7. 歌词入口。
8. MV 入口。
9. 输出或状态提示。

播放异常排查

现象	先检查
点播放没声音	系统音量、应用音量、输出设备
进度不走	文件是否可解码、音频宿主是否启动
突然下一首	文件是否损坏、是否提前结束、是否有解码错误
进度跳动	输出模式、设备、播放诊断
切歌卡顿	是否同时扫描、下载、远程补全、插件重任务
某些文件不能播	文件格式、封装、损坏、FFmpeg 支持

不要看到播放问题就先重建数据库。播放链路和数据库不是一回事。

歌词

歌词体验包含显示、匹配、翻译、罗马音、假名增强、偏移和样式。

歌词来源

歌词可能来自：

1. 本地 LRC。
2. 嵌入式歌词。
3. 在线歌词候选。
4. 手动选择的候选。
5. 增强来源，例如日文假名或注音辅助。

歌词设置

常见设置：

设置	用途
歌词来源	控制从哪里找歌词
时间偏移	修正整体早晚
字体	调整歌词字体
字号	调整阅读大小
行宽限制	避免长句撑爆
翻译	显示辅助翻译
罗马音	给日文等内容提供读音辅助
假名增强	在可用时显示日文假名或注音
可读性增强	提高背景复杂时的歌词可读性

歌词不同步

情况	处理
全部歌词都晚一点	增加负向或正向偏移，按实际设置方向调整
只有某几句不准	可能是歌词文件本身时间轴不准
匹配到另一首	手动选择候选
现场版对不上	找现场版歌词或手动调整
翻译和原文不成对	来源数据质量问题

日文假名和罗马音

假名、罗马音是辅助文本，不应该替代主歌词时间轴。它们适合：

1. 日文学习。
2. 看不熟悉汉字读音。
3. 跟唱。
4. 辅助理解。

如果增强来源质量不好，宁可不显示，也不要破坏主歌词。

MV

MV 功能围绕当前歌曲查找视频候选。

MV 来源和候选

MV 可能来自 Bilibili、YouTube 或其它支持来源。匹配会依赖：

1. 歌曲标题。
2. 艺术家。
3. 专辑。
4. 平台搜索结果。
5. 候选标题。
6. 视频质量和编码。

质量选择

常见质量包括 720p、1080p、1080p 60fps、4K、4K 60fps、4K 120fps 等。实际可用质量由平台返回结果决定。

注意：

1. 高质量不一定能内嵌播放。
2. HEVC、HDR、Dolby Vision 等编码可能需要外部播放器。
3. Bilibili 某些高规格流可能浏览器不支持。
4. 自动选择不一定是你想要的版本。

MV 不准怎么办

1. 手动选择候选。
2. 自定义 URL。
3. 修正歌曲标题和艺术家。
4. 对同名歌曲加上版本信息。
5. 接受部分歌曲需要手选，这是正常情况。

音频输出与 HiFi

音频输出是 ECHO NEXT 的重点之一，但也是最容易受设备环境影响的部分。

输出模式

模式	说明	适合
系统输出	使用系统默认输出	普通用户、快速排查
WASAPI 共享输出	Windows 共享输出	日常稳定播放
WASAPI 独占输出	独占设备	更直接的设备输出
ASIO	专业声卡链路	声卡、录音设备、低延迟场景
DirectSound	兼容输出	特殊设备或排查

选择建议

1. 不确定时先用“系统输出”。
2. 想稳定日常播放，用“WASAPI 共享输出”。
3. 想测试独占输出，再试“WASAPI 独占输出”。
4. 有专业声卡，再试 ASIO。
5. 遇到异常先回到“系统输出”或“共享输出”。

bit-perfect

bit-perfect 代表信号尽量未经处理地输出。以下情况通常会破坏 bit-perfect：

1. EQ。
2. 前级增益。
3. ReplayGain。
4. 变速。
5. 重采样。
6. 系统混音。
7. 某些设备驱动处理。

不要为了显示好看强行追求 bit-perfect。如果你需要 EQ 或响度统一，就接受信号被处理。

采样率

采样率状态可能涉及：

1. 文件采样率。
2. 解码输出采样率。
3. 请求输出采样率。
4. 设备实际采样率。
5. 共享模式设备采样率。

如果这些值不同，不一定是 bug。共享输出、系统混音、设备限制都会影响实际结果。

EQ / DSP

EQ 是 DSP 的一部分，用来调整声音风格。ECHO NEXT 的 DSP 不只是一个孤立的均衡器开关，它会影响信号链路、前级增益、ReplayGain、变速、bit-perfect 状态和削波风险。

最简单的判断方式是：只要你开启了 EQ、前级增益、响度统一、变速或其它处理，声音就不再是完全原生的 bit-perfect 输出。需要原生输出时，把这些 DSP 处理全部关掉，再回到“系统输出”或你确认稳定的 WASAPI / ASIO 输出模式。

基本原则

1. 从“平直”或“默认”预设开始。
2. 小幅调整。
3. 提升频段时降低前级增益。
4. 不要所有频段一起大幅提升。
5. 每种设备保存单独预设。

频段理解

频段	大致影响
低频	鼓、贝斯、厚度
中低频	温暖感、浑厚感，也容易糊
中频	人声、吉他、主体
中高频	清晰度、齿音
高频	空气感、亮度，也容易刺

常见问题

问题	处理
声音爆或破	降低前级增益
低频太轰	降低低频或中低频
人声靠后	轻微提升中频
声音刺	降低中高频或高频
想验证原始输出	关闭 EQ 和前级增益

ReplayGain 和响度

ReplayGain 用来让不同歌曲的响度更接近。

适合：

1. 随机播放不同专辑。
2. 混合播放不同年代音乐。
3. 播放来源复杂的曲库。
4. 夜间听歌避免忽大忽小。

不适合：

1. bit-perfect 验证。
2. 想保持每张专辑原始响度关系。
3. 专业对比测试。

播放速度

播放速度功能适合特殊场景，例如听播客、练习、Nightcore / Daycore 等。

注意：

1. 变速会改变音频处理链路。
2. 变速后不应视为 bit-perfect。
3. 如果播放异常，先恢复正常速度再排查。

远程曲库

远程来源用于访问不在本机磁盘上的音乐。

支持类型

类型	适合
WebDAV / AList	网盘、AList、支持 WebDAV 的服务
Jellyfin	自建媒体服务器
Emby	自建媒体服务器
NAS / SMB	局域网共享
SSHFS	SSH 文件系统
Subsonic / Navidrome	音乐服务器

添加远程来源

一般流程：

1. 进入 远程曲库。
2. 选择来源类型。
3. 填写显示名称。
4. 填写服务器地址。
5. 填写账号、密码或 token。
6. 选择同步模式。
7. 测试连接。
8. 保存。
9. 需要时开始索引。

同步模式

模式	说明	建议
仅浏览	不写入曲库索引	临时访问
建立索引	写入远程曲目索引，播放时取流	推荐
镜像缓存	未来扩展，不默认复制整库	谨慎

远程后台任务

远程来源可能产生后台任务：

1. 元数据。
2. 封面。
3. 歌词。
4. MV。
5. 时长回填。

这些任务应当低优先级运行，尤其在播放中不要抢资源。

远程排查

现象	检查
连接失败	地址、账号、密码、证书、代理、防火墙
扫描慢	服务端速度、网络、文件数量
播放卡	网络带宽、服务端响应、正在后台任务
封面不显示	远程封面权限、缓存、后台任务
文件缺失	远程路径变化、服务端索引变化

局域网播放

局域网播放 面向 DLNA、AirPlay 等局域网发现和播放能力。

使用前检查

1. 电脑和目标设备在同一局域网。
2. 路由器没有隔离设备。
3. 防火墙允许相关通信。
4. 安全软件没有拦截。
5. 多网卡环境下选择了正确网络。

发现不到设备

可能原因：

1. 设备不在同一网络。
2. 路由器开启 AP 隔离。
3. Windows 防火墙拦截。
4. 设备服务没启动。
5. 多网卡广播到了错误接口。

处理顺序：

1. 重启目标设备投放服务。
2. 确认网络。
3. 检查防火墙。
4. 刷新 ECHO NEXT。
5. 必要时重启应用。

在线搜索

在线搜索 用于在线搜索、试听和发现候选。

搜索类型

类型	用途
单曲	找具体歌曲
专辑	找整张发行
歌手	找艺术家详情
歌单	找平台歌单

质量偏好

偏好	含义
最高可用	尽量选择平台返回的最高质量
高音质	通常偏 320kbps
标准	兼容优先
无损	优先 FLAC 等无损
Hi-Res	平台可用时尝试高解析

质量偏好不是保证。平台没有对应资源、账号权限不足、网络失败时，都可能回退或失败。

为什么流媒体只能播 30 秒

如果某个平台的歌曲只能播放 30 秒，通常不是 ECHO 把声音截断了，而是平台只返回了试听片段、账号权限不足、地区版权不可用，或当前接入方式只能拿到 preview stream。

先检查这些地方：

1. 当前平台账号是否已经登录。
2. 账号是否有播放完整歌曲所需的会员、Premium、订阅或地区权限。
3. 当前歌曲在你的账号地区是否可播放。
4. 平台官方客户端或网页是否能播放完整版本。
5. ECHO 里使用的插件、账号、API 配置或外部来源是否只提供试听链接。

ECHO 只能按合法账号状态、平台返回结果和插件提供的公开 URL 播放。ECHO 不会帮你绕过会员、付费、地区、版权、DRM、访问控制或平台规则，也不会提供“把 30 秒试听变成完整歌曲”的 bypass。

如果你要的是绕过平台限制、破解会员试听、伪造账号状态或规避版权控制，请卸载 ECHO，另寻合法合规的播放方式。这类需求不属于 ECHO 的功能范围，也不会进入官方维护。

平台边界

1. NetEase、QQ Music 等更偏音乐来源。
2. Spotify 更偏账号、链接或外部生态能力。
3. SoundCloud 依赖平台公开资源。
4. Bilibili 更偏视频来源。
5. 任何平台都不承诺绕过会员或版权限制。

下载器

下载器用于 URL 下载、搜索下载和导入曲库。

页面能力

1. 粘贴 URL 下载。
2. 搜索 YouTube / Bilibili。
3. 查看任务状态。
4. 查看下载进度。
5. 查看速度和 ETA。
6. 取消任务。
7. 设置输出目录。
8. 检查 FFmpeg、yt-dlp 等工具状态。

任务状态

状态	含义
排队	等待下载任务开始
解析链接	正在识别 URL 和可下载流
下载中	正在下载文件
提取音频	正在从视频或容器里提取音频
导入曲库	正在把下载结果加入本地曲库
绑定 MV	正在把视频来源绑定到当前歌曲
完成	任务已经完成
失败	任务出错，需要看错误详情
已取消	任务已经取消

下载设置

设置	建议
音频策略	默认最佳可用
下载目录	选择空间充足、路径稳定的位置
导入曲库	想长期管理就开启
绑定 MV	想保留视频来源就开启

下载失败排查

问题	检查
搜不到	平台搜索、网络、代理、关键词
解析失败	URL 是否有效、平台是否限制
下载慢	网络、平台限速、代理
提取音频失败	FFmpeg 是否可用
导入失败	输出文件是否存在、曲库路径权限

请确认内容来源合法。

插件

插件是受控扩展能力，不是随便执行任意脚本的后门。

插件目录

插件通常放在用户数据目录下的 plugins/。每个插件是独立文件夹，包含插件清单、脚本和可选面板。

典型结构：

plugins/
  echo.example/
    echo.plugin.json
    plugin.js
    panel.html
    plugin-storage.json

启用流程

1. 打开 插件。
2. 创建示例插件或导入插件包。
3. 刷新插件列表。
4. 查看插件权限。
5. 确认可信后启用。
6. 出错时看插件日志。
7. 修改插件文件后重载。

示例插件类型

类型	说明
播放状态面板	监听播放状态，显示小面板
命令工具	注册手动执行命令
曲库脚本	读取曲库摘要，做轻量整理
自定义音源	返回搜索候选，并在播放时解析显式音频 URL

权限说明

权限	能力	风险
playback:read	读取播放状态	低
playback:control	播放、暂停、跳转	中
library:read	分页读取曲库公开字段	中
library:write	预留曲库写入能力	高
sources:provide	提供自定义音源候选和播放 URL	中
settings:read	读取设置快照	中
settings:write	写入设置	高
network	访问外部网络	高
fs:plugin	读写插件目录数据	中

插件安全建议

1. 不要启用来源不明的高权限插件。
2. 不要让插件做大量同步计算。
3. 不要让插件扫描完整曲库。
4. 插件报错先禁用，再看日志。
5. 设置写入和曲库写入属于高风险权限。
6. 自定义音源只应返回合法 http / https 音频 URL，不应绕过平台授权或触碰本地文件系统。

启用自定义音源插件后，可以在 在线搜索 页面选择“插件音源”进行搜索。ECHO 只在搜索和播放解析时调用插件，播放仍由宿主拿到显式音频 URL 后进入原有播放链路。

插件 v2 额外支持受控网络 API、歌词提供器、封面提供器和插件自有设置。网络访问必须有 network 权限，并且只能通过宿主包装的 echo.net.fetchJson/fetchText；歌词、封面和音源都只返回候选，是否应用或播放由 ECHO 决定。插件包导入会记录校验信息，覆盖已有插件时会保留旧目录备份。

设置

设置页内容很多，可以按模块理解。

通用

常见内容：

1. 语言。
2. 窗口行为。
3. 托盘行为。
4. 设置备份。
5. 自动备份。

建议开启自动备份，尤其是你经常调整设置、插件、远程来源或音频输出。

播放

管理播放相关内容：

1. 输出设备。
2. 输出模式。
3. 音频状态。
4. HQPlayer 相关设置。
5. 播放速度。
6. ReplayGain。
7. 当前播放诊断。

快捷键

快捷键分两类：

类型	说明
应用内快捷键	ECHO NEXT 聚焦时生效
全局快捷键	ECHO NEXT 不聚焦时也可能生效

常见动作：

1. 播放 / 暂停。
2. 上一首。
3. 下一首。
4. 停止。
5. 音量加减。
6. 快退快进。
7. 显示主窗口。
8. 老板键。
9. 速度调整。
10. 打开音频设置、MV 设置、歌词设置。

全局快捷键可能与系统或其它应用冲突。录制失败时换一个组合。

歌词

歌词设置集中管理：

1. 歌词来源。
2. 时间偏移。
3. 字体。
4. 辅助文本。
5. 假名增强。
6. 可读性。

MV

MV 设置管理：

1. 来源。
2. 质量。
3. 同步模式。
4. 外部播放。
5. 自定义视频。
6. 可读性增强。

集成

集成能力可能包括：

1. Last.fm。
2. Discord Presence。
3. 账号。
4. YouTube 浏览器登录信息来源。
5. 网络代理。
6. 自动更新。

代理模式通常有：

模式	说明
关闭	不使用代理
系统代理	跟随系统设置
手动代理	手动填写代理地址
PAC	使用 PAC 配置

代理会影响网络歌词、MV、流媒体、下载、元数据等功能。播放本地文件通常不需要代理。

EQ / DSP

EQ 设置集中管理：

1. 开关。
2. 10 段均衡调节。
3. 前级增益。
4. 内置预设。
5. 用户预设。
6. 保存、导入或恢复。

外观

外观设置管理：

1. 主题。
2. 自定义颜色。
3. 字体。
4. 壁纸。
5. 视频背景。
6. 动效。
7. 圆角、透明度、模糊等视觉参数。

建议：

1. 先保证文字可读。
2. 再调整装饰效果。
3. 视频背景不应该影响播放稳定。
4. UI 字体和歌词字体分开处理。

曲库

曲库设置管理：

1. 本地文件夹。
2. 网络元数据。
3. 曲库质量。
4. 重复歌曲。
5. ReplayGain 分析。
6. BPM 分析。
7. 艺术家图片缓存。
8. 数据库保护。

数据库、缓存、扫描相关操作都要谨慎。

关于

通常包含：

1. 应用版本。
2. 项目链接。
3. 日志。
4. 诊断。
5. 崩溃信息。

反馈问题前建议先看这里是否有可导出的诊断信息。

危险操作

危险区可能包含：

1. 重建数据库。
2. 修复数据库。
3. 删除数据库。
4. 清理缓存。
5. 恢复默认设置。
6. 数据库快照或恢复。

原则：

1. 能备份先备份。
2. 能小范围修复就不要全量重建。
3. 播放问题不要第一时间动数据库。
4. 不确定影响范围时先停手。

外观和桌面体验

字体

字体分两类：

类型	重点
应用 UI 字体	可读性、布局稳定
歌词字体	观感、沉浸、舞台感

不要为了歌词效果把整个应用 UI 字体改得难读。

壁纸和视频背景

壁纸和视频背景适合增强氛围，但要注意：

1. 视频背景会消耗渲染资源。
2. 最小化或隐藏时应该减少开销。
3. 播放卡顿时先关闭视频背景排查。
4. 低性能设备不要使用太重的视频背景。

网络元数据

网络元数据是补全，不是真相。

优先级建议：

1. 手动整理。
2. 嵌入式标签。
3. sidecar 或文件夹信息。
4. 网络候选。
5. 文件名兜底匹配。

网络元数据适合：

1. 缺标题。
2. 缺艺术家。
3. 缺专辑。
4. 缺年份。
5. 缺封面。

不适合：

1. 覆盖你手动整理过的字段。
2. 覆盖嵌入式高可信标签。
3. 盲目批量套用低分候选。

备份和安全

建议备份：

1. 设置。
2. 曲库数据库。
3. 插件目录。
4. 重要播放列表。
5. 长期整理过的音乐文件标签。

高风险操作前，至少确认：

1. 影响范围是什么。
2. 是否会删除文件。
3. 是否只影响缓存。
4. 是否能恢复。
5. 是否有备份。

常见排查路线

播放没有声音

1. 检查系统音量。
2. 检查 ECHO NEXT 音量。
3. 检查输出设备。
4. 切回“系统输出”。
5. 换一首确定正常的 MP3 或 FLAC。
6. 关闭 EQ、ReplayGain、变速。
7. 查看音频状态和日志。

某首歌播放失败

1. 用其它播放器播放同一文件。
2. 检查文件是否损坏。
3. 检查格式是否特殊。
4. 看是否只有这首失败。
5. 看日志是否有解码错误。
6. 必要时重新导入或重新读取标签。

曲库显示不对

1. 检查源文件标签。
2. 检查是否扫描完成。
3. 检查是否添加了重复目录。
4. 检查网络元数据是否覆盖了预期字段。
5. 重新读取嵌入式标签。
6. 不要一上来清空数据库。

封面不对

1. 检查文件嵌入封面。
2. 检查文件夹封面。
3. 检查同一专辑每首歌封面是否一致。
4. 清理或刷新封面缓存前先确认影响范围。

歌词不准

1. 看是否匹配到错误版本。
2. 手动选择候选。
3. 调整时间偏移。
4. 修正歌曲标题和艺术家。
5. 检查是否现场版、翻唱、剪辑版。

MV 不准

1. 手动选择候选。
2. 自定义 URL。
3. 修正元数据。
4. 检查平台搜索结果。
5. 接受部分歌曲需要手动绑定。

远程来源连接失败

1. 检查地址。
2. 检查账号和密码。
3. 检查证书。
4. 检查代理。
5. 检查服务端日志。
6. 检查防火墙。

下载失败

1. 检查 URL。
2. 检查平台是否限制。
3. 检查 FFmpeg 和 yt-dlp。
4. 检查代理。
5. 检查输出目录权限。
6. 检查磁盘空间。

反馈问题时请带什么

有效反馈最好包含：

1. ECHO NEXT 版本。
2. 操作系统版本。
3. 安装版、便携版还是开发模式。
4. 问题发生页面。
5. 复现步骤。
6. 预期行为。
7. 实际行为。
8. 截图。
9. 日志或诊断报告。
10. 如果是播放问题，附输出模式、设备、音频格式和是否只影响某些文件。
11. 如果是扫描问题，附文件夹类型、本地盘还是远程盘、失败路径。
12. 如果是网络问题，附代理模式、来源类型和服务端返回信息。

只说“不能用”“不好用”“卡了”通常很难修。越接近真实操作链路，越容易定位。