xiaomusic 在线搜索落地指南1 份配置打通 3 条小爱音箱点歌链路【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicxiaomusic 在线搜索配好后小爱音箱多出三种点歌方式网页搜歌推送、语音在线点歌、口令点歌单。以下按真实操作顺序展开双生态选型、配置落盘、排障处置。配完能做什么三种用法先看结果网页搜歌、推给音箱在在线搜索页输入“歌名 歌手”命中后点推送音箱直接播不依赖本地曲库语音在线点歌唤醒后说“在线播放 歌名 歌手”例如“在线播放 林俊杰 江南”后端自动完成搜索、打分与播放口令点歌单语音搜歌单系统按你选的策略挑一个最优歌单把全部歌曲推给音箱。不推音箱也行搜索结果可以在搜索页里直接播。个别插件如 B 站源拿到的流格式小爱可能播不了这类资源放网页端最稳。两套生态怎么选先看结论手里有 MusicFree 插件资源选插件版愿意多部署一个服务端选接口版。背后的分界线是后台字段api_type决定请求走哪条路的开关取值只有1与2前者对应 MusicFree 插件、后者对应 LX Server 接口同一时刻仅一套生效。切换生态时前端会弹确认框——两边配置互不兼容切完旧配置对另一边失效。插件版音乐源由 JS 插件逐个对接。JSPluginManager插件沙箱管理器拉起一个 Node.js 子进程当沙箱Python 端通过标准输入输出收发 JSON 消息聚合方式是对全部已启用插件并行发请求。接口版指向一个自建的 LX Sync Server 服务对全部已配置平台并行请求。搜索、聚合都交给服务端本地代码专注播放保障。按操作顺序走一遍配置绑定音箱。在「小爱音箱设置面板」完成绑定一切“推送到音箱”的动作都以它为前置条件。选生态。打开在线搜索配置页xiaomusic/static/onlineSearch/setting.html在「接口生态」二选一切换会弹确认框。插件版怎么配编辑订阅地址后点「更新订阅」后台从订阅源拉 JSON 清单并批量下插件没有订阅也能手动上传本地.js文件或直接粘贴http(s)://开头的插件地址做在线导入。单个插件可启用、禁用或卸载。启用列表的排列顺序即源偏好排序算法optimize_search_results只对前 9 个启用插件记权重分权重 9 - 排名越靠前分越高。LX 接口地址怎么测把 LX Server 的 API 地址http://127.0.0.1:9527/api这种形式填进去用「接口测试」按钮验连通鉴权开启时补x-user-name、x-user-token请求会自动携带这两个头。平台列表里增删tx、kg、kw等搜索平台平台全留着即聚合搜索。接口版自带播放保障音质按master → flac24bit → flac → 320k → 192k → 128k逐档降级直链解析失败自动切下一档跨平台按“歌名 歌手 时长误差 ≤5 秒”换源重试相关逻辑集中在xiaomusic/online_music.py。高级开关怎么开自动追加歌曲播到歌单末尾自动补同歌手歌曲默认开启自动拉取并转换 LX 歌单每 30 秒同步一次仅接口版显示AI 口令提取默认关闭具体开启方法见下一节语音搜单策略default取首条另有歌曲最多、播放最多、随机三档。配置落在哪里一切持久化在运行目录的conf/plugins-config.json。骨架如下看懂三行即可覆盖日常维护back_conf_info: {api_type: 1}, lx_server_info: {base_url: , platforms: {tx: 小秋音乐}}, music_free_info: {enabled_plugins: [], plugin_source: {source_url: }}back_conf_info.api_type决定走哪条路lx_server_info与music_free_info分别承载两套生态的专属参数。后台另有一把可选密码锁password字段填非空值即启用置空即关闭。语音点歌与 AI 口令在「允许唤醒的命令」白名单中加入singer_play,online_play三条口令即可用在线播放 林俊杰 江南→online_play搜索后对候选逐条分层计分——歌名完全匹配、开头匹配、包含匹配依次给分歌手名同理——取最高分那条直接播播放歌手 周杰伦→singer_play拉取该歌手热歌组成临时歌单顺序播放语音点歌单→online_playlist_play独立链路先搜歌单列表按所选策略挑出最优再拉全量歌曲推送。AI 口令提取怎么开高级设置里打开开关填接口地址留空走阿里百炼默认通道、API Key、模型名默认qwen-flash。模型接口必须符合 OpenAI API 规范。开启后“我想听那首关于秋天的歌”这类模糊说法会先经大模型解析出歌名和歌手再搜索一旦解析失败或模型服务不可用系统退回按-切分“歌名-歌手”的旧逻辑点歌不中断。搜索偏好也能固定高级设置里的“口令搜索偏好”字段box_play_platform可指定某平台优先填all保持聚合两种生态各有一份此字段互不干扰。排障速查 按高频到低频排序现象最可能原因处置动作语音喊了没反应口令不在「允许唤醒的命令」白名单确认列表包含singer_play与online_playLX 接口版搜得到但播不出来LX Music Sync Server v1.8.2 之后接口加了 Token 限制与当前版本不兼容停留在 1.8.2 之前的服务端版本或参考 docs/issues/811.md 的处理方案AI 口令提取没生效aiapi_info中enabled不为true、api_key为空或接口不符合 OpenAI 规范三项逐一核对接口地址留空即走阿里百炼通道转出来的 LX 歌单放不了_online_lx_前缀歌单只在 LXServer 生态下生效回接口生态页切回 LX Server重新播放升级后台后配置页行为不对部分版本如 V1.1.1重构过配置结构手动删掉旧的conf/plugins-config.json重启后在网页端重新配一遍安全边界也值得知道后端对所有在线播放地址做校验内网、回环、多播这类地址一律拦下以防 SSRF实现在_make_request_with_validation中。源码与文档入口在线搜索核心搜索/聚合/直链/降级/AI 解析xiaomusic/online_music.py插件沙箱与 LX 接口管理xiaomusic/js_plugin_manager.py全部 REST 接口路由xiaomusic/api/routers/plugin.py后台配置页及脚本xiaomusic/static/onlineSearch/配置文件模板xiaomusic/plugins-config-example.jsonLX 歌单同步方案讨论docs/issues/807.md【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考