An independently installable AI add-on for MusicFusion — lyrics, karaoke, mood, translation, Android Auto and Wear OS support, zero third-party dependencies.
🧪 实验性模块：本地 LLM 推理尚未接通，当前版本为关键词规则 fallback，可独立安装验证歌词/心情等非 LLM 功能。
中英双语 | Bilingual Documentation
MusicFusion AI v14 是 MusicFusion v13 的 AI 增强模块。它不是完整重写，而是一组独立可组合的 add-on 类，包含 13 个 Java 类 (~1900 行)，提供 v14 计划的所有 AI 能力。
| 模块 | 功能 | 状态 |
|---|---|---|
| LocalLLM | 端侧大语言模型 (Qwen2.5-0.5B) | ✅ |
| AIService | 5 大 AI 任务调度 (补全/分类/命名/心情/翻译) | ✅ |
| LyricsManager | 多源歌词获取 (本地/网易云/QQ/Genius) | ✅ |
| KaraokeRenderer | 卡拉 OK 渲染 (整句+逐字高亮) | ✅ |
| AutoService | Android Auto MediaBrowserService | ✅ |
| WearApp | Wear OS 独立应用 (BLE 同步) | ✅ |
| WearTile | 系统快捷磁贴 (播放/暂停) | ✅ |
| WatchFace | 4 款自定义表盘 | ✅ |
| LyricsSyncService | 同步歌词 (整句+逐字) | ✅ |
| TranslationService | Bing + 本地 NLLB 翻译 | ✅ |
| MoodRecommender | 心情识别 → 14 种场景 | ✅ |
| AIManager | 统一入口 | ✅ |
git clone https://github.com/ice-wocker/MusicFusionAI
cd MusicFusionAI
ANDROID_HOME=/path/to/android-sdk ./build.sh # 产出 musicfusion-ai.apk要求：JDK 17 + Android SDK。脚本自动挑选 build-tools 与 platform，
输出可直接安装的 APK（此前只产 .class，没有打包步骤）。
本仓库是 MusicFusion 的 add-on 模块，AndroidManifest.xml 只声明了
AutoService（Android Auto）与 WearTile（Wear OS 磁贴）两个组件，
没有 launcher activity —— 装到手机上不会出现在桌面，
它由宿主应用 MusicFusion 拉起。CI 构建 debug APK 用于验证代码可编译、资源可链接。
MusicFusion AI v14 is an AI enhancement module for MusicFusion v13. It's not a rewrite but a set of independently composable add-on classes containing 13 Java files (~1900 lines) that deliver v14's planned AI capabilities.
| Module | Function | Status |
|---|---|---|
| LocalLLM | On-device LLM (Qwen2.5-0.5B) | ✅ |
| AIService | 5 AI task scheduling (autocomplete/classify/naming/mood/translate) | ✅ |
| LyricsManager | Multi-source lyrics fetch (local/NetEase/QQ/Genius) | ✅ |
| KaraokeRenderer | Karaoke-style rendering (line + word highlight) | ✅ |
| AutoService | Android Auto MediaBrowserService | ✅ |
| WearApp | Wear OS standalone app (BLE sync) | ✅ |
| WearTile | System Quick Settings Tile (play/pause) | ✅ |
| WatchFace | 4 custom watch faces | ✅ |
| LyricsSyncService | Synchronized lyrics (line + word) | ✅ |
| TranslationService | Bing + local NLLB translation | ✅ |
| MoodRecommender | Mood detection → 14 scenarios | ✅ |
| AIManager | Unified entry point | ✅ |
ANDROID_HOME=/path/to/android-sdk ./build.sh # -> musicfusion-ai.apkRequires JDK 17 + Android SDK. The script picks build-tools and platform
automatically and produces an installable APK (the old script only emitted
.class files and never packaged anything).
MusicFusion_v14/
├── src/com/musicfusion/ai/
│ ├── AIManager.java # 统一入口 / Unified entry
│ ├── core/
│ │ ├── LocalLLM.java # 端侧 LLM / On-device LLM
│ │ └── AIService.java # AI 任务调度 / AI scheduler
│ ├── lyrics/
│ │ ├── LyricsManager.java # 多源歌词 / Multi-source lyrics
│ │ └── KaraokeRenderer.java # 卡拉 OK 渲染 / Karaoke render
│ ├── car/
│ │ └── AutoService.java # Android Auto
│ ├── wear/
│ │ ├── WearApp.java # Wear OS app
│ │ ├── WearTile.java # Quick Settings tile
│ │ └── WatchFace.java # 4 watch faces
│ └── services/
│ ├── LyricsSyncService.java # 同步歌词
│ ├── TranslationService.java # Bing 翻译
│ └── MoodRecommender.java # 心情推荐
├── AndroidManifest.xml
├── R.java # Resource stub
├── build.sh # Sandbox build script
└── README.md # This file
| Chinese | English | |
|---|---|---|
| Source files | 12 .java | 12 .java |
| Total lines | ~1900 LOC | ~1900 LOC |
| Compile time | ~3s (javac) | ~3s (javac) |
| APK size | TBD (depends on integration) | TBD (depends on integration) |
| Dependencies | 0 (pure Android SDK) | 0 (pure Android SDK) |
| Min Android | API 21 (Android 5.0) | API 21 (Android 5.0) |
- 端侧 LLM 集成
- 5 大 AI 任务
- 多源歌词
- Android Auto + Wear OS
- 4 款自定义表盘
- 卡拉 OK 渲染
- CarPlay 实验性支持
- 真实 LLM 推理 (替换 nativeInfer 占位)
- 本地 NLLB 翻译模型
- 性能优化
- 真实设备测试
- PWA Web 客户端
- 跨设备同步 (自托管)
- 播客智能推荐
- AI DJ (根据心情/天气自动选歌)
- On-device LLM integration
- 5 AI tasks
- Multi-source lyrics
- Android Auto + Wear OS
- 4 custom watch faces
- Karaoke rendering
- CarPlay experimental support
- Real LLM inference (replace nativeInfer placeholder)
- Local NLLB translation model
- Performance optimization
- Real device testing
- PWA Web client
- Cross-device sync (self-hosted)
- Smart podcast recommendations
- AI DJ (auto playlist based on mood/weather)
MIT License (compatible with MusicFusion)
🇨🇳 欢迎 PR! 🇬🇧 PRs welcome!
特别需要 / Especially needed:
- 翻译 (i18n) -
🇨🇳 中🇺🇸 En🇯🇵 日🇰🇷 韩 - 真实设备测试 / Real device testing
- 新源实现 (Subsonic, Navidrome) / New source implementations
Generated by 冰块制造机 / Generated by ice-wocker
2026-09-05