在数字音乐版权日益严格、平台间壁垒森严的今天，想要在一个地方便捷地搜索、试听并下载高品质音乐变得愈发困难。COCO Downloader (COCO音乐下载站) 是一个基于 Next.js 16 构建的现代化、开源音乐搜索与下载平台，旨在为用户提供无广告、极速且纯净的音乐获取体验。
核心亮点：聚合、高效、美观
COCO Downloader 不仅仅是一个简单的爬虫工具，它在交互设计和功能完整性上都达到了应用级水准：
1. 🎵 多源聚合搜索
内置多种音乐源渠道，包括：
- 主流平台：QQ音乐、咪咕音乐、网易云音乐（通过煎饼系列聚合）、酷狗、酷我。
- 第三方引擎：歌曲宝、歌曲海、布谷、力音等。
用户只需一次搜索，即可在全网范围内查找资源，并支持一键切换音源，解决“某首歌在这个平台没有”的痛点。
2. ⬇️ 批量下载与无损音质
- 批量打包：支持多选歌曲，一键将选中的音乐打包下载，极大提升了建立本地音乐库的效率。
- 自动最高音质：程序会自动解析目标源提供的默认最高可用音质。部分音源（如咪咕、QQMP3）在资源允许的情况下，会自动解析出 FLAC 无损格式，满足 Hi-Fi 用户需求。
- 注：不支持手动选择音质，系统优先保证最佳可用性。
3. 🎧 精致的在线试听体验
内置精美的悬浮播放器，功能完备：
- 支持播放/暂停、进度拖拽、音量调节。
- 支持上下曲切换及多种播放模式（顺序/随机/单曲循环）。
- 列表双击即可播放，鼠标悬停与选中效果经过细致优化，操作流畅丝滑。
4. 🌓 极致的视觉主题体验
- 深色/浅色模式完美适配：基于
next-themes实现无缝切换。 - 独家涟漪动画：利用浏览器原生的 View Transitions API 配合 CSS
clip-path，实现了以点击坐标为圆心的圆形扩散遮罩动画。相比传统的淡入淡出，这种过渡更具动感和现代感，视觉效果惊艳。
技术架构：现代化全栈实践
COCO Downloader 采用了当前最前沿的前端技术栈，展现了极高的工程化水平：
- 核心框架：Next.js 16.1.2 (App Router)，利用服务端渲染（SSR）和静态生成提升首屏加载速度。
- 编程语言：TypeScript，确保代码的类型安全与维护性。
- 样式方案：Tailwind CSS v4，原子化 CSS 带来高效的样式开发与极小的包体积。
- 动画与交互：Framer Motion 处理复杂交互动画，Lucide React 提供统一风格的图标。
- 后端逻辑：Next.js API Routes + Axios + Cheerio，采用策略模式设计后端解析器。在
src/lib/providers下定义统一接口，新增音乐源只需实现接口并注册，无需修改前端逻辑，扩展性极强。
快速开始：本地部署指南
对于希望私有化部署或参与开发的用戶，项目提供了简便的运行方式。
环境要求： Node.js >= 18.17.0
# 1. 克隆项目
git clone https://github.com/markcxx/coco-downloader.git
cd coco-downloader
# 2. 安装依赖
pnpm install # 推荐使用 pnpm，也可用 npm/yarn
# 3. 运行开发服务器
npm run dev
# 访问 http://localhost:3000
Docker 一键部署
为了方便服务器部署，项目提供了官方 Docker 镜像，支持自定义端口。
# 拉取最新镜像
docker pull markcxx/coco-downloader:latest
# 默认运行在 3000 端口
docker run -d -p 3000:3000 --name coco-downloader markcxx/coco-downloader:latest
# 自定义端口 (例如映射到宿主机的 8080)
docker run -d -p 8080:3000 -e PORT=3000 --name coco-downloader markcxx/coco-downloader:latest
COCO Downloader 是开源社区中一款兼具美感与实用性的音乐工具。它不仅解决了跨平台搜索和下载的痛点，更通过 Next.js 16 和 View Transitions API 等技术展示了现代 Web 应用的可能性。
注意事项：
- 本项目仅用于个人学习和研究，请勿用于商业用途。
- 由于依赖第三方音源接口，部分链接可能存在时效性，若遇到无法播放的情况，建议切换其他音源重试。
- 请尊重音乐版权，支持正版音乐平台。
对于开发者而言，COCO Downloader 的代码结构清晰，策略模式的后端设计值得借鉴；对于普通用户，它则是一个回归纯粹、享受音乐的绝佳避风港。
