音乐自动化生成产品系统

短视频音乐工作室「热曲灵感批量翻新」：定时监听酷狗榜单与关注歌手，用 AI 改写歌词、生成封面与歌曲，再做人声分离/响度处理，批量产出可发布的 BGM 与翻唱素材，抢热歌流量窗口。

1. 榜单监听与新歌发现
支持酷狗 TOP500、新歌榜、飙升榜拉取；可按歌手名单筛选；支持定时检测，发现新增歌曲后自动进入生成流程。

2. AI 歌词生成
基于歌名或副歌/高潮句作为灵感，对接 Gemini 或阿里云百炼批量生成歌词；可选千问提取高潮句，提升改写质量。

3. AI 封面与音乐生成
自动生成歌曲封面图；对接 Suno API 批量出曲，支持风格配置、立体声优先、空白音重试，结果按歌曲分目录输出。

4. 人声翻唱流水线
支持 Excel 歌单驱动：酷狗下载 → KGG 解密 → Demucs 人声分离 → 歌词获取 → Suno 上传翻唱；也可「仅下载分离」或「仅翻唱」分步执行。

5. 音频后期处理
支持响度增益、EQ 高切、轻微混响；输出 MP3/WAV，成品可直接用于短视频 BGM 或账号发布。

6. 可视化配置与打包分发
Fluent 风格界面统一管理配置与运行日志；支持 Windows/Mac 打包，适合个人创作者与小型音乐工作室日常量产

本项目基于 Python + PySide6（Fluent 界面） 实现桌面端 AI 音乐自动化流水线，采用「配置驱动 + 模块化流水线」架构，核心实现如下：

技术架构

界面层：qt_ui.py 提供侧边导航与卡片式配置，YAML（config.yaml）统一持久化参数
编排层：pipeline.py 串联「拉榜 → 差分 → 写词 → 封面 → Suno 出曲 → 后期」全流程
能力层：按业务拆分独立模块（酷狗、歌词、封面、Suno、下载分离、翻唱、音频处理），便于单步调试与复用
发布层：PyInstaller 打包 Windows/Mac；重型能力（Demucs 等）通过子进程隔离，降低主程序体积与依赖冲突
关键实现要点

榜单监听：拉取酷狗多榜单数据，与本地历史快照对比得到新增歌曲；支持按歌手筛选与分榜定时检测，命中后自动入队生成。
内容生成：歌词对接 Gemini / 阿里云百炼；封面对接千问文生图；音乐对接 Suno API（提交、轮询、下载、空白音重试）。
人声翻唱链：Excel 歌单驱动酷狗 API 下载 → KGG 解密 → Demucs 人声分离 → 歌词解析（客户端 KRC / HTTP 回退）→ Suno upload-cover 批量翻唱，支持断点状态与失败升调重试。
音频后期：librosa / soundfile / ffmpeg 完成响度、EQ、混响；输出按模板命名并按歌曲分目录落盘。
工程化：已生成/待处理状态本地持久化，避免重复出曲；授权校验、日志与可中断任务线程保证桌面端可用性。
技术栈
Python、PySide6、YAML 配置、HTTP API 对接、音频处理（Demucs / librosa / ffmpeg）、PyInstaller 打包。