xiaomusic 在线搜索快速上手：语音点歌与配置避坑-北京尧图网络

xiaomusic 在线搜索快速上手语音点歌与配置避坑【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicxiaomusic 的「在线搜索」扩展让小爱音箱不依赖本地曲库直接在线搜到歌曲并立刻播放可以语音口令点歌也可以网页搜索后推到音箱或干脆在浏览器里听。本文带你按顺序完成这些事先把一种生态跑通再在 MusicFree 插件与 LX Server 接口之间做选型最后掌握搜索格式、语音口令、进阶设置和一份排错清单。五步把 xiaomusic 在线搜索跑起来先走配置量最小的 LX Server 路线拿到正反馈再谈其他。在服务器上部署好 LX Sync Server确认可访问的接口地址形如http://127.0.0.1:9527/api打开在线搜索后台配置页在「接口生态」处切到 LX Server 接口填入base_url点「接口测试」V1.1.2 提供验证连通性回到「小爱音箱设置面板」完成音箱绑定没有绑定音箱推送就不工作在搜索页输入歌曲名 - 艺术家确认结果能推到音箱播放。坑点拿不准生态先跑通 LX Server它只有一个地址必填项还能一键自检跑通后再按需要换 MusicFree。选对接口生态MusicFree 插件还是 LX Server两条路线同一时间只有一条生效配置项back_conf_info.api_type里1代表 MusicFree 插件、2代表 LX Server 接口。切换时前端会弹确认因为两套配置各管各的字段切过去等于放弃另一边的已有设置。对比维度MusicFree 插件版api_type1LX Server 接口版api_type2前置条件有可用的 JS 插件资源已部署 LX Sync Server配置成本要管插件订阅、启停、上传只填一个接口地址搜索来源按启用顺序聚合各插件按配置平台聚合tx/kg/kw/wy/mg适合你想多试几个音乐源想要稳定的服务端统一接口MusicFree 路线的关键点订阅插件源编辑地址后点「更新订阅」系统校验返回的 JSON 含plugins数组再批量下载手动上传只接受.js文件文件名不能占用ALL、OpenAPI等保留字段同名不可重复在线导入只需粘贴一个http(s)://插件地址权重规则启用列表里排得越靠前权重越高前 9 个插件有效第一名权重 9 分逐位递减。LX Server 路线的关键点base_url是唯一必填项认证V1.1.3另填x-user-name与x-user-token请求时自动带上这两个头接口测试V1.1.2会请求${base_url}/music/config校验player.enableAuth和user.enablePublicRestriction字段来确认是合法接口播放保障做得比较完整音质按master → flac24bit → flac → 320k → 192k → 128k逐级降级原平台解析失败时按「歌名歌手时长误差 5 秒内」跨平台换源。坑点不建议把 LX Music Sync Server 升到 v1.8.2 及以上因为该版本起接口加了 Token 限制需等在线搜索新版适配后再升。搜索与播放写准关键词、看懂排序、选对出口关键词格式用歌曲名 - 艺术家后端以第一个-为界拆开歌曲与歌手匹配准确度明显高于只搜歌名。聚合与排序MusicFree 侧并行调用所有已启用插件每插件限额按数量分摊LX 侧并行请求所有已配置平台结果合并后统一排序。优先级固定为歌曲名匹配度歌手名匹配度平台权重。语音取第一首时按分数选歌名完全匹配 90、开头匹配 70、结尾 50、包含 30歌手名命中按 9/7/5/3 递减。两个播放出口按场景取舍推音箱适合日常点歌前提是已绑定音箱网页端适合听一些音箱吃不下的音频流。坑点MusicFree 部分插件如 B 站源拿到的音频流不被小爱音箱支持这类资源请改用网页端播放。另外后端对在线 URL 有安全校验内网、回环、链路本地、多播等地址一律拒绝防止 SSRF这是设计行为不用怀疑配置。开口点歌两条语音口令和 AI 解析先做进入后台「允许唤醒的命令」把,singer_play,online_play,加进列表口令才生效。口令格式示例行为在线播放歌曲在线播放关键词在线播放林俊杰江南搜索当前生态按打分取最优一首立即播放播放歌手歌单播放歌手歌手名播放歌手周杰伦搜该歌手歌曲建临时歌单顺序播放语音搜歌单是独立链路online_playlist_play先搜歌单列表、按策略选出最优一个再拉全量歌曲推给音箱。选哪个歌单由voice_playlist_strategy控制下一节讲。AI 口令提取默认关闭在aiapi_info里把enabled设为true、填上api_key即可能帮你从我想听那首关于秋天的歌这类模糊话术里拆出歌名和歌手。接口地址留空时默认走阿里百炼模型默认qwen-flash解析失败或 AI 不可用会自动回退到传统的歌名-歌手分割不会卡死。aiapi_info: { enabled: true, api_key: 你的key, model: qwen-flash }注意只认符合 OpenAI API 规范的接口其他规范的模型服务暂时用不了。进阶设置自动追加、搜单策略、密码锁与歌单转换配置项作用什么时候动它auto_add_song顶层播到歌单末尾时自动搜同歌手歌曲追加仅「全部播放」全部循环模式生效想无限连播时确认开着voice_playlist_strategy语音搜单策略default首条 /max_songs歌曲最多 /max_plays播放最多 /random随机觉得默认首条不够合口味时password顶层后台密码锁字段非空即启用多人共用设备、不想别人改设置lx_server_info.auto_convert每 30 秒拉取 LX 歌单转成 XM 歌单仅 LX Server 生态显示想直接用 LX 上的歌单密码锁的实际流程进后台先查GET /api/password/check返回required: true就弹密码框验证接口是POST /api/password/verify。忘记密码直接编辑conf/plugins-config.json把password改掉置空即关闭密码锁。password: , auto_add_song: true坑点由 LX 歌单转换来的 XM 歌单带_online_lx_前缀必须把生态切到 LXServer 侧才能使用配置结构大改的版本升级后旧conf/plugins-config.json需要删掉重配。排错清单常见现象与处理现象排查动作解决LX 接口测试不通过确认地址以/api结尾、服务器版本别用 v1.8.2 的 LX Server或等新版适配说在线播放没反应查「允许唤醒的命令」列表补上singer_play和online_playAI 提取不生效查aiapi_info字段enabled为true、api_key非空、接口符合 OpenAI API 规范推音箱失败、网页能播看命中来源是哪家插件MusicFree 的 B 站等源换网页端播放转换的歌单找不到看当前生态选择切到 LXServer 生态再找_online_lx_歌单口令搜到的歌不对查搜索偏好设置偏好平台别锁死单一来源用all聚合把生态跑通、口令配好、偏好留all在线搜索这套功能基本就不会再坑你。想深入实现细节建议按顺序读这三处搜索与降级逻辑在xiaomusic/online_music.py插件沙箱与 LX 请求在xiaomusic/js_plugin_manager.py全部 REST 接口在xiaomusic/api/routers/plugin.py后台页面入口是xiaomusic/static/onlineSearch/setting.html。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

