xiaomusic 在线搜索怎么接两条路线一步步配好音箱随时点歌【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic对着小爱音箱说一句在线播放 林俊杰 江南音箱却只回一句找不到歌或者你在网页搜索框里敲了半天列表空空如也——多半是 xiaomusic 的在线搜索还没接好搜索源。这个扩展不用本地曲库直接去互联网上搜歌、把结果推给音箱播或网页直接听核心逻辑集中在 在线音乐服务源码搜索源管理则由 JS 插件管理器 负责。整个接入过程只需要选一条路线、填几个参数配好之后语音点歌、网页搜歌都能直接用。动手前的 3 分钟检查清单在动配置之前先把下面几件事过一遍能避开后面 80% 的配了不生效问题音箱已绑定要用推给音箱播必须先在「小爱音箱设置面板」完成设备绑定否则搜索结果只能在网页听。口令白名单语音点歌依赖两个口令检查【允许唤醒的命令】列表里是否包含singer_play和online_play缺一个对应功能就哑火。LX 版本如果打算走 LX Server 路线注意 LX Music Sync Server v1.8.2 之后接口加了 Token 限制该版本先别急着升等 onlineSearch 新版适配。旧配置清理如果你从较早版本升级过来配置文件结构已经重构过直接删掉/conf/plugins-config.json再重启服务在网页端重新配一遍最省事。先想清楚走 LX Server 还是 MusicFree 插件两条路线功能上能做的事一样——聚合搜索、语音点歌、网页播放区别只在歌从哪儿来对比点LX Server 接口MusicFree 插件你手上要有什么一台已部署好的 LX Sync ServerMusicFree 生态的 JS 插件资源配置量一个接口地址可选鉴权头订阅源地址或逐个上传插件玩法上限平台列表管理tx/kg/kw/wy/mg插件增删、排序调权重出问题时排查查服务端和地址连通性查单个插件状态一句话推荐已经跑着 LX Sync Server 的直接选 LX五分钟接完没有部署习惯、只想要现成插件资源的选 MusicFree。两条路线互斥同一时间只有一条生效配置文件里对应api_type字段1 MusicFree 插件2 LX Server 接口。切换时后台会弹确认框——因为两边配置项插件列表 vs 平台列表互相不兼容切错要重新填。5 分钟接好 LX Server 接口这节解决我有 LX 服务端想让 xiaomusic 用上它的问题。打开哪里在线搜索后台配置页setting.html在「接口生态」区域选择 LXServer 接口。填什么接口地址填你的 LX 服务 API 入口典型形如http://127.0.0.1:9527/api。如果服务开了鉴权把x-user-name和x-user-token一并填上之后所有请求会自动带这两个请求头。点什么先点「接口测试」。后端会请求${base_url}/music/config并校验返回里有没有player.enableAuth、user.enablePublicRestriction字段通过即说明地址合法。然后在「平台管理」里添加要参与搜索的平台常用的五个tx小秋、kg小枸、kw小蜗、wy小芸、mg小蜜。加几个平台搜索时就并行请求几个再合并结果。如何验证生效回搜索页搜一首歌列表顶部应能看到来源平台标签再对音箱说一句在线播放口令能出声就通了。机制上只补两句播放时系统先查${base_url}/music/cache/check缓存未命中再走进度接口加${base_url}/music/url解析直链音质按master flac24bit flac 320k 192k 128k的顺序优先选你偏好的档位直链解析失败自动降档原始平台挂了还会按歌名歌手时长误差 5 秒内跨平台换源。这些都不用你管知道它不会轻易失败就行。手动装好 MusicFree 插件这节解决我不想部署服务端想用现成插件搜歌的问题。打开哪里同一后台配置页「接口生态」选 MusicFree 插件下面出现「插件源配置」区域。填什么 / 点什么三种导入方式任选订阅更新填入插件源地址点「更新订阅」。系统会拉取该地址的 JSON校验其中有plugins数组后批量下载插件手动上传只收.js文件且文件名不能用ALL、all、OpenAPI、OPENAPI这几个保留名同名插件也不能重复传在线导入直接粘一个http(s)://的插件地址拉单个插件。管插件对已装插件可以做启用、禁用、卸载后台也留了 MusicFree 官方插件市场的直达入口。如何验证生效把要用的插件启用回搜索页搜一首歌结果里带上该插件的平台标签即生效。插件文件落在配置目录的js_plugins/下元数据记在配置文件的music_free_info节点里。⚠️ 一个容易踩的点搜索结果排序按【歌曲名匹配度】【歌手名匹配度】【插件权重】走插件权重就是启用列表里的先后顺序只有前 9 个插件的权重有效排得越靠前分数越高。想优先出某个源的歌把它往前挪就行。从能用到好用语音口令与自动连播搜索通了之后这几个开关能让体验从能用跨到顺手。语音点歌。两条口令直接对音箱说口令说法示例实际行为online_play在线播放 林俊杰 江南聚合搜索后打分挑最匹配的一首立即播singer_play播放歌手 周杰伦搜该歌手热门歌曲生成临时歌单顺序播打分规则是歌名完全匹配 90、开头 70、结尾 50、包含 30歌手名按 9/7/5/3 递减取最高分。所以歌名-歌手的写法如江南-林俊杰以第一个-分割能显著提高命中准确度。另外还有一条搜歌单口令online_playlist_play搜出歌单列表后按策略选一个拉全量歌曲推给音箱播。AI 智能口令提取。默认关闭。开了之后模糊指令我想听那首关于秋天的歌会先丢给大模型解析出歌名和歌手再搜失败或不可用时自动回退到传统的歌名-歌手分割。在高级设置里填接口地址留空默认阿里百炼、API Key、模型名默认qwen-flash。❗ 注意接口必须符合 OpenAI API 规范其他协议的模型接不上。自动追加同歌手。默认开启。播放到歌单最后一首时自动搜同歌手的新歌续上适合躺平时挂机连播。注意它只对「全部播放」即全部循环模式生效——在线点播创建的歌单默认就是这个模式。另外两个策略开关口令搜索偏好平台box_play_platform填all表示全平台聚合和语音搜单策略default取首条 /max_songs歌曲最多 /max_plays播放最多 /random随机都在高级设置里默认值日常够用。conf/plugins-config.json 里最常动的几处整个扩展的持久化配置都在这一个文件里首次启动由 配置文件模板 生成。只挑最常改的说{ api_type: 1, base_url: http://127.0.0.1:9527/api, x-user-name: , x-user-token: , auto_convert: false, auto_add_song: true, aiapi_info: {enabled: false, api_key: }, box_play_platform: all, password: }以上为各节点关键字段节选完整结构见模板文件。api_type改成 2 就走 LX 路线改 1 走 MusicFree。改错会导致后台页面和实际搜索对不上。base_url/x-user-name/x-user-tokenLX 三件套地址填错一切白搭服务开了鉴权却不填头请求会被拒。auto_convert打开后每 30 秒自动把 LX 歌单转成 xiaomusic 歌单仅 LX 路线显示该选项。❗ 转出来的歌单带_online_lx_前缀只有生态停留在 LXServer 状态下才能使用。auto_add_song自动追加同歌手歌曲的开关设false即关闭。aiapi_infoenabled设true且api_key非空AI 口令提取才启动。box_play_platform两条路线各有一份语音口令搜索时优先哪个源all是全部聚合。password非空即开启后台密码锁。进后台会先过GET /api/password/check验证走POST /api/password/verify忘记密码就编辑此字段置空即解锁。问题自救现象 → 原因 → 处理配好 LX 接口搜得到歌但播不出先确认服务端版本不是 v1.8.2 之后Token 限制再点一次「接口测试」看连通性仍不行参考 issue 811 的处理方案。想同步平台歌单到音箱播LX 路线下开auto_convert做 LX 歌单转 XM 歌单前提生态停在 LXServer更多讨论见 issue 807。AI 口令提取不生效检查aiapi_info的enabled是不是true、api_key是否为空以及模型接口是否遵循 OpenAI API 规范三者缺一即静默回退到普通分割。B 站等部分源的歌音箱放不了MusicFree 个别插件拿到的音频流格式小爱不支持这类资源改用网页直接听。搜同一首歌出来一堆结果在关键词里用-把歌名和歌手分开写比如江南-林俊杰匹配度立刻上来。播放链接突然失效这是保护机制在起作用——在线 URL 校验会拒绝内网、回环、链路本地、多播等地址SSRF 防护链接解析不过关时会原样返回此时换个源或平台再试。改了高级设置里自动追加歌曲没反应确认当前播放模式是「全部播放」该功能只在全部循环模式下工作。资源入口在线搜索核心业务搜索、聚合、直链解析、换源降级、SSRF 防护xiaomusic/online_music.py插件沙箱与 LX 接口请求Node 子进程通信、自动转换定时任务xiaomusic/js_plugin_manager.py全部在线搜索 REST 接口/api/js-plugins/*、/api/lxServer/*、/api/advanced-config/*、/api/password/*xiaomusic/api/routers/plugin.py后台配置页及脚本setting.html、setting-lxserver.js、setting-musicfree.js、setting-backend.js网页搜索页xiaomusic/static/onlineSearch/index.html配置文件模板xiaomusic/plugins-config-example.json历史问题记录docs/issues/【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 xiaomusic 在线搜索怎么接？两条路线一步步配好，音箱随时点歌
xiaomusic 在线搜索怎么接两条路线一步步配好音箱随时点歌【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic对着小爱音箱说一句在线播放 林俊杰 江南音箱却只回一句找不到歌或者你在网页搜索框里敲了半天列表空空如也——多半是 xiaomusic 的在线搜索还没接好搜索源。这个扩展不用本地曲库直接去互联网上搜歌、把结果推给音箱播或网页直接听核心逻辑集中在 在线音乐服务源码搜索源管理则由 JS 插件管理器 负责。整个接入过程只需要选一条路线、填几个参数配好之后语音点歌、网页搜歌都能直接用。动手前的 3 分钟检查清单在动配置之前先把下面几件事过一遍能避开后面 80% 的配了不生效问题音箱已绑定要用推给音箱播必须先在「小爱音箱设置面板」完成设备绑定否则搜索结果只能在网页听。口令白名单语音点歌依赖两个口令检查【允许唤醒的命令】列表里是否包含singer_play和online_play缺一个对应功能就哑火。LX 版本如果打算走 LX Server 路线注意 LX Music Sync Server v1.8.2 之后接口加了 Token 限制该版本先别急着升等 onlineSearch 新版适配。旧配置清理如果你从较早版本升级过来配置文件结构已经重构过直接删掉/conf/plugins-config.json再重启服务在网页端重新配一遍最省事。先想清楚走 LX Server 还是 MusicFree 插件两条路线功能上能做的事一样——聚合搜索、语音点歌、网页播放区别只在歌从哪儿来对比点LX Server 接口MusicFree 插件你手上要有什么一台已部署好的 LX Sync ServerMusicFree 生态的 JS 插件资源配置量一个接口地址可选鉴权头订阅源地址或逐个上传插件玩法上限平台列表管理tx/kg/kw/wy/mg插件增删、排序调权重出问题时排查查服务端和地址连通性查单个插件状态一句话推荐已经跑着 LX Sync Server 的直接选 LX五分钟接完没有部署习惯、只想要现成插件资源的选 MusicFree。两条路线互斥同一时间只有一条生效配置文件里对应api_type字段1 MusicFree 插件2 LX Server 接口。切换时后台会弹确认框——因为两边配置项插件列表 vs 平台列表互相不兼容切错要重新填。5 分钟接好 LX Server 接口这节解决我有 LX 服务端想让 xiaomusic 用上它的问题。打开哪里在线搜索后台配置页setting.html在「接口生态」区域选择 LXServer 接口。填什么接口地址填你的 LX 服务 API 入口典型形如http://127.0.0.1:9527/api。如果服务开了鉴权把x-user-name和x-user-token一并填上之后所有请求会自动带这两个请求头。点什么先点「接口测试」。后端会请求${base_url}/music/config并校验返回里有没有player.enableAuth、user.enablePublicRestriction字段通过即说明地址合法。然后在「平台管理」里添加要参与搜索的平台常用的五个tx小秋、kg小枸、kw小蜗、wy小芸、mg小蜜。加几个平台搜索时就并行请求几个再合并结果。如何验证生效回搜索页搜一首歌列表顶部应能看到来源平台标签再对音箱说一句在线播放口令能出声就通了。机制上只补两句播放时系统先查${base_url}/music/cache/check缓存未命中再走进度接口加${base_url}/music/url解析直链音质按master flac24bit flac 320k 192k 128k的顺序优先选你偏好的档位直链解析失败自动降档原始平台挂了还会按歌名歌手时长误差 5 秒内跨平台换源。这些都不用你管知道它不会轻易失败就行。手动装好 MusicFree 插件这节解决我不想部署服务端想用现成插件搜歌的问题。打开哪里同一后台配置页「接口生态」选 MusicFree 插件下面出现「插件源配置」区域。填什么 / 点什么三种导入方式任选订阅更新填入插件源地址点「更新订阅」。系统会拉取该地址的 JSON校验其中有plugins数组后批量下载插件手动上传只收.js文件且文件名不能用ALL、all、OpenAPI、OPENAPI这几个保留名同名插件也不能重复传在线导入直接粘一个http(s)://的插件地址拉单个插件。管插件对已装插件可以做启用、禁用、卸载后台也留了 MusicFree 官方插件市场的直达入口。如何验证生效把要用的插件启用回搜索页搜一首歌结果里带上该插件的平台标签即生效。插件文件落在配置目录的js_plugins/下元数据记在配置文件的music_free_info节点里。⚠️ 一个容易踩的点搜索结果排序按【歌曲名匹配度】【歌手名匹配度】【插件权重】走插件权重就是启用列表里的先后顺序只有前 9 个插件的权重有效排得越靠前分数越高。想优先出某个源的歌把它往前挪就行。从能用到好用语音口令与自动连播搜索通了之后这几个开关能让体验从能用跨到顺手。语音点歌。两条口令直接对音箱说口令说法示例实际行为online_play在线播放 林俊杰 江南聚合搜索后打分挑最匹配的一首立即播singer_play播放歌手 周杰伦搜该歌手热门歌曲生成临时歌单顺序播打分规则是歌名完全匹配 90、开头 70、结尾 50、包含 30歌手名按 9/7/5/3 递减取最高分。所以歌名-歌手的写法如江南-林俊杰以第一个-分割能显著提高命中准确度。另外还有一条搜歌单口令online_playlist_play搜出歌单列表后按策略选一个拉全量歌曲推给音箱播。AI 智能口令提取。默认关闭。开了之后模糊指令我想听那首关于秋天的歌会先丢给大模型解析出歌名和歌手再搜失败或不可用时自动回退到传统的歌名-歌手分割。在高级设置里填接口地址留空默认阿里百炼、API Key、模型名默认qwen-flash。❗ 注意接口必须符合 OpenAI API 规范其他协议的模型接不上。自动追加同歌手。默认开启。播放到歌单最后一首时自动搜同歌手的新歌续上适合躺平时挂机连播。注意它只对「全部播放」即全部循环模式生效——在线点播创建的歌单默认就是这个模式。另外两个策略开关口令搜索偏好平台box_play_platform填all表示全平台聚合和语音搜单策略default取首条 /max_songs歌曲最多 /max_plays播放最多 /random随机都在高级设置里默认值日常够用。conf/plugins-config.json 里最常动的几处整个扩展的持久化配置都在这一个文件里首次启动由 配置文件模板 生成。只挑最常改的说{ api_type: 1, base_url: http://127.0.0.1:9527/api, x-user-name: , x-user-token: , auto_convert: false, auto_add_song: true, aiapi_info: {enabled: false, api_key: }, box_play_platform: all, password: }以上为各节点关键字段节选完整结构见模板文件。api_type改成 2 就走 LX 路线改 1 走 MusicFree。改错会导致后台页面和实际搜索对不上。base_url/x-user-name/x-user-tokenLX 三件套地址填错一切白搭服务开了鉴权却不填头请求会被拒。auto_convert打开后每 30 秒自动把 LX 歌单转成 xiaomusic 歌单仅 LX 路线显示该选项。❗ 转出来的歌单带_online_lx_前缀只有生态停留在 LXServer 状态下才能使用。auto_add_song自动追加同歌手歌曲的开关设false即关闭。aiapi_infoenabled设true且api_key非空AI 口令提取才启动。box_play_platform两条路线各有一份语音口令搜索时优先哪个源all是全部聚合。password非空即开启后台密码锁。进后台会先过GET /api/password/check验证走POST /api/password/verify忘记密码就编辑此字段置空即解锁。问题自救现象 → 原因 → 处理配好 LX 接口搜得到歌但播不出先确认服务端版本不是 v1.8.2 之后Token 限制再点一次「接口测试」看连通性仍不行参考 issue 811 的处理方案。想同步平台歌单到音箱播LX 路线下开auto_convert做 LX 歌单转 XM 歌单前提生态停在 LXServer更多讨论见 issue 807。AI 口令提取不生效检查aiapi_info的enabled是不是true、api_key是否为空以及模型接口是否遵循 OpenAI API 规范三者缺一即静默回退到普通分割。B 站等部分源的歌音箱放不了MusicFree 个别插件拿到的音频流格式小爱不支持这类资源改用网页直接听。搜同一首歌出来一堆结果在关键词里用-把歌名和歌手分开写比如江南-林俊杰匹配度立刻上来。播放链接突然失效这是保护机制在起作用——在线 URL 校验会拒绝内网、回环、链路本地、多播等地址SSRF 防护链接解析不过关时会原样返回此时换个源或平台再试。改了高级设置里自动追加歌曲没反应确认当前播放模式是「全部播放」该功能只在全部循环模式下工作。资源入口在线搜索核心业务搜索、聚合、直链解析、换源降级、SSRF 防护xiaomusic/online_music.py插件沙箱与 LX 接口请求Node 子进程通信、自动转换定时任务xiaomusic/js_plugin_manager.py全部在线搜索 REST 接口/api/js-plugins/*、/api/lxServer/*、/api/advanced-config/*、/api/password/*xiaomusic/api/routers/plugin.py后台配置页及脚本setting.html、setting-lxserver.js、setting-musicfree.js、setting-backend.js网页搜索页xiaomusic/static/onlineSearch/index.html配置文件模板xiaomusic/plugins-config-example.json历史问题记录docs/issues/【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考