洛雪音乐助手使用指南多源聚合搜索与完整配置手册【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop同一首歌在三个平台上各有一份歌单又散落在不同 App 里想连续听完得来回切换应用。洛雪音乐助手LX Music 桌面版是一款免费开源的桌面播放器内置酷我、酷狗、QQ 音乐、网易云、咪咕五平台在一个搜索框里聚合返回结果并覆盖本地列表管理、下载、桌面歌词适合同时在多个平台听歌、又想把歌单握在自己手里的用户。先说一条边界软件本身不生产音频播放链接来自设置中配置的音乐源不能把它当整库批量下载工具用。洛雪音乐助手主界面左侧为搜索、歌单、排行榜、下载入口中部展示聚合结果底部为播放控制条从安装到第一次使用5 分钟上手下载对应平台的版本。Windows 分安装版Setup支持自动更新、绿色版免安装无自动更新与 x64/x86/arm 位数包macOS 为dmgLinux 有AppImage、deb、rpm、pacman四种格式。当前版本 2.12.x基于 Electron 40.x 与 Vue 3Windows 需 7 及以上系统。播放一首歌。顶部搜索框输入歌名结果由 5 个源并行返回、每源最多 25 条点击歌曲会自动加入我的列表中的试听列表后再播放。核对 3 个设置项。① 设置→搜索启用了哪些平台源、播放音质默认128k可选到320k/flac/flac24bit② 设置→基本界面主题默认绿意盎然③ 设置→快捷键本地快捷键modf5播放/暂停macOS 上mod为CommandF11进出全屏。经验提示官方明确说明默认设置与 UI 操作不以新手友好为目标第一次使用时把设置项过一遍再弄清播放列表机制能避免为什么点歌只播一首这类困惑。多源聚合搜索一个框查五个平台能力说明内置酷我kw、酷狗kg、QQ 音乐tx、网易云wy、咪咕mg5 个平台 SDK一次搜索合并返回音质分128k、320k、flac、flac24bit四档各源支持的档位是四档中的子集默认播放音质为128k。机制每个平台的接口封装在独立目录搜索时逐源并行请求后合并排序入口在 src/renderer/utils/musicSdk/。适用场景一首歌只在单一平台能听一次搜索即可看到它在各平台的可用情况想拿高音质直接挑带flac标签的结果试听同一首歌各源封面、歌手名、播放量不同便于核对版本粘贴歌单链接或 ID 可打开在线歌单并整体收藏进我的列表经验提示只用一两个平台时把其余源关掉列表更干净、返回更快同一条结果音质标签低不一定是没有先在设置→搜索确认该源启用的音质档位。本地列表与稍后播放队列能力说明我的列表全部存本地数据库better-sqlite3多选操作为Shift连续选、Ctrl不连续选、CtrlA全选后右击操作已选项稍后播放是优先级最高的特殊队列点下一曲时优先消耗。机制搜索列表、歌单、排行榜里的单曲点播只会播放一首点击歌曲会先进试听列表要连续播放一批需要多选后加入自建列表或走稍后播放列表管理逻辑在 src/renderer/store/list/。适用场景听完整个在线歌单全选→加入自建列表→到列表里播放批量下载多选后下载默认最多 3 个并发任务可内嵌封面、以utf8保存歌词调整列表顺序按住CtrlmacOS 为Command进入拖动模式列表内找歌CtrlF打开列表内搜索框Ctrl回车跳转并播放选中项经验提示直接点击歌曲切歌不经上一曲/下一曲会清空稍后播放队列想保留队列内容就用下一曲切歌。桌面歌词与音效链能力说明桌面歌词是独立于主窗口的置顶窗口横排/竖排两种形态默认 450×300、字号 20支持锁定位置、暂停时隐藏、鼠标移出隐藏音效链由 10 段均衡器31Hz 至 16kHz、卷积混响、立体声平移、变调 4 类模块叠加组成每类都能保存预设。机制歌词窗口由独立渲染进程运行、主进程负责窗口管理效果链是可按序插入的音频节点序列主进程逻辑在 src/main/modules/winLyric/音效组件在 src/renderer/components/common/SoundEffectBtn/。适用场景边写文档边看歌词开启鼠标移出隐藏与暂停时隐藏想拉开空间感给轻音乐挂一个轻度混响预设廉价耳机听人声EQ 拉中频即可不必加混响播放详情页可换内置背景图风格随主题走内置水墨风主题背景2560×1440可用作播放详情页背景经验提示桌面歌词默认关闭需在设置→桌面歌词设置里启用只想锁定歌词窗口位置时右击播放栏的LRC按钮即可不必回到设置页。故障与配置速查现象处理路径所有歌曲提示请求异常升级最新版→设置→音乐来源切换接口→换手机热点仍失败多为接口侧问题等一两天再试提示getaddrinfo EAI_AGAIN或无法连接到服务器多为 DNS 问题可改为223.6.6.6、8.8.8.8改完重启软件Windows 10/11 界面无法显示或异常快捷方式加启动参数依次尝试--disable-gpu-sandbox、-dha、--no-sandbox、--disable-gpumacOS 提示已损坏无法启动软件未签名被系统拦截终端执行xattr移除隔离属性换机/重装后数据丢失定期备份数据目录Windows%APPDATA%/lx-music-desktop、macOS~/Library/Application Support/lx-music-desktop、Linux~/.config/lx-music-desktop自动更新失败仅 Windows 安装版支持自动更新绿色版、macOS、Linux 需手动下载新包覆盖安装杀毒软件提示访问摄像头v0.17.0 起音频设备切换功能触发提示实际未用摄像头可阻止进阶与自动化自建数据同步服务v2.2.0 起可部署独立同步服务端多台电脑同步歌单、设置与播放记录默认端口23332客户端逻辑见 src/main/modules/sync/。适用人群有多台电脑且有自己的服务器注意传输为明文只在受信任网络启用首次同步前先备份一次列表。开放 APIv2.7.0 起可启用本地 HTTP 服务默认端口23330提供播放器状态、切歌、搜索等接口实现见 src/main/modules/openApi/。适用人群写脚本或做智能家居联动注意默认只监听本机确需局域网访问再打开绑定选项。Scheme URL 与启动参数lxmusic://协议支持搜索、打开歌单、播放歌曲v1.17.0 起命令行支持-search、-play、-proxy-server、-hidden等参数例如启动即从本地列表第 2 首播放-playtypesongListsourcemyListname默认列表index2。适用人群习惯命令行或浏览器油猴脚本的用户注意 URL 传参需自行编码。自定义源脚本用 ES6 的 JavaScript 脚本注册自定义音频源通过事件与主程序通信可用音质值为128k/320k/flac/flac24bit。适用人群有脚本能力且拥有自有音源注意链接准确性由脚本负责可能出现播放内容与实际不符。暂不支持账号登录、社交分享、移动端推送这类需求目前只能靠外部服务解决。选型判断适合经常在 2 个以上平台找歌有桌面歌词刚需希望歌单、下载、设置完全由本地文件或自建同步服务掌控接受先花几分钟把设置过一遍的入门成本。不适合追求官方 App 的推送、社交、推荐流体验期待无限制批量下载整库资源或不愿意学习多选与播放列表机制。最低成本验证方式先装上使用一周只调搜索源和主题两项设置确有跨设备需求时再决定是否部署同步服务与开放 API。完整功能演进见 CHANGELOG.md上表现象的细节处理见 FAQ.md。【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
洛雪音乐助手使用指南：多源聚合搜索与完整配置手册
洛雪音乐助手使用指南多源聚合搜索与完整配置手册【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop同一首歌在三个平台上各有一份歌单又散落在不同 App 里想连续听完得来回切换应用。洛雪音乐助手LX Music 桌面版是一款免费开源的桌面播放器内置酷我、酷狗、QQ 音乐、网易云、咪咕五平台在一个搜索框里聚合返回结果并覆盖本地列表管理、下载、桌面歌词适合同时在多个平台听歌、又想把歌单握在自己手里的用户。先说一条边界软件本身不生产音频播放链接来自设置中配置的音乐源不能把它当整库批量下载工具用。洛雪音乐助手主界面左侧为搜索、歌单、排行榜、下载入口中部展示聚合结果底部为播放控制条从安装到第一次使用5 分钟上手下载对应平台的版本。Windows 分安装版Setup支持自动更新、绿色版免安装无自动更新与 x64/x86/arm 位数包macOS 为dmgLinux 有AppImage、deb、rpm、pacman四种格式。当前版本 2.12.x基于 Electron 40.x 与 Vue 3Windows 需 7 及以上系统。播放一首歌。顶部搜索框输入歌名结果由 5 个源并行返回、每源最多 25 条点击歌曲会自动加入我的列表中的试听列表后再播放。核对 3 个设置项。① 设置→搜索启用了哪些平台源、播放音质默认128k可选到320k/flac/flac24bit② 设置→基本界面主题默认绿意盎然③ 设置→快捷键本地快捷键modf5播放/暂停macOS 上mod为CommandF11进出全屏。经验提示官方明确说明默认设置与 UI 操作不以新手友好为目标第一次使用时把设置项过一遍再弄清播放列表机制能避免为什么点歌只播一首这类困惑。多源聚合搜索一个框查五个平台能力说明内置酷我kw、酷狗kg、QQ 音乐tx、网易云wy、咪咕mg5 个平台 SDK一次搜索合并返回音质分128k、320k、flac、flac24bit四档各源支持的档位是四档中的子集默认播放音质为128k。机制每个平台的接口封装在独立目录搜索时逐源并行请求后合并排序入口在 src/renderer/utils/musicSdk/。适用场景一首歌只在单一平台能听一次搜索即可看到它在各平台的可用情况想拿高音质直接挑带flac标签的结果试听同一首歌各源封面、歌手名、播放量不同便于核对版本粘贴歌单链接或 ID 可打开在线歌单并整体收藏进我的列表经验提示只用一两个平台时把其余源关掉列表更干净、返回更快同一条结果音质标签低不一定是没有先在设置→搜索确认该源启用的音质档位。本地列表与稍后播放队列能力说明我的列表全部存本地数据库better-sqlite3多选操作为Shift连续选、Ctrl不连续选、CtrlA全选后右击操作已选项稍后播放是优先级最高的特殊队列点下一曲时优先消耗。机制搜索列表、歌单、排行榜里的单曲点播只会播放一首点击歌曲会先进试听列表要连续播放一批需要多选后加入自建列表或走稍后播放列表管理逻辑在 src/renderer/store/list/。适用场景听完整个在线歌单全选→加入自建列表→到列表里播放批量下载多选后下载默认最多 3 个并发任务可内嵌封面、以utf8保存歌词调整列表顺序按住CtrlmacOS 为Command进入拖动模式列表内找歌CtrlF打开列表内搜索框Ctrl回车跳转并播放选中项经验提示直接点击歌曲切歌不经上一曲/下一曲会清空稍后播放队列想保留队列内容就用下一曲切歌。桌面歌词与音效链能力说明桌面歌词是独立于主窗口的置顶窗口横排/竖排两种形态默认 450×300、字号 20支持锁定位置、暂停时隐藏、鼠标移出隐藏音效链由 10 段均衡器31Hz 至 16kHz、卷积混响、立体声平移、变调 4 类模块叠加组成每类都能保存预设。机制歌词窗口由独立渲染进程运行、主进程负责窗口管理效果链是可按序插入的音频节点序列主进程逻辑在 src/main/modules/winLyric/音效组件在 src/renderer/components/common/SoundEffectBtn/。适用场景边写文档边看歌词开启鼠标移出隐藏与暂停时隐藏想拉开空间感给轻音乐挂一个轻度混响预设廉价耳机听人声EQ 拉中频即可不必加混响播放详情页可换内置背景图风格随主题走内置水墨风主题背景2560×1440可用作播放详情页背景经验提示桌面歌词默认关闭需在设置→桌面歌词设置里启用只想锁定歌词窗口位置时右击播放栏的LRC按钮即可不必回到设置页。故障与配置速查现象处理路径所有歌曲提示请求异常升级最新版→设置→音乐来源切换接口→换手机热点仍失败多为接口侧问题等一两天再试提示getaddrinfo EAI_AGAIN或无法连接到服务器多为 DNS 问题可改为223.6.6.6、8.8.8.8改完重启软件Windows 10/11 界面无法显示或异常快捷方式加启动参数依次尝试--disable-gpu-sandbox、-dha、--no-sandbox、--disable-gpumacOS 提示已损坏无法启动软件未签名被系统拦截终端执行xattr移除隔离属性换机/重装后数据丢失定期备份数据目录Windows%APPDATA%/lx-music-desktop、macOS~/Library/Application Support/lx-music-desktop、Linux~/.config/lx-music-desktop自动更新失败仅 Windows 安装版支持自动更新绿色版、macOS、Linux 需手动下载新包覆盖安装杀毒软件提示访问摄像头v0.17.0 起音频设备切换功能触发提示实际未用摄像头可阻止进阶与自动化自建数据同步服务v2.2.0 起可部署独立同步服务端多台电脑同步歌单、设置与播放记录默认端口23332客户端逻辑见 src/main/modules/sync/。适用人群有多台电脑且有自己的服务器注意传输为明文只在受信任网络启用首次同步前先备份一次列表。开放 APIv2.7.0 起可启用本地 HTTP 服务默认端口23330提供播放器状态、切歌、搜索等接口实现见 src/main/modules/openApi/。适用人群写脚本或做智能家居联动注意默认只监听本机确需局域网访问再打开绑定选项。Scheme URL 与启动参数lxmusic://协议支持搜索、打开歌单、播放歌曲v1.17.0 起命令行支持-search、-play、-proxy-server、-hidden等参数例如启动即从本地列表第 2 首播放-playtypesongListsourcemyListname默认列表index2。适用人群习惯命令行或浏览器油猴脚本的用户注意 URL 传参需自行编码。自定义源脚本用 ES6 的 JavaScript 脚本注册自定义音频源通过事件与主程序通信可用音质值为128k/320k/flac/flac24bit。适用人群有脚本能力且拥有自有音源注意链接准确性由脚本负责可能出现播放内容与实际不符。暂不支持账号登录、社交分享、移动端推送这类需求目前只能靠外部服务解决。选型判断适合经常在 2 个以上平台找歌有桌面歌词刚需希望歌单、下载、设置完全由本地文件或自建同步服务掌控接受先花几分钟把设置过一遍的入门成本。不适合追求官方 App 的推送、社交、推荐流体验期待无限制批量下载整库资源或不愿意学习多选与播放列表机制。最低成本验证方式先装上使用一周只调搜索源和主题两项设置确有跨设备需求时再决定是否部署同步服务与开放 API。完整功能演进见 CHANGELOG.md上表现象的细节处理见 FAQ.md。【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
