XiaoMusic：用小爱音箱免费听歌，本地播放 + yt-dlp 自动下载

XiaoMusic 是一款专为小爱音箱打造的本地音乐播放解决方案，通过集成 yt-dlp 实现“无限听歌”——既能播放本地曲库，也能按需自动下载指定歌曲，彻底绕过平台版权限制。

• 地址：https://xdocs.hanxi.cc
• GitHub：https://github.com/hanxi/xiaomusic

核心理念：把音乐控制权交还用户

XiaoMusic 将小爱音箱转变为完全由你掌控的本地音乐中心。所有音频文件存储在本地设备（如树莓派、NAS 或 PC），无需依赖第三方音乐平台账号或会员，真正实现“想听就听”。

语音控制全覆盖

通过自然语音指令，即可完成几乎所有播放操作：

• 基础播放
  • “播放歌曲”：随机播放本地曲库
  • “播放歌曲周杰伦晴天”：点播指定歌曲（本地无则自动下载）
• 播放控制
  • “上一首” / “下一首”
  • “单曲循环” / “全部循环” / “随机播放”
  • “停止播放” 或 “关机”：暂停并退出播放
• 歌单管理
  • “播放列表其他”：播放名为“其他”的自定义歌单
  • “播放列表收藏”：播放收藏歌单
  • “加入收藏” / “取消收藏”：动态管理收藏
• 智能搜索
  • “搜索播放林俊杰”：自动下载并播放所有匹配歌曲（联网）
  • “本地搜索播放林俊杰”：仅在本地库中查找，不触发下载
• 维护指令
  • “刷新列表”：当手动向 music 目录添加新歌后，用此指令更新歌单

注：“播放列表第几个+列表名”等高级用法详见项目 Issue #158。

技术特点

• 基于 yt-dlp 实现高质量音频下载，支持主流平台资源；
• 所有音乐文件本地存储，隐私安全，离线可用；
• 轻量级设计，可部署在低功耗设备上，与 Home Assistant 等智能家居系统兼容性良好；
• 开源免费，社区持续维护。

适用人群

• 厌倦音乐平台会员套路的用户；
• 拥有小爱音箱但希望摆脱联网依赖的极客；
• 想构建私有家庭音乐库的技术爱好者。