XiaoMusic 使用指南：解锁小爱音箱免费音乐播放功能

什么是 XiaoMusic？

XiaoMusic 是一款专为小爱音箱打造的开源音乐解决方案。它通过集成 yt-dlp 强大的下载能力，让用户能够摆脱付费订阅的限制，直接获取并播放丰富的音乐资源，实现真正灵活且免费的听歌体验。

核心功能特性

全方位的音频兼容性

系统支持 mp3、flac、wav、ape、ogg、m4a 等主流格式。本地音乐会检索指定目录下的相关文件，而下载歌曲则默认采用 mp3 格式。

• 兼容性处理： 针对 L05B、L05C、LX06、L16A 等不支持 flac 格式的型号，可通过开启「型号兼容模式」或「转换为 MP3」选项解决。

便捷的语音交互控制

用户无需手动操作，直接通过小爱同学即可完成绝大多数指令：

• 精准播放： 支持播放本地歌曲、指定曲目（如“播放歌曲周杰伦晴天”）或通过关键词搜索播放（如“搜索播放林俊杰”）。
• 播放控制： 涵盖上一首、下一首、暂停、停止等基础操作。
• 模式管理： 支持单曲循环、全部循环及随机播放。
• 歌单维护： 可实现播放列表管理、收藏 / 取消收藏、播放收藏内容以及刷新歌单。

高度可定制的扩展能力

• 自定义口令： 用户可根据个人习惯定义专属的语音指令。
• 插件机制： 开发者可通过编写自定义插件，扩展更复杂的控制逻辑。
• 网络歌单： 支持 JSON 格式的网络歌单（含电台与歌曲），并提供 m3u 转换为 JSON 的工具，简化导入流程。

部署与安全建议

快速安装

XiaoMusic 推荐使用 Docker 部署，用户可在 NAS 或本地服务器上通过简单的命令快速搭建。部署完成后，所有管理工作均可在 Web 界面中完成。

安全注意事项

• 访问权限： 若开启公网访问，务必设置高强度的登录密码，防止小米账号信息泄露。
• 网络环境： 建议在可信网络环境下使用，避免在公共 Wi-Fi 中操作，以保障设备安全。

项目资源

官方文档： https://xdocs.hanxi.cc/

GitHub 仓库： https://github.com/hanxi/xiaomusic