无法导入外部歌单——跨源不匹配和歌单源切换

症状

从网易云、QQ 音乐、酷狗等平台复制了歌单链接，粘贴到洛雪音乐的「打开歌单」对话框中，导入失败或无反应。

根本原因

洛雪音乐不支持跨源打开歌单。歌单源（你启用的音源脚本所属的平台）和链接来自的平台必须匹配。比如：

• 你粘贴的是网易云音乐的歌单链接。
• 但你只启用了支持 QQ 音乐的音源脚本。
• 导入失败 → 因为洛雪音乐找不到能处理这个链接的音源。

排查与解决

第 1 步：确认歌单源选择正确

在「打开歌单」对话框中，通常有一个歌单源下拉菜单或选择按钮。检查你选的歌单源是否与链接来自的平台一致：

• 网易云音乐的歌单链接 → 选「网易云音乐」作为歌单源。
• QQ 音乐的歌单链接 → 选「QQ 音乐」作为歌单源。
• 酷狗音乐的歌单链接 → 选「酷狗音乐」作为歌单源。

歌单源的选项由你当前启用的音源脚本动态决定。如果你只启用了支持网易云音乐的音源脚本，歌单源下拉菜单里可能只有「网易云」一个选项——这时候贴 QQ 音乐的歌单链接肯定导入失败。

第 2 步：确认音源脚本支持歌单获取

不是所有音源脚本都完整实现了歌单获取接口。在自定义源管理界面查看音源脚本的能力声明：

• 如果脚本声明了歌单相关能力，应该在初始化时显示。
• 如果脚本只支持歌曲搜索和播放，不支持歌单接口 → 导入歌单必然失败。

第 3 步：确认链接格式正确

确保你粘贴的是歌单详情页的完整 URL，而不是：

• 单曲链接。
• 专辑链接。
• 用户主页链接。
• 短链接（如 t.cn/xxx）。

正确的歌单链接格式示例：

• 网易云：https://music.163.com/#/playlist?id=123456789
• QQ 音乐：https://y.qq.com/n/ryqq/playlist/xxxxxxxxxx

第 4 步：确认歌单存在且公开

• 歌单没有被作者删除或设为私密。
• 歌单链接能在浏览器中正常打开。

如果原歌单已不存在，洛雪音乐当然也找不到。

第 5 步：尝试切换歌单源再导入

部分版本的「打开歌单」对话框支持切换歌单源：

1. 粘贴链接后，不着急点导入。
2. 切换到另一个歌单源试试。
3. 不同音源脚本可能对同一个歌单有不同的支持情况。

示例：网易云歌单导入的正确姿势

假设你想导入一个网易云音乐的歌单：

1. 从网易云 APP 或网页版复制歌单链接。
2. 在洛雪音乐中找到「打开歌单」入口。
3. 粘贴链接到输入框。
4. ⚠️ 关键：确保当前启用了支持网易云音乐的音源脚本。
5. 确保歌单源选择的是「网易云音乐」。
6. 点击导入。

替代方案：手动搜索添加

如果以上方法都不行（某个平台没有可用的音源脚本、或音源脚本不支持歌单接口），可以手动搬运：

1. 在原来的音乐平台上打开歌单。
2. 逐首查看歌曲列表。
3. 回到洛雪音乐中搜索每首歌。
4. 搜索到正确版本后，添加到自己的自建歌单。

这种方式虽然繁琐，但最可靠——每首歌你都确认能在洛雪音乐中正常播放。

为什么设计成跨源不兼容

洛雪音乐的歌单导入机制依赖音源脚本的实现。每个音源脚本知道如何解析自己平台的歌单链接、提取歌单 ID、请求歌单详情。但它不知道如何解析其他平台的歌单链接——网易云的脚本解析不了 QQ 音乐的链接结构，反之亦然。

这不是 Bug，是架构设计决定的——每个音源脚本只负责自己熟悉的平台。

相关阅读

• 导入外部歌单 —— 完整的歌单导入指南。
• 音源机制详解 —— 音源脚本的各接口职责。