指南:從配置到語音點歌)
xiaomusic 在線搜索實戰(zhàn)指南從配置到語音點歌【免費下載鏈接】xiaomusic使用小愛音箱播放音樂音樂使用 yt-dlp 下載。項目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic小愛音箱里的曲庫被你聽完了想點一首新歌本地卻翻不到去網頁找歌又要搜半天再想辦法傳到設備。xiaomusic 的在線搜索模塊解決的就是這個麻煩輸入歌名全網找歌直接播到音箱不下載、不折騰也可以不動手喊一聲口令讓音箱自己搜、自己播。能力全景小愛音箱在線音樂的完整鏈路整條鏈路分四步。第一步搜索搜索頁按歌名 歌手格式輸入發(fā)送后 xiaomusic 同時向當前生效的搜索源要結果。第二步選源結果來自不同平臺系統(tǒng)按匹配度打分排序你挑最靠譜的那條。第三步播放推送到已綁定的小愛音箱或直接在當前網頁播。第四步保障直鏈解析失敗時自動降檔音質、跨平臺換源重試這段臟活由后臺代勞。選型決策MusicFree 插件與 LX Server 接口怎么選xiaomusic 在線搜索有兩套底座由api_type字段決定1 是 MusicFree 插件2 是 LX Server 接口同一時間只有一套生效。對比項MusicFree 插件版LX Server 接口版歌曲來源在哪本地運行的 JS 插件一個插件對應一個音樂源你自己部署的 LX Sync Server 服務部署成本只需 Node.jsxiaomusic 默認自帶要多跑一個服務端進程或容器結果怎么聚合并行請求全部已啟用插件本地合并并行請求全部已配置平臺tx/kg/kw 等由服務端統(tǒng)一返回音質怎么保證取決于各插件能取到什么檔位本地從 master 一路降到 128k失敗自動換下一檔某個源失效怎么辦禁用或卸載對應插件從平臺列表里移除該平臺插件版的工作原理是本地沙箱JSPluginManager拉起一個 Node.js 子進程Python 端通過標準輸入輸出收發(fā) JSON每個插件都是這個沙箱里的獨立任務。接口版則把找歌這件事整體外包給遠端服務端本地只保留播放保障邏輯兩邊代碼重心完全不同。配置全流程先定生態(tài)再填參數先用一句話做判斷手里有現成的 MusicFree 插件資源選插件版自己搭過 LX Sync Server選接口版。兩邊的配置互不兼容切換時會彈確認框彈了就意味著舊配置對另一邊失效。MusicFree 插件版配置步驟打開在線搜索配置頁先填插件訂閱地址點更新訂閱系統(tǒng)會拉取訂閱源并批量下載插件。沒有訂閱源也可以手動上傳本地.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先搜歌單列表按你選的策略挑最優(yōu)的一個拉全量歌曲推給音箱。想折騰打分細節(jié)可以讀online_music.py里的_search_top_one。個性化調優(yōu)三個可選增強項如果你想讓模糊指令也能搜到歌開啟 AI 口令提取后我想聽那首關于秋天的歌這類說法會先經大模型解析出歌名和歌手再搜索解析失敗或 AI 不可用時自動回退到按-分割的老辦法功能不會斷。如果你想固定搜索偏好把口令搜索偏好配置字段box_play_platform填成某個平臺即優(yōu)先該平臺填all保持聚合兩種生態(tài)各有一份此字段互不干擾。如果你要網頁端聽歌部分插件如 B 站源拿到的流格式小愛可能播不了這類資源直接在搜索頁播放最穩(wěn)。故障速查xiaomusic 在線搜索常見卡點LX 接口版搜得到但播不出來現象搜索有結果點播放后音箱沒有聲音。原因LX Music Sync Server 在 v1.8.2 之后對接口加了 Token 限制與當前版本不兼容。解法服務端停留在 1.8.2 之前的版本或參考項目 issue 里的 LX 播放失敗討論。AI 口令提取沒生效現象開了 AI 解析模糊口令還是按老辦法切分。原因aiapi_info的enabled不是true、api_key為空、或模型接口不符合 OpenAI 規(guī)范。解法三項逐一核對接口地址留空即可走默認百煉通道。語音喊了沒反應現象喊在線播放音箱無響應。原因口令不在允許喚醒的命令白名單里。解法確認列表包含singer_play與online_play兩項。轉換出來的 LX 歌單放不了現象帶_online_lx_前綴的歌單播放失敗。原因這類歌單只在 LX Server 生態(tài)下生效。解法把接口生態(tài)切換回 LX Server 再播放。升級后臺后配置頁行為不對現象版本升級后舊選項加載不出來或顯示錯亂。原因部分版本如 V1.1.1重構過配置結構。解法刪除舊的conf/plugins-config.json重啟后在網頁端重新配置。順帶一提安全細節(jié)后端對所有在線播放地址做 SSRF 校驗會拒絕內網、回環(huán)、多播等地址。資源導航核心源碼與文檔xiaomusic/online_music.py在線搜索聚合、直鏈解析、音質降級與 AI 口令解析的核心業(yè)務。xiaomusic/js_plugin_manager.py插件沙箱管理 Node.js 子進程與插件生命周期。xiaomusic/api/routers/plugin.py在線搜索配置頁的全部 REST 接口路由。xiaomusic/plugins-config-example.json配置文件模板兩套生態(tài)的字段骨架都在這里。docs/issues/807.mdLX 歌單同步方案的討論記錄。【免費下載鏈接】xiaomusic使用小愛音箱播放音樂音樂使用 yt-dlp 下載。項目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic創(chuàng)作聲明:本文部分內容由AI輔助生成(AIGC),僅供參考