xiaomusic 在线搜索实战指南从配置到语音点歌【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic小爱音箱里的曲库被你听完了想点一首新歌本地却翻不到去网页找歌又要搜半天再想办法传到设备。xiaomusic 的在线搜索模块解决的就是这个麻烦输入歌名全网找歌直接播到音箱不下载、不折腾也可以不动手喊一声口令让音箱自己搜、自己播。能力全景小爱音箱在线音乐的完整链路整条链路分四步。第一步搜索搜索页按歌名 歌手格式输入发送后 xiaomusic 同时向当前生效的搜索源要结果。第二步选源结果来自不同平台系统按匹配度打分排序你挑最靠谱的那条。第三步播放推送到已绑定的小爱音箱或直接在当前网页播。第四步保障直链解析失败时自动降档音质、跨平台换源重试这段脏活由后台代劳。选型决策MusicFree 插件与 LX Server 接口怎么选xiaomusic 在线搜索有两套底座由api_type字段决定1 是 MusicFree 插件2 是 LX Server 接口同一时间只有一套生效。对比项MusicFree 插件版LX Server 接口版歌曲来源在哪本地运行的 JS 插件一个插件对应一个音乐源你自己部署的 LX Sync Server 服务部署成本只需 Node.jsxiaomusic 默认自带要多跑一个服务端进程或容器结果怎么聚合并行请求全部已启用插件本地合并并行请求全部已配置平台tx/kg/kw 等由服务端统一返回音质怎么保证取决于各插件能取到什么档位本地从 master 一路降到 128k失败自动换下一档某个源失效怎么办禁用或卸载对应插件从平台列表里移除该平台插件版的工作原理是本地沙箱JSPluginManager拉起一个 Node.js 子进程Python 端通过标准输入输出收发 JSON每个插件都是这个沙箱里的独立任务。接口版则把找歌这件事整体外包给远端服务端本地只保留播放保障逻辑两边代码重心完全不同。配置全流程先定生态再填参数先用一句话做判断手里有现成的 MusicFree 插件资源选插件版自己搭过 LX Sync Server选接口版。两边的配置互不兼容切换时会弹确认框弹了就意味着旧配置对另一边失效。MusicFree 插件版配置步骤打开在线搜索配置页先填插件订阅地址点更新订阅系统会拉取订阅源并批量下载插件。没有订阅源也可以手动上传本地.js文件或粘贴一个http(s)://插件地址在线导入。单个插件支持启用、禁用、卸载三档操作。注意启用列表的顺序排序算法只给前 9 个插件记权重分排名越靠前分越高顺序就是你的源偏好。LX Server 接口对接与连通性测试填入 LX Sync Server 的 API 地址形如http://127.0.0.1:9527/api点接口测试验证连通性。服务端开了鉴权的话再补上x-user-name与x-user-token请求会自动带上这两个头。最后在平台列表里增删tx、kg、kw等平台全部保留就是聚合搜索。高级设置有四项开关按需打开自动追加歌曲播放到歌单末尾时自动补同歌手歌曲默认开启。自动拉取并转换 LX 歌单每 30 秒同步一次 LX 服务端歌单仅接口版显示。AI 口令提取默认关闭开启后填接口地址留空走阿里百炼、API Key、模型名默认qwen-flash。语音搜单策略default取首条也可选歌曲最多、播放最多或随机。所有设置持久化在运行目录的conf/plugins-config.json骨架如下看懂这几行就够日常维护back_conf_info: {api_type: 1}, lx_server_info: {base_url: , platforms: {tx: 小秋音乐}}, music_free_info: {enabled_plugins: [], box_play_platform: all}另外给password字段填非空值就能给后台加一道密码锁置空即关闭。xiaomusic 语音点歌三条口令直接开口播在允许唤醒的命令里加上singer_play,online_play音箱就有三种点歌方式在线播放 林俊杰 江南后端搜索后对候选逐条打分歌名完全匹配、开头匹配、包含匹配分层计分取最高分那条直接播。播放歌手 周杰伦把该歌手的热歌建成临时歌单顺序播放。语音搜歌单走独立链路online_playlist_play先搜歌单列表按你选的策略挑最优的一个拉全量歌曲推给音箱。想折腾打分细节可以读online_music.py里的_search_top_one。个性化调优三个可选增强项如果你想让模糊指令也能搜到歌开启 AI 口令提取后我想听那首关于秋天的歌这类说法会先经大模型解析出歌名和歌手再搜索解析失败或 AI 不可用时自动回退到按-分割的老办法功能不会断。如果你想固定搜索偏好把口令搜索偏好配置字段box_play_platform填成某个平台即优先该平台填all保持聚合两种生态各有一份此字段互不干扰。如果你要网页端听歌部分插件如 B 站源拿到的流格式小爱可能播不了这类资源直接在搜索页播放最稳。故障速查xiaomusic 在线搜索常见卡点LX 接口版搜得到但播不出来现象搜索有结果点播放后音箱没有声音。原因LX Music Sync Server 在 v1.8.2 之后对接口加了 Token 限制与当前版本不兼容。解法服务端停留在 1.8.2 之前的版本或参考项目 issue 里的 LX 播放失败讨论。AI 口令提取没生效现象开了 AI 解析模糊口令还是按老办法切分。原因aiapi_info的enabled不是true、api_key为空、或模型接口不符合 OpenAI 规范。解法三项逐一核对接口地址留空即可走默认百炼通道。语音喊了没反应现象喊在线播放音箱无响应。原因口令不在允许唤醒的命令白名单里。解法确认列表包含singer_play与online_play两项。转换出来的 LX 歌单放不了现象带_online_lx_前缀的歌单播放失败。原因这类歌单只在 LX Server 生态下生效。解法把接口生态切换回 LX Server 再播放。升级后台后配置页行为不对现象版本升级后旧选项加载不出来或显示错乱。原因部分版本如 V1.1.1重构过配置结构。解法删除旧的conf/plugins-config.json重启后在网页端重新配置。顺带一提安全细节后端对所有在线播放地址做 SSRF 校验会拒绝内网、回环、多播等地址。资源导航核心源码与文档xiaomusic/online_music.py在线搜索聚合、直链解析、音质降级与 AI 口令解析的核心业务。xiaomusic/js_plugin_manager.py插件沙箱管理 Node.js 子进程与插件生命周期。xiaomusic/api/routers/plugin.py在线搜索配置页的全部 REST 接口路由。xiaomusic/plugins-config-example.json配置文件模板两套生态的字段骨架都在这里。docs/issues/807.mdLX 歌单同步方案的讨论记录。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考