音源导入完整流程
打开 LX Music → 点击右上角"设置"图标 → 选择"基本设置" → 找到"自定义源" → 点击"自定义源管理"按钮。
在弹窗中可选择"本地导入"（选择已下载的音源接口文件，常见为 .js 文件）或"在线导入"（粘贴音源在线地址，软件会自动拉取）。
导入后勾选启用对应音源，关闭弹窗。回到"音乐来源"设置，将启用后的音源设为默认搜索源即可。
3 分钟上手 LX Music
从安装、配置音源到畅听第一首歌，本页面将带你完成所有关键步骤，并解答最常见的使用问题。
QUICK START
4 步开始听歌
第一次使用 LX Music？跟着下面四步走，3 分钟即可畅听全网音乐。
下载并安装
前往 下载中心 选择对应平台的安装包。Windows 用户推荐 Setup.exe（支持自动更新），追求绿色便携可选择 green.7z。
导入音源
首次启动后进入"设置 → 基本设置 → 自定义源管理"，选择本地导入或在线导入音源接口文件。导入后启用对应音源。
设置默认源
在"设置 → 音乐来源"中将导入的音源设为默认搜索源。也可针对特殊歌曲临时手动指定其他平台搜索。
搜索并播放
在顶部搜索框输入歌曲名、歌手或专辑关键词，回车后即可看到跨平台聚合结果。点击即可试听，长按可下载。
关于音源：LX Music 项目本身不内置、不分发任何音源接口文件，音源由用户自行配置。请从可信渠道获取音源，并仅用于个人学习研究，禁止商用。
DEEP DIVE
进阶配置详解
掌握下面这些设置，让 LX Music 更贴合你的使用习惯。
桌面歌词个性化
播放任意歌曲时，点击播放控制栏的"歌词"按钮即可独立开启桌面歌词窗口。窗口可拖动到任意位置，右键菜单可设置置顶。
从 v2.11.0 起，暂停播放时桌面歌词会自动提高透明度，避免遮挡其他内容。
字体大小、颜色、对齐方式均可在"设置 → 桌面歌词"中自定义，支持歌词卡拉 OK 高亮效果。
跨端数据同步
同步功能需要桌面版 v2.4.0+ 与移动版 v1.1.0+，同步服务端需自部署（详见官方文档）。
服务端可使用 Docker 一键部署，仅需配置同步服务器地址、端口与认证码。
在客户端"设置 → 同步设置"中填入服务器信息，开启同步后收藏歌曲将在所有端保持一致。
开放 API 启用
从 v2.7.0 起内置开放 API 服务。在"设置 → 开放 API"中开启后，软件会在本地启动 HTTP 服务。
第三方软件可通过 HTTP 接口调用控制播放器，实现播放、暂停、切歌、获取歌词等操作。
配合官方提供的油猴脚本，还能在网页上一键将歌曲发送到 LX Music 播放。
FAQ
常见问题解答
收集自 GitHub Issues 与社区讨论中最常被问到的 10 个问题。
是的，LX Music 完全免费。官方声明明确写道："本项目完全免费，且开源发布于 GitHub，直至停止维护都会保持免费、开源、无广告。"不存在会员、内购或付费解锁。补充协议第 6.1 / 8.1 条款中明确规定不接受任何商业行为，包括但不限于贩卖、捆绑销售、植入广告等。
软件完全开源，代码公开于 GitHub 可供任何用户审查。官方强调无强制登录、无手机号绑定、不收集个人信息。
但需注意：网络上流传的"魔改版 / 第三方封装版"非官方发布，可能存在安全风险（如植入挖矿、窃取数据等）。请只从官方渠道（GitHub Releases 或官网下载页）获取安装包。
但需注意：网络上流传的"魔改版 / 第三方封装版"非官方发布，可能存在安全风险（如植入挖矿、窃取数据等）。请只从官方渠道（GitHub Releases 或官网下载页）获取安装包。
出于版权与合规考虑，官方不再内置音源。用户需通过"设置 → 音乐来源 / 自定义源管理"自行导入音源接口文件（本地导入或在线导入）。
音源由第三方编写或社区分享，与 LX Music 项目本身无隶属关系。请在可信渠道获取音源，并仅用于个人学习研究。
音源由第三方编写或社区分享，与 LX Music 项目本身无隶属关系。请在可信渠道获取音源，并仅用于个人学习研究。
LX Music 本身只是一个调用第三方接口的"音乐查找工具"，不存储、不分发音乐内容。其补充协议明确本项目仅用于技术学习与研究，所产生的版权数据归原平台所有，可联系项目更改或移除。
使用者需自行承担遵守当地法律法规的责任，仅限个人学习研究使用，禁止商用。商业使用（包括但不限于贩卖、捆绑销售、植入广告等）均被协议明确禁止。
使用者需自行承担遵守当地法律法规的责任，仅限个人学习研究使用，禁止商用。商业使用（包括但不限于贩卖、捆绑销售、植入广告等）均被协议明确禁止。
LX Music 不会强制上传你的个人数据。数据同步功能为实验性、可自主部署的同步服务（需用户自行搭建或使用自建同步服务端），数据完全可控。
如果你没有启用同步功能，所有数据仅保存在本地，不会上传到任何服务器。
如果你没有启用同步功能，所有数据仅保存在本地，不会上传到任何服务器。
Windows 安装版（Setup.exe）：启动时会自动检测并安装更新。
Windows 绿色版（green.7z）：无自动更新，需手动下载新版覆盖。
macOS / Linux：可通过各自包管理器（如 Homebrew、Flatpak、AUR）或官网下载新版覆盖安装。
更新失败通常是因为网络访问 GitHub 较慢，建议前往 GitHub Releases 手动下载安装包覆盖安装。
Windows 绿色版（green.7z）：无自动更新，需手动下载新版覆盖。
macOS / Linux：可通过各自包管理器（如 Homebrew、Flatpak、AUR）或官网下载新版覆盖安装。
更新失败通常是因为网络访问 GitHub 较慢，建议前往 GitHub Releases 手动下载安装包覆盖安装。
桌面版（lx-music-desktop）：基于 Electron + Vue 3，支持 Windows / macOS / Linux，功能最完整（桌面歌词、开放 API、Scheme URL 等）。
移动版（lx-music-mobile）：基于 React Native，仅支持 Android 5+；移动端听歌体验良好，但功能特性与桌面版略有差异（如移动端不能下载，以在线试听为主）。
两者可通过数据同步服务同步收藏的歌曲，互为补充。
移动版（lx-music-mobile）：基于 React Native，仅支持 Android 5+；移动端听歌体验良好，但功能特性与桌面版略有差异（如移动端不能下载，以在线试听为主）。
两者可通过数据同步服务同步收藏的歌曲，互为补充。
可能原因与排查方法：
1. 音源失效：第三方音源可能因平台接口变更而失效，更换其他音源重试。
2. 网络异常：检查网络连接，必要时配置代理。
3. 未启用音源：确认导入的音源已在"自定义源管理"中勾选启用。
4. 未设为默认源：在"音乐来源"中将启用后的音源设为默认搜索源。
所有歌曲都提示"请求异常"时，可多次重试；仍不行则更换音源。具体排查见 官方 FAQ。
1. 音源失效：第三方音源可能因平台接口变更而失效，更换其他音源重试。
2. 网络异常：检查网络连接，必要时配置代理。
3. 未启用音源：确认导入的音源已在"自定义源管理"中勾选启用。
4. 未设为默认源：在"音乐来源"中将启用后的音源设为默认搜索源。
所有歌曲都提示"请求异常"时，可多次重试；仍不行则更换音源。具体排查见 官方 FAQ。
不支持。官方明确目前没有计划支持 iOS 与 HarmonyOS NEXT。iOS 用户可考虑通过 PWA 等替代方案，或关注社区后续动态。
Android 5 及以上用户可使用 lx-music-mobile 移动版。
Android 5 及以上用户可使用 lx-music-mobile 移动版。
欢迎通过以下方式参与：
1. 问题反馈：在 GitHub Issues 提交 Bug 报告或功能请求。
2. 参与讨论：在 GitHub Discussions 与其他用户交流使用心得。
3. 代码贡献：Fork 仓库并提交 Pull Request，欢迎参与功能开发与 Bug 修复。
4. 官方反馈入口：也可通过 官网反馈页 提交问题。
1. 问题反馈：在 GitHub Issues 提交 Bug 报告或功能请求。
2. 参与讨论：在 GitHub Discussions 与其他用户交流使用心得。
3. 代码贡献：Fork 仓库并提交 Pull Request，欢迎参与功能开发与 Bug 修复。
4. 官方反馈入口：也可通过 官网反馈页 提交问题。
