Repository navigation
LX Music Sync Server v2.1.4
v2.1.4 (2026-10-26)
🌟 新增功能与体验升级
-
Subsonic 本地歌曲与自定义目录歌单:
-
Tailwind CSS v4 样式适配:完善响应式断点、明暗主题及动态背景样式,优化歌单操作按钮、下载状态和本地音乐页面的显示。
-
用户管理支持禁用账号与 WebSocket 在线状态指示:


- WebSocket 同步连接实时在线指示: 在用户管理列表中为账户头像前置直观的连接状态圆点(🟢 绿点表示当前有同步客户端在线,🔴 红点表示离线),悬停可浮动查看当前已连接的设备数;后端实时统计 WebSocket 活跃客户端连接,账号在线情况一目了然。
- 新增禁用用户功能与全链路登录拦截: 用户配置面板中新增「禁用此用户」开关(默认关闭)。禁用后该用户的历史数据、歌单及目录均完整保留,但 Web 管理登录、Token 签发、Web 播放器登录以及客户端同步连接均会被全链路安全拦截。
- 配置面板自适应滚动与移动端卡片优化: 重构用户配置弹窗为视口约束与弹性布局架构,固定顶部标题与底部确定/取消按钮,内部配置项超长时平滑自适应滚动,避免超出视口;移动端卡片视图同步恢复状态徽章与连接指示圆点对齐展示。
-
歌曲播放页背景自适应与灵动动态特效系统:


