跳转到内容
ECHO Next 文档
⌂ 回到首页

歌单导入教程

ECHO 的歌单导入分成两类入口：普通流媒体歌单会导入到 Playlists / 歌单 页面；Bilibili、YouTube、SoundCloud 这类更接近“收藏表”的来源，会导入到流媒体收藏列表。两者都只是读取你提供的合法链接和账号可访问的条目，不提供下载服务，也不会绕过平台权限、会员限制或版权保护。

先选对入口

Section titled “先选对入口”

在 ECHO 里打开 Playlists / 歌单：

  1. 要导入网易云音乐、QQ 音乐、酷狗或 Spotify 歌单，用左侧的 添加流媒体歌单 输入框。
  2. 要导入 Bilibili 收藏夹、YouTube 播放列表或 SoundCloud sets，用流媒体收藏区域里的 导入收藏 输入框。
  3. 粘贴完整链接，点击添加或导入。
  4. 等待导入完成后，在歌单列表或流媒体收藏列表里选择刚导入的项目。
  5. 如果歌单很大，第一次读取需要分页拉取，等待时间会比普通本地歌单长。

不要把两类入口混用。YouTube 播放列表、Bilibili 收藏和 SoundCloud sets 不走普通“添加流媒体歌单”入口；网易云、QQ、Spotify 歌单也不走“导入收藏”入口。

普通歌单：网易云、QQ、Spotify

Section titled “普通歌单：网易云、QQ、Spotify”

网易云音乐

Section titled “网易云音乐”

网易云歌单常见可用格式：

  • https://music.163.com/#/playlist?id=123456789
  • https://music.163.com/playlist?id=123456789
  • 分享文案里带有 music.163.com 的完整链接
  • 电台 / 播客链接，例如 https://music.163.com/djradio?id=990232286

注意事项：

  • 链接里需要能看到 id=，或者路径里能识别出歌单 ID。
  • 如果链接来自手机 App，优先复制“分享链接”而不是只复制歌单名。
  • 私密歌单、地区限制内容、账号不可访问内容，可能读取不到或只能读到部分曲目。
  • 歌单里的曲目能不能播放，仍然取决于当前来源、版权状态、账号和网络。

QQ 音乐

Section titled “QQ 音乐”

QQ 音乐链接格式最多，导入失败时优先检查这一段。ECHO 会尽量识别移动端、桌面端、旧版网页、hash 参数、复制分享文案和部分跳转链接，但链接里必须能解析出数字歌单 ID。

常见可用格式：

  • https://y.qq.com/n/ryqq/playlist/778899
  • https://y.qq.com/n/yqq/playlist/7177076625.html
  • https://i.y.qq.com/n2/m/share/details/taoge.html?id=9102222552
  • https://i2.y.qq.com/n3/other/pages/details/playlist.html?id=9718644800
  • https://y.qq.com/musicmac/v6/playlist/detail.html?id=7177076626
  • https://y.qq.com/portal/playlist.html#id=9718644801
  • https://c6.y.qq.com/base/fcgi-bin/u?__=... 这类短分享链接
  • 一整段 QQ 音乐分享文字，只要里面包含完整 https://... 歌单链接
  • 带嵌套跳转参数的链接，例如参数名是 url、redirect、jumpurl、link 或 shareUrl

QQ 导入时最容易踩的坑：

  • 不要只复制歌单标题、歌单作者名或截图，必须复制完整链接。
  • 不要手动删掉 id、disstid、dissid、dirid、tid、playlistId 这类参数。
  • QQ 的短链接可能需要先解析跳转，网络或代理异常时会失败；失败后建议重新从 QQ 音乐里复制一次完整分享链接。
  • 如果链接打开后是单曲、专辑、MV、搜索页或用户主页，不是歌单页，ECHO 不会把它当作歌单导入。
  • 歌单 ID 通常是一串数字；如果链接里完全没有数字歌单 ID，基本无法导入。
  • QQ 歌单详情接口偶尔会返回空列表或拒绝请求，这时先在浏览器确认歌单可公开访问，再换网络或稍后重试。

推荐复制方式：

  1. 在 QQ 音乐里打开目标歌单详情页。
  2. 使用分享功能复制链接，不要从地址栏手工截短。
  3. 如果拿到的是 c6.y.qq.com 短链接，可以直接粘贴；如果失败，再打开短链接后复制最终落地页地址。
  4. 粘贴到 ECHO 的 添加流媒体歌单 输入框。
  5. 导入后在歌单页检查曲目数量和封面是否符合预期。

Spotify

Section titled “Spotify”

Spotify 支持的歌单链接：

  • https://open.spotify.com/playlist/5MFN2Ep3ZU2FIQWIXNSLrT
  • spotify:playlist:5MFN2Ep3ZU2FIQWIXNSLrT

