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