- 双层解耦视觉自由定制: 在设置面板「播放背景与视觉特效」模块中新增专属「动态效果」下拉选择器,与「歌曲播放页背景」彻底解耦组合。支持选择封面虚化、极光渐变、午夜渐变、暖雾纸感、纯色背景或黑色背景,并可叠加无、极光流光、宇宙星海、SVG 音乐漫游、音符升腾、梦幻泡泡、流动波纹、萤火虫、流星雨、冬日飘雪、樱花飘落、粒子星座等 12 种灵动动态特效。
- 明暗主题全场景智能自适应: 突破播放页背景色调单一暗沉的局限,深度自适应明亮与暗黑主题。封面虚化在明亮模式下呈现通透微白高斯磨砂与浅色底,渐变风格(北欧晨曦极光、晴空微风蓝灰、素雅暖雾纸感)自动切换为高雅浅色谱,黑色背景坚守极致纯黑;歌词与控制栏均通过算法自适应对比度色彩。
- 轻量化通用动效引擎与全站复用: 提炼并重构底层动态粒子渲染管线(
dynamic_backgrounds.js),与登录页面实现同源引擎复用与自动休眠优化;登录页动效选择器全面统一为精致翡翠绿胶囊交互风格。
-
本地音乐智能检测与多平台匹配面板 (#462):
-
桌面端侧边栏折叠/展开与快捷键联动:
-
自定义目录模式侧边目录分类面板与树形层级筛选 (#439):
-
Subsonic 配置独立管理页与架构解耦 (#460 @pyss56):
- 独立管理页面与表单: 新增独立的 Subsonic 配置页(
view-subsonic),与系统主配置完全解耦,支持专属加载与保存流程,避免主配置保存时误写默认值或误触发服务重启。 
- 支持独立端口监听: 新增
subsonic.standalone独立服务开关与subsonic.port监听端口(默认 4050,默认关闭),支持将 Subsonic API 独立暴露在专属端口上。 - 播放与下载统一缓存: 统一流媒体处理逻辑,下载音频时一并自动写入缓存并注入附件文件名;播放时优先复用已下载/已转码音频,有效降低流量与回源成本。
- 死配置项清理与缓存回退优化: 移除
clientCapMode与transcode.onQualityMiss等废弃死配置;缓存探测优化为确定性降序回退机制;subsonic.playCacheFirst默认置为false。
- 独立管理页面与表单: 新增独立的 Subsonic 配置页(
-
Web 播放器全功能投放、VU 表头升级与构建指纹集成 (#451 @pokemonred06-creator):
- AirPlay 与 Chromecast 全功能无线投放:
- Safari 原生 AirPlay: 深度接入原生音频投播,优化 iOS 音频路由与中断恢复。
- Chromecast Web Sender: 支持桌面及 Android Chrome 投屏至 Cast 设备,支持双向进度交接、暂停/播放、切歌、音量同步与断开无缝回切本地,并采用短时单资源随机令牌保障媒体安全。
- 底栏交互与居中自适应: 左右功能区等宽自适应,无论是否激活投播控件均保持核心播放按键水平居中。
- 双通道 VU 动态表头与音频图(DSP)隔离保护:
- 真实构建指纹与版本一致性:
- 播放器底栏与「关于」页统一展示真实运行包版本与 Git 源码构建指纹(如
v2.1.x · build xxxxxxx),杜绝因元数据缺失误显v1.0.0。
- 播放器底栏与「关于」页统一展示真实运行包版本与 Git 源码构建指纹(如
- 登录鉴权会话绑定与数据安全:
- 完善有效 Token 与 HttpOnly Cookie 的联动绑定和自动换发,支持访客升级与掉线静默恢复;歌单列表字段强化防 XSS 转义,多用户下载任务严格隔离防竞态。
- AirPlay 与 Chromecast 全功能无线投放:
-
自定义音源在线自动更新 (#443):
-
文件管理器现代化全面重构 (VueFinder):
🐛 缺陷修复与安全性提升
- 歌词详情页顶部控件精简、Now Playing 居中与移动端自动隐藏优化: 修复顶部导航栏中「NOW PLAYING」未能绝对居中的问题;解决手机端收起封面时「NOW PLAYING」与上移歌曲标题重叠的问题;左侧收起按钮精简为纯图标圆形按钮,并在手机端支持数秒无操作自动隐藏、触屏操作即刻唤醒;移除右上角功能重复的「X」关闭按钮。
- 设置加载与初始化流程防重优化: 本地配置收敛为单次统一加载,移除延迟任务中冗余的自动登录入口以避免并发冲突;已登录账号跳过公共限制配置拉取,防止覆盖用户个性化设置;相同背景、下载并发及歌单自动检测间隔增加防重判定,避免无谓重复应用。
- 设置面板排版与详情页背景选项精简: 优化设置面板主题风格网格布局(
settings-theme-grid);移除歌词详情页背景特效中已不适用的「双表头」选项并同步更新提示说明。 - 封面加载与代理优化: 修复 QQ 列表封面使用不支持的缩略图尺寸导致加载失败,失败时回退原图;系统媒体封面优先由浏览器加载,失败后使用服务器代理,同一封面共用请求结果,全部失败后冷却 60 秒;后台区分封面代理与下载代理,受限地址仅记录简短原因。
- 切歌歌词加载修复: 统一收藏歌曲的平台编号判断,修复首次加载停留在「正在加载歌词」、切回后才显示的问题,并防止过期请求覆盖当前歌词。
- 圆点频谱与暂停显示优化: 将方块频谱调整为圆点样式,优化大小、间距和高分屏显示;暂停时清空频谱,移除静音时残留的底部圆点。
- 运行时缓存目录统一: 封面缓存统一保存到
data/runtime/cover_cache;洗版任务与暂存索引集中保存到data/runtime/remaster-staging.json,临时音频、歌词与封面使用data/runtime/remaster-temp并在任务结束时清理,避免在曲库目录中留下.remaster-staging。 - 本地音乐目录浏览与缓存设置解耦(#461): 修复切换「根目录 / 数据目录」会改写「缓存歌曲位置」的问题;浏览位置独立保存,列表、播放与文件操作使用当前浏览目录,不再修改缓存与下载的默认存储位置。
- 私有歌单与收藏库越权访问修复与鉴权重构 (#457 @pokemonred06-creator):
- 强制校验认证身份: 彻底移除 Token 验证失败或缺失时的请求用户名回退逻辑,私有歌单(
/api/user/list)与收藏库(/api/user/library/*)访问严格要求已验证身份匹配或具备管理员权限,杜绝越权访问与修改私有数据。 - 公共集合读写鉴权加固: 公共集合(
_open)修改/写入操作强制要求管理员身份;非法与未鉴权请求在触碰存储层前即时拦截。
- 强制校验认证身份: 彻底移除 Token 验证失败或缺失时的请求用户名回退逻辑,私有歌单(
- 后台管理控制台播放器跳转路径动态化修复 (#445):
- 动态路由与路径规范化: 修复后台登录面板底部的「进入音乐播放器」链接硬编码为
/music/的问题,建立动态链接绑定;修复侧边栏「Web播放器」链接在配置为根路径(player.path: "")时判定失效停留在当前页的问题。 - 全生命周期实时同步: 统一在页面初始化、配置加载(
loadConfig)与配置保存(saveConfig)全生命周期内实时同步更新侧边栏、登录面板及「关于」页面的播放器跳转目标,确保与后端自定义路由配置严格保持一致。
- 动态路由与路径规范化: 修复后台登录面板底部的「进入音乐播放器」链接硬编码为
🛠️ 架构重构与工程优化
- 前后端 JS 与 TS 目录模块化重组:
- 前端播放器脚本分层 (
public/music/js/): 将原本平铺的脚本按职责领域解耦归入core/、player/、lyrics/、library/、local/、download/、sync/、ui/与vendor/等目录,并补齐模块说明文档。 - 服务端核心模块解耦 (
src/server/): 将平铺的服务端 TS 代码重构归类至auth/、http/、media/、music/、sources/、integrations/、task/与utils/等领域子目录,大幅提升维护性与可读性。
- 前端播放器脚本分层 (
- 关于页与版本展示优化:
- 播放器顶部栏精简版本号显示,去除直显的 build hash(转移至鼠标悬停提示)。
- 修复管理后台关于页状态徽章与特性卡片的 HTML 标记异常。
- 本次版本由 @XCQ0607 维护构建 🚀






