珊瑚音乐

珊瑚音乐移动端（Coral Music Mobile）仓库概览

基于 Flutter 的跨平台音乐客户端，一套业务代码同时覆盖 iOS / Android / 鸿蒙（HarmonyOS） 三端。与上一版文档相比，项目已从「v1.0.0 开发阶段」迭代到 v1.0.6，功能大幅扩展。

📊 仓库数据

指标 数值 🏷️ 最新版本 v1.0.6（2026-08-06） 📌 首版 v1.0.0（2026-07-20） 🔧 环境 Flutter 3.27.5-ohos / Dart 3.6.2 🎨 主题 珊瑚红种子色，跟随系统明暗模式

⚠️ 注：该仓库较新，GitHub 页面 star/fork 数据暂未公开显示，建议直接访问仓库查看实时数据。 🚀 版本迭代历程

- v1.0.6（08-06）：落雪列表同步（兼容 v4 协议，RSA 交换连接码 + AES-CBC 快照传输）、歌单链接/JSON 导入、Android 媒体通知自定义图标、历史页合并本地曲目 - v1.0.5（07-29）：应用更新检查（启动时异步查 GitHub Release）、WebDAV 协议适配（端点归一化、Basic 鉴权、账号密码输入） - v1.0.4（07-27）：原生后台完整列表播放 —— 引入 "NativePlaybackBridge"，Flutter 只下发队列/索引/模式/音质，原生侧完成取链和连续播放；iOS "AVQueuePlayer"、Android QuickJS-NG 0.15.1 + 锁屏播放卡片 - v1.0.3（07-23）：修复酷狗/酷我/咪咕封面与播放链路，接入酷狗与网易云榜单， "TrackArtworkResolver" 封面兜底 - v1.0.2（07-22）：iOS WKWebView 进程终止恢复、本地脚本文件持久化（导入脚本存到 "applicationSupportDirectory"） - v1.0.1（07-22）：自定义下载目录、返回键移至后台（不再直接退出）

🎵 九个产品入口（核心功能闭环）

# 入口 说明 1 五源在线检索 酷我 / QQ / 网易云 / 咪咕 / 酷狗 2 完整播放器 音频引擎、取链、歌词、队列、后台播放、进度恢复 3 SQLite 持久化 列表 / 收藏 / 历史 / 歌单收藏 / 专辑收藏 4 下载队列 自定义目录、WiFi 限制 5 WebDAV 远程媒体 协议适配 + 账号密码鉴权 6 本地音频导入 MediaStore 扫描 7 备份恢复 落雪同步（RSA + AES-CBC） 8 音源管理 JS 插件 + 持久化恢复 9 进度恢复 跨会话续播

🛠 技术栈

Flutter / Dart（Material 3） + Riverpod 状态管理 + Go Router 路由 + Dio 网络 + QuickJS-NG 0.15.1（Android 无头脚本运行时）+ just_audio / AVQueuePlayer 原生音频引擎 + SQLite 本地存储

🏗 架构分层

每个功能模块按 "features/xxx/" 划分，内部严格三层分离：

data/ → 数据层（Dio / SQLite / MethodChannel） state/ → 状态管理（Riverpod） view/ → UI 层（Material 3）

约束：UI 不直接访问 Dio、SQLite 或 MethodChannel，保证可测试性与跨平台一致性。 📌 平台支持状态

平台 状态 ✅ Android 真机验证（SM-N986U / Android 13）核心播放闭环通过 🔶 iOS 编译通过，待真机验收 🔧 鸿蒙 待调试签名

💡 与同类项目对比亮点

相比之前提到的 MintMusic（Flutter 安卓单端），珊瑚音乐的优势在于：

1. 三端统一：一套代码覆盖 iOS / Android / 鸿蒙，鸿蒙适配基于 Flutter 3.27.5-ohos 分支 2. 原生音频引擎下沉：v1.0.4 起将取链与连续播放移到原生侧（iOS "AVQueuePlayer" / Android QuickJS），Flutter 只做调度，后台播放更丝滑 3. 同步能力：v1.0.6 的落雪同步（RSA + AES-CBC 双加密）支持跨设备歌单同步，是较独特的差异化功能 4. 架构规范性：严格的 data/state/view 分层约束，更适合中大型团队协作

📖 完整开发文档位于仓库 "skills/coral-music-mobile/" 目录，桌面端另有独立仓库。 整体来看，这是一个架构规范、迭代极快（不到一个月 6 个版本）、差异化明显的跨平台音乐项目，尤其在鸿蒙适配和原生音频下沉方面走在前列，值得关注其后续鸿蒙签名调试进展。