music-dl产品系统

音乐爱好者经常遇到“这首歌在网易云有，但QQ音乐没有”、“想下载某首歌曲却需要多个App会员”的痛点。同时，部分歌曲因版权下架或地域限制无法收听。本项目旨在解决跨平台音乐资源分散、下载入口割裂的问题，通过聚合 QQ、网易云、酷狗、GitHub 等多个音源，提供统一的搜索与下载入口。行业背景上，数字音乐版权分散在不同平台，用户需要工具类产品来降低获取成本。项目作为开源工具，也探索了 AI 辅助音源发现的技术路径，为后续智能音乐聚合提供实践基础。

项目主要包含四大功能模块：1) 多平台音源搜索与解析：支持 QQ音乐、网易云音乐、酷狗音乐、GitHub 等多个渠道，用户输入歌曲名或链接即可自动匹配最佳音源；2) 三层下载回退机制：优先使用官方音源，失败后切换备选音源，最后调用 AI（DeepSeek/OpenAI/Claude）进行网页搜索兜底；3) 三端交互界面：提供 Web GUI（FastAPI + 原生JS）、Android App（Java + Material You设计）和命令行 CLI 三种使用方式；4) AI 音源发现功能：通过 LLM 自动分析未知网页，动态注册新音源，使工具具备自扩展能力。此外还包含 Chrome CDP 协议 Cookie 提取、多引擎并行搜索、单元测试覆盖率 80%+、GitHub Actions CI/CD 自动打包等工程化特性。

后端使用 Python + FastAPI 构建 RESTful API，集成 Requests 实现多音源网页抓取与解析；通过 Chrome CDP 协议自动化登录并提取含 HttpOnly 标记的 Cookie，解决反爬难题。AI 模块接入 DeepSeek/OpenAI/Claude API，设计 Prompt 引导 LLM 分析网页结构并提取音源链接，实现动态注册新音源。前端采用原生 HTML/CSS/JS 构建 Web 界面，Android 端使用 Java + Material You 设计，通过 Chaquopy 在 App 内调用 Python 代码实现混合开发。项目包含三层下载回退机制、多引擎并行搜索、日志轮转与 80%+ 单元测试覆盖率，利用 GitHub Actions 实现跨平台自动打包（macOS、Windows、Android APK）。