ACE Script 工具包

ACE_script 是一套面向 ACE Studio 的 Python 自动化脚本工具库，旨在通过简洁接口，实现对音符、剪辑、轨道及项目上下文的高效编程控制。它是ACE MCP服务的python warpper

📦 核心功能

• 音符操作：创建、添加、查询、选择音符（支持带 UUID 的真实音符与草稿音符）
• 上下文感知：提供项目信息、时间/tick/小节坐标转换、轨道元数据查询等能力
• 编辑器交互：可打开编辑器、获取选区、粘贴音符等

🚀 快速开始

首先打开ACE的MCP服务
安装依赖后，直接导入即可使用：

from ACE_script import *

示例：创建一个上行音阶

from ACE_script import *

def create_rising_scale():
    """创建逐渐上升的音符序列"""
    notes = []
    start_pos = 0
    note_duration = 480
    note_gap = 480
    pitches = [
        62, 64, 65, 67, 69, 71, 72 
    ]

    for i, pitch in enumerate(pitches):
        pos = start_pos + i * note_gap
        note = AceNote(pos=pos, dur=note_duration, pitch=pitch)
        notes.append(note)

    return notes
def main():
    print("创建逐渐上升的音符序列...")
    notes = create_rising_scale()
    # 创建序列对象
    sequence = AceNoteSequence.from_notes(notes, offset=0)
    # 添加到项目
    sequence.set_to_project()
    print("音符序列添加完成！")
if name == "main":
    main()

文档

还没写完，敬请期待！