YuE2 Studio 是一款跑在本地 GPU 上的 AI 音乐生成工作室，能生成带人声的完整歌曲。它的"和弦床"（Chord Bed）功能让你先写好和弦，再让模型填旋律与编曲：只需指定速度、调性和拍号，和弦就会瞬间铺满全曲，模型直接在这张和声"床"上表演，从而跳过耗时的规划（planning）步骤，出歌更快、调性更可控。

什么是和弦床？为什么值得"先写和弦" 🎹

正常情况下，YuE2 模型会自己"规划"一份乐谱（旋律 + 和弦），再唱出来。这意味着调性和走向交给模型决定——惊喜有，控制少。

和弦床把顺序倒过来：

换句话说：你拿到的是一个和声骨架确定的"半成品乐谱"——人声声部里是一串放在休止符上的和弦，乐器声部留空，等模型把旋律和伴奏填进去。

4 步上手：从零写出一张和弦床

第 1 步：进入创建页。打开 YuE2 Studio 的 Create（创建）面板，在风格（style）和歌词（lyrics）下方，找到Chord bed按钮（与 Compose the score、Score editor 并排），点开后弹出三个输入项。

第 2 步：填写三项参数。

• Tempo, BPM：40–240 之间的速度值；
• Key：24 个常用调，12 大调（C、G、D…）+ 12 小调（Am、Em、Bm…）；
• Meter：拍号，支持4/4、3/4、6/8、2/4。

第 3 步：给歌词分好段落。歌词里每行写一个段落标签，如[Intro]、[Verse 1]、[Chorus]、[Bridge]、[Outro]，段落之间空一行。和弦床会每个标签一段：主歌、副歌、桥段各有一套自己的和弦进行，段落长短由歌词行数自动决定。

第 4 步：点击 Write the bed（写出铺底）。几秒内，乐谱区就填好了 ABC 记谱，下方还会回显三套和弦进行，例如：

Verse: F G Em Am · chorus: C G F · bridge: C F

不满意？再点Write another bed（再写一个），换一组随机进行。这个功能的前端逻辑在 app/components/CreatePanel.tsx，请求经由 app/services/scoreApi.ts 发给本地服务端的/v1/score/chord-bed接口。

揭秘：和弦床背后的生成逻辑 🔍

和弦床不是模型推理，而是一个确定性的小生成器（crates/music-server/src/score/chord_bed.rs），所以又快又稳定：

• 和弦池：内置 15 组大调、16 组小调进行，取材自流行、摇滚、舞曲、爵士与影视音乐中常见的走向。seed 从中不重复地抽 3 组，分别给主歌、副歌和桥段——保证副歌听感与主歌不同。
• 绝不"原地踏步"：相邻两小节的和弦永远不同；如果进行里下一项与上一小节撞车，就自动跳过一格。正是这种持续变化的和弦，把全曲牢牢"扣"在你指定的速度上。
• 段落 → 小节数规则：

• 输出格式：标准 ABC 记谱，L:1/16精度、Q:1/4=速度、双声部（Vocal 放和弦+休止符，Ins 留空），可直接被 crates/music-server/src/score/api.rs 的记谱校验器解析，也可粘贴给 yue2.cpp 的 WebUI。

从和弦床到成品歌曲 🎧

和弦床写入乐谱区后，直接点Create即可。模型会保持你给的调性、速度、拍号，把旋律与整套编曲写在和声之上，规划步骤被跳过，渲染更快。

歌成之后，和弦床乐谱会随歌曲一起存档：

• 想换一种演奏但保留作曲？重新渲染（re-render）即可，和声不动、声音变样；
• 想微调个别和弦或音符？打开Score editor（内嵌的 Signal MIDI 编辑器），改完用 Apply 回写到创建面板的乐谱；
• 连 AI 代理也能走同一套流程：MCP 工具score_chord_bed一条命令生成同样的和弦床，再把返回的abc传给song_create，详见 docs/mcp-skill.md。

实用技巧与常见问题 💡

• 想要完全可复现：同一 seed + 同一组参数 = 完全相同的和弦床。界面按钮每次"再写一个"用随机 seed；通过 API 调用时显式传seed即可锁定结果。
• 报错怎么办：速度必须在 40–240 BPM；调性写成 A–G + 可选#/b+ 可选m（如Em、Bb）；拍号仅限4/4、3/4、6/8、2/4，写错会收到明确的英文错误提示。
• 和弦床 ≠ 伴奏音频：它只是一张"休止符上的和弦"乐谱，乐器演奏由模型在渲染时补全，所以最终配器仍取决于你写的风格描述。
• 别混淆两个开关：Advanced 里的Chords and sections（和弦多样性、段落开头变化等）作用于模型自己写的乐谱；指定了和弦床abc后，这些参数会被忽略。
• 想只写谱不唱歌？旁边的 Compose the score 按钮是"只做规划"模式，和和弦床互补：一个让模型规划，一个由你拍板。

小结

和弦床是 YuE2 Studio 里"人定骨架、AI 填肉"的捷径：30 秒铺好和声，跳过规划阶段，调性、速度、拍号尽在掌握，还能靠 seed 精确复现。下次写歌，不妨先想想和弦走向，再让模型去唱——这就是"先写和弦、再填旋律"的完整工作流。

更多功能说明可参考 README.md 中的 "Chord bed" 条目，以及 CHANGELOG.md 中 3.5.0 版本的功能介绍。