LX Music Sync Server v2.0.0

v2.0.0 (2026-07-22)

🌟 新增功能

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

🔧 修复与优化

• 下载与仅下载模式缺陷修复 (@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 以及本地播放器/歌单缓存，并自动重新加载页面，彻底杜绝数据残留与隐私泄漏隐患。

LX Music Sync Server v1.9.4

v1.9.4 (2026-06-10)

🌟 新增功能

• 安全 VM 模式管理:
  • VM 模式配置: 在系统设置的“权限与缓存限制”卡片中新增“允许 VM 模式运行脚本”开关，默认关闭，极大提升安全性。
  • 强制管理员验证: 任何上传、导入或启用原生 VM 模式自定义源脚本的操作，都必须附带正确的管理员密码验证，彻底阻断了通过单条命令行（如 curl）进行越权上传和运行 VM 模式的攻击路径。
  • 可视化 VM 标识: 自定义音源列表中，以原生 VM 模式运行的音源其后面会新增明显的 VM 标签提示，更易于管理员进行安全审计。
  • 
• 设置界面分块优化:
  • 设置界面去英文: 移除设置界面中多余的英文标识。
  • 分块设置布局: 对设置界面进行合理分块排版，让选项设置更加一目了然，结构层次更明晰。
  • 
• 播放失败处理策略优先级:
  • 策略优先级自定义: 新增“播放失败策略优先级”设置，支持灵活配置失败处理逻辑的优先级（例如选择 切换平台 -> 降低音质 -> 下一首），以提供更好的自动纠错机制。
  • 
• 默认入口设置:
  • 默认Tab自定义: 新增“默认入口”设置，支持自定义刷新或打开网页时默认显示的Tab页面（支持“搜索”、“歌单”、“排行榜”、“我的收藏（默认）”、“本地音乐”）。
  • 状态恢复逻辑适配: 即使开启了“自动恢复进度”，系统在静默恢复播放状态时也绝不会强制跳转走用户设定的默认入口页面。
  • 
• 群晖 SPK 分发:
  • 引入 SPK 打包子模块 (#190 @yy505149): 引入群晖套件打包子模块，支持群晖 SPK 套件分发。

🔧 修复与优化

• 仅下载模式优化 (#207):
  • 选项文本更新: 仅下载模式下，单曲下载菜单选项由“缓存到服务器”改为“下载到服务器”。
  • 忽略缓存重复下载: 在仅下载模式下，即使歌曲在 cache 目录中已缓存，依旧允许用户继续进入下一步选择新的音质并下载到 /music 目录。
  • 
• 播放器自动换源优化:
  • 检索优先级更新: 将播放失败自动换源的目标平台检索优先级调整为：网易云 ➔ QQ ➔ 酷我 ➔ 酷狗 ➔ 咪咕。
  • 解析源平台校验: 自动匹配时仅在当前已启用的自定义源所支持的平台中搜索，防止匹配到无法解析的音乐源。
  • 无解跳过提示: 如果当前没有其他可解析的目标平台，则直接跳过跨平台搜索并弹出“未找到自定义源下支持的平台下的对应歌曲”提示。
• 系统安全与路径过滤:
  • 防路径穿越 (#223 @sebastiondev): 修复了 elFinder 文件管理器中 decode() 方法的路径穿越风险，防止未授权访问或读取系统文件。
• 文件存储安全与健壮性:
  • 安全重命名回退 (#226 @bobcc4): 修复了 fileCache 部分场景下的移动与命名安全问题，引入了安全命名回退和调试日志，并确保目标路径目录存在。
• 本地歌曲与缓存性能优化 (#186):
  • 歌曲封面缓存机制: 在服务端引入封面缓存。提取音频文件的 ID3 封面时，计算文件名 MD5 并将图片数据与 MIME 类型缓存至 cover_cache 目录。后续请求直接读取缓存文件，彻底避免了重复读取并解析大音频文件标签的高开销操作，同时在删除歌曲缓存时自动清理关联封面缓存。
  • 异步扫描与事件循环让渡: 将本地歌曲扫描（syncCacheIndex）的递归文件遍历改写为异步 I/O 模式（使用 fs.promises），并在遍历循环中加入 setImmediate 机制主动释放/让渡 Node.js 事件循环，避免了超大音乐库扫描时导致的服务器主线程阻塞，保证了高并发下的服务响应速度。
  • 客户端浏览器缓存优化: 移除了本地音乐及缓存列表中封面图 URL 携带的 &t=Date.now() 时间戳，允许浏览器正常对封面图片进行强缓存，显著降低了重复的 HTTP 缓存请求开销，使歌曲列表页面加载和滚动渲染更加丝滑。
• 前端样式重构:
  • 暗色模式适配: 为部分内容适配不同的系统主题配色并保障对比度。
  • 样式提取与分离: 将 index.html 头部 <style> 样式块提取并搬移到了独立的外部样式表 app.css 中，大幅缩减了主页面的 HTML 体积，便于后续样式的独立维护。
  • 歌曲重映射(#199,#195): 本地音乐面板新增“歌曲重映射”功能按钮，激活后可以针对已关联好的歌曲显示手动关联/重新关联按钮，提升本地音乐与云端数据的映射灵活度。

LX Music Sync Server v1.9.3

v1.9.3 (2026-05-06)

🌟 新增功能

• 本地音乐子目录管理 (Categorization) (#150):
  • 分类文件夹: 支持在 /data/music 或 /music 目录中创建多级子目录，实现本地音乐的物理分类管理（注意：cache 文件夹暂不支持创建子目录）。
  • 批量分类: 批量操作栏新增“分类”功能，支持一键将选中的音乐及其关联歌词文件移动到目标文件夹，并自动同步索引。
  • 路径自动识别: 优化扫描逻辑，支持深度递归搜索，自动识别并记录歌曲的 subPath 物理路径。
  • 
• 搜索与分页增强 (#151):
  • 自动回弹: 切换搜索分页时自动滚动回列表顶部。
  • 跳转功能: 分页控件新增“跳转至指定页”功能。
• 登录状态查看与快捷入口 (#162): 增加登录状态查看面板及快捷操作入口。
• 歌曲歌词嵌入功能 (#163): 支持将歌词内容嵌入到歌曲文件的元数据标签中，方便本地文件管理。
  • 
• 筛选多选功能: 筛选面板支持多项选择，极大提升了歌曲过滤的灵活性。
  • 

🔧 修复与优化

• 系统存储升级 (#160): 引入 IndexedDB 替代 LocalStorage 存储核心列表数据，彻底解决了大规模歌单场景下 5MB 储存空间不足的问题。
• 播放与下载逻辑修复 (#164, #167):
  • 浏览器下载修复: 修复了存在缓存歌曲后，无法使用浏览器下载的问题。
  • 播放器接入修复: 修复了部分情况下无法正常进入网页播放器的问题。
• 播放器交互:
  • 语境切换修复: 修复了播放搜索列表歌曲时，在开启“切换播放语境”设置的情况下仍会错误意外触发重置到默认歌单的 Bug。
• UI 与体验:
  • 移动端深度优化: 优化了手机端部分弹出面板的触摸交互与布局表现。
  • 界面展示优化: 进一步优化了部分 UI 组件的视觉表现。

LX Music Sync Server v1.9.2

v1.9.2 (2026-04-27)

🌟 新增功能

• 搜索体验优化 (#143, #144):
  • 步长调整: 搜索歌曲的分页加载步长从一次请求多页调整为单页步长（Step = 1）。
  • 预连接拉取: 新增后台预拉取机制，当触及当前列表末尾时自动拉取后续页码，实现无缝滚动体验。

🔧 修复与优化

• 音源兼容性:
  • 播放代理优化 (#139): 修复了部分歌曲由于 CORS 限制无法播放的问题，现在支持自动检测 CORS 状态并智能开启音频中转代理。
  • 酷我封面画质: 整体提升酷我音源的封面分辨率，从默认的低画质统一升级至 1000x1000 高清版本。
• 系统核心:
  • 缓存机制修复 (#147): 修复了某些经代理重写的最终播放链接传递到后端时，由于 URL 校验问题导致服务器端缓存失败的问题。
  • 本地歌词播放 (#149): 优化并修复了本地缓存/导入歌词在离线或特定网络环境下的播放显示问题。
• 第三方协议:
  • Subsonic 协议适配 (#141): 增强了 Subsonic 接口的数据返回，支持获取并展示专辑的发行年份。

LX Music Sync Server v1.9.1

v1.9.1 (2026-04-22)

🌟 新增功能

• 本地歌曲管理 (#114):
  • 多目录扫描: 支持管理 /cache、/music、/data/cache 及 /data/music 目录下的所有本地音乐文件。
  • 自动特征刮削: 内置 Acoustid 与 Chromaprint 指纹识别引擎，支持对外部导入的无标签音乐进行全自动音乐特征识别与刮削。
  • 元数据补全: 支持手动刮削、补全歌词、补全封面以及完善歌曲 ID3 标签信息（歌手、专辑等）。
  • 本地搜索与播放: 完美集成到播放器中，支持将本地扫描到的歌曲作为歌单列表进行搜索、筛选及循环播放。
  • 
• 下载与缓存优化 (#124):
  • 自定义文件名: 在“仅下载模式”或执行服务器缓存时，新增支持自定义文件名命名规则，满足用户对本地库文件命名的个性化需求。
  • 

🔧 修复与优化

• 播放器核心:
  • 歌单导入修复 (#100, #125): 修复了从第三方平台导入部分特定格式歌单时，歌曲由于 ID 映射问题导致无法正常解析播放的问题。
  • 自定义路径修复 (#122): 修复了在应用设置中将播放器 URL 路径自定义为根路径 / 时，导致资源加载 404 或重定向循环的问题。

LX Music Sync Server v1.9.0

v1.9.0 (2026-04-18)

🌟 新增功能

• 搜索与发现:
  • 歌手/专辑搜索 (#95): 新增搜索歌手和专辑功能，支持从 QQ 音乐和网易云音乐两大平台深度检索相关内容。
  • 
  • 支持收藏歌手和专辑: 全面支持对歌手和专辑进行收藏/星标操作，方便用户构建个人音乐库。
  • 
  • QQ 号歌单导入 (#110): 新增支持通过 QQ 号直接导入公开歌单功能，极大方便了歌单迁移与快速收藏。
  • 
• 系统集成:
  • Subsonic 功能深度适配: 适配 Subsonic 协议的大部分核心功能，进一步提升与第三方客户端的兼容性。
  • 
  • 
• 管理与限制:
  • 公开音源列表隐藏: 开启“公开用户限制”后，针对未验证的公开用户将自动隐藏自定义源列表，进一步增强服务器隐私与安全性。
  • 
  • 歌手信息源优先级: 支持在后台管理界面灵活配置Subsonic歌手详情、头像及简介的获取来源优先级（支持 TX 与 WY 平台）。
  • 用户缓存深度限制 (#112):
    • 管理员监控: 为管理员新增用户缓存限制开关。开启后可限制非管理员用户仅能使用核心三项功能（同步、歌词、播放）及“仅下载模式”，确保系统稳定性。
    • 空间配额统计: 统一统计每个用户在 data/cache (同步) 与 cache (非同步) 目录下的总资产体积。
    • 智能 LRU 清理机制: 当检测到用户缓存超出设定的空间限制时，系统将按文件修改时间 (mtime) 执行从旧到新的覆盖删除，直至容量回落到限制值的 95% 以内。
    • 
  • 修改用户名 (#117): 支持用户在管理界面自定义更改登录用户名，增强用户管理的灵活性。
  • 
• 界面交互:
  • 音乐平台记忆功能 (#97): 增加音乐平台选择缓存功能。现在系统会自动记住用户上次选中的音乐平台（如网易/QQ），下次刷新网页时将自动恢复选择。

🔧 修复与优化

• 系统与安全:
  • 用户密码持久化修复 (#103): 修复了在用户管理界面刷新列表时会错误重载配置，导致用户密码被意外恢复为默认值的问题。
  • 自定义路径安装修复 (#108): 修复了在支持自定义路径配置后，应用安装过程中可能出现的路径识别与部署问题。
• 存储与下载:
  • 文件类型精确识别 (#105): 修复了下载歌曲后缀名可能不准确的问题。引入了 file-type 库进行二进制文件头检测，确保下载文件的扩展名与其实际内容严格匹配。
• 后台管理:
  • 排序背景色显示优化 (#98): 修复了管理后台“数据查看”模块中，所有歌曲列表在执行排序操作时背景总是显示为白色的视觉问题。

LX Music Sync Server v1.8.4

v1.8.4 (2026-04-12)

🌟 新增功能

• 界面交互:
  • 歌单折叠功能: 新增歌单详情页头部折叠功能，点击标题可展开/收起详细描述，优化列表空间利用。
  • 
• 系统集成:
  • Subsonic 协议支持: 完美支持 Subsonic 系列协议，可配合各类第三方客户端连接服务器进行音乐播放与管理。
  • 
  • SMTC 显示歌词 (#85): 增加系统媒体传输控件 (SMTC) 显示歌词选项。开启后，在 Windows 系统媒体控制中心可直接同步查看当前歌词。
  • 
• 后端管理:
  • 管理界面完全重构: 针对后端 UI 进行了重构与深度优化，视觉更现代，交互更流畅。
  • 
  • 
  • 自定义入口功能 (#79): 后端增加自定义入口设置，允许通过指定路径访问服务端。
  • 仅下载模式: 后端新增仅下载模式支持。开启后，歌曲及歌词将优先存储于 /music 目录，并采用 {歌名} - {歌手} - {音质} 的简洁命名格式，同时增强了对新旧两种格式的兼容检索与去重逻辑。
  • 
• 镜像分发:
  • Docker 多架构支持: 新增对 32 位 (arm/v7, 386) 架构的 Docker 镜像支持。

🔧 修复与优化

• 移动端适配:
  • 歌曲操作面板冲突修复（#83）: 修复了手机端歌曲操作面板弹出时与歌曲标题显示的冲突问题。
  • 
• 显示与交互:
  • 侧边栏封面遮挡修复 (#91): 修复了左侧歌曲封面在预览时遮挡大部分功能模块的问题。
  • 
  • 联想区域关闭逻辑 (#89): 修复了在搜索后联想词区域未能正常关闭的问题，优化搜索过程的流畅度。

LX Music Sync Server v1.8.3

v1.8.3 (2026-04-06)

🌟 新增功能

• 代理设置增强:
  • 自定义播放代理 (#74): 新增播放音乐自定义代理设置，允许用户指定特定的代理服务器进行音频流中转。
  • 
  • MusicSDK 代理: 增加 MusicSDK 代理设置，支持热搜、歌单、排行榜等元数据获取通过代理中转，提升在特殊网络环境下的访问稳定性。
  • 
• 播放器功能:
  • 批量收藏 (#68): 列表操作新增批量收藏功能，支持一次性将多首歌曲添加到收藏夹。
  • 

🔧 修复与优化

• 性能与稳定性:
  • CPU 占用优化 (#72): 针对 WebDAV 同步及文件缓存逻辑进行了深度优化，有效降低了服务器在高负载下的 CPU 占用。
  • 缓存报错修复 (#65, #76): 修复了部分情况下出现的“服务器拒绝缓存”错误，提升了缓存成功率。
  • iOS 后台播放 (#73): 进一步优化了 iOS 设备在后台播放时的稳定性，解决部分场景下的中断问题。
• 界面显示:
  • 后端 UI 优化: 优化了后端管理控制台的 UI 细节显示，提升了视觉一致性与操作体验。
  • 
  • 平板竖屏适配: 安卓与ipad平板竖屏UI适配

LX Music Sync Server v1.8.2

v1.8.2 (2026-04-03)

🌟 新增功能

• 安全与授权:
  • Token 管理: 新增 Token 管理面板。用户可以生成具有自定义名称和过期时间的永久/长期访问 Token，供第三方应用或自动化脚本安全调用服务器 API。
  • 
  • 接口权限增强: 全面增强了后端 API 接口的安全性，支持通过 X-User-Token 进行持久化状态验证。
• 客户端模式:
  • 客户端模式: 支持每次登陆本地账户都会模拟客户端向远程服务器发起同步请求
  • 
  • 

🔧 修复与优化

• 播放体验:
  • iOS 后台播放 (#61): 修复了 iOS 设备在锁屏或浏览器切到后台时音频自动暂停的问题，显著提升了移动端收听的稳定性。
• 系统底层:
  • 存储路径修复 (#62): 修复了缓存目录问题。
  • 性能优化:
    • 网页加载提速: 进一步优化了前端资源加载逻辑，网页首屏加载速度显著提升。
• 界面显示:
  • 修复部分模态框样式问题。

LX Music Sync Server v1.8.1

v1.8.1 (2026-04-01)

🌟 新增功能

• 打包与分发:
  • 多平台客户端: 完成了 Windows、macOS 和 Linux 三个主流平台的桌面客户端打包。现在支持在各大平台下载并使用本地客户端。

🔧 修复与优化

• UI 体验:
  • 优化了前端播放器及后端管理控制台的部分 UI 交互与视觉表现。
  • 修复了排行榜底部布局阴影及圆角显示不一致的问题。
• 系统更新:
  • 修复了检查更新时，发布日志或版本信息显示异常的问题，确保能获取到最新的更新详情。