xiaomusic 在线搜索快速上手：语音点歌与配置避坑

相关推荐

AI Agent可视化配置平台：降低技术门槛，加速企业智能化

377 条现成 Prompt 60 秒跑通第一条｜awesome-prompts 实用上手

Pandoc 源码解析：标题内代码为何不做语法高亮（LaTeX 输出中的 texorpdfstring 机制）

更多资讯

自动购票脚本揭秘：从环境报错到反爬机制与合规替代

OpenCASCADE与Qt实战：JellyCAD三维建模框架构建指南

DataHub Smoke Test 编写指南：面向活跃 GMS 实例的 E2E 测试权威规范

V8 内置函数（Built-in Functions）完全指南：从 JavaScript 实现到 Runtime 与 CSA 的多种实现路径

TensorFlow.js WebGPU 后端（tfjs-backend-webgpu）使用指南：安装、算子支持与性能调优

AquaPulse：边缘AI如何实现管道漏水实时检测与预警

今日更新

深入解析Transformer多头注意力机制与工程优化

OpenClaw 的 Skills 跑学习任务，模型通道改到 TaoToken 通道行不行？

ChatGPT报错Oops, an error occurred! 全链路排查指南

本周精选

深入解析Transformer多头注意力机制与工程优化

OpenClaw 的 Skills 跑学习任务，模型通道改到 TaoToken 通道行不行？

ChatGPT报错Oops, an error occurred! 全链路排查指南

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？