主题

洛雪（LX Music）音源 ​

瓜子音乐兼容第三方洛雪音乐（LX Music）自定义源脚本，为高音质与 VIP 歌曲取链提供更多选择。

Pro 权益

洛雪音源为 Pro 权益功能，详见 Pro 权益。非 Pro 用户无法导入或使用洛雪音源脚本。

什么是洛雪音源？ ​

洛雪音乐（LX Music）是一款开源的音乐播放器，其社区维护了丰富的自定义音源脚本。这些脚本作为第三方插件导入瓜子音乐后，可以扩展在线播放的音源渠道。

免责声明

洛雪音源为第三方社区维护，瓜子音乐仅提供兼容导入能力，不对脚本内容、可用性、版权合规性负责。请用户自行判断使用。

  • 脚本仅在本地客户端沙箱中执行
  • 不会上传个人数据
  • 瓜子音乐签名插件机制会校验内置插件完整性，洛雪音源作为外挂脚本独立运行

安装步骤 ​

1. 获取音源脚本 ​

从洛雪音乐社区获取 .js 格式的源脚本文件。常见渠道：

  • 洛雪音乐官方 GitHub 仓库
  • 社区维护的音源仓库
  • 第三方开发者分享

2. 导入瓜子音乐 ​

  1. 打开瓜子音乐，进入 设置 -> 插件 -> LX Music 音源
  2. 点击 导入音源
  3. 选择已下载的 .js 源脚本文件
  4. 提示导入成功后即可生效

防误操作

导入过程中 UI 有 busyRef 防重入，重复点击或快速连续点击不会触发多次导入。

3. 启用 / 停用 ​

  • 在 LX Music 音源设置中可随时启用或停用导入的脚本
  • 停用后在线播放将回退到默认音源
  • 禁用 / 移除脚本会 dispose() runner，清理定时器等资源

取链模式 ​

LX 音源的取链模式有三档，可在 localStorage lx_source_mode 中设置：

模式行为适用场景
fallback（默认）仅作为兜底，内置音源失败后尝试 LX日常使用
prefer优先使用 LX（6s 短超时）失败回退内置追求高音质
only屏蔽内置，仅用 LX（10s 超时）测试用途

模式限制

  • 三种模式都不会改变内置搜索逻辑
  • only 模式仅对有 LX 映射的平台（kw / kg / tx / wy / mg）生效
  • only 模式下，soda（汽水音乐）不受影响
  • only 模式下，handlePlaySong 的内置直取也会被跳过

使用效果 ​

导入洛雪音源后：

  • 搜索：搜索结果中可看到来自洛雪音源的歌曲，标注来源标识
  • 取链：高音质及 VIP 歌曲可能通过洛雪音源获取到可播放链接
  • 播放：播放逻辑与其他音源一致，支持歌词、封面、下载等完整功能
  • 标记：LX 兜底成功的曲目会标记 extra.lxSource/lxScript，队列标签显示 LX·平台，播放详情徽标显示「LX 音源」

切音质时清除标记

切换音质时会清除 LX 标记并重新取链，确保音质切换后状态正确。

平台与音质映射 ​

瓜子音乐将各平台 ID 映射到洛雪音源协议：

平台映射字段
酷我（kuwo）songmid=extra.rid
酷狗（kugou）hash=extra.hash
QQ（qq）songmid=extra.mid
网易（netease）songmid=extra.song_id
咪咕（migu）copyrightId=extra.copyright_id

音质映射支持标准 / 高品 / 无损 / Hi-Res，对超纲音质（hires / atmos / master）用 pickLxQuality 偏好序兜底。

易错点

缺失字段必须省略 key，不能给空字符串--社区脚本常用 hash ?? songmid 判空，空串会 shadow 有效字段。

注意事项 ​

  • 洛雪音源为 JavaScript 脚本，仅在使用时动态执行，不会修改播放器核心程序
  • 脚本需要定期更新以适应音乐平台接口变化，请关注源社区的最新版本
  • 如遇播放异常，可尝试停用洛雪音源后重新搜索，对比是否为音源脚本问题
  • 本地音乐播放、WebDAV 远程音乐播放不受洛雪音源影响
  • 已知不兼容：主动锁宿主的脚本（如六音、lxmusics 的 lx 脚本）不绕过

沙箱运行时 ​

洛雪音源脚本在独立的 Worker 线程沙箱中运行：

必须跑在 Worker 线程

jsjiami / obfuscator 系混淆脚本带周期性反调试循环，空闲也持续烧 CPU（实测长青 ~3% + 洛雪 ~25%，合计 ~70%），在 Electron 主进程会堵事件循环导致窗口拖动卡顿、界面无响应。禁止将沙箱迁回主进程。

  • Worker 崩溃后 manager 自动重载启用脚本（1 分钟 >3 次则停止，提示移除问题脚本）
  • 请求主进程侧有 timeoutMs + 3s 兜底超时
  • 取链中途禁用脚本按失败处理，不会崩溃

常见问题 ​

洛雪音源和内置插件有什么区别？ ​

  • 内置插件为程序自带，洛雪音源由第三方社区维护
  • 两者互补，可同时使用
  • 洛雪音源为 Pro 权益，内置插件所有用户可用

导入后搜索没变化？ ​

  • 确认音源脚本已启用（设置 -> 插件 -> LX Music 音源 -> 状态为"已启用"）
  • 确认当前是 Pro 用户（非 VIP 会被卸载全部脚本）
  • 尝试搜索热门歌曲验证，部分冷门歌曲可能不在洛雪音源覆盖范围内
  • 检查取链模式，fallback 模式下 LX 仅作兜底

取链失败？ ​

  • 脚本可能已过期，更新到最新版本
  • 部分歌曲在某平台无资源，尝试切换平台
  • 网络不稳定可能导致超时，重试一次
  • 检查脚本是否被脚本作者主动锁宿主

会影响播放安全吗？ ​

  • 脚本仅在本地客户端执行，不会上传个人数据
  • 瓜子音乐签名插件机制会校验内置插件完整性
  • 洛雪音源作为外挂脚本在独立 Worker 沙箱中运行，崩溃不影响主进程

非 VIP 用户能导入吗？ ​

  • 不能。LX 音源为 Pro 权益
  • 非 VIP 用户登录后，已导入的脚本会被自动卸载（防误删机制：登录态解析完成且非 VIP 才触发）
  • 升级 Pro 后可重新导入使用