企业官网建设流程全解析

LX Music：免费开源的多音源音乐搜索播放器，三步跑起来

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

LX Music 是免费开源的多音源聚合音乐播放器，把酷我、酷狗、QQ音乐、网易云等多平台的在线音源装进同一个搜索框，一处搜全所有歌。适合想免费听歌的用户，也适合读 Electron 桌面代码的开发者。

🚀 跑起来：三步在本地运行 LX Music

直接用的话，从 release 页面下载对应平台的安装包双击安装即可。想改代码，需要 Node 22 以上：

git clone https://gitcode.com/GitHub_Trending/lx/lx-music-desktop cd lx-music-desktop npm install npm run dev

默认设置不以新手友好为目标，首次启动先做三件事：

1. 改音质：默认 128k，在「设置 → 播放」里按网络情况改成 320k 或无损
2. 定下载路径：在「设置 → 下载」里启用下载并指定保存位置，默认落在桌面，并发下载任务上限 3 个
3. 挑主题：在设置里选一个顺眼的主题，桌面歌词可以稍后再开

🎬 场景走查：多音源搜索找歌、开桌面歌词窗

多源聚合搜索解决「歌找不到」的场景。你输入歌名，程序会同时向选定的多个平台音源接口发查询，把结果合并、去重、排序。实际体验：一首歌在某个平台下架了，别的平台音源还会顶上，命中率比单平台客户端高不少，音源失效时可以切源重试。代码在 src/renderer/utils/musicSdk/，每个平台一个子目录（kw、kg、tx、wy、mg），搜索、歌单、歌词接口各自独立封装。

桌面歌词解决「工作时想看歌词」的场景。开启后弹出独立于主窗口的歌词窗：横向纵向可选，字体字号、已唱未唱两种行颜色、透明度、锁屏置顶都能设。固定在屏幕角落，行随播放滚动，不用切窗口。这个窗口单独打包，跑在 src/renderer-lyric/ 目录。

音质档位解决「想要无损但音源不支持」的场景。128k、320k、flac、wav 按歌曲和平台支持情况选择，选的源不支持时程序会取它能支持的档位。

🔍 深度剖析：一次搜索如何变成多平台并行请求

LX Music 是典型的 Electron 三层结构：主进程在 src/main/（窗口、托盘、热键、开放 API、同步服务都在 modules/ 下），主界面 src/renderer/ 用 Vue 3 + TypeScript 写，桌面歌词窗是 src/renderer-lyric/，共享的配置默认值和类型定义放 src/common/。歌单、收藏等本地数据用 better-sqlite3（内嵌 SQLite 数据库，不用单独装数据库服务）写进本地文件。

跟着数据流走一遍：搜索框输入歌名 → 渲染进程把它拆成多个并行请求发给各平台接口 → 结果按「歌名 + 歌手 + 时长」匹配去重排序 → 点开播放，src/renderer/core/player/ 的播放器接管音量、进度、倍速和 EQ、混响等音效；音源失效会自动试下一个。

技术栈是 Electron 40（用 Web 技术写桌面应用的框架）+ Vue 3 + TypeScript，webpack 打包。想参与贡献：克隆仓库切 dev 分支开发，PR 提交到 dev；新功能建议先建 Issue 讨论必要性，修 bug 附复现方式，合并会顺很多。

🛠️ 自定义与扩展：用开放 API 把 LX Music 接进脚本

开放 API：v2.7.0 起在「设置 → 开放 API」里启用，本机启动一个 HTTP 服务，暴露播放/暂停、切歌、跳转进度、音量、静音、当前状态、整首歌词等接口。写几行脚本就能把播放器接进定时任务，或订阅状态变化实时调音量。实现在 src/main/modules/openApi/。

自建数据同步：v2.2.0 起把同步服务部署到自己服务器，多台电脑的歌单、收藏保持一致，客户端和服务端代码都在 src/main/modules/sync/ 下，数据留在自己手里。

主题定制：主题定义在 src/common/theme/，index.json 保存每个主题的名称、明暗模式和一整套 CSS 颜色变量，背景图在同目录 images/ 下。内置「绿意盎然」等主题在设置里一键切换，也可以照同样格式自建主题——换一张背景图就是一套新皮肤。

适合谁

• 歌分散在多个平台，想一个入口搜全的用户
• 要在多台设备间同步歌单、又不想把数据放公网的人
• 想用 API 把播放器接进脚本或智能家居的开发者
• 想参考结构完整的 Electron + Vue 3 桌面应用源码的程序员

找得到歌、免费听、数据自己管，这三件事 LX Music 都替你办了。

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