关于 ace-studio-workflows
ACE Studio 工作流技能,为歌曲生成、音频歌曲编辑和乐谱导出提供分步指引。内容涵盖节拍对齐、分轨、音符转录、MIDI 清理及在 MuseScore 中整理和核验乐谱。
主要功能
- 01指导生成歌曲并对齐节拍
- 02将音频拆分为音轨并转为 MIDI
- 03清理转录结果中的错误音符
- 04通过 MIDI 将项目内容导入 MuseScore
- 05检查乐谱文件及导出结果
适用场景
- 01根据音频分轨并编辑歌曲
- 02将人声或乐器音轨转录为 MIDI
- 03把项目中的音符整理成可打印乐谱
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ beatmagic/ acestudio_agent_plugin --skill ace-studio-workflows安装后在 Claude Code 中输入/ace-studio-workflows确认已加载。
详细介绍
ACE Studio 工作流
歌曲生成
当用户想生成一首完整歌曲时,请使用 Inspire Me。
1. 生成
有关 Inspire Me 的输入要求和费用,请参阅 ace-studio-features。
2. 让项目速度与生成结果保持一致
请在任何编辑之前完成此操作——项目速度不匹配会导致之后的每次编辑都与网格冲突。具体采用哪种方式取决于时间线上还有什么内容,因为应用速度会彻底替换项目的速度和拍号,并移动现有内容。
-
时间线上只有生成的音频。 不会影响其他内容,因此可以直接将其速度应用到项目。
-
时间线上已有其他内容。 请先询问用户:确认他们要保留哪个版本的音乐,以及速度应以哪个版本为准。然后应用该版本的速度。时间线上已有的所有内容都会移动,因此请在操作前告知用户。
3. 询问是否继续
询问用户是否要编辑歌曲。如果要编辑,下面的第一个工作流就是入口——将歌曲拆分为分轨,并转录他们想要修改的部分。
从音频编辑歌曲
当用户提供一段完整音乐并想要编辑时,请按以下流程操作。
1. 让项目与音频保持一致
导入音频后会自动进行节拍分析。应用分析结果,让项目速度与音频速度一致——此操作还会将音频的第一个强拍向后吸附到最近的小节线,从而使音频向后移动。
应用之前请告知用户音频会移动,并记住应用操作会彻底替换项目的速度和拍号。
2. 将音乐拆分为分轨
使用 Stem Splitter。根据用户的实际需求选择模式——有关各模式的分离内容和费用,请参阅 ace-studio-features。
3. 将旋律分轨转换为 MIDI
3.1 主唱
使用内置的 Vocal to MIDI。它会提供旋律和歌词,因此比通用转录工具更适合此处。它需要单声部人声。
3.2 其他乐器分轨——在 Studio 外使用 Basic Pitch
ACE Studio 中没有乐器转录工具。请使用本地运行且免费的 Basic Pitch,然后将 MIDI 导回。
分轨位于音轨上,而 Basic Pitch 读取的是文件——因此流程为:将每条分轨导出为音频 → 对文件运行 Basic Pitch → 将生成的 MIDI 导入到音轨。
设置。 请先检查是否已有可用环境;不要覆盖用户现有的环境。Basic Pitch 需要的解释器版本较新系统 Python 更旧,因此请为它创建独立的虚拟环境——Python 3.11 是一个兼容的起点:
python3.11 -m venv work/transcribe-env
work/transcribe-env/bin/python -m pip install basic-pitch librosa pretty_midi mido
在 Windows 上,解释器路径为 work/transcribe-env/Scripts/python.exe。
basic-pitch <output-dir> <stem.wav>
Basic Pitch 生成的是候选结果,而非转录成品。 它是为单乐器素材设计的,而这正是分轨的特点——但导入之前仍需清理输出结果。多次运行并得到相同答案并不能作为准确性的证据;那只是同一个模型运行了两次。
3.3 导入前清理 MIDI
移除识别器凭空生成的内容:
- 和声叠加——真实音符上方高八度或高五度的虚假音符。
- 超短噪声音符和尾部残片,它们是衰减留下的。
- 同一音高在同一时刻的重复起音。
保留音乐性内容:装饰音、切分音和休止都是音乐内容,不是噪声。 根据实际速度和乐句来判断——不要用一个固定的毫秒阈值删除所有短音符,否则会抹平演奏的表现力。
然后逐件检查乐器:
- 贝斯。 八度错误是最常见的问题,滑音会变成密集的半音音符串。对照底鼓和和弦变化核对根音。 默认保持单音:吉他或键盘的串音不能变成贝斯和弦。
- 吉他。 失真吉他的转录效果很差。对照频谱图、起音和下方的和弦检查短乐句。
- 键盘。 延音踏板和尾部共振会变成大量持续音符——不要照原样转录。根据贝斯和和声重新构建左右手的分工。
- 鼓。不要使用 Basic Pitch。 它是音高模型,打击乐不在其适用范围内。
3.4 加载音源
在用户想要编辑的音轨上加载合适的音源。关于如何在 AI Instruments 和插件之间选择,请参阅
ace-studio-features。
将项目导出为乐谱
当用户想要将项目中的内容打印成乐谱时。
1. 从 Studio 导出音符
导出 MIDI。它会在调用线程中写入文件,因此命令返回时文件就已写入磁盘——无需等待。导出的内容包含所有带音符的音轨:人声、乐器、通用 MIDI 和和弦音轨。
音频音轨不包含音符,因此不会出现在乐谱中。 导出前检查项目中的音频音轨——如果贝斯或吉他只存在于音频中,它就会悄无声息地消失,用户直到查看乐谱才会发现缺失。
如需将其加入乐谱,请使用第一个工作流中的转录流程:如果是混合音频音轨,先拆分为分轨;然后导出音频,对文件运行 Basic Pitch,清理结果,再将其作为 MIDI 音轨导入。对于主唱音频音轨,请改用 Vocal to MIDI——它会一并带入歌词,而歌词正是乐谱中需要显示在人声旋律线下方的内容。将素材放入带音符的音轨后,再次导出 MIDI。
进行此操作前请询问用户:转录结果只是估算,他们可能更希望乐谱只包含自己实际创作的部分。
了解 MIDI 会丢失什么。 MIDI 文件无法保存歌词、音节、人声参数和演奏法。如果乐谱需要在人声旋律线下方显示歌词,请单独将人声导出为 UfData——它会保留歌词,但仅适用于人声音轨;或者准备在制谱软件中手动输入歌词。
此界面不支持导出 MusicXML,因此需要通过 MIDI 转换。
2. 在 MuseScore 中制谱
MuseScore Studio 是免费的制谱和导出工具。请查找可执行文件,而不要假设它位于某个固定路径:检查 PATH、正在运行的进程的可执行文件路径、常见的操作系统安装目录,或者询问用户。在 Windows 上,文件通常名为 MuseScore4.exe——不要假设它位于 C: 盘。
导入 MIDI,创建乐谱,并保存为原生 .mscz 文件。从该 .mscz 文件导出 PDF 和 MIDI,这样三个文件都来自同一来源:
<musescore> -o work/score.pdf work/score.mscz
<musescore> -o work/score.mid work/score.mscz
-o 根据目标扩展名选择格式。不要传入 -F——它会清除用户的设置;如果乐谱无法打开,也不要使用 --force 来掩盖问题。
3. 整理 MIDI 导入的内容
MIDI 导入只是起点,不是乐谱。请准备好修正以下问题:
- 音符时值和休止符。 演奏 MIDI 中的音符结束时间可能略早或略晚;乐谱需要准确的时值、延音线和休止符。
- 等音异名和调性。 MIDI 记录的是音高数值,而非音名拼写,因此需要手动设置调号和临时记号。
- 声部和谱表分配。 键盘声部会作为一条音符流导入,需要拆分到两个谱表;打击乐轨可能会被导入为钢琴。
- 速度图。 确认导入的速度和拍号与项目一致,尤其是在之前应用过节拍分析的情况下。
4. 交付前进行核验
不要仅凭文件存在就声称乐谱已完成。
- 在 MuseScore 中重新打开最终的
.mscz,确认其可编辑。 - 解析导出的 MIDI(使用
mido或pretty_midi):检查速度图、是否包含音符、声部分配和时值。留意八度偏移、以钢琴形式导出的鼓声,以及空轨。非空文件且具有有效文件头,只能证明它是 MIDI 文件。 - 将 PDF 的每一页渲染为图像(
pdftoppm -png -r 120 …),并逐页检查谱号、符尾、延音线、节奏和版面。抽查几页并不算完成最终检查。 - 如果导出后编辑了
.mscz,请从中重新导出 PDF 和 MIDI。
在源乐谱中修复问题,并重新检查所有受修复影响的内容。常规问题请自行处理,不要每调整一次间距都询问用户。
如实描述结果:说明你核验了哪些内容,以及哪些内容未核验。除非确有证据证明音符级别的准确性,否则请称其为可演奏的编曲。