企业官网建设流程全解析

洛雪音乐助手使用指南：多源聚合搜索与完整配置手册

【免费下载链接】lx-music-desktop一个基于 Electron 的音乐软件项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop

同一首歌在三个平台上各有一份，歌单又散落在不同 App 里，想连续听完得来回切换应用。洛雪音乐助手（LX Music 桌面版）是一款免费开源的桌面播放器：内置酷我、酷狗、QQ 音乐、网易云、咪咕五平台，在一个搜索框里聚合返回结果，并覆盖本地列表管理、下载、桌面歌词，适合同时在多个平台听歌、又想把歌单握在自己手里的用户。先说一条边界：软件本身不生产音频，播放链接来自设置中配置的"音乐源"，不能把它当整库批量下载工具用。

洛雪音乐助手主界面：左侧为搜索、歌单、排行榜、下载入口，中部展示聚合结果，底部为播放控制条

从安装到第一次使用：5 分钟上手

1. 下载对应平台的版本。Windows 分安装版（Setup，支持自动更新）、绿色版（免安装，无自动更新）与 x64/x86/arm 位数包；macOS 为dmg；Linux 有AppImage、deb、rpm、pacman四种格式。当前版本 2.12.x，基于 Electron 40.x 与 Vue 3，Windows 需 7 及以上系统。
2. 播放一首歌。顶部搜索框输入歌名，结果由 5 个源并行返回、每源最多 25 条，点击歌曲会自动加入"我的列表"中的试听列表后再播放。
3. 核对 3 个设置项。① 设置→搜索：启用了哪些平台源、播放音质（默认128k，可选到320k/flac/flac24bit）；② 设置→基本：界面主题，默认"绿意盎然"；③ 设置→快捷键：本地快捷键mod+f5播放/暂停（macOS 上mod为Command），F11进出全屏。

经验提示：官方明确说明默认设置与 UI 操作"不以新手友好为目标"，第一次使用时把设置项过一遍，再弄清播放列表机制，能避免"为什么点歌只播一首"这类困惑。

多源聚合搜索：一个框查五个平台

能力说明：内置酷我（kw）、酷狗（kg）、QQ 音乐（tx）、网易云（wy）、咪咕（mg）5 个平台 SDK，一次搜索合并返回；音质分128k、320k、flac、flac24bit四档，各源支持的档位是四档中的子集，默认播放音质为128k。

机制：每个平台的接口封装在独立目录，搜索时逐源并行请求后合并排序，入口在 src/renderer/utils/musicSdk/。

适用场景：

• 一首歌只在单一平台能听：一次搜索即可看到它在各平台的可用情况
• 想拿高音质：直接挑带flac标签的结果试听
• 同一首歌各源封面、歌手名、播放量不同，便于核对版本
• 粘贴歌单链接或 ID 可打开在线歌单，并整体收藏进"我的列表"

经验提示：只用一两个平台时，把其余源关掉，列表更干净、返回更快；同一条结果音质标签低不一定是没有，先在"设置→搜索"确认该源启用的音质档位。

本地列表与"稍后播放"队列

能力说明："我的列表"全部存本地数据库（better-sqlite3），多选操作为Shift连续选、Ctrl不连续选、Ctrl+A全选后右击操作已选项；"稍后播放"是优先级最高的特殊队列，点"下一曲"时优先消耗。

机制：搜索列表、歌单、排行榜里的单曲点播只会播放一首，点击歌曲会先进试听列表；要连续播放一批，需要多选后加入自建列表，或走"稍后播放"，列表管理逻辑在 src/renderer/store/list/。

适用场景：

• 听完整个在线歌单：全选→加入自建列表→到列表里播放
• 批量下载：多选后下载，默认最多 3 个并发任务，可内嵌封面、以utf8保存歌词
• 调整列表顺序：按住Ctrl（macOS 为Command）进入拖动模式
• 列表内找歌：Ctrl+F打开列表内搜索框，Ctrl+回车跳转并播放选中项

经验提示：直接点击歌曲切歌（不经"上一曲/下一曲"）会清空"稍后播放"队列，想保留队列内容就用"下一曲"切歌。

桌面歌词与音效链

能力说明：桌面歌词是独立于主窗口的置顶窗口，横排/竖排两种形态，默认 450×300、字号 20，支持锁定位置、暂停时隐藏、鼠标移出隐藏；音效链由 10 段均衡器（31Hz 至 16kHz）、卷积混响、立体声平移、变调 4 类模块叠加组成，每类都能保存预设。

机制：歌词窗口由独立渲染进程运行、主进程负责窗口管理；效果链是可按序插入的音频节点序列，主进程逻辑在 src/main/modules/winLyric/，音效组件在 src/renderer/components/common/SoundEffectBtn/。

适用场景：

• 边写文档边看歌词：开启"鼠标移出隐藏"与"暂停时隐藏"
• 想拉开空间感：给轻音乐挂一个轻度混响预设
• 廉价耳机听人声：EQ 拉中频即可，不必加混响
• 播放详情页可换内置背景图，风格随主题走

内置水墨风主题背景（2560×1440），可用作播放详情页背景

经验提示：桌面歌词默认关闭，需在"设置→桌面歌词设置"里启用；只想锁定歌词窗口位置时，右击播放栏的LRC按钮即可，不必回到设置页。

故障与配置速查

进阶与自动化

• 自建数据同步服务：v2.2.0 起可部署独立同步服务端，多台电脑同步歌单、设置与播放记录，默认端口23332，客户端逻辑见 src/main/modules/sync/。适用人群：有多台电脑且有自己的服务器；注意传输为明文，只在受信任网络启用，首次同步前先备份一次列表。
• 开放 API：v2.7.0 起可启用本地 HTTP 服务（默认端口23330），提供播放器状态、切歌、搜索等接口，实现见 src/main/modules/openApi/。适用人群：写脚本或做智能家居联动；注意默认只监听本机，确需局域网访问再打开绑定选项。
• Scheme URL 与启动参数：lxmusic://协议支持搜索、打开歌单、播放歌曲（v1.17.0 起）；命令行支持-search、-play、-proxy-server、-hidden等参数，例如启动即从本地列表第 2 首播放：-play="type=songList&source=myList&name=默认列表&index=2"。适用人群：习惯命令行或浏览器油猴脚本的用户；注意 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