导入音源

这页只解决一个问题：你手里有音乐，或者你手里有一个来源，怎么把它放进 ECHO Next 里用。

先别急着乱点。ECHO 里大家口头说的“音源”，可能是三种完全不同的东西：

你手里有什么	去哪里操作	导入后在哪里看	先做什么
本机里的 MP3、FLAC、WAV、M4A 等音乐文件	导入文件夹	收件箱、歌曲、专辑	先导入一个小测试文件夹
NAS、WebDAV、Jellyfin、Emby、Subsonic、Navidrome 等远程音乐库	远程曲库	远程曲库，或歌曲页的远程来源切换	先测试连接，再浏览小目录
第三方插件提供的搜索音源	插件	在线搜索 里的插件音源	先看权限，再启用插件

不要把这三件事混在一起。本地文件夹不是远程曲库，远程曲库不是插件音源，插件音源也不会自动变成你的本地歌曲。

第一种：导入本地音乐文件夹

这是新手最应该先跑通的方式。你电脑里已经有音乐文件，就从这里开始。

1. 先准备一个测试文件夹

不要第一次就导入整个硬盘。先在电脑上建一个小文件夹，例如：

D:\Music\Test

往里面放 3 到 10 首确定能正常播放的歌。建议至少包含：

文件	为什么
一首普通 MP3	最容易验证基础播放
一首普通 FLAC	验证无损、标签和封面
一首带封面的歌	验证专辑墙和播放器封面

第一轮不要放这些东西：

不要放什么	为什么
整个 C:\	会扫到系统文件、软件缓存和一堆没用目录
整个下载目录	里面经常混着安装包、压缩包、临时文件
网盘占位文件	看起来在本机，实际还没下载下来
损坏文件或超冷门格式	第一轮先证明基础流程能跑通
.zip、.rar、压缩包	导入文件夹不是解压工具
歌曲快捷方式	ECHO 要读真实音频文件，不是快捷方式

2. 点左侧的 导入文件夹

1. 打开 ECHO Next。
2. 看左侧菜单。
3. 找到 导入文件夹。
4. 点它。
5. Windows 会弹出一个文件夹选择窗口。
6. 在窗口里找到刚才的 D:\Music\Test。
7. 选中这个文件夹。
8. 点 选择文件夹、确定 或类似按钮。

注意：要选文件夹，不是选里面某一首歌。你如果点进文件夹后只盯着一首歌发呆，导入窗口可能没有选中正确目录。

3. 等它扫描

导入后，ECHO 会读取文件、标签、封面、时长和格式信息，然后写入曲库索引。

扫描时先别做这些事：

1. 不要拔移动硬盘。
2. 不要移动刚导入的文件夹。
3. 不要立刻重命名一堆文件。
4. 不要同时开全量远程索引。
5. 不要一边扫描一边疯狂点重建数据库。

几首歌应该很快。大曲库慢是正常的，但测试文件夹不应该卡很久。

4. 去 收件箱 和 歌曲 检查

导入完成后按这个顺序看：

1. 打开 收件箱。
2. 看刚才导入的歌有没有出现。
3. 打开 歌曲。
4. 搜一首歌名。
5. 找一首普通 MP3。
6. 双击播放。
7. 看底部播放器有没有变成这首歌。
8. 看进度条有没有动。
9. 听有没有声音。

看到这些就算成功：

位置	正常表现
收件箱	能看到新导入的歌
歌曲	能看到标题、艺术家、时长
专辑	有专辑信息的歌能归到专辑里
底部播放器	显示当前播放歌曲
进度条	播放后会往前走
声音	耳机、音箱或 DAC 有声音

如果看不到歌，先查这些：

问题	怎么查
选错文件夹	回到 导入文件夹，确认选的是有音乐的那一层
文件夹是空的	用资源管理器打开目录，确认里面真有音频文件
网盘文件没下载	在资源管理器里先把文件下载到本机
搜索框有残留	清空 歌曲 页面搜索框
扫描没结束	等状态结束后再看
文件格式太奇怪	先用普通 MP3 / FLAC 验证

如果进度条在动但没声音，不要先动数据库。先查系统音量、ECHO 底部音量、输出设备和 设置 -> 播放。

第二种：添加远程曲库

远程曲库适合你已经有自己的服务器或网盘服务，例如 WebDAV、NAS、Jellyfin、Emby、Subsonic 或 Navidrome。

你需要先准备好这些信息：

需要什么	示例
来源类型	WebDAV、Jellyfin、Emby、Subsonic
显示名称	Home NAS、My WebDAV
服务器地址	https://example.com/dav/music/
账号	你的服务账号
密码或 token	对应服务的密码、应用密码或 token
音乐目录	服务器里真正放音乐的目录

操作顺序：

