洛雪音乐助手

2.10.0

不兼容性变更

Linux 系统至少需要 GLIBC_2.29 版本才能运行。

由于将 Electron 升级到 v32.x，原生库的编译被限制到不低于 C++ 20，试了几次无法在 docker 镜像 node:16 安装 gcc-10，最终将构建使用镜像更新到 node:18。

新增

新增下载的歌曲按列表名分组的功能，默认关闭，可以通过「设置 → 下载设置 → 将文件保存到以对应列表命名的子目录中」启用

新增托盘图标样式「跟随系统亮暗模式」设置，可以在「设置 → 其他」里启用

支持本地同名 .krc 格式歌词文件的读取

开放 API 新增播放器播放/暂停、切歌、收藏当前播放歌曲等接口调用，详情看文档「开放 API 服务」部分

优化

优化正常播放结束时的下一首歌曲播放衔接度，在歌曲即将结束播放时将预获取下一首歌曲的播放链接，减少自动切歌时的等待时间

优化歌曲换源机制，提升换源正确率

优化 Windows 平台上桌面歌词窗口大小调整机制，改用原生的窗口调整方式

修正搜索歌曲提示框文案

优化播放详情页 UI，修复「歌曲名」「艺术家」等文字过长时被截断的问题

Scheme URL 的播放歌曲允许更长的专辑名称

播放本地歌曲时，将优先尝试读取本地同名 .jpg 或 .png 图片作为播放封面显示，若文件不存在则从音频文件内读取，最后再尝试使用在线图片

客户端模式的同步服务连接允许重定向 5 次

更新软件默认使用的字体，修复 macOS Sequoia (15) 上界面出现乱码的问题

优化简体、繁体中文文案编排，大幅修订英语文案编排

优化排序歌曲、主题名称、添加/编辑主题、列表更新管理等对话框布局及长文本显示效果

修复

修复歌单详情页内歌单名字过长时的 UI 显示问题

修复获取自定义环境音效预设列表逻辑问题

修复 .m4a 文件内嵌歌词无法读取的问题

修复 Windows 任务管理器中的进程名显示为软件描述的问题

修复本地歌曲同名歌词文件调整偏移时间后，下次再播放时调整的设置未被应用的问题

修复首次打开软件后直接创建并删除列表时的报错问题

变更

不再长期缓存换源歌曲信息

更新软件默认使用的字体，现在软件尽量使用系统自带的默认字体

Linux 系统至少需要 GLIBC_2.29 版本才能运行

其他

更新 Readme 文档，优化文案编排

更新 Issue 模板

更新项目文档

修订项目协议文件

更新 Electron 到 v32.3.0

自定义源的不兼容变更与新增内容(源开发者需要看)

自定义源的调用方式已改变：

为了与移动端的调用方式统一，不再推荐使用 window.lx 对象(移动端无window对象)，改用 globalThis.lx

inited 事件不再需要传递 status 属性，脚本运行过程中，在成功调用 inited 事件之前的任何首次未捕获的错误都将视为初始化失败，所以现在若想人为让脚本初始化失败，直接抛出一个错误即可

新增 globalThis.lx.env 属性，桌面端环境固定为 desktop，移动端环境固定为 mobile

新增 globalThis.lx.currentScriptInfo 对象，可以从这里获取解析后的脚本头部注释信息及脚本原始内容，具体可用属性看文档说明

globalThis.lx.version 属性更新到 2.0.0

自定义源不再使用script标签的形式执行，若要获取脚本原始代码字符串需从 globalThis.lx.currentScriptInfo.rawScript 属性获取

自定义源新增支持local源的musicUrl、pic、lyric的获取操作详情看自定义源文档说明