薄荷音乐

你贴的是  h​t​t​p​s​:​/​/​g​i​t​h​u​b​.​c​o​m​/​k​i​n​g​m​u​c​h​e​n​/​M​i​n​t​-​M​u​s​i​c——一个叫「薄荷音乐 / MintMusic」的开源 Flutter 安卓音乐播放器 项目。

一、项目定位

- 技术栈：Flutter / Dart - 平台：主要面向 Android（iOS / 桌面 / Web 未在主 README 中确认） - 设计参考：CeruMusic 的插件化 / 清爽交互思路 - 版权声明：仅供学习交流，在线内容版权归原平台，支持正版

二、核心功能

- 在线曲库聚合搜索：网易云、 《QQ》、 《酷狗》、酷我、 《咪咕》等 - 本地音乐：通过 MediaStore 扫描与管理 - 歌词：LRC / LRCX / YRC 解析， 《Apple Music》 风格逐字歌词 AMLL - 播放能力：后台播放、通知控制、进度记忆、启动时续播 - 音效：均衡器、低音增强、环绕、声道平衡 - 音源扩展：支持 LX Music 风格 JS 音源插件，不硬编码平台源 - 下载：在线歌曲缓存到本地

三、技术架构（简版）

- 播放： "just_audio" + "audio_service" + "audio_session" - 状态/路由/网络： "Riverpod" + "go_router" + "dio" - 本地媒体： "on_audio_query" - 插件执行： "flutter_js" - 歌词： "amll_bridge" - 模型： "freezed" / "json_serializable" - 权限： "permission_handler"

四、测试和限制

- 纯 "flutter_test" 跑不了完整 UI 冒烟（依赖真实音频/音源通道） - 仓库测试主要是：主题层冒烟 + 歌词解析等纯逻辑单测 - 内置公开接口可能失效，需要自己补 JS 音源 - 不适合直接当“生产级商用音乐服务”用

五、适合谁

- 想学 Flutter 音乐播放器架构 的开发者 - 想要 Android 本地+在线聚合+逐字歌词的折腾党 - 想研究 LX Music JS 音源插件 怎么接进 Flutter 的人 你发的  h​t​t​p​s​:​/​/​k​i​n​g​m​c​.​m​i​n​t​m​u​s​i​c​.​c​c​w​u​.​c​c​/ 就是 MintMusic（薄荷音乐）的项目主页/文档站，内容和 GitHub 仓库 "kingmuchen/Mint-Music" 是对应的。

一、这个站是什么

- 项目官网/文档站：首页、使用文档、插件开发 - 介绍 MintMusic：Flutter Android 音乐播放器，仿 CeruMusic，兼容 《洛雪》（LX Music）JS 插件体系 - 只提供“播放器框架 + 插件运行环境”，不内置/不提供音乐版权内容 - 入口里也链回 GitHub：github.com/kingmuchen/Mint-Music (https://github.com/kingmuchen/Mint-Music)

二、要注意的点

- 域名 "ccwu.cc" 不是大厂域名，也不是 GitHub 官方页；它大概率是作者自己搭的文档站，不是“公司官网” - 第三方下载站（西西、87G、9k9k、k73）说的“内置洛雪音源、免费听全网、无损下载”和项目自己的声明不一致：项目声明是需用户自行加载合规插件，并不承诺内置可用音源 - 这类音乐聚合播放器常见风险：在线音源失效、插件涉版权、第三方打包 APK 夹带广告/权限

三、安全用法

1. APK 只从 GitHub Releases / 自己 "flutter build apk" 出 2. 别信“破解会员/全网免费/内置六大音源”的下载站包 3. 插件只加载合规、公开搜索接口的 JS 音源 4. 不用于商业分发，不传播违规插件 https://kingmc.mintmusic.ccwu.cc/