Skip to content

LX Music Sync Server v2.0.0

Latest

Choose a tag to compare

@github-actions github-actions released this 22 Jul 13:29
· 8 commits to main since this release

v2.0.0 (2026-07-22)

🌟 新增功能

  • 本地音乐洗版功能 (@bobcc4):
    • 精准洗版与高品质记忆: 支持按歌曲选择、搜索、目标音质记忆及音质降级提示,默认目标音质统一设为 FLAC 无损。
    • 索引与识别改进: 改进本地音乐重新索引、封面和歌词识别、来源平台识别及高级音质筛选功能。
    • Remaster 1 Remaster 2 Remaster 3
  • 本地歌曲加入歌单功能 (@bobcc4):
    • 平台 ID 校验与安全过滤: 本地音乐支持单曲及批量加入歌单。仅当本地歌曲同时具备有效来源平台 (source) 与平台歌曲 ID 时才允许收藏,自动拒绝 unknownlocal 或文件名回退 ID 等未关联歌曲。
    • 单曲与批量校验提示: 单首未绑定歌曲收藏时明确提示使用“手动关联”绑定平台 ID;批量收藏全为未绑定歌曲时不触发弹窗,混有未绑定歌曲时自动跳过并给出跳过数量友好提示。
    • Local Music Add To Playlist
  • 高级布尔搜索语法 (@bobcc4):
    • 空格激活与方框浅色字符: 本地音乐及洗版搜索框支持 & (与)、| (或)、! (非) 和 () 括号优先级运算(优先级 () > ! > & > |)。符号后输入空格自动转换为带有边框的浅色方框标签,防止 R&B 等包含 & 的普通词汇被误切分。
    • 语法错误红框提示与复制粘贴再现: 表达式出现语法错误(如括号未闭合)时输入框呈现红框发光高亮提醒;全选复制粘贴后可完整保留并自动重新解析呈次方框标签。未输入时自动展示语法提示与悬浮说明。
    • Advanced Search Syntax
  • 自动更新歌单与检测提醒 (@bobcc4):
    • 定时与状态标记: 给自动更新歌单添加了定时更新机制,并支持手动检测全部歌单是否有更新。若存在更新,将在歌单旁以红色感叹号显示,方便手动更新需要更新的歌单。
  • 专辑一键下载与收藏 (@bobcc4):
    • 快捷专辑操作: 在专辑列表中增加单张专辑一键下载和收藏操作。
  • WebDAV 备份同步功能增强 (#262):
    • 增量与全量间隔配置: 新增增量同步间隔设置(默认 60 分钟)和全量备份间隔配置(默认 24 小时)。
    • WebDAV Settings
    • 自定义备份路径: 支持自定义 WebDAV 全量备份远端存储路径。
  • Subsonic 协议全网检索与音源前缀支持 (#228, #268):
    • 全网在线搜索: 支持在 Subsonic 客户端中通过 wy:, kg:, tx:, kw:, mg: 等指定平台前缀,或 online: / local: 强制指定全网或本地搜索。
    • 后端配置开关: 设置页面新增“开启全网在线搜索”、“默认在线搜索模式”以及“默认在线搜索平台”选项。
    • Online Search Settings
  • Subsonic 多行翻译歌词支持 (#188):
    • 中文/翻译歌词显示: 支持在 Subsonic /getLyrics/getLyricsBySongId 接口中返回多行翻译歌词(原文在上,翻译在下),解决客户端无法展示翻译歌词的问题。
    • Subsonic Lyric Display
    • 歌词翻译开关按钮: 设置界面新增“开启歌词翻译支持”选项开关。
    • Lyric Translation Switch
  • Subsonic 协议 search3 API 实现 (#213):
    • search3 接口完全适配: 实现并完善 Subsonic search3 标准接口,完美支持第三方客户端(如音流、Feishin、Symfonium 等)进行更丰富的搜索检索。
  • 公共音乐库与公开收藏管理 (#272):
    • 公开收藏与歌曲权限控制: 在后台设置中开启“开启公共收藏和歌曲”后,管理员可在未登录音乐账号但登录管理员的情况下对公开用户的列表进行增加删除管理。
    • 非管理员访问权限控制: 新增“开启非管理员访问本地音乐”与“开启非管理员访问”开关选项,可以精准限制未登录管理员的公开账号及未登录用户对本地音乐、公开收藏和歌曲的查看与访问权限。
    • Public Library 1 Public Library 2
    • Public Library 3 Public Library 4
    • Public Library 5

🔧 修复与优化

  • 下载与仅下载模式缺陷修复 (@bobcc4):
    • 换源与歌词自动下载: 修复直接下载歌单里面的歌曲不会自动切换平台的问题,以及直接下载歌曲时不会自动下载歌词、只会显示检测歌词的 Bug。
    • 路径与命名规范: 修复仅下载模式下下载歌曲到 music 但歌词依旧下载到 cache 的 Bug,以及仅下载模式下歌曲命名方式未按设置命名的 Bug。
    • 并发控制优化: 修复下载并发量修改无效的 Bug,并移除并发量为 6 的选项以防止 UI 卡死。
    • 大批量下载稳定与恢复: 修复批量下载中歌曲数量超过 1000 时浏览器卡死的 Bug,以及批量下载全部暂停后不能继续下载的 Bug。
    • 下载体验与音质统一: 改进单曲和批量下载的音质大小探测、下载换源、服务端队列恢复、文件命名与元数据写入,并将播放和下载的默认音质统一为 FLAC 无损,确保重置配置同步完成后再刷新页面。
  • 本地音乐与歌手专辑交互修复 (@bobcc4):
    • 搜索框修复: 修复本地音乐右上方搜索框无效的 Bug。
    • 缺封面识别: 修复筛选缺封面时,原封面为 0 KB 的占位符被误识别为封面的 Bug。
    • 性能与收藏夹优化: 优化打开本地歌曲的分页,当本地歌曲大于 3000 时解决浏览器卡顿问题;将我的收藏父项开关仅作为折叠/开启的作用。
    • 歌手与专辑交互: 修复收藏的歌手点击全部音乐时批量模式切换传参顺序错误(source 和 order 串位)的 Bug,以及查看多个已收藏歌手专辑均显示为第一个歌手专辑的 Bug。
  • 构建与依赖适配 (#270 @bobcc4):
    • Archiver 8 ESM 导出适配: 适配 archiver 8 的 ESM 类导出。
    • lock 文件清理: 清理 package-lock.json 中遗留的冲突标记。
  • WebDAV 备份同步逻辑修复 (#262):
    • 上传文件完整性: 修复云端为空时只上传 config.js 而漏传其他文件的逻辑缺陷。
    • 同步间隔生效: 修复 sync.interval 配置项实际不生效的问题,并修复 WebDAV 同步备份多处细节逻辑缺陷。
  • 缓存空间配置与系统设置 (#258):
    • 缓存限制持久化: 修复 Web 端缓存空间配置修改后服务器缓存限制会恢复默认的 Bug。
  • Subsonic 酷狗 (kg) 接口与音质解析修复 (#214, #260, #268):
    • 酷狗接口报错修复: 修复了酷狗 (kg) 搜索时因请求 limit 超过平台单页限制而导致 Out Page Range (error_code: 149) 的问题,并补全了 hash 元数据映射以保证歌词与流媒体播放顺畅。
    • 全网音质角标精确透传: 在 Subsonic 数据转换中完整保留 SDK 音质数组,使 Master, Hi-Res, 无损 (FLAC), 320k 等音质角标在客户端中精准呈现。
  • 播放器根路径路由与登录重定向 (#230):
    • 规范化播放器根路径: 修复了在 Docker Compose 环境变量或 config.js 中将播放器访问路径配置为根路径 PLAYER_PATH=/ 时,由于路径拼接产生双斜杠 //login 导致登录页白名单失效及 302 无限重定向循环的 Bug。
    • 动态前端重定向: 优化了 Web 播放器登出时的路径跳转逻辑,不再硬编码 /music/login,而是根据系统配置的播放器路径进行动态匹配与跳转。
  • 退出登录清除浏览器缓存 (@bobcc4):
    • 全量缓存清理与自动重载: 优化 Web 播放器退出登录(Logout)时的处理机制,登出时自动彻底清除所有 LocalStorage、SessionStorage 以及本地播放器/歌单缓存,并自动重新加载页面,彻底杜绝数据残留与隐私泄漏隐患。