Spotify 需要额外注意：

  • 先完成 Spotify OAuth 配置，并使用你自己的 Spotify Client ID 登录。
  • Spotify 播放走官方播放器 / Connect 路线，通常需要 Premium；ECHO 不会提供可下载音频 URL。
  • Spotify Web API 对某些歌单曲目列表有权限限制。非创建者或非协作者歌单可能会提示无法读取曲目列表。
  • 如果遇到“只有创建者或协作者可读取”的提示，先在系统浏览器打开歌单，把它复制到自己的 Spotify 账号，再导入新歌单链接。
  • Development Mode 下，Spotify App 可能只允许白名单用户登录；公开使用需要在 Spotify Dashboard 里处理配额和用户权限。

特殊收藏：Bilibili、YouTube、SoundCloud

Section titled “特殊收藏：Bilibili、YouTube、SoundCloud”

这些来源在 ECHO 中更像“流媒体收藏表”，不是普通长期歌单。它们会记录来源、收藏表名称和读取到的条目，适合把视频平台或 SoundCloud 的列表作为一个可浏览集合保存。

Bilibili 收藏

Section titled “Bilibili 收藏”

支持的是 Bilibili 用户收藏夹，不是普通合集、频道页或单个视频页。链接里需要能识别收藏夹 ID，例如：

  • https://www.bilibili.com/medialist/detail/ml123456789
  • https://space.bilibili.com/123456/favlist?fid=987654321
  • 带 fid、media_id 或 mediaId 参数的收藏夹链接

注意事项：

  • 私密收藏夹、账号不可访问的收藏夹或需要登录状态的内容，需要先在设置里的 Bilibili 账号区域登录并同步。
  • ECHO 读取的是收藏夹条目，不是 Bilibili 用户所有收藏的总集合。
  • 如果链接打开后不是收藏夹页面，而是单个视频、动态或个人主页，导入会失败。

YouTube 播放列表

Section titled “YouTube 播放列表”

支持的是 YouTube playlist，典型格式：

  • https://www.youtube.com/playlist?list=PLxxxxxxxx
  • https://www.youtube.com/watch?v=VIDEO_ID&list=PLxxxxxxxx

注意事项：

  • 链接里必须有 list= 播放列表 ID。
  • 普通单个视频链接没有 list= 时不能作为播放列表导入。
  • 私密、会员、地区限制、年龄限制或需要登录的播放列表，取决于你在设置里选择的 YouTube 浏览器 / Cookie 状态。
  • YouTube 的列表读取依赖网络和上游页面结构，失败时先确认浏览器能打开同一个列表。

SoundCloud Sets

Section titled “SoundCloud Sets”

支持 SoundCloud 的 sets / playlist 页面，常见格式：

  • https://soundcloud.com/user/sets/name
  • https://soundcloud.com/discover/sets/...

注意事项：

  • 普通 SoundCloud 单曲页面不是 sets，不会当作收藏表导入。
  • 私密、地区限制或需要登录的内容，可能需要在设置里选择浏览器 Cookie，或先登录 SoundCloud。
  • SoundCloud 不需要 Artist Pro 或开发者 API；ECHO 使用你保存的登录状态和可访问页面。

导入后怎么管理

Section titled “导入后怎么管理”

普通流媒体歌单导入后会出现在 Playlists / 歌单 列表中。你可以：

  • 像本地歌单一样打开、播放、搜索其中的条目。
  • 对已导入的远程歌单执行刷新，让 ECHO 重新读取来源列表。
  • 通过外部链接按钮回到原平台查看来源。
  • 遇到曲目不可播放时，先判断是单曲版权、账号状态、网络还是来源接口问题。

流媒体收藏导入后会出现在收藏列表中。你可以：

  • 在 Bilibili / YouTube / SoundCloud 不同收藏表之间切换。
  • 重新同步已保存的收藏来源。
  • 删除某个导入收藏表；这不会删除平台上的原收藏。

失败时按这个顺序排查

Section titled “失败时按这个顺序排查”
  1. 确认你粘贴的是完整 URL，不是歌单名、截图、短文本或单曲链接。
  2. 确认入口选对：网易云 / QQ / Spotify 用 添加流媒体歌单；Bilibili / YouTube / SoundCloud 用 导入收藏。
  3. 在浏览器里打开同一个链接，确认当前网络和账号能访问。
  4. 对 QQ 音乐，检查链接里是否有数字歌单 ID 或 id / disstid / dissid / dirid / tid / playlistId。
  5. 对 Spotify，确认 OAuth、Premium、白名单、歌单所有者 / 协作者权限。
  6. 对 Bilibili、YouTube、SoundCloud，确认需要登录的内容已经在设置里配置账号或浏览器 Cookie。
  7. 如果歌单很大，先等第一页导入完成；不要连续重复点击导入。
  8. 如果仍然失败，反馈时附上来源平台、链接格式截图、错误提示、是否使用代理、是否已登录，以及浏览器能否打开原链接。

合规边界

Section titled “合规边界”

歌单导入只是把你有权访问的列表信息同步到 ECHO。ECHO 不提供破解、下载、绕过会员、绕过地区限制、抓取私密内容或规避平台规则的能力。任何第三方脚本、灰色来源、资源站链接或侵权内容都不属于 ECHO 官方支持范围。