xiaomusic 在线搜索快速上手指南从搜歌到小爱音箱在线点歌只需 3 步【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicxiaomusic 的「在线搜索」扩展让音箱不再只播本地曲库网页端直接搜歌、推送到小爱音箱播放或一句话语音点歌。你只需在 MusicFree 插件与 LX Server 接口两个生态里选一个填好配置即可用。选型决策MusicFree 插件版 vs LX Server 接口版这节帮你 30 秒定下生态不用翻整篇文档。两个生态并列且互斥后台「接口生态」区域二选一对应back_conf_info.api_type取值1MusicFree 插件或2LX Server 接口切换时会弹确认框——因为两边的配置项插件列表 vs 平台列表互不兼容。你的情况建议选已部署 LX Sync Server想最少配置LX Server 接口版填个地址就能用想要多源聚合、精细管理音源或有现成插件资源MusicFree 插件版没服务器可搭想尽快跑起来MusicFree 插件版生态内公开插件更多LX Server 接入实操3 步填好接口地址并通过测试这节带你走完 LX Server 路径的全部操作。在后台「接口生态」区域切到 LXServer 接口确认弹窗后进入配置区填入 API 地址占位示例http://127.0.0.1:9527/api系统会自动做格式校验点「接口测试」V1.1.2后端请求${base_url}/music/config校验player.enableAuth、user.enablePublicRestriction字段通过即说明地址可用。接下来管理平台添加tx小秋、kg小枸、kw小蜗、wy小芸、mg小蜜等标识搜索时会并行请求所有已配置平台再合并排序这就是聚合搜索。如果你的 LX Server 开了用户限制V1.1.3在x-user-name/x-user-token两个框里填上请求时会自动附加这两个鉴权头。⚠️ 版本坑LX Music Sync Serverv1.8.2 之后对接口增加了 Token 限制onlineSearch 尚未适配暂时别升到该版本反过来降到 1.8.1 的老版本又拿不到 token拉歌单会一直 401。升级前务必确认当前 xiaomusic 版本的适配情况详见 docs/issues/811.md 的排查记录。播放链路上 LX 生态内置了保障机制音质按master → flac24bit → flac → 320k → 192k → 128k优先选择某档直链拉不下来就自动降一档再试原平台彻底失败时会按歌名 歌手 时长误差 ≤ 5 秒跨平台找同一首歌换源播放。 前端对接口地址只做 IP/域名格式校验Docker 容器名这类自定义 host 会被拒直接把地址写进conf/plugins-config.json的base_url通常可用。MusicFree 插件配置实操订阅、上传、启停与排序加权这节按操作步骤带你把 MusicFree 插件生态跑起来。订阅编辑插件源订阅地址后点「更新订阅」系统校验返回 JSON 含plugins数组后批量下载插件也可点官方入口直达 MusicFree 插件市场手动导入上传.js插件文件或粘贴一个http(s)://地址在线导入。注意文件名不能是保留字段ALL / all / OpenAPI / OPENAPI同名插件不能重复上传启停与卸载对单个插件执行启用、禁用、卸载插件文件存放在配置目录的js_plugins/下元数据写入plugins-config.json的music_free_info节点。排序决定权重聚合搜索结果的优先级是歌曲名匹配度 歌手名匹配度 插件权重插件权重只取启用列表中前 9 个排名越靠前分越高最高 9 分。想让某个音源的结果优先展示就把它排在启用列表前面。用起来聚合搜索结果、音箱推送与小爱音箱在线点歌这节是配置完成后的日常用法。搜索支持歌曲名 - 艺术家格式后端以第一个-为界拆分以提升准确度结果页展示标题、歌手、专辑、时长、音质和来源平台标签每页 20 条可翻页。命中歌曲后有两条播放路径推送到音箱系统构造临时歌单推到已绑定设备——前提是你已先在「小爱音箱设置面板」完成音箱绑定网页端在线播放不经过音箱直接在当前网页播音频流。 MusicFree 部分插件如 B 站源取到的音频流可能不被小爱音箱支持这类资源请改用网页端播放。语音口令使用前记得在「允许唤醒的命令」列表中加入singer_play和online_play口令示例背后逻辑在线播放 关键词在线播放 林俊杰 江南online_play对搜索结果打分歌名完全匹配 90、开头 70、结尾 50、包含 30歌手匹配 9/7/5/3取最高分播放播放歌手 歌手名播放歌手 周杰伦singer_play搜出该歌手歌曲生成_online_歌手名临时歌单顺序播放语音搜歌单走独立链路后端online_playlist_play搜歌单列表 → 按策略选出最优歌单 → 拉取全量歌曲推送音箱。进阶开关什么时候开这节不罗列配置项只告诉你遇到什么情况才该动哪个开关都在高级设置模态框内。语音指令太模糊我想听那首关于秋天的歌开启AI 大模型口令提取。默认关闭填接口地址留空用阿里百炼、API Key 和模型名默认qwen-flash。接口必须符合 OpenAI API 规范AI 不可用时自动回退到歌名-歌手分割功能不断线歌单播完了还想继续听这位歌手自动追加歌曲播放完最后一首时自动搜同歌手歌曲追加进来默认开启auto_add_song仅对「全部播放」即全部循环模式生效语音搜歌单选的歌单不合心意调语音搜单策略voice_playlist_strategy可选default首条默认/max_songs歌曲最多/max_plays播放最多/random随机后台可能被别人访问开启密码锁在conf/plugins-config.json顶层password字段填非空值即启用进入后台先验证再放行置空即解锁想把 LX 歌单同步过来仅 LX 生态开启自动拉取转换auto_convert每 30 秒把 LX 歌单转成 XM 歌单。配置速查与故障对照这节把你要改的字段和最常见的故障集中放这里排查时对照即可。{ auto_add_song: true, password: , aiapi_info: {enabled: false, api_key: }, back_conf_info: {api_type: 1}, lx_server_info: { base_url: , x-user-name: , x-user-token: , auto_convert: false, platforms: {tx: 小秋音乐, kg: 小枸音乐}, box_play_platform: all }, music_free_info: { enabled_plugins: [], plugin_source: {source_url: }, box_play_platform: all }, voice_playlist_strategy: {value: default} }字段位置作用api_typeback_conf_info1MusicFree 插件2LX Server 接口base_urllx_server_infoLX Server API 地址x-user-name/x-user-tokenlx_server_infoLX 请求鉴权头platformslx_server_infoLX 平台字典标识→展示名auto_convertlx_server_infoLX 歌单自动拉取转换30 秒/次enabled_pluginsmusic_free_info启用插件列表顺序即权重前 9 个有效source_urlmusic_free_info.plugin_source插件订阅源地址box_play_platform两者均有语音口令偏好平台all为聚合auto_add_song顶层自动追加同歌手歌曲aiapi_info顶层AI 口令提取enabled/api_key/base_url/modelpassword顶层后台密码锁非空即启用voice_playlist_strategy顶层语音搜单策略⚠️ 涉及配置文件结构变化的版本如 V1.1.1 重构升级后删掉conf/plugins-config.json再重启在网页端重新配置即可。症状可能原因处理能搜到但播不了日志见/api/music/url500 或超时LX Server 解析直链失败确认 LX Server 本身正常换平台测试排查防火墙如 ufw拦截LX Server 升到 v1.8.2 后无法播放接口新增 Token 限制未适配暂缓升级等 onlineSearch 新版适配拉 LX 歌单报 401老版本如 1.8.1无 token 设置升级 LX Server 并填x-user-token自定义 host 的接口地址添加被拒前端只做 IP/域名格式校验直接写入conf/plugins-config.json的base_url语音点歌无反应唤醒命令未放行「允许唤醒的命令」加入singer_play、online_playLX 转换的歌单播不了转换歌单带_online_lx_前缀要求 LXServer 生态后台生态切回 LXServer另外源码层面对在线 URL 做了 SSRF 防护解析出的内网、回环、链路本地等地址会被拒绝如果你配置的就是内网 LX Server 地址注意这是针对音频直链的校验接口地址本身不受影响。下一步现在就去后台的「在线搜索」配置页挑一个生态有 LX Sync Server 就填地址过测试没有就从订阅 MusicFree 插件开始配好后绑好音箱对着它说一句在线播放试试。相关源码入口在线搜索核心业务搜索、聚合、换源降级、AI 解析、SSRF 防护xiaomusic/online_music.py插件与 LX 接口管理Node 沙箱、插件加载、定时转换xiaomusic/js_plugin_manager.py全部在线搜索 REST 接口xiaomusic/api/routers/plugin.py前端后台配置页xiaomusic/static/onlineSearch/setting.html配置文件模板xiaomusic/plugins-config-example.jsonLX Server 播放故障排查实录docs/issues/811.md【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 xiaomusic 在线搜索快速上手指南：从搜歌到小爱音箱在线点歌只需 3 步
xiaomusic 在线搜索快速上手指南从搜歌到小爱音箱在线点歌只需 3 步【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicxiaomusic 的「在线搜索」扩展让音箱不再只播本地曲库网页端直接搜歌、推送到小爱音箱播放或一句话语音点歌。你只需在 MusicFree 插件与 LX Server 接口两个生态里选一个填好配置即可用。选型决策MusicFree 插件版 vs LX Server 接口版这节帮你 30 秒定下生态不用翻整篇文档。两个生态并列且互斥后台「接口生态」区域二选一对应back_conf_info.api_type取值1MusicFree 插件或2LX Server 接口切换时会弹确认框——因为两边的配置项插件列表 vs 平台列表互不兼容。你的情况建议选已部署 LX Sync Server想最少配置LX Server 接口版填个地址就能用想要多源聚合、精细管理音源或有现成插件资源MusicFree 插件版没服务器可搭想尽快跑起来MusicFree 插件版生态内公开插件更多LX Server 接入实操3 步填好接口地址并通过测试这节带你走完 LX Server 路径的全部操作。在后台「接口生态」区域切到 LXServer 接口确认弹窗后进入配置区填入 API 地址占位示例http://127.0.0.1:9527/api系统会自动做格式校验点「接口测试」V1.1.2后端请求${base_url}/music/config校验player.enableAuth、user.enablePublicRestriction字段通过即说明地址可用。接下来管理平台添加tx小秋、kg小枸、kw小蜗、wy小芸、mg小蜜等标识搜索时会并行请求所有已配置平台再合并排序这就是聚合搜索。如果你的 LX Server 开了用户限制V1.1.3在x-user-name/x-user-token两个框里填上请求时会自动附加这两个鉴权头。⚠️ 版本坑LX Music Sync Serverv1.8.2 之后对接口增加了 Token 限制onlineSearch 尚未适配暂时别升到该版本反过来降到 1.8.1 的老版本又拿不到 token拉歌单会一直 401。升级前务必确认当前 xiaomusic 版本的适配情况详见 docs/issues/811.md 的排查记录。播放链路上 LX 生态内置了保障机制音质按master → flac24bit → flac → 320k → 192k → 128k优先选择某档直链拉不下来就自动降一档再试原平台彻底失败时会按歌名 歌手 时长误差 ≤ 5 秒跨平台找同一首歌换源播放。 前端对接口地址只做 IP/域名格式校验Docker 容器名这类自定义 host 会被拒直接把地址写进conf/plugins-config.json的base_url通常可用。MusicFree 插件配置实操订阅、上传、启停与排序加权这节按操作步骤带你把 MusicFree 插件生态跑起来。订阅编辑插件源订阅地址后点「更新订阅」系统校验返回 JSON 含plugins数组后批量下载插件也可点官方入口直达 MusicFree 插件市场手动导入上传.js插件文件或粘贴一个http(s)://地址在线导入。注意文件名不能是保留字段ALL / all / OpenAPI / OPENAPI同名插件不能重复上传启停与卸载对单个插件执行启用、禁用、卸载插件文件存放在配置目录的js_plugins/下元数据写入plugins-config.json的music_free_info节点。排序决定权重聚合搜索结果的优先级是歌曲名匹配度 歌手名匹配度 插件权重插件权重只取启用列表中前 9 个排名越靠前分越高最高 9 分。想让某个音源的结果优先展示就把它排在启用列表前面。用起来聚合搜索结果、音箱推送与小爱音箱在线点歌这节是配置完成后的日常用法。搜索支持歌曲名 - 艺术家格式后端以第一个-为界拆分以提升准确度结果页展示标题、歌手、专辑、时长、音质和来源平台标签每页 20 条可翻页。命中歌曲后有两条播放路径推送到音箱系统构造临时歌单推到已绑定设备——前提是你已先在「小爱音箱设置面板」完成音箱绑定网页端在线播放不经过音箱直接在当前网页播音频流。 MusicFree 部分插件如 B 站源取到的音频流可能不被小爱音箱支持这类资源请改用网页端播放。语音口令使用前记得在「允许唤醒的命令」列表中加入singer_play和online_play口令示例背后逻辑在线播放 关键词在线播放 林俊杰 江南online_play对搜索结果打分歌名完全匹配 90、开头 70、结尾 50、包含 30歌手匹配 9/7/5/3取最高分播放播放歌手 歌手名播放歌手 周杰伦singer_play搜出该歌手歌曲生成_online_歌手名临时歌单顺序播放语音搜歌单走独立链路后端online_playlist_play搜歌单列表 → 按策略选出最优歌单 → 拉取全量歌曲推送音箱。进阶开关什么时候开这节不罗列配置项只告诉你遇到什么情况才该动哪个开关都在高级设置模态框内。语音指令太模糊我想听那首关于秋天的歌开启AI 大模型口令提取。默认关闭填接口地址留空用阿里百炼、API Key 和模型名默认qwen-flash。接口必须符合 OpenAI API 规范AI 不可用时自动回退到歌名-歌手分割功能不断线歌单播完了还想继续听这位歌手自动追加歌曲播放完最后一首时自动搜同歌手歌曲追加进来默认开启auto_add_song仅对「全部播放」即全部循环模式生效语音搜歌单选的歌单不合心意调语音搜单策略voice_playlist_strategy可选default首条默认/max_songs歌曲最多/max_plays播放最多/random随机后台可能被别人访问开启密码锁在conf/plugins-config.json顶层password字段填非空值即启用进入后台先验证再放行置空即解锁想把 LX 歌单同步过来仅 LX 生态开启自动拉取转换auto_convert每 30 秒把 LX 歌单转成 XM 歌单。配置速查与故障对照这节把你要改的字段和最常见的故障集中放这里排查时对照即可。{ auto_add_song: true, password: , aiapi_info: {enabled: false, api_key: }, back_conf_info: {api_type: 1}, lx_server_info: { base_url: , x-user-name: , x-user-token: , auto_convert: false, platforms: {tx: 小秋音乐, kg: 小枸音乐}, box_play_platform: all }, music_free_info: { enabled_plugins: [], plugin_source: {source_url: }, box_play_platform: all }, voice_playlist_strategy: {value: default} }字段位置作用api_typeback_conf_info1MusicFree 插件2LX Server 接口base_urllx_server_infoLX Server API 地址x-user-name/x-user-tokenlx_server_infoLX 请求鉴权头platformslx_server_infoLX 平台字典标识→展示名auto_convertlx_server_infoLX 歌单自动拉取转换30 秒/次enabled_pluginsmusic_free_info启用插件列表顺序即权重前 9 个有效source_urlmusic_free_info.plugin_source插件订阅源地址box_play_platform两者均有语音口令偏好平台all为聚合auto_add_song顶层自动追加同歌手歌曲aiapi_info顶层AI 口令提取enabled/api_key/base_url/modelpassword顶层后台密码锁非空即启用voice_playlist_strategy顶层语音搜单策略⚠️ 涉及配置文件结构变化的版本如 V1.1.1 重构升级后删掉conf/plugins-config.json再重启在网页端重新配置即可。症状可能原因处理能搜到但播不了日志见/api/music/url500 或超时LX Server 解析直链失败确认 LX Server 本身正常换平台测试排查防火墙如 ufw拦截LX Server 升到 v1.8.2 后无法播放接口新增 Token 限制未适配暂缓升级等 onlineSearch 新版适配拉 LX 歌单报 401老版本如 1.8.1无 token 设置升级 LX Server 并填x-user-token自定义 host 的接口地址添加被拒前端只做 IP/域名格式校验直接写入conf/plugins-config.json的base_url语音点歌无反应唤醒命令未放行「允许唤醒的命令」加入singer_play、online_playLX 转换的歌单播不了转换歌单带_online_lx_前缀要求 LXServer 生态后台生态切回 LXServer另外源码层面对在线 URL 做了 SSRF 防护解析出的内网、回环、链路本地等地址会被拒绝如果你配置的就是内网 LX Server 地址注意这是针对音频直链的校验接口地址本身不受影响。下一步现在就去后台的「在线搜索」配置页挑一个生态有 LX Sync Server 就填地址过测试没有就从订阅 MusicFree 插件开始配好后绑好音箱对着它说一句在线播放试试。相关源码入口在线搜索核心业务搜索、聚合、换源降级、AI 解析、SSRF 防护xiaomusic/online_music.py插件与 LX 接口管理Node 沙箱、插件加载、定时转换xiaomusic/js_plugin_manager.py全部在线搜索 REST 接口xiaomusic/api/routers/plugin.py前端后台配置页xiaomusic/static/onlineSearch/setting.html配置文件模板xiaomusic/plugins-config-example.jsonLX Server 播放故障排查实录docs/issues/811.md【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考