github XCQ0607/lxserver v2.1.4
LX Music Sync Server v2.1.4

latest release: v2.2.0
27 days ago

v2.1.4 (2026-10-26)

🌟 新增功能与体验升级

  • Subsonic 本地歌曲与自定义目录歌单:

    • 新增「本地歌曲(用户名)」「自定义目录(用户名)」只读歌单,按账号所选存储位置读取本地歌曲,自定义目录单独展示;支持后台开关控制,本地歌单优先返回。
    • 支持本地歌曲播放、封面、收藏及混合歌单,完善同名 LRC、内嵌歌词、缓存歌词与已关联平台歌词的获取。
    • 修复音流因网络歌曲大小为 0 而不加载歌单封面的问题;网络歌单优先返回原始封面,自建歌单回退首曲封面。音流当前可能仍使用首曲专辑封面,Feishin 可显示原始歌单封面。
    • Subsonic 本地歌曲歌单配置
  • Tailwind CSS v4 样式适配:完善响应式断点、明暗主题及动态背景样式,优化歌单操作按钮、下载状态和本地音乐页面的显示。

  • 用户管理支持禁用账号与 WebSocket 在线状态指示:

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

    • 播放背景与动态效果设置
    • 歌曲播放页动态特效展示
    • 双层解耦视觉自由定制: 在设置面板「播放背景与视觉特效」模块中新增专属「动态效果」下拉选择器,与「歌曲播放页背景」彻底解耦组合。支持选择封面虚化、极光渐变、午夜渐变、暖雾纸感、纯色背景或黑色背景,并可叠加无、极光流光、宇宙星海、SVG 音乐漫游、音符升腾、梦幻泡泡、流动波纹、萤火虫、流星雨、冬日飘雪、樱花飘落、粒子星座等 12 种灵动动态特效。
    • 明暗主题全场景智能自适应: 突破播放页背景色调单一暗沉的局限,深度自适应明亮与暗黑主题。封面虚化在明亮模式下呈现通透微白高斯磨砂与浅色底,渐变风格(北欧晨曦极光、晴空微风蓝灰、素雅暖雾纸感)自动切换为高雅浅色谱,黑色背景坚守极致纯黑;歌词与控制栏均通过算法自适应对比度色彩。
    • 轻量化通用动效引擎与全站复用: 提炼并重构底层动态粒子渲染管线(dynamic_backgrounds.js),与登录页面实现同源引擎复用与自动休眠优化;登录页动效选择器全面统一为精致翡翠绿胶囊交互风格。
  • 本地音乐智能检测与多平台匹配面板 (#462):

    • 本地音乐智能检测面板
    • 声学指纹识别与多平台智能匹配: 优先调用 fpcalc 提取音频声学指纹进行高精度比对,辅以歌名、歌手与有效时长复合检索校验;支持自由配置优先尝试的平台顺序(QQ 音乐、网易云音乐、酷狗音乐、酷我音乐、咪咕音乐)。
    • 多线程并发检测配置: 控制台新增「识别并发线程」下拉配置(支持 1~4 线程,默认推荐 2 线程),指纹识别与平台检索支持多线程并发提速,关联入库与索引更新排队串行执行以保障文件安全;选择配置自动持久化到本地。
  • 桌面端侧边栏折叠/展开与快捷键联动:

    • 窄长半透明圆角折叠控制手柄: 侧边栏边缘新增极简半透明圆角折叠按钮,支持一键折叠左侧导航栏以沉浸浏览歌单与歌词;折叠后屏幕左边缘悬浮窄圆角长方形手柄以供随时展开。
    • 桌面端侧边栏折叠与展开控件
    • 快捷键支持与设置联动: 支持 Alt + B 全局快捷键一键折叠/展开侧边栏,设置面板快捷键列表同步增加说明,并与「按键快捷方式」全局开关严谨联动。
  • 自定义目录模式侧边目录分类面板与树形层级筛选 (#439):

    • 沉浸式侧边目录面板: 桌面端折叠主侧边栏且处于自定义目录模式时,原高级筛选面板中的目录筛选下拉自动转为左侧独立的目录分类侧边面板;面板支持一键再次折叠为竖向窄条手柄,让曲库浏览视野更宽阔。
    • 自定义目录侧边分类面板
    • 树形层级与灵活多选交互: 目录树支持 +/- 节点折叠展开、全部展开/折叠、各目录歌曲实时数量角标及父级自动包含子级标注;支持单选即时过滤、按住 Ctrl 点击多选,并内置专属「多选」快捷开关。
    • 弹窗与侧边栏体验统一: 目录筛选模态框全面统一为精致的树形节点架构,与侧边目录面板共享同一套展开状态与多选逻辑。
  • Subsonic 配置独立管理页与架构解耦 (#460 @pyss56):

    • 独立管理页面与表单: 新增独立的 Subsonic 配置页(view-subsonic),与系统主配置完全解耦,支持专属加载与保存流程,避免主配置保存时误写默认值或误触发服务重启。
    • Subsonic 独立配置页
    • 支持独立端口监听: 新增 subsonic.standalone 独立服务开关与 subsonic.port 监听端口(默认 4050,默认关闭),支持将 Subsonic API 独立暴露在专属端口上。
    • 播放与下载统一缓存: 统一流媒体处理逻辑,下载音频时一并自动写入缓存并注入附件文件名;播放时优先复用已下载/已转码音频,有效降低流量与回源成本。
    • 死配置项清理与缓存回退优化: 移除 clientCapMode 与 transcode.onQualityMiss 等废弃死配置;缓存探测优化为确定性降序回退机制;subsonic.playCacheFirst 默认置为 false。
  • Web 播放器全功能投放、VU 表头升级与构建指纹集成 (#451 @pokemonred06-creator):

    • AirPlay 与 Chromecast 全功能无线投放:
      • Safari 原生 AirPlay: 深度接入原生音频投播,优化 iOS 音频路由与中断恢复。
      • Chromecast Web Sender: 支持桌面及 Android Chrome 投屏至 Cast 设备,支持双向进度交接、暂停/播放、切歌、音量同步与断开无缝回切本地,并采用短时单资源随机令牌保障媒体安全。
      • 底栏交互与居中自适应: 左右功能区等宽自适应,无论是否激活投播控件均保持核心播放按键水平居中。
    • 双通道 VU 动态表头与音频图(DSP)隔离保护:
      • 新增双通道立体声 VU 动圈表头与多种表盘主题;无线投播期间自动保护音频流并延后本地 DSP 处理,切回本地后自愈恢复桌面音频图。
      • VU 动态表头
    • 真实构建指纹与版本一致性:
      • 播放器底栏与「关于」页统一展示真实运行包版本与 Git 源码构建指纹(如 v2.1.x · build xxxxxxx),杜绝因元数据缺失误显 v1.0.0。
    • 登录鉴权会话绑定与数据安全:
      • 完善有效 Token 与 HttpOnly Cookie 的联动绑定和自动换发,支持访客升级与掉线静默恢复;歌单列表字段强化防 XSS 转义,多用户下载任务严格隔离防竞态。
  • 自定义音源在线自动更新 (#443):

    • 更新与前往双操作交互: 音源更新提示栏拆分为「更新」与「前往」两个独立按钮,点击「前往」可跳转至源发布页,点击「更新」即可在当前页面直接触发一键在线更新。
    • 自定义音源自动更新
  • 文件管理器现代化全面重构 (VueFinder):

    • 文件管理
    • 基于 Vue 3 + VueFinder 全新重构: 彻底淘汰陈旧且依赖外部 CDN 的 jQuery / elFinder 架构,前端使用 Vue 3 与 VueFinder 4.7.6 构建为自包含本地静态资源,大幅降低外部依赖,界面轻量流畅。

🐛 缺陷修复与安全性提升

  • 歌词详情页顶部控件精简、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)修改/写入操作强制要求管理员身份;非法与未鉴权请求在触碰存储层前即时拦截。
  • 后台管理控制台播放器跳转路径动态化修复 (#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 维护构建 🚀

Don't miss a new lxserver release

NewReleases is sending notifications on new releases.