xiaomusic 在线搜索实战双生态配置与语音点歌一次跑通【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic30 秒速览xiaomusic 在线搜索让小爱音箱免下载听全网歌后台配好 MusicFree 插件或 LX Server 接口网页搜歌直接推音箱还能语音点歌、AI 听懂模糊口令。适合已部署 xiaomusic 并绑定好音箱的你涉及接口测试、认证、AI 提取等能力为 V1.1.2 / V1.1.3 逐步加入具体以最新 release notes 为准。1. 一张清单看懂能干嘛5 个场景对号入座不聊原理先看你想要哪种玩法。网页搜歌→ 在搜索框输入林俊杰 - 江南→ 结果带平台、音质、时长标签点播放即可网页端听推送到小爱→ 命中后系统自动构造临时歌单 → 音箱直接出声前提是音箱已绑定语音点歌→ 说在线播放 周杰伦 青花瓷 → 系统打分选出最匹配的一首立即播放歌手歌单→ 说播放歌手 林俊杰 → 生成该歌手热门歌单顺序播放多源聚合→ 多个插件/平台并行搜索 → 按歌名匹配 歌手匹配 源权重统一排序命中更准模糊口令→ 我想听那首关于秋天的歌 → AI 提取歌名歌手后搜索命中率明显提升默认关闭见第 4 节。2. 选型两条接口生态怎么走1 分钟定位三个问题问完你就知道自己该填哪张表。你手里有自己部署好的 LX Sync Server 吗有 → 走LX Server 接口版只填一个接口地址最省事。没有服务端但有 MusicFree 插件资源订阅源地址或现成的.js插件文件 → 走MusicFree 插件版导入插件、启用即可。两者都没有先别急两条路都能起步LX Server 版少配置MusicFree 版后台就有官方插件市场入口点一下就能找资源。注意两种生态互斥api_type只能二选一1 MusicFree 插件2 LX Server 接口切换时页面会弹确认框因为两边的配置项互不兼容。维度MusicFree 插件版LX Server 接口版前置条件插件订阅源或.js插件文件一台跑着 LX Sync Server 的机器配置量订阅/上传插件 启用排序填接口地址可选鉴权适合谁有插件生态资源的人想快速跑通、少维护的人3. 跑通MusicFree 插件版最小可用配置跟着点四次第一条搜索链路就通了。这里以默认的 MusicFree 插件版为例LX Server 版在第 5 节排查时顺带覆盖。3.1 绑定音箱并打开后台拿到配置页入口先在「小爱音箱设置面板」里完成音箱绑定然后打开 xiaomusic 后台进入在线搜索onlineSearch配置页。✅ 到这里你应该看到配置页正常加载「接口生态」区域默认停在 MusicFree 插件这一侧。3.2 选生态并导入插件订阅一次搞定搜索源 此处建议插入onlineSearch 后台「接口生态」选择区截图确认生态选的是 MusicFree 后在「插件源配置」区填写订阅地址点「更新订阅」系统会拉取插件列表并批量下载没有订阅源的话也可以直接上传本地.js插件文件注意同名插件不能重复上传文件名不能是ALL、OpenAPI这类保留字。✅ 到这里你应该看到插件列表里出现已下载的插件状态正常。3.3 启用插件并设排序让权重按你的习惯来在插件列表中把想要参与的插件点「启用」。排序就是权重启用的前 9 个插件参与打分排得越靠前权重越高最高 9 分再往后基本靠匹配度自己说话。✅ 到这里你应该看到启用列表里按你期望的优先级排好了至少 2 个插件。3.4 搜歌并推送到音箱听到第一首就算成功回到搜索页输入歌曲名 - 歌手如青花瓷 - 周杰伦结果按匹配度排好序。点网页端播放按钮先在浏览器里试听没问题再点推送到音箱。✅ 到这里你应该看到音箱播出了第一首歌播放列表里出现一条_online_开头的临时歌单——第一条链路跑通收工。4. 进阶语音、AI、自动化怎么开默认关的功能先说关再讲怎么打开。4.1 语音口令点歌让在线播放直接出歌开关在哪后台「允许唤醒的命令」列表即active_cmd配置。默认列表里已包含online_play、singer_play、online_playlist_play如果你自定义过这个列表检查别把它们删了。怎么填不需要填默认关键词就是在线播放/搜索歌曲、播放歌手/搜索歌手、在线歌单/搜索歌单。不生效时查哪里先确认音箱唤醒能听到完整指令在线播放 林俊杰 江南中间不要停太久再确认当前生态已配置好搜索源否则搜不到就是空结果。小爱音箱 在线点歌 想更精准就把歌名和歌手都说全。4.2 AI 口令提取默认是关的这样打开开关在哪高级设置里的「AI 大模型配置」卡片默认关闭。怎么填开启enabled填api_key接口地址留空默认走阿里百炼模型名默认qwen-flash。不生效时查哪里检查aiapi_info里enabled: true且api_key非空你的大模型接口必须符合 OpenAI API 规范不符合会直接回退到传统的歌名-歌手分割方式功能不丢只是变笨一点。 此处建议插入高级设置中 AI 大模型配置卡片截图4.3 自动追加同歌手歌单播完还能接着听开关在哪高级设置「自动追加歌曲」默认是开的对应顶层字段auto_add_song: true。怎么填不用填保持开启即可。不生效时查哪里它只对「全部播放」即全部循环模式生效——如果你当前是单曲循环或顺序播到就停自然没有追加。早期版本这项没露到前端只能在配置文件conf/plugins-config.json里改auto_add_song字段。4.4 口令搜索偏好与搜单策略语音更懂你开关在哪高级设置里的「口令搜索偏好」和「语音搜单策略」两项。怎么填偏好平台填all就是聚合搜索也可以指定某个平台/插件搜单策略可选default取首条、max_songs歌曲最多、max_plays播放最多、random随机默认default。不生效时查哪里偏好填了某个平台但该平台没启用/没配置时回落到聚合逻辑属正常表现。4.5 后台密码锁3 步上锁改空解锁开关在哪默认未开启。怎么填在配置文件conf/plugins-config.json里把顶层password字段填成非空值重启后进入后台就会先弹密码框忘记密码就回去把这个字段置空置空即关闭密码锁。不生效时查哪里确认改的是运行时那份conf/plugins-config.json首次启动由模板复制生成而不是仓库里的示例文件。5. 排查五个高频故障的 30 秒自查法先做 30 秒检查再翻字段名别一上来就重装。Q1LX Server 接口测试失败搜索一直没结果连通性30 秒检查浏览器里手动访问你填的地址看服务本身通不通Docker 环境下用宿主机 IP 或容器 IP 填地址别用服务名。需要翻配置时看lx_server_info.base_url。V1.1.2 有「接口测试」按钮点一下比肉眼看快。Q2接口测试通过了一播放就报鉴权失败鉴权30 秒检查LX Sync Server 端是否开启了用户登录限制开了就要在 xiaomusic 侧把用户和令牌填上。需要翻配置时看lx_server_info下的x-user-name和x-user-token两者都会作为请求头自动带上。Q3转换出来的歌单播不了名字带_online_lx_前缀格式/前缀30 秒检查后台「接口生态」当前是不是 LXServer 一侧LX 歌单转成的 XM 歌单_online_lx_前缀必须在 LXServer 生态下才能用切回 MusicFree 侧就会哑火。切过去重播一遍试试。Q4LX Music Sync Server 升级后突然 403 / 接口被限版本兼容30 秒检查先看 LX Music Sync Server 版本号——v1.8.2 之后接口增加了 Token 限制官方建议暂时先别升到该版本等 onlineSearch 新版适配具体进度以最新 release notes 为准。Q5有些歌网页能听音箱就是播不出来安全策略30 秒检查先分清两类情况。一类是源本身的问题——MusicFree 部分插件如 B 站源拿到的音频流小爱不支持这类资源改用网页端播放另一类是安全策略——源码里的在线 URL 校验会拒绝内网、回环、多播地址防 SSRF如果你填的是内网直链源属于被保护拦下属正常行为。 此处建议插入LX Server 接口测试按钮与结果提示截图6. 附录字段速查与源码坐标忘了填哪改哪直接查表。6.1 配置字段速查表运行时文件conf/plugins-config.json字段所在节点作用默认值api_typeback_conf_info1MusicFree 插件2LX Server 接口1base_urllx_server_infoLX Server 接口地址空x-user-name/x-user-tokenlx_server_info请求 LX 时的鉴权头空platformslx_server_info参与聚合搜索的平台字典key 为平台标识5 个默认平台auto_convertlx_server_info每 30 秒自动拉取 LX 歌单并转为 XM 歌单falsebox_play_platformmusic_free_info/lx_server_info语音口令搜索偏好平台all为聚合allenabled_pluginsmusic_free_info已启用插件列表前 9 个计权重[]plugin_source.source_urlmusic_free_info插件订阅源地址空auto_add_song顶层播完自动追加同歌手歌曲trueaiapi_info顶层AI 口令提取enabled/api_key/model关闭password顶层后台密码锁非空即启用空voice_playlist_strategy顶层语音搜单策略default6.2 关键模块路径索引在线搜索核心业务搜索、聚合、直链解析、降级换源、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.json6.3 延伸阅读LX Server 生态测试成功但无法播放的完整排查记录docs/issues/811.md平台歌单能否同步到音箱播放的方案讨论docs/issues/807.md跑通第一条链路只是开始下一步你可以试着打开 4.2 的 AI 口令提取用一句我想听那首关于秋天的歌考考它——大概率会有惊喜。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考