NotaGen使用手册：轻松生成ABC与MusicXML格式乐谱
1. 快速开始指南
1.1 启动WebUI服务
NotaGen提供了一个基于Gradio的图形化界面，便于用户快速上手。启动服务非常简单，只需在终端中执行以下命令：
cd /root/NotaGen/gradio && python demo.py或者使用系统预置的快捷脚本：
/bin/bash /root/run.sh成功启动后，终端将显示如下提示信息：
================================================== 🎵 NotaGen WebUI ================================================== 访问地址: http://0.0.0.0:7860 ==================================================该服务默认监听7860端口，确保防火墙或安全组已开放此端口。
1.2 访问WebUI界面
在本地浏览器中输入以下地址即可进入操作界面：
http://localhost:7860若为远程服务器部署，请将localhost替换为实际IP地址，并确保网络可达。首次加载可能需要数十秒时间，待页面完全渲染后即可开始音乐创作。
注意：系统建议使用Chrome或Edge等现代浏览器以获得最佳体验，避免因JavaScript兼容性问题导致功能异常。
2. 界面功能详解
2.1 左侧控制面板
左侧区域是用户进行风格配置和参数调节的核心操作区，分为两个主要模块。
风格选择区域
- 时期（Period）
提供三大古典音乐时期的选项： - 巴洛克（Baroque）
- 古典主义（Classical）
- 浪漫主义（Romantic）
不同时期对应不同的作曲技法、和声语言与结构特征，直接影响生成作品的整体气质。
作曲家（Composer）
下拉菜单内容会根据所选“时期”动态更新。例如选择“浪漫主义”后，可选肖邦、李斯特、德彪西等代表性人物。乐器配置（Instrumentation）
进一步细化到具体作品类型。如选择“肖邦”时，仅支持“艺术歌曲”和“键盘”，体现其创作风格集中于钢琴独奏的特点。
系统验证机制：只有合法的三元组合（时期+作曲家+乐器）才能触发生成流程，无效组合将被前端拦截并提示错误。
高级生成参数
| 参数 | 默认值 | 功能说明 |
|---|---|---|
| Top-K | 9 | 限制每步采样时考虑的最高概率token数量 |
| Top-P (Nucleus Sampling) | 0.9 | 累积概率阈值，控制候选集大小 |
| Temperature | 1.2 | 调节输出随机性，值越高越具创造性 |
建议初学者保持默认设置，熟悉后再尝试调整以探索不同风格倾向。
2.2 右侧输出面板
右侧用于实时展示生成过程及最终结果。
生成进度反馈
显示当前patch生成状态，包括已完成的小节数与总耗时，帮助用户预估等待时间。ABC格式乐谱输出
生成完成后，原始ABC代码将以高亮文本形式呈现，支持一键复制。文件保存按钮
点击“保存文件”可将结果持久化至磁盘，同时导出.abc和.xml两种格式。
3. 使用流程详解
3.1 构建有效风格组合
步骤一：选择音乐时期
从“时期”下拉框中选定目标历史阶段。每个时期具有鲜明的艺术特征：
- 巴洛克：复调主导，严谨对位，代表人物有巴赫、亨德尔。
- 古典主义：主调音乐成熟，结构清晰，强调平衡与比例。
- 浪漫主义：情感表达强烈，和声丰富，注重个性与意境。
步骤二：指定作曲家
系统内置多位经典作曲家模型，均基于其真实作品数据训练而成。例如：
- 莫扎特 → 擅长交响曲、协奏曲、室内乐
- 柴可夫斯基 → 管弦乐与钢琴作品见长
- 斯卡拉蒂 → 主要贡献于键盘奏鸣曲
选择后，系统自动加载对应的风格嵌入向量。
步骤三：设定乐器编制
此步骤决定作品的配器规模与体裁形式：
- 键盘 → 钢琴独奏、奏鸣曲等
- 室内乐 → 弦乐四重奏、钢琴三重奏等
- 管弦乐 → 交响曲、序曲等大型编制
- 声乐管弦乐 → 歌剧选段、清唱剧等
组合确认无误后，“生成音乐”按钮变为可用状态。
3.2 参数调优建议（可选）
虽然默认参数适用于大多数场景，但可通过微调实现更精细控制：
- 追求稳定性：降低
Temperature至 0.8~1.0，减少意外跳跃音程 - 增强创意性：提高
Temperature至 1.5~2.0，增加旋律新颖度 - 提升连贯性：增大
Top-K至 15~20，扩大搜索空间 - 加快节奏变化：适当调低
Top-P，聚焦更高概率路径
修改参数会影响生成多样性与可控性的权衡，建议通过多次试验找到理想平衡点。
3.3 执行音乐生成
点击“生成音乐”按钮后，系统执行以下流程：
- 校验风格组合合法性
- 加载对应LLM解码器权重
- 初始化生成上下文
- 分块生成ABC符号序列（patch-by-patch）
- 实时刷新进度条与中间结果
整个过程通常耗时30~60秒，取决于GPU性能与生成长度。
3.4 结果保存与导出
生成完毕后，点击“保存文件”按钮，系统将在/root/NotaGen/outputs/目录下创建两个文件：
{composer}_{instrumentation}_{timestamp}.abc {composer}_{instrumentation}_{timestamp}.xml例如：
chopin_keyboard_202504051423.abc chopin_keyboard_202504051423.xml这两个文件分别适用于轻量编辑与专业打谱软件处理。
4. 支持风格组合一览
NotaGen共支持112种经过验证的有效组合，覆盖三大时期主流作曲家及其典型体裁。
4.1 巴洛克时期
| 作曲家 | 支持的乐器配置 |
|---|---|
| 巴赫 | 室内乐、合唱、键盘、管弦乐、声乐管弦乐 |
| 亨德尔 | 室内乐、键盘、管弦乐、声乐管弦乐 |
| 维瓦尔第 | 室内乐、管弦乐、声乐管弦乐 |
| 斯卡拉蒂 | 键盘 |
巴赫的《平均律钢琴曲集》与维瓦尔第的《四季》均可作为参考模板。
4.2 古典主义时期
| 作曲家 | 支持的乐器配置 |
|---|---|
| 贝多芬 | 艺术歌曲、室内乐、键盘、管弦乐 |
| 莫扎特 | 室内乐、合唱、键盘、管弦乐、声乐管弦乐 |
| 海顿 | 室内乐、键盘、管弦乐、声乐管弦乐 |
特别适合生成奏鸣曲式第一乐章或交响乐快板段落。
4.3 浪漫主义时期
| 作曲家 | 支持的乐器配置 |
|---|---|
| 肖邦 | 艺术歌曲、键盘 |
| 李斯特 | 键盘 |
| 德彪西 | 艺术歌曲、键盘 |
| 柴可夫斯基 | 键盘、管弦乐 |
| 勃拉姆斯 | 艺术歌曲、室内乐、合唱、键盘、管弦乐 |
肖邦夜曲风格可通过“键盘”配置高度还原。
5. 典型应用场景示例
5.1 场景一：生成浪漫派钢琴小品
目标：创作一首类似肖邦夜曲风格的钢琴独奏曲
操作步骤： 1. 时期：浪漫主义 2. 作曲家：肖邦 3. 乐器配置：键盘 4. 参数保持默认 5. 点击“生成音乐”
生成结果可用于后续导入MuseScore进行排版与音频渲染。
5.2 场景二：模拟贝多芬交响乐片段
目标：生成一段典型的古典主义管弦乐主题
操作步骤： 1. 时期：古典主义 2. 作曲家：贝多芬 3. 乐器配置：管弦乐 4. 温度设为1.0（增强结构性） 5. 点击“生成音乐”
可观察到典型的动机发展手法与清晰的奏鸣曲式轮廓。
5.3 场景三：探索同一作曲家的不同体裁
目标：对比莫扎特在键盘与管弦乐上的创作风格差异
操作建议： - 固定作曲家为“莫扎特” - 分别选择“键盘”与“管弦乐”配置 - 保持相同参数设置 - 对比生成的ABC代码结构与织体密度
此方法有助于理解AI如何捕捉作曲家在不同媒介中的表现逻辑。
6. 输出文件格式说明
6.1 ABC记谱法简介
ABC是一种基于纯文本的音乐表示语言，语法简洁且易于解析。示例如下：
X:1 T:Generated by NotaGen C:Chopin Style M:3/4 L:1/8 K:C z4 | E2 G2 c2 | d2 e2 f2 | g4 e2 | d4 z2 |特点： - 可直接复制粘贴至在线编辑器（如 abcnotation.com） - 支持标准MIDI转换 - 便于版本控制与批量处理
6.2 MusicXML格式优势
MusicXML 是现代数字乐谱的标准交换格式，具备以下优点：
- 被 MuseScore、Sibelius、Finale 等主流软件原生支持
- 保留完整的排版信息（谱号、拍号、装饰音、力度标记等）
- 支持多声部、复杂节奏与歌词对齐
- 可直接打印出版级乐谱
推荐将
.xml文件导入专业软件进行后期润色与演奏录制。
7. 常见问题排查
7.1 生成按钮无响应
原因分析：未完成完整风格组合选择
解决方案： - 检查是否遗漏任一字段（时期、作曲家、乐器） - 查看是否有红色错误提示浮层 - 尝试重新选择以刷新联动菜单
7.2 生成速度缓慢
可能原因：GPU资源不足或显存紧张
优化建议： - 关闭其他占用显存的应用程序 - 若支持，升级至更高性能GPU（建议至少8GB显存） - 减少生成长度（需修改后台配置PATCH_LENGTH）
7.3 文件保存失败
常见原因：未先完成生成即点击保存
正确流程： 1. 成功生成ABC乐谱 2. 确认右侧面板已显示完整代码 3. 再点击“保存文件”
另请检查目录权限：
ls -ld /root/NotaGen/outputs/确保写入权限正确。
7.4 生成质量不理想
应对策略： - 多次生成取最优：AI具有一定随机性，建议生成3~5次择优选用 - 调整Temperature在 1.0~1.5 区间内微调 - 更换作曲家或体裁尝试不同风格迁移效果
8. 高级使用技巧
8.1 参数协同调优策略
| 目标 | 推荐设置 |
|---|---|
| 高保真还原 | Temp=0.8, Top-K=20, Top-P=0.95 |
| 创意灵感激发 | Temp=1.8, Top-K=10, Top-P=0.8 |
| 快速原型生成 | Temp=1.2, 其他默认 |
可建立参数模板库，便于重复使用。
8.2 批量生成工作流
尽管当前UI为单次交互模式，但仍可通过以下方式实现批量产出：
- 记录一组满意参数组合
- 手动重复点击生成→保存→命名归档
- 后期统一导入音乐软件筛选整理
未来版本或将支持批处理脚本接口。
8.3 后期处理建议
推荐采用“AI初稿 + 人工精修”模式：
- 将
.xml文件导入 MuseScore 或 Dorico - 修正不合理指法、呼吸记号、强弱变化
- 添加演奏指示与表情术语
- 导出PDF乐谱或WAV音频
AI擅长生成结构合理的基础素材，人类专家则负责艺术升华。
9. 注意事项与最佳实践
- 版权说明：生成内容可用于非商业学习与研究，若用于公开演出或发行，请进行实质性改编并注明来源。
- 资源需求：建议运行环境配备至少8GB显存的GPU，否则可能出现OOM错误。
- 文件管理：定期备份
/outputs/目录，防止意外覆盖。 - 模型局限：AI无法完全替代人类作曲思维，应视作辅助工具而非替代品。
10. 获取帮助与技术支持
- 技术文档：查看项目根目录下的
CLAUDE.md - 开发日志：查阅
todo.md了解功能迭代计划 - 部署说明：参考
镜像说明.md进行定制化部署 - 联系作者：微信 312088415（科哥），备注“NotaGen咨询”
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。
