xiaomusic在线搜索插件语音点歌实战选型指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicxiaomusic 是让小爱音箱播放音乐的工具它的「在线搜索」扩展能让你在网页端直接搜各大音乐平台的歌曲推给音箱播放也能在网页在线播放还支持语音点歌和 AI 口令提取。无论你已经搭好 LX Server还是想直接开箱用聚合曲库这篇指南都能帮你一次配通。两种接口生态怎么选MusicFree 插件还是 LX Server这一节你会花一分钟选对搜索源生态。后台配置页的「接口生态」区域是两个互斥选项同一时间只生效一种。对比维度MusicFree 插件版LX Server 接口版上手难度中需订阅或上传插件低只填一个接口地址依赖前提有插件订阅源或本地 .js 插件已自行部署 LX Sync Server自建的音乐聚合服务灵活性高插件可单独启用/禁用/卸载低平台逻辑由服务端统一管理典型场景多音乐源聚合搜索洛雪生态用户插件权重启用列表前 9 个插件有效排名越靠前权重越高聚合结果按「歌曲名匹配度 歌手名匹配度 插件权重」排序。LX 音质按 母带 flac24bit flac 320k 192k 128k 依次降级解析失败自动跨平台找时长误差 ≤5 秒的同歌换源。如果你已经部署了 LX Sync Server或本来就是洛雪生态用户选 LX Server 接口版填地址即生效如果你只是想让音箱尽快能聚合搜歌、没有任何现成部署选 MusicFree 插件版订阅官方源就能用。上手配置两条完整路径这一节你跟着屏幕一步步做完全部配置入口都在后台配置页。MusicFree 插件版从订阅到聚合搜索在「接口生态」区域选中 MusicFree 插件目的把系统切到插件生态。踩坑提示从 LX Server 切过来会弹确认提示两套配置互不兼容别中途来回切。填插件订阅源地址点「更新订阅」目的系统会请求订阅源、校验其中的plugins数组后批量下载插件。踩坑提示先确认订阅源地址可访问且返回合法 JSON否则整批下载失败。按需上传或在线导入插件目的补充搜索源可手动传.js文件也可直接粘贴 http(s) 插件地址导入。踩坑提示只收.js文件名不能是 ALL / all / OpenAPI / OPENAPI 这些保留字段同名插件不能重复传。整理启用列表的排序目的启用顺序就是聚合搜索优先级前 9 个插件参与权重计算。踩坑提示没启用的插件不参与搜索启用列表为空时搜不到任何结果。LX Server 接口版填地址、测接口、选平台先自行部署 LX Sync Server目的xiaomusic 本身不带曲库接口版完全依赖这台自建服务。踩坑提示先做这一步否则后面「接口测试」必然不通LX Server v1.8.2 之后接口加了 Token 限制建议暂时别升到该版本。填接口地址并点「接口测试」目的系统会请求${base_url}/music/config校验返回中是否含player.enableAuth、user.enablePublicRestriction字段来判定合法性。踩坑提示地址形如http://127.0.0.1:9527/api测试不通过先查网络连通性和服务端版本。填认证信息V1.1.3目的系统请求 LX Server 时会自动带上x-user-name、x-user-token两个请求头避免鉴权被拒。踩坑提示只填了名字没填 Token 等于没认证。管理平台列表目的搜索时系统会并行请求所有保留的平台如tx、kg、kw、wy、mg再合并结果。踩坑提示只留你需要的平台平台越多聚合越慢。语音点歌实战两条口令立即可用这一节你会让音箱「开口即唱」不用打开网页。下面是操作面板示意口令格式示例效果在线播放歌曲在线播放 关键词在线播放 林俊杰 江南按当前生态搜索取最匹配的一首立即播播放歌手歌单播放歌手 歌手名播放歌手 周杰伦搜该歌手热门歌曲建临时歌单顺序播在线播放歌单在线播放歌单 关键词在线播放歌单 华语流行按策略选最优歌单全量歌曲推到音箱前置检查清单后台「允许唤醒的命令」列表里已加入online_play和singer_play已在「小爱音箱设置面板」完成音箱绑定二选一生态已配好MusicFree 插件已启用或 LX Server 接口测试通过 AI 增强高级设置里可开启大模型提取「歌名/歌手」让模糊指令如我想听那首关于秋天的歌也能命中接口地址留空默认用阿里百炼模型默认qwen-flash接口需符合 OpenAI API 规范AI 不可用时自动回退「歌名 - 歌手」分割。进阶开关速查高级设置一览表这一节你会知道哪些开关值得动、动了会怎样。开关名默认值什么时候需要动动了之后发生什么自动追加歌曲开启歌单播完还想连播同歌手播完最后一首时自动搜同歌手歌曲追加仅「全部播放」即全部循环模式生效自动拉取并转换LX 专属关闭想让 LX 歌单直接变 XM 歌单每 30 秒拉取 LX 歌单转为_online_lx_前缀的 XM 歌单AI 大模型配置关闭语音指令模糊、搜索命中率低系统先调大模型提取歌名/歌手再搜索口令搜索偏好all聚合只想搜指定平台语音搜索限定到该平台语音搜单策略default首条首条结果不理想可切歌曲最多 / 播放最多 / 随机配置字段速查plugins-config.json 关键字段这一节你即使直接改文件也知道去哪改。全部在线搜索配置集中在conf/plugins-config.json首次启动由插件配置模板生成{ password: , auto_add_song: true, 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, 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_info生态选择1MusicFree 插件2LX Server 接口1或2base_urllx_server_infoLX Server 接口地址http://127.0.0.1:9527/apix-user-name/x-user-tokenlx_server_infoLX Server 鉴权请求头账号 / Tokenplatformslx_server_infoLX 平台字典key 是标识、value 是展示名{tx: 小秋音乐}enabled_pluginsmusic_free_info已启用插件列表决定权重排序按优先级排列的插件名source_urlmusic_free_info.plugin_source插件订阅源地址订阅源 URLbox_play_platformlx_server_info / music_free_info语音口令搜索偏好平台allauto_add_song顶层自动追加同歌手歌曲开关truepassword顶层后台密码锁非空即启用任意非空字符串voice_playlist_strategy顶层语音搜单策略default/max_songs/max_plays/random避坑与排查常见报错怎么办这一节你会不用翻代码就处理掉绝大多数问题。⚠️ 硬约束违反会直接报错或不可用LX Server v1.8.2 之后接口增加 Token 限制暂时别升级该版本等 onlineSearch 适配AI 口令提取只支持符合 OpenAI API 规范的大模型接口遇到变更配置文件结构的版本升级如 V1.1.1 重构需手动删除conf/plugins-config.json重启后在网页端重新配置一般提醒LX 接口生态无法播放按 issues/811 处理方案 逐项排查。平台歌单同步到音箱播放参见 issues/807 方案讨论注意 LX 歌单转换出的 XM 歌单_online_lx_前缀需切到 LXServer 生态才能用。AI 口令提取不生效确认aiapi_info里enabled为true且api_key非空。密码锁默认未开启password置空即解锁、非空即启用忘记密码改文件重置。MusicFree 的 B 站源等插件资源可能不被小爱音箱支持这类歌改用网页端在线播放。安全机制系统会拒绝内网、回环、链路本地、多播等地址的在线 URL 以防范 SSRF服务器端请求伪造属正常拦截不要试图绕过。资源索引源码与文档在哪看这一节你会按用途快速定位到对应文件。xiaomusic/online_music.py — 搜索、聚合、播放直链、SSRF 防护xiaomusic/js_plugin_manager.py — 插件沙箱、LX 接口请求、自动转换xiaomusic/api/routers/plugin.py — 在线搜索相关 REST 接口xiaomusic/static/onlineSearch/setting.html — 后台配置页xiaomusic/static/onlineSearch/index.html — 在线搜索页xiaomusic/plugins-config-example.json — 配置文件模板【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考