1. 打开 远程曲库。
2. 选择真实的来源类型。
3. 填一个你能看懂的显示名称。
4. 填服务器地址。
5. 填账号、密码或 token。
6. 如果有根目录选项，填音乐所在目录。
7. 先点 测试连接。
8. 测试成功后再保存。
9. 先浏览一个小目录。
10. 播放一首普通 MP3 或 FLAC。
11. 确认能浏览、能播放后，再开启索引或同步。

远程曲库第一轮不要直接全量索引整个 NAS。远程慢不一定是 ECHO 坏了，可能是网络、服务器、证书、转码、硬盘休眠或权限配置的问题。

远程连接失败时按这个顺序看：

现象	先检查
连不上	地址、端口、账号、密码、证书
能连但看不到文件	根目录、账号权限、服务端媒体库配置
能看但不能播	文件权限、转码设置、网络带宽
很慢	Wi-Fi、NAS 性能、服务端休眠、代理
只有部分文件	服务端索引、文件格式、目录权限

请只连接你有权访问和使用的内容。ECHO 不会帮你绕过付费、版权、地区、DRM 或平台访问限制。

第三种：导入插件音源

插件音源是插件提供的搜索候选和播放解析能力。它不是 ECHO 官方音源，也不是下载站入口。

你可能拿到两种东西：

你拿到什么	怎么处理
ECHO 插件包 .json	在 插件 页面使用导入入口
一个插件文件夹	放进 ECHO 插件页打开的插件目录

导入插件包

1. 打开 ECHO Next。
2. 进入 插件。
3. 找到导入插件包的入口。
4. 选择 .json 插件包。
5. 导入后先不要急着启用。
6. 点开插件详情。
7. 看它申请了哪些权限。
8. 确认来源可信后再启用。
9. 启用后看插件日志有没有报错。
10. 去 在线搜索，选择对应插件音源搜索。

放入插件文件夹

1. 打开 插件 页面。
2. 点击 打开目录。
3. 系统会打开真实插件目录。
4. 把插件文件夹放进去。
5. 回到 ECHO，点击刷新。
6. 点开插件详情。
7. 看权限。
8. 启用。
9. 看日志。
10. 到 在线搜索 里试插件音源。

不要自己猜插件目录。以 ECHO 插件页打开的目录为准。

看到这些权限要多想一下：

权限	为什么要谨慎
network	插件会访问外部网络
sources:provide	插件会提供自定义音源候选
library:read	插件会读取曲库公开字段
settings:write	插件可能修改设置
library:write	插件可能写曲库，风险更高

来源不明的高权限插件不要启用。插件音源只应该返回合法可访问的 http / https 音频 URL，不应该绕过平台授权、会员限制、版权限制或访问控制。

导入后到底去哪里找

你刚做了什么	去哪里确认
导入本地文件夹	收件箱、歌曲、专辑
重扫本地文件夹	歌曲、文件夹、对应专辑
添加远程曲库	远程曲库，以及歌曲页的远程来源切换
启用插件音源	在线搜索 里的插件音源
下载并导入歌曲	下载 任务完成后看 收件箱 或 歌曲

如果你期待在 歌曲 里看到东西，但你实际只是启用了插件音源，那是不会自动出现的。插件音源通常要在 在线搜索 里搜索，只有你明确保存、下载或导入后的内容，才会进入本地曲库。

最常见的错误

错误操作	正确做法
第一次就导入整个硬盘	先导入 3 到 10 首歌的小文件夹
把文件夹路径选错一层	选真正包含音乐文件的目录
把网盘占位文件当本地文件	先下载到本机
以为导入就是复制文件	导入主要是建立索引，源文件仍在原位置
扫描没结束就说没有歌	等扫描结束，再看 收件箱 和 歌曲
播放没声音就清数据库	先查音量、输出设备和输出模式
把远程曲库当本地文件夹导入	远程服务去 远程曲库 添加
以为插件音源是官方音乐库	插件只是第三方扩展，责任和合法性要自己确认
插件启用后找不到歌	去 在线搜索 选择插件音源，不是去本地 歌曲 硬找
连续启用一堆插件排错	一次只启用一个，先看日志

最短路线

如果你只想赶紧听到第一首歌，按这条做：

1. 建一个 D:\Music\Test 文件夹。
2. 放几首确定正常的 MP3 / FLAC。
3. 打开 ECHO Next。
4. 点左侧 导入文件夹。
5. 选中 D:\Music\Test。
6. 等扫描结束。
7. 打开 收件箱 看有没有歌。
8. 打开 歌曲。
9. 双击一首 MP3。
10. 底部进度条动、有声音，就完成。

这一套跑通之后，再导入完整曲库、添加远程曲库或启用插件音源。先把最小流程跑通，后面的排查才不会变成乱猜。