小爱音箱自定义固件开发指南
小爱音箱自定义固件（xiaoai-patch） 是一个专为小米小爱音箱设计的开源项目，通过补丁和自定义二进制文件，让你彻底摆脱原厂限制，自由安装开源软件，打造专属智能语音助手。支持 LX06、LX01、LX05、L09A 等多款音箱型号，轻松实现智能家居控制、音乐播放等个性化功能。
为什么选择小爱音箱自定义固件？
原厂音箱往往受限于封闭系统，无法安装第三方应用或优化功能。而 xiaoai-patch 项目通过以下特性为你的音箱注入新活力：
- 100% 开源组件：所有代码基于开源许可，从底层补丁到应用层工具完全透明可修改
- 丰富媒体服务：集成 MPD 音乐播放器、Snapcast 多房间同步、Shairport-Sync AirPlay 支持
- AI 语音增强：支持 Porcupine 唤醒词引擎和 Whisper 语音识别
- 智能家居联动：可对接 Home Assistant 等平台，实现灯光、家电语音控制
支持设备与准备工作
已验证兼容型号
- LX06：主流热销型号，支持完整功能
- LX01/LX05：入门款性价比之选
- L09A：带屏幕版本适配
提示：不同型号需使用对应补丁，具体型号识别可参考 research/lx06/info.md
必备工具
- 电脑（Windows/macOS/Linux 均可）
- USB 数据线（部分型号需拆机焊接）
- 固件打包工具：tools/docker_firmware_build.sh
- 镜像处理脚本：tools/mico_firmware.py
快速安装步骤（以 LX06 为例）
1. 获取项目源码
git clone <repository_url>
cd xiaoai-patch
2. 配置固件参数
修改配置文件 api/config.py 设置：
- 网络参数（WiFi 名称/密码）
- 默认音频输出设备
- 启用的服务模块（如蓝牙/AirPlay）
3. 编译自定义固件
# 使用 Docker 环境构建（推荐新手）
bash tools/docker_firmware_build.sh lx06
# 或手动编译
make -j4
4. 刷入固件
- 将音箱进入恢复模式（具体方法参考 research/lx06/install.md）
- 连接电脑并执行刷机脚本：
python3 tools/mico_upgrade.py output/lx06_firmware.bin
警告：刷机有风险，请确保电量充足并严格遵循 docs/voice-assistant.md 中的安全指引
核心功能体验
打造全能音乐中心
- 多协议支持：AirPlay/DLNA/蓝牙无缝切换
