小爱音箱只会回“暂不支持“?三步用 XiaoMusic 把它变成免费私人点歌台 📅 2026/8/17 19:58:52 小爱音箱只会回暂不支持三步用 XiaoMusic 把它变成免费私人点歌台【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic播放周杰伦的晴天。你对着小爱音箱说完这句话它停顿两秒回了一句抱歉暂不支持播放该内容。这句话听着耳熟吗想听的歌总在版权之外几乎成了智能音箱的标配遗憾。而 XiaoMusic就是来终结这句话的——它能让小爱音箱真正听懂你的点歌把任何想听的音乐都搬进客厅。先弄明白它到底在小爱音箱背后干了什么很多人第一次听说 XiaoMusic 时第一反应是又一个山寨播放器。其实它的思路完全不一样——它不是给音箱塞一个 App而是站在音箱背后当翻译官 采购员 搬运工。你可以把小爱音箱想象成一台只认官方曲库的收音机你点播的歌不在小米的曲库里它就两手一摊。而 XiaoMusic 做的事情是把你和音箱之间的每一句对话都旁听下来一旦识别到点歌口令就去你的本地曲库找歌找不到它立刻调用yt-dlp去网络上搜索并下载等歌到手了再指挥音箱把它播放出来。整个过程走完你在表面上看到的只是音箱突然会唱那首歌了。底层用到的是 Python FastAPI 搭起的轻量服务靠 MiService 库和小爱通信下载交给 yt-dlp——都是开源界久经考验的成熟组件。说得更直白一点你家的音箱还是那个音箱但它的曲库权限被 XiaoMusic 悄悄解锁了。拆箱上手从空目录到第一首歌只需三步别被上面那套原理吓到实际跑起来新手十分钟以内就能听到第一首歌。第一步用一个命令把服务装进 Docker。先建两个目录一个放音乐、一个放配置mkdir -p /xiaomusic_music /xiaomusic_conf再写一个极简的docker-compose.ymlservices: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf然后docker-compose up -d就完事了。第二步打开网页填两个必填项。浏览器访问http://你的设备IP:58090进设置页把小米账号和密码填进去——这是 XiaoMusic 获取音箱设备列表的钥匙。保存后页面上就能看到你家那台小爱了。第三步开口点歌。对音箱说一句播放歌曲周杰伦晴天它会先愣一下然后……真的唱起来了。如果本地没有这首歌它会现下载现播等几秒而已。不喜欢 Docker 的话也有原生方案pip install -U xiaomusic然后xiaomusic --config config.json启动默认端口 8090。想折腾源码的git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic之后跟着项目里的安装脚本一步步来就行文档写得很清楚。跟着我家的一天看看它怎么被用起来工具讲得再热闹不如看看它在一个普通家里到底长什么样。我们假设周末这天你家有了 XiaoMusic早上 8:00客厅。你之前顺手在配置里加了一条定时任务每个工作日早上八点自动播放今日推荐歌单。于是早餐还没摆好音箱已经自己开始哼歌了。这种到点自动放的能力来自内置的crontab_json配置你甚至可以写多条比如晚上十点自动停止播放睡前不用专门喊关机。下午 2:00书房。你突然想听一首十年前的冷门老歌歌单里没有网上搜也很费劲。你对着音箱说播放歌曲xxx几秒后它唱了——XiaoMusic 用 yt-dlp 现找现下然后存进本地曲库。下次再点这首就是本地播放秒出。这就是它最迷人的地方歌越听越多曲库越用越肥而且全部免费。晚上 8:30儿童房。娃吵着要听睡前故事。你说播放歌曲小猪佩奇的故事音箱居然真的开始讲起了故事——这是作者藏在语音口令里的隐藏玩法它会把故事当歌下载下来再播放。哄睡完你补一句30分钟后关机音箱会乖乖在半小时后闭嘴。周末下午整理时间。你把电脑里积攒多年的 MP3 按风格分进摇滚古典轻音乐几个文件夹然后在网页上点一下刷新列表。从此只要说播放歌单摇滚它就按你的品味放。收藏功能也顺手——听到好歌说一句加入收藏它就会归入收藏歌单。以下是这个家里最常用的一桌口令几乎覆盖了日常所有需求你说的话它做的事播放歌曲 歌名本地播放或自动下载后播放下一首 / 上一首切换曲目单曲循环 / 全部循环 / 随机播放切换播放模式播放歌单 分类名按目录播放对应歌单加入收藏 / 取消收藏管理收藏歌单分钟后关机定时停止播放刷新列表重新扫描本地音乐库上图是 XiaoMusic 的操控面板设备选择、播放列表、搜索、音量、循环模式一应俱全页面上的彩色标注就是给新手的操作引导。让曲库自己长大从零首歌到随便点你可能会担心网上搜来的歌质量靠谱吗格式放不了怎么办XiaoMusic 对这些问题都有预案。格式兼容性。本地扫描和下载主要覆盖 mp3、flac、wav、ape、ogg、m4a 这些主流格式。个别音箱型号比如小爱音箱 Play 和 Xiaomi Sound对无损格式不友好遇到播放失败去设置里打开转换为 MP3和型号兼容模式用 ffmpeg 现转一下就好不用你手动处理。网络歌单。除了本地曲库它还支持网络歌单——一个 JSON 格式的清单既能装电台又能装单曲也能直接用别人分享的链接。手头有 m3u 格式电台文件项目自带转换工具把 m3u 变成 JSON 丢进去你的音箱从此就是一台会说话的收音机。模糊匹配。语音识别总有口音和误差它内置了模糊匹配即使你念得不太准也能尽量找对歌不会因为一个字不对就报错。上图是音乐库管理界面所有歌曲、收藏、下载状态分门别类点一下就能筛选整理上千首歌也不费劲。再进一步把点歌台升级成音乐系统如果只用基础点歌那只是把 XiaoMusic 用了个零头。它真正值钱的地方在于可塑性。多设备统一管理。家里客厅一台、卧室一台、爸妈家一台一个后台就能全管。登录一次所有音箱都能联动设备分组、单独控制都行。你甚至可以在网页上直接操作任意一台设备不用跟它们隔空喊话。自定义口令。默认的播放歌曲不喜欢可以在user_key_word_dict里加自己的黑话比如设一句放点能打的来触发随机播放。更妙的是口令可以直接调用插件user_key_word_dict: { 播放今日推荐: play_music_list_index#今日推荐, 查一下天气: exec#httpget(\https://api.weather.com\) }像httpget、httppost、code1这些现成插件就躺在plugins/目录里相当于给小爱音箱装上了自定义技能——今天查天气明天接别的接口全看你想象力。界面随你换。官方默认界面主打简单实用社区还贡献了 Pure极简风、Tailwind响应式、支持暗色、XPlayer专业播放器范儿、SoundScape沉浸式等好几套主题网页端一键切换颜值和功能都不将就。周边生态。有人给它做了微信小程序、手机 App甚至安卓 TV 版本——你在沙发上用遥控器也能翻歌单。这套生态意味着它不只服务折腾党全家老小都能轻松上手。几句大实话兼容性、格式坑与安全底线任何工具都有边界XiaoMusic 也不例外提前知道能少走弯路。设备兼容性。目前常见的小爱音箱型号基本都测过了从 Redmi 小爱音箱 Play、小爱音箱 Pro、Xiaomi Sound 到小爱音箱 mini连触屏版都在支持列表里。少数特殊型号可能需要额外开一个特殊型号获取对话记录的开关遇到问题先去常见问题文档翻一翻大概率有现成答案。安全是底线。这里要说一句重话XiaoMusic 需要你的小米账号才能工作所以千万不要把绑定了摄像头的账号给它用也别在公共场所的 WiFi 下运行。如果非要暴露到公网务必开启访问密码并设一个足够复杂的口令。局域网内自娱自乐才是最舒服的姿势。遇到问题别慌。配置不对、播放失败、登录不上这类问题九成都能在 常见问题汇总 里找到解法想细看配置项的直接对照仓库里的 配置示例每个字段都有注释说明。真解决不了还能在网页底部一键下载日志文件带着日志去提问维护者一眼就能定位。写在最后回头想想智能音箱最让人失望的时刻就是那句暂不支持播放该内容。它明明离你最近却总在最需要的时候掉链子。XiaoMusic 的出现把这个官方遗憾变成了用户自由点歌、下载、分类、定时、收藏、自定义技能——一台本来只会放平台歌单的音箱从此变成真正属于你的私人点歌台而且越用越懂你越用越能打。它免费、开源、部署门槛低到一杯咖啡的时间。与其继续对着音箱生闷气不如今天就照着上面三步试一次。等那句好的正在为你播放响起时你会发现原来音乐自由的开关一直都在我们自己手里。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考