timoncool/YuE2-Studio · 上手攻略
- 仓库：timoncool/YuE2-Studio
- 链接：https://github.com/timoncool/YuE2-Studio
- 分类：AI 音乐生成 · 本地大模型
- 作者：Tom
- 更新：2026-09-25
这是什么
YuE2-Studio 是 YuE2（M-A-P 团队开源歌曲模型）的桌面工作室。YuE2 是一个约 30 亿参数的音乐生成模型，输入歌词和风格描述，先写一份可编辑的乐谱（ABC 记谱法），再基于乐谱演唱为完整歌曲——含人声、伴奏、节拍结构（引子/主歌/副歌/桥段/尾奏）。
传统 AI 音乐工具生成后无法修改，YuE2-Studio 的核心差异化在于乐谱先行、演出可换：你可以先看谱、修改音符/调/速度，再生成；或者保留演唱、换一种音色重新演绎。底层基于 yue2.cpp（原生 C++/CUDA 移植，非 Python），外层用 Tauri（Rust + React）封装为一个 .exe 安装包，无需 Python 环境。
解决什么问题
想让 AI 唱歌但不接受"黑盒输出"的用户，面临两个痛点：
- 无法编辑——生成什么样就什么样，改一个字要重新生成整首歌。
- 依赖云端——Suno、Udio 等商业产品需要联网，数据不能私有。
YuE2-Studio 在本地 GPU 上完整解决这两个问题：乐谱是中间产物，音符可自由编辑；全流程离线程运行，歌曲数据不离开你的机器。
快速安装
硬件要求
| 项目 | 最低 | 推荐 |
|---|---|---|
| 显存 | 6 GB（NVIDIA） | 8 GB 以上 |
| 显卡 | NVIDIA（CUDA） | RTX 3060 及以上 |
| AMD/Intel | 实验性（Vulkan） | — |
安装步骤
- 打开 https://github.com/timoncool/YuE2-Studio/releases/latest
- 下载最新的 Windows installer（
.exe），运行安装 - 或下载 portable 版本，解压后直接运行
安装后启动应用，模型会在首次生成时自动下载（连接 Hugging Face）。全程无需 Python、Node.js 或任何命令行操作。
⚠️ 首次生成约需下载数 GB 模型文件，确保网络畅通。
核心用法
1. 从歌词和风格生成完整歌曲
在创作表单中填写：
- Style（风格）：用自然语言描述想要的音乐风格，如 "90s Cantonese pop ballad, piano driven, female vocal"
- Lyrics（歌词）：粘贴带结构标记的歌词，标记格式为 [verse]、[chorus]、[bridge] 等
点击 Create，约 40-60 秒（RTX 4090 Q8_0 量化，3:38 歌曲约 46 秒）后得到完整歌曲及对应乐谱。
2. 编辑乐谱后重新生成
生成的乐谱以 ABC notation 显示，并被排版为五线谱。编辑任意音符、调号或节拍，然后重新生成——乐谱不变，演唱风格变化，保留你喜欢的旋律。
3. AI 翻唱（Cover）
- 在菜单上传一首参考歌曲
- SheetSage2（内置）会自动听写旋律并转写为乐谱
- YuE2 用这张乐谱在你的指定风格下重新演唱
⚠️ 注意：歌词需要与原旋律的音节数匹配，否则演唱会漂移到错误位置。建议先用原始歌词做翻唱，熟悉后再替换。
4. 精确重放（Exact Replay）
每次生成都会保存原始 request 和 audio codes。可以在历史记录中： - Bit-for-bit 重放：原样重新渲染 - 换音色重放：保留乐谱，换 Sound Seed 或歌手音色 - 换格式输出：MP3 或 16/24/32-bit WAV
5. 训练自己的 LoRA
在 LoRA 页面可以训练自己的作曲风格 LoRA 或演唱风格 LoRA。三步完成： 1. 拖入一个文件夹（含多首同风格/同歌手歌曲） 2. 检查准备情况（歌词自动从 LRCLIB/QQ Music/Kugou 匹配） 3. 开始训练
训练好的 LoRA 保存在本地 LoRA 库中，下次创作时直接在表单里引用。
6. MCP 工具（AI Agent 控制）
YuE2-Studio 自带 MCP 服务器，AI Agent 可以直接控制它：
# Claude Code 添加 MCP 工具
claude mcp add --transport http yue2-studio http://127.0.0.1:8791/mcp
# 读取 MCP skill 文件
# 资源：studio://skill
# 工具：studio_status（查看状态）、studio_create（创建歌曲）等
每次 Studio 启动后 MCP 服务默认在 http://127.0.0.1:8791/mcp 可用。
7. 音频处理管线
生成后可进入处理管线： - 6 轨干声分离：鼓、贝斯、吉他、钢琴、人声、其他 - 去噪 / 混响 / 人声自然化 - VST3 插件链 - 母带化（Mastering）：参考音轨对比
典型适用场景
- 独立音乐人快速原型：用自然语言探索编曲方向，不用买设备或请乐手
- AI 音乐二次创作：先生成旋律，再换风格/音色做多个版本
- 翻唱本地化：保留原曲旋律，换语言、换风格重新演绎
- LoRA 个性化训练：用自己喜欢的歌手/风格数据训练专属 LoRA
- 私密创作：所有数据留在本地，适合有版权顾虑的专业用户
坑与注意
| 坑点 | 说明 | 应对 |
|---|---|---|
| 首次生成下载模型卡住 | 网络问题或 Hugging Face 连接不稳定 | 检查代理设置，重复尝试；模型约数 GB |
| 翻唱歌词不对齐 | 音节数与原旋律不匹配 | 严格按原歌词音节数调整；参考 [verse] 段落结构 |
| AMD/Intel GPU 支持不完整 | Vulkan 后端为实验性，功能和性能可能受限 | 建议使用 NVIDIA 显卡 |
| 显存不足 | 低于 6GB 可能 OOM | 降低量化精度（Q4_0）；或减少生成长度 |
| SheetSage2 转写错误 | 转录错误会传递到翻唱结果 | 生成后检查乐谱，必要时手动校正 ABC notation |
| LoRA 训练耗时 | 单次训练需数小时 | 用较干净的数据集（高质量、去人声），避免过多风格混杂 |
与同类对比
| 特性 | YuE2-Studio | Suno / Udio（商业） | MusicGen（Meta） |
|---|---|---|---|
| 本地运行 | ✅ 完整离线 | ❌ 纯云端 | ✅ 可本地 |
| 可编辑乐谱 | ✅ ABC notation + 五线谱 | ❌ 不可编辑 | ❌ 无乐谱 |
| 翻唱能力 | ✅ SheetSage2 转写旋律 | ❌ | ❌ |
| LoRA 训练 | ✅ 内置训练管线 | ❌ | ⚠️ 需手动配置 |
| 翻唱质量 | 约 6 分钟最长 | 约 4 分钟 | 约 30 秒 |
| 商业授权 | 需看 YuE2 原始许可 | 需付费订阅 | CC-BY 4.0 |
YuE2 的最大差异化是乐谱作为中间层——这是目前所有主流云端 AI 音乐工具都没有的设计，也使其成为真正可以做"编辑-重生成"闭环的唯一开源选项。
一句话推荐结论
YuE2-Studio 是目前唯一集「本地运行 + 可编辑乐谱 + AI 翻唱 + LoRA 训练」于一身的开源 AI 音乐工作站，适合对创作有掌控欲、不想被云端绑定的音乐人。
⚠️ 本攻略基于 2026-09-25 GitHub README 及公开文档。版本号、具体参数默认值请以最新版 release 说明为准。