音云 服务端 v1.5.5

v1.5.5 (2026-08-12)

歌词缓存修复

• 修复后台预加载 WY 歌曲时，数字型歌曲 ID 导致服务端歌词补全报错、音频已缓存但没有生成同名歌词文件的问题。
• 歌词侧文件现在只允许写入真实存在且已加入缓存索引的音频旁边，不再在音质尚未确定时创建 unknown.lrc。
• 修复快速切歌时旧歌词原文未及时清空，存在把上一首歌词提交给当前歌曲的竞态问题。
• 删除音频时会同步清理该歌曲由旧版本生成的 unknown.lrc；缓存索引同步时也会清理没有对应音频的旧版 unknown 孤立歌词，普通外置歌词保持不变。

升级说明

• 本版本不改变数据目录、数据库或接口结构，可以从 v1.5.4 直接升级。

音云 服务端 v1.5.4

v1.5.4 (2026-08-12)

歌词与缓存修复

• 默认歌词输出调整为：外置逐行 LRC、内嵌增强型 LRC（ESLyric）。重置设置或首次使用时会采用该组合；已有用户自行保存的歌词格式设置保持不变。
• 修复普通同步账户播放歌曲时，后台缓存请求误携带管理员专用的命名规则参数，导致音频下载被服务端拒绝、仅留下歌词文件的问题。
• 后台缓存请求失败现在会保留明确的错误信息，便于从浏览器控制台和服务端日志定位下载失败原因。

依赖安全维护

• 将 js-yaml 升级至 4.3.1，将传递依赖 nanoid 升级至 3.3.17。
• npm audit 已无已知漏洞；未进行框架或大版本依赖升级，避免扩大维护版本的变更范围。

升级说明

• 本版本不改变数据目录、数据库或接口结构，可以从 v1.5.3 直接升级。

音云 服务端 v1.5.3

v1.5.3 (2026-08-11)

逐字歌词

• TX 歌词优先通过原生 QRC 接口获取并在服务端完成纯 TypeScript 解密，支持逐字时间轴、翻译和罗马音；QRC 不可用时仅降级到 TX 自身的逐行 LRC，不进行跨平台歌词匹配。
• 保留 WY YRC、KG KRC 和 MG MRC 的原生逐字歌词能力；缺少逐字数据时明确降级为同平台逐行歌词，不生成伪造的逐字时间戳。
• 修复服务器下载链路过早把结构化歌词压成纯文本、导致逐字歌词和扩展歌词在保存前丢失的问题。

歌词格式

• 设置新增“外置歌词格式”和“内嵌歌词格式”，可分别选择逐行 LRC、逐字 LRC 或增强型 LRC（ESLyric）。
• 服务器下载队列会持久化每个任务的歌词格式，关闭浏览器后继续下载时仍保持原选择。
• 缓存索引记录请求格式、实际格式和降级原因；缓存列表会显示实际保存的歌词格式，发生降级时使用醒目标记并给出原因。
• 浏览器下载、服务器缓存、仅下载模式、API v1 下载和本地音乐批量嵌入均使用同一套格式转换逻辑。

升级说明

• 本版本不改变目录结构，可从 v1.5.2 直接升级；已有歌词文件继续兼容，新格式设置对新下载或重新补全的歌词生效。

音云 服务端 v1.5.2

v1.5.2 (2026-08-09)

日志系统完善

• 应用运行期的普通、警告和错误输出统一写入应用日志，业务异常保留完整堆栈并同步进入错误日志。
• 访问日志新增 HTTP 状态码、请求耗时、请求与响应大小、来源 IP 和客户端信息，5xx 请求同步进入错误日志。
• 登录日志补充用户、来源 IP 和客户端信息，Token 配置操作补充来源 IP，便于定位异常访问和账户问题。
• 密码、Cookie、Token、签名及 URL 内嵌凭据自动脱敏；启动日志不再输出用户密码。
• 应用、访问、登录、Token 和错误日志统一按 10 MB 轮转并保留 10 个历史文件，避免日志无限增长。
• 限制后台日志接口仅能读取已定义的日志类型，并将单次读取范围限制在 1 至 2000 行。

界面修复

• 修复浏览器处于非 100% 缩放比例时，切换到访问日志后超长 URL 撑宽页面并造成异常缩放的问题。
• 日志长文本现在会在容器范围内自动换行，应用日志和登录日志继续沿用原有布局。

升级说明

• 本版本不改变持久化目录和数据结构，可从 v1.5.1 直接升级。

音云 服务端 v1.5.1

v1.5.1 (2026-08-09)

紧急修复

• 修复 v1.5.0 根路径播放器点击“搜索”“本地音乐”“设置”等侧边栏入口后跳转到 /_player/ 并显示 404 的问题。
• 删除会改变 href="#" 解析结果的 HTML <base> 标签，播放器 CSS、JavaScript 和图标全部改用明确的 /_player/* 绝对资源地址。
• 增加播放器入口回归测试，阻止相对静态资源和 <base> 标签再次引入页面导航错误。
• 更新播放器 Service Worker 缓存版本，确保浏览器获取修复后的入口页面和静态资源。

音云 服务端 v1.4.1

v1.4.1 (2026-08-09)

Bug Fixes

• Removed stale hard-coded v1.3.0 labels from the initial HTML of the admin console and Web player.
• Synchronized the runtime version in public/js/config.js from package.json during every build.

文案修正

• 关于页面的“歌单同步”改为与音云客户端数据互通，不再宣称兼容 LX Music 客户端；同步与备份文档同步更新。

音云 服务端 v1.4.0

v1.4.0 (2026-08-09)

破坏性升级

• Web 播放器、管理后台和音云原生客户端统一使用 /api/v1 接口契约。
• 管理后台使用 /api/v1/admin/*，播放器使用 /api/v1/player/*。
• 裸 /api/* 已移除并返回 410 Gone；Subsonic /rest/* 保持可用。
• 旧 Web、Windows 客户端和旧 API 调用方不再兼容；Windows 客户端配套版本为 v1.1.0。