企业官网建设流程全解析

LX Music：五音源聚合进一个搜索框，无损批量下载直接落本地曲库

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

LX Music 是一款 Apache 2.0 开源音乐播放器，把 QQ音乐、网易云、酷我、酷狗、咪咕五个音源聚合进一个搜索框。试听最高 flac24bit 无损，支持批量下载、内嵌封面与歌词，适合自建本地曲库。

🚀 安装 LX Music 并三步建起本地曲库

第 1 步：选对安装包装上。要完成的：装一个匹配系统的包。Windows 分 Setup 安装版与 green 绿色版，差别在启动时是否自动检测新版：只有安装版会弹窗提示更新，绿色版要手动换包；x64/x86对应系统位数。macOS 用.dmg，Linux 有.deb、.rpm、.AppImage、.pacman四种可选。操作位置是发布页。绿色版 v1.17.0 起多了便携模式：程序目录里存在portable文件夹时，配置和列表直接写进它，整目录拷到 U 盘即可带走。

第 2 步：跑通第一次搜索与试听。要完成的：确认能搜到、能放。顶部搜索框输入歌名回车，或先按 F1 聚焦，五个音源的结果合并返回，每行标着可用音质（128k / 320k / flac / flac24bit）。点任意一条直接播放，它会自动进本地播放列表，之后在"我的列表"随时翻到，不用重搜。

第 3 步：批量存进本地曲库。要完成的：把想留的歌变成文件。批量下载默认关闭，先到"设置 → 下载"打开开关。回到列表用 Ctrl 点选、Shift 连选或 Ctrl+A 全选，再右键"下载"。任务默认 3 个并发、存到桌面，跑完后在"下载"页能直接播放、补下失败项、右键加回列表。命名、并发、嵌封面这些默认值如下，都在"设置 → 下载"里可改：

• 文件名：歌名 - 歌手
• 并发下载：3
• 同名文件：跳过已存在
• 封面：默认写入
• 歌词：lxlrc 默认嵌入，普通 lrc 需手动勾选
• 按列表名分目录：默认关

🎧 调好无损音质、主题、LX Music 桌面歌词与快捷键

• 音质档位。改什么：试听与播放用的档位。在哪改："设置 → 播放"。默认 128k，日常够听还省流量；如果网络条件好就往上调到 flac 或 flac24bit。旁边还有"出错自动跳过"，默认开——某首加载失败时直接切下一首，不用你手动处理。
• 主题。改什么：整体配色。在哪改：设置里的主题区。内置主题一键切换，水墨和月夜两套最有辨识度。内置背景图在 src/common/theme/images/；设置里支持自建，拖一张背景图配上主色即可。

• 桌面歌词。改什么：是否出现一个独立歌词小窗及其样式。在哪改："设置 → 桌面歌词"。默认关，开启后它是独立于主窗口的小窗，默认尺寸 450×300。可设横排或竖排、字号、已播与未播颜色、透明度，还能锁位置、始终置顶；主窗口全屏或歌曲暂停时默认自动隐藏。
• 快捷键。改什么：是否用按键控制播放。在哪改："设置 → 快捷键"。应用内这组默认开，全局这组默认关；如果打开全局那组，窗口失焦时也能控制播放。macOS 上表中的 Ctrl 对应 Cmd。

🔌 开启数据同步、LX Music 开放 API 与自定义音源（可选）

三项都在设置里，默认全关，用哪个再开哪个。

• 数据同步。开关在"设置 → 数据同步"。开启后起一个本地服务，默认监听端口23332；在手机端填上 PC 的局域网地址，歌单、列表、设置就在多设备间互相同步。因为传输是明文，只在可信局域网里用；首次同步前先把列表备份一次，出问题能回滚。最小验证：开启后在手机端填PC地址:23332，看数据是否出现。
• LX Music 开放 API。开关在"设置 → 开放 API"。开启后起一个 HTTP 服务，默认只监听127.0.0.1:23330（仅本机可调用），对外暴露/status、/play、/pause、/skip-next、/lyric、/volume、/seek、/collect等端点；/subscribe-player-status以 SSE 事件流持续推播放状态，做歌词桌宠、状态面板这类小工具最方便。实现代码在 src/main/modules/openApi/。最小验证：本机跑一条命令，返回播放状态的 JSON 就说明端点可用。

curl http://127.0.0.1:23330/status

• 自定义音源。做法：在用户数据目录放一个.js脚本，声明支持的源与musicUrl动作，运行时监听musicUrl事件，被要求时返回该歌曲的 http/https 直链。脚本内发 HTTP 请求走lx.request，不受浏览器跨域限制、跟随软件代理设置；另提供 AES、MD5、RSA 一类加解密工具，用于处理接口签名。实现代码在 src/main/modules/userApi/。适合给某平台加专属音源，或在默认音源不稳定时留一条备用链路。最小验证：导入脚本后新音源出现在搜索里并能返回可播放直链。

🩺 卡住时查这里：三个高频问题快速排查

搜索整页刷不出来，所有歌曲提示请求异常多半是接口源不可用。先去"设置 → 音乐来源"换一个接口源；如果还不行就连手机热点看是不是网络问题；网络没问题就把 DNS 指向223.6.6.6或8.8.8.8，改完重启软件再试。

Windows 10/11 界面整屏空白或窗口显示不全这是 GPU 沙箱与显卡驱动冲突，属渲染层问题。给快捷方式追加--disable-gpu-sandbox这个启动参数；如果没效果，再逐个换成--no-sandbox、-dha、--disable-gpu试，能恢复显示的就是你要的参数。

--disable-gpu-sandbox --no-sandbox -dha --disable-gpu

下载任务报错 ENOENT: no such file or directory, mkdir所选下载路径没有读写权限，软件连文件夹都建不出来。把下载目录指向一个有读写权限的位置即可，比如用户主目录下自己新建的文件夹。

📍 各平台数据目录位置与最短上手路径

配置、列表、下载缓存都存在平台固定的数据目录里：

• Windows：%APPDATA%/lx-music-desktop
• Linux：~/.config/lx-music-desktop
• macOS：~/Library/Application Support/lx-music-desktop
• 绿色版是例外：v1.17.0 及以上若程序目录有portable文件夹，数据直接写进它

最短上手路径：装 Windows 安装版 → F1 搜歌 → 点一条试听 → 在"设置 → 下载"打开开关 → 批量存到桌面。卡住时按"换源 → 换网 → 改 DNS"的顺序排查。

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