lx-music-desktop-auto-source

项目概述

洛雪增强版由 shellsec 在 lyswhut/lx-music-desktop 的基础上二次开发，保留 Apache-2.0 许可证与原作者版权声明，修改说明写在 NOTICE 里。它在原版能力上补了三件事：自定义源管理、播放失败后按用户顺序自动换源重试、HTTPS 订阅清单自动更新。软件本身不提供任何音源，首次启动自定义源列表为空，一切解析脚本由用户自行导入。

洛雪桌面版的老用户，多了自动换源和订阅这两件顺手事。

项目	内容
基础	lyswhut/lx-music-desktop v2.12.6
平台	Windows x64（安装/7z/单文件）、macOS Apple Silicon、Linux x64 AppImage/DEB
许可证	Apache-2.0（含 NOTICE 修改说明）
音源	不内置，用户自行导入

主要功能

• 自定义源管理：设置里打开「自定义源」窗口，本地导入脚本或填在线脚本地址，上移下移调整重试顺序
• 多源自动切换：默认关闭，勾选启用后播放失败仅按用户列表顺序尝试其余源，每个源每轮最多一次
• 订阅更新：填 HTTPS 清单地址保存持久生效，支持 JSON 数组或 sources 对象，脚本地址必须 HTTPS
• 订阅冷却：同一首歌对同一地址最多自动检查一次，连续切歌间隔至少 60 秒，手动更新不受限
• 增量合并：更新保留本地导入源与顺序，清理已删条目并追加新条目，下载或校验失败保留原列表
• 原版能力：桌面歌词、音质选择、歌单、主题等洛雪桌面版功能全部保留

安装

1. 从发布页按平台下载：Windows 有 x64 安装版、7z 解压版与单文件免安装版
2. macOS 提供 Apple Silicon ARM64 DMG，未用 Developer ID 签名，首次打开需手动放行
3. Linux 提供 x64 AppImage 与 DEB，尚未经 Linux 实机验证
4. 发布页的 SHA256SUMS.txt 供逐包校验

使用流程

1. 打开设置中的「自定义源」管理窗口
2. 点「本地导入」选自己的源脚本，或「在线导入」填自己的脚本地址
3. 导入多个源后勾选「多源自动切换」，用上移下移调整重试顺序
4. 需要订阅时填自己的清单地址，点「保存订阅地址」

开发与验证

• 构建：Node.js 22+，npm ci、npm run lint、npm run build
• 测试：npm run test:sources 覆盖空列表、导入、顺序重试与订阅解析
• 打包检查：发布构建会校验分发文件不包含源脚本资源

注意事项

• 免责声明：软件不提供任何音源，导入内容由用户自行负责，遵守当地法律与版权
• 平台边界：macOS DMG 未签名，Linux 包未经实机验证
• 订阅边界：地址为空时不请求远程，清单与脚本都未变化时不重载不重试