如何给小爱音箱配上线搜歌和语音点歌能力xiaomusic 在线搜索完整指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic导语你回到家想听林俊杰的《江南》但本地曲库里只有之前用 yt-dlp 攒下来的那几十首歌——想要的歌不在里面。翻网页播放器也能找到可你得一直守在屏幕前。xiaomusic 的在线搜索扩展解决的就是这件事配好一个搜索后端之后音箱不再依赖本地文件而是直接搜索互联网上的音乐资源把结果推送到音箱播放或者用语音说一句歌名就立刻开播。读完本文你能从零完成全部配置、分清两种搜索后端怎么选、掌握两条语音点歌口令并看懂plugins-config.json里的每个关键字段。能力全景配置完在线搜索你能做什么一句话概括这个扩展让音箱拥有了云端曲库搜到的歌可以推到音箱上听也可以直接在网页里听。能力配好之后你能做的事网页聚合搜索在网页播放器输入周杰伦 晴天一次拿到多个平台的结果分页翻看推送到音箱命中的歌曲一键推给已绑定的小爱音箱自动开播网页端在线播放不经过音箱浏览器里直接播放音频流语音点歌对着音箱说在线播放 林俊杰 江南搜到最匹配的一首立即播放歌手歌单说播放歌手 周杰伦生成临时歌单并顺序播放播完自动续歌单放完时自动搜索并追加同歌手歌曲全部循环模式下MusicFree 插件还是 LX Server 接口怎么选在线搜索内部支持两套并列的搜索后端同一时间只能启用一套配置文件里api_type为1是 MusicFree 插件为 2 是 LX Server 接口。两者的配置项互不兼容切换时系统会弹确认框。先说人话MusicFree 插件版靠加载一堆 JS 插件文件干活每个插件对接一个音乐源xiaomusic 在 Node.js 子进程沙箱里跑它们LX Server 接口版则把搜索和音质解析的活全部交给你自己部署的 LX Sync Server 服务xiaomusic 只负责填它的接口地址。维度MusicFree 插件版LX Server 接口版适用场景没部署任何服务端想直接借用社区插件资源已部署 LX Sync Server、熟悉洛雪生态配置成本中等填订阅源、更新订阅、勾选启用的插件低填一个接口地址就能用维护成本中等插件要靠订阅源定期更新单个插件故障可单独禁用低接口逻辑由服务端统一维护特色机制单个插件可启用/禁用/卸载前 9 个插件按列表顺序决定权重越靠前权重越高完整的播放保障链音质自动降档、跨平台换源聚合方式并行调用所有已启用插件并行调用所有已配置平台tx/kg/kw/wy/mg一句话结论没有服务端、想开箱即用选 MusicFree已经在跑 LX Sync Server比如同步洛雪歌单选 LX Server播放链路更稳。从零配置在线搜索从绑定音箱到第一次推送先绑定小爱音箱进入「小爱音箱设置面板」完成音箱绑定。推送播放离不开这一步没绑定就只能用网页播放。选定搜索后端打开在线搜索后台页在「接口生态」区域选 MusicFree 或 LX Server。切换会弹确认提示——两套配置互不兼容想好了再切。填写接口信息按所选后端二选一MusicFree 路线填订阅源地址后点「更新订阅」系统校验通过即批量下载插件也可以手动上传本地.js文件或直接粘贴插件 URL 在线导入。完成后在启用列表里勾选要参与搜索的插件列表顺序即权重顺序。LX Server 路线在base_url填入有效的 API 地址占位示例http://127.0.0.1:9527/api如果服务端开了用户鉴权再补填x-user-name和x-user-token在平台列表里维护参与聚合的平台默认 5 个tx小秋、kg小枸、kw小蜗、wy小芸、mg小蜜。测试验证LX Server 路线点「接口测试」后端会请求${base_url}/music/config并校验返回字段确认是合法 LX 接口MusicFree 路线没有独立测试按钮直接搜一首确定有的歌比如晴天看哪些插件出了结果没出结果的插件禁用即可。搜索播放在网页播放器搜歌手 歌名从结果里选一首选「推送到音箱」或「网页播放」第一次推送应该在几秒内出声。示例地址只是占位务必替换成你自己部署的服务地址否则测试必然失败。聚合搜索、排序与音质降级是怎么工作的聚合搜索提交关键词后后端并行向所有启用的搜索源要结果——MusicFree 按插件分、LX Server 按平台分——每个源都有条数上限最后统一合并排序。排序优先级歌曲名匹配度 歌手名匹配度 搜索源权重。权重由启用列表中的顺序决定排名越靠前越优先有效范围见上一节表格。所以如果你发现某个源的结果总被压到后面把它往前挪就行。播放保障链LX Server 生态音质按master → flac24bit → flac → 320k → 192k → 128k的优先级选择偏好音质不可用或解析失败时自动逐档降级而不是直接报错某个平台解析失败时系统会去其他平台找同一首歌——同名 同歌手 时长相差不超过 5 秒——找到就继续播。两种播放方式的差别推送到小爱音箱网页端在线播放链路构造临时歌单推给已绑定的音箱浏览器直接拉流适合场景走动中听、不想看屏幕试听某首、或音箱播不了该资源前提音箱已绑定无⚠️ 部分插件源比如 B 站源拿到的音频流小爱音箱无法识别这类资源建议改用网页端播放别反复重试推送。注册语音口令再用 AI 解析模糊指令前提把singer_play和online_play两项加入设置里的「允许唤醒的命令」列表逗号分隔。列表里没有它们口令一律不生效。口令指令格式可照抄的示例行为在线播放指定歌曲在线播放 关键词在线播放 林俊杰 江南搜索后取打分最高的一条立即播放播放歌手歌单播放歌手 歌手名播放歌手 周杰伦搜该歌手热门歌曲生成临时歌单顺序播放在线播放的打分逻辑是歌名和关键词越像、歌手名越像得分越高取最高分的那首所以稍微说不准确一般也能选对。AI 口令提取在高级设置里默认关闭。开启后要配接口地址、API Key、模型名称三项地址留空默认走阿里百炼模型默认qwen-flash被调用的接口必须遵循OpenAI API 规范其他规范暂不支持回退行为AI 不可用或解析失败时自动退回传统的歌名-歌手拆分以第一个-为界功能不会中断。配置字段速查plugins-config.json 一览在线搜索的全部持久化配置都在conf/plugins-config.json首次启动时由模板 plugins-config-example.json 复制生成。骨架如下{ account: , password: , auto_add_song: true, aiapi_info: {enabled: false, api_key: }, back_conf_info: { api_type: 1, api_options: [ {name: MusicFree插件, type: 1}, {name: LXServer接口, type: 2} ] }, lx_server_info: { base_url: , x-user-name: , x-user-token: , auto_convert: false, platforms: { tx: 小秋音乐, kg: 小枸音乐, kw: 小蜗音乐, wy: 小芸音乐, mg: 小蜜音乐 }, box_play_platform: all }, music_free_info: { enabled_plugins: [], plugin_source: {source_url: }, plugins_info: [], box_play_platform: all }, voice_playlist_strategy: { desc: 语音搜单策略: default(首条), max_songs(歌曲最多), max_plays(播放最多), random(随机), value: default } }关键字段说明字段所在位置默认值含义api_typeback_conf_info11MusicFree 插件2LX Server 接口base_urllx_server_info空LX Server 的 API 地址x-user-name/x-user-tokenlx_server_info空请求时附带的用户鉴权头platformslx_server_info5 个平台参与聚合搜索的平台字典auto_convertlx_server_infofalse每 30 秒自动拉取 LX 歌单并转为本地歌单enabled_pluginsmusic_free_info[]已启用插件列表顺序即权重source_urlmusic_free_info.plugin_source空插件订阅源地址box_play_platform两个 info 节点all语音点歌的平台偏好all表示聚合搜索auto_add_song顶层true歌单播完自动追加同歌手歌曲仅全部循环模式生效aiapi_info顶层关闭AI 口令提取enabled/api_key/base_url/modelpassword顶层空后台密码锁非空启用、置空关闭voice_playlist_strategy顶层default语音搜单策略首条 / 歌曲最多 / 播放最多 / 随机避坑与常见问题1. LX Server 生态突然播不了现象接口测试以前通过现在直链解析失败或播放报错。原因LX Music Sync Server 从 v1.8.2 起给接口加了 Token 限制旧版在线搜索尚未适配。解法⚠️ 暂时停留在 v1.8.2 之前的版本等新版适配常见故障的处理思路见 issues/811。2. 说在线播放音箱没反应现象网页端搜歌正常语音口令却唤不起。原因「允许唤醒的命令」列表里没有singer_play和online_play。解法把这两项加进列表并保存重新试口令。3. 后台打不开卡在密码框现象进在线搜索后台先弹密码验证。原因conf/plugins-config.json里password非空即启用密码锁默认是关闭的。解法直接改配置文件把password改成新值或置空以彻底关闭密码锁。4. 升级后配置全部变回默认现象更新到调整过配置结构的版本后旧配置加载不上。原因旧plugins-config.json结构与新版不兼容。解法删掉旧的/conf/plugins-config.json重启服务在网页端重新配置一遍即可。5. 某首歌网页能播、推音箱就是不出声现象同一条搜索结果网页端正常音箱端静默。原因部分插件源如 B 站源提供的音频流格式小爱音箱不支持。解法这类资源走网页播放日常资源可把该插件调低排序让其他源顶上。6. 平台歌单能同步到音箱吗相关需求与讨论见 issues/807。LX 生态下可以打开auto_convert让系统定时把 LX 歌单转成本地歌单来用。安全说明在线搜索模块会对返回的在线 URL 做地址校验拒绝指向内网、回环等地址的请求用来防范 SSRF 类风险正常使用无需干预。深入阅读在线搜索业务核心搜索、聚合、直链解析、换源、AI 解析online_music.pyJS 插件沙箱、LX 接口请求、自动转换定时任务js_plugin_manager.py在线搜索相关 REST 接口plugin.py后台配置页setting.html前端搜索页index.html配置模板plugins-config-example.json已知问题处理issues/811.md、issues/807.md【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何给小爱音箱配上线搜歌和语音点歌能力：xiaomusic 在线搜索完整指南
如何给小爱音箱配上线搜歌和语音点歌能力xiaomusic 在线搜索完整指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic导语你回到家想听林俊杰的《江南》但本地曲库里只有之前用 yt-dlp 攒下来的那几十首歌——想要的歌不在里面。翻网页播放器也能找到可你得一直守在屏幕前。xiaomusic 的在线搜索扩展解决的就是这件事配好一个搜索后端之后音箱不再依赖本地文件而是直接搜索互联网上的音乐资源把结果推送到音箱播放或者用语音说一句歌名就立刻开播。读完本文你能从零完成全部配置、分清两种搜索后端怎么选、掌握两条语音点歌口令并看懂plugins-config.json里的每个关键字段。能力全景配置完在线搜索你能做什么一句话概括这个扩展让音箱拥有了云端曲库搜到的歌可以推到音箱上听也可以直接在网页里听。能力配好之后你能做的事网页聚合搜索在网页播放器输入周杰伦 晴天一次拿到多个平台的结果分页翻看推送到音箱命中的歌曲一键推给已绑定的小爱音箱自动开播网页端在线播放不经过音箱浏览器里直接播放音频流语音点歌对着音箱说在线播放 林俊杰 江南搜到最匹配的一首立即播放歌手歌单说播放歌手 周杰伦生成临时歌单并顺序播放播完自动续歌单放完时自动搜索并追加同歌手歌曲全部循环模式下MusicFree 插件还是 LX Server 接口怎么选在线搜索内部支持两套并列的搜索后端同一时间只能启用一套配置文件里api_type为1是 MusicFree 插件为 2 是 LX Server 接口。两者的配置项互不兼容切换时系统会弹确认框。先说人话MusicFree 插件版靠加载一堆 JS 插件文件干活每个插件对接一个音乐源xiaomusic 在 Node.js 子进程沙箱里跑它们LX Server 接口版则把搜索和音质解析的活全部交给你自己部署的 LX Sync Server 服务xiaomusic 只负责填它的接口地址。维度MusicFree 插件版LX Server 接口版适用场景没部署任何服务端想直接借用社区插件资源已部署 LX Sync Server、熟悉洛雪生态配置成本中等填订阅源、更新订阅、勾选启用的插件低填一个接口地址就能用维护成本中等插件要靠订阅源定期更新单个插件故障可单独禁用低接口逻辑由服务端统一维护特色机制单个插件可启用/禁用/卸载前 9 个插件按列表顺序决定权重越靠前权重越高完整的播放保障链音质自动降档、跨平台换源聚合方式并行调用所有已启用插件并行调用所有已配置平台tx/kg/kw/wy/mg一句话结论没有服务端、想开箱即用选 MusicFree已经在跑 LX Sync Server比如同步洛雪歌单选 LX Server播放链路更稳。从零配置在线搜索从绑定音箱到第一次推送先绑定小爱音箱进入「小爱音箱设置面板」完成音箱绑定。推送播放离不开这一步没绑定就只能用网页播放。选定搜索后端打开在线搜索后台页在「接口生态」区域选 MusicFree 或 LX Server。切换会弹确认提示——两套配置互不兼容想好了再切。填写接口信息按所选后端二选一MusicFree 路线填订阅源地址后点「更新订阅」系统校验通过即批量下载插件也可以手动上传本地.js文件或直接粘贴插件 URL 在线导入。完成后在启用列表里勾选要参与搜索的插件列表顺序即权重顺序。LX Server 路线在base_url填入有效的 API 地址占位示例http://127.0.0.1:9527/api如果服务端开了用户鉴权再补填x-user-name和x-user-token在平台列表里维护参与聚合的平台默认 5 个tx小秋、kg小枸、kw小蜗、wy小芸、mg小蜜。测试验证LX Server 路线点「接口测试」后端会请求${base_url}/music/config并校验返回字段确认是合法 LX 接口MusicFree 路线没有独立测试按钮直接搜一首确定有的歌比如晴天看哪些插件出了结果没出结果的插件禁用即可。搜索播放在网页播放器搜歌手 歌名从结果里选一首选「推送到音箱」或「网页播放」第一次推送应该在几秒内出声。示例地址只是占位务必替换成你自己部署的服务地址否则测试必然失败。聚合搜索、排序与音质降级是怎么工作的聚合搜索提交关键词后后端并行向所有启用的搜索源要结果——MusicFree 按插件分、LX Server 按平台分——每个源都有条数上限最后统一合并排序。排序优先级歌曲名匹配度 歌手名匹配度 搜索源权重。权重由启用列表中的顺序决定排名越靠前越优先有效范围见上一节表格。所以如果你发现某个源的结果总被压到后面把它往前挪就行。播放保障链LX Server 生态音质按master → flac24bit → flac → 320k → 192k → 128k的优先级选择偏好音质不可用或解析失败时自动逐档降级而不是直接报错某个平台解析失败时系统会去其他平台找同一首歌——同名 同歌手 时长相差不超过 5 秒——找到就继续播。两种播放方式的差别推送到小爱音箱网页端在线播放链路构造临时歌单推给已绑定的音箱浏览器直接拉流适合场景走动中听、不想看屏幕试听某首、或音箱播不了该资源前提音箱已绑定无⚠️ 部分插件源比如 B 站源拿到的音频流小爱音箱无法识别这类资源建议改用网页端播放别反复重试推送。注册语音口令再用 AI 解析模糊指令前提把singer_play和online_play两项加入设置里的「允许唤醒的命令」列表逗号分隔。列表里没有它们口令一律不生效。口令指令格式可照抄的示例行为在线播放指定歌曲在线播放 关键词在线播放 林俊杰 江南搜索后取打分最高的一条立即播放播放歌手歌单播放歌手 歌手名播放歌手 周杰伦搜该歌手热门歌曲生成临时歌单顺序播放在线播放的打分逻辑是歌名和关键词越像、歌手名越像得分越高取最高分的那首所以稍微说不准确一般也能选对。AI 口令提取在高级设置里默认关闭。开启后要配接口地址、API Key、模型名称三项地址留空默认走阿里百炼模型默认qwen-flash被调用的接口必须遵循OpenAI API 规范其他规范暂不支持回退行为AI 不可用或解析失败时自动退回传统的歌名-歌手拆分以第一个-为界功能不会中断。配置字段速查plugins-config.json 一览在线搜索的全部持久化配置都在conf/plugins-config.json首次启动时由模板 plugins-config-example.json 复制生成。骨架如下{ account: , password: , auto_add_song: true, aiapi_info: {enabled: false, api_key: }, back_conf_info: { api_type: 1, api_options: [ {name: MusicFree插件, type: 1}, {name: LXServer接口, type: 2} ] }, lx_server_info: { base_url: , x-user-name: , x-user-token: , auto_convert: false, platforms: { tx: 小秋音乐, kg: 小枸音乐, kw: 小蜗音乐, wy: 小芸音乐, mg: 小蜜音乐 }, box_play_platform: all }, music_free_info: { enabled_plugins: [], plugin_source: {source_url: }, plugins_info: [], box_play_platform: all }, voice_playlist_strategy: { desc: 语音搜单策略: default(首条), max_songs(歌曲最多), max_plays(播放最多), random(随机), value: default } }关键字段说明字段所在位置默认值含义api_typeback_conf_info11MusicFree 插件2LX Server 接口base_urllx_server_info空LX Server 的 API 地址x-user-name/x-user-tokenlx_server_info空请求时附带的用户鉴权头platformslx_server_info5 个平台参与聚合搜索的平台字典auto_convertlx_server_infofalse每 30 秒自动拉取 LX 歌单并转为本地歌单enabled_pluginsmusic_free_info[]已启用插件列表顺序即权重source_urlmusic_free_info.plugin_source空插件订阅源地址box_play_platform两个 info 节点all语音点歌的平台偏好all表示聚合搜索auto_add_song顶层true歌单播完自动追加同歌手歌曲仅全部循环模式生效aiapi_info顶层关闭AI 口令提取enabled/api_key/base_url/modelpassword顶层空后台密码锁非空启用、置空关闭voice_playlist_strategy顶层default语音搜单策略首条 / 歌曲最多 / 播放最多 / 随机避坑与常见问题1. LX Server 生态突然播不了现象接口测试以前通过现在直链解析失败或播放报错。原因LX Music Sync Server 从 v1.8.2 起给接口加了 Token 限制旧版在线搜索尚未适配。解法⚠️ 暂时停留在 v1.8.2 之前的版本等新版适配常见故障的处理思路见 issues/811。2. 说在线播放音箱没反应现象网页端搜歌正常语音口令却唤不起。原因「允许唤醒的命令」列表里没有singer_play和online_play。解法把这两项加进列表并保存重新试口令。3. 后台打不开卡在密码框现象进在线搜索后台先弹密码验证。原因conf/plugins-config.json里password非空即启用密码锁默认是关闭的。解法直接改配置文件把password改成新值或置空以彻底关闭密码锁。4. 升级后配置全部变回默认现象更新到调整过配置结构的版本后旧配置加载不上。原因旧plugins-config.json结构与新版不兼容。解法删掉旧的/conf/plugins-config.json重启服务在网页端重新配置一遍即可。5. 某首歌网页能播、推音箱就是不出声现象同一条搜索结果网页端正常音箱端静默。原因部分插件源如 B 站源提供的音频流格式小爱音箱不支持。解法这类资源走网页播放日常资源可把该插件调低排序让其他源顶上。6. 平台歌单能同步到音箱吗相关需求与讨论见 issues/807。LX 生态下可以打开auto_convert让系统定时把 LX 歌单转成本地歌单来用。安全说明在线搜索模块会对返回的在线 URL 做地址校验拒绝指向内网、回环等地址的请求用来防范 SSRF 类风险正常使用无需干预。深入阅读在线搜索业务核心搜索、聚合、直链解析、换源、AI 解析online_music.pyJS 插件沙箱、LX 接口请求、自动转换定时任务js_plugin_manager.py在线搜索相关 REST 接口plugin.py后台配置页setting.html前端搜索页index.html配置模板plugins-config-example.json已知问题处理issues/811.md、issues/807.md【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考