REAPER 轨道操作与管理
为 Agent 提供 REAPER 轨道操作的详细指令,包括轨道创建、遍历、颜色设置等功能。
使用时机
在以下情况使用此技能:
- 当用户提到"轨道"、"track"、"音轨"等关键词时
- 当需要创建、编辑、配置或管理 REAPER 轨道时
- 当需要遍历或统计轨道时
- 当需要设置轨道颜色时
指令
核心规则
- reaper 对象:
reaper对象已自动注入,可直接使用 - hold 模式:
with reaper.hold()用于批量操作- API 调用在 for 循环中时,必须使用
with reaper.hold()包裹 hold内所有调用都会被批处理,返回值一律为None/0- 任何需要返回值或读取的调用必须放在
hold外 - 推荐流程:hold 外先计算/获取 → hold 内只做 Set/Insert 写入 → hold 外再读取/校验
- defer: 生成的 Python 代码不需要再使用 defer,因为 server 已经实现
操作指引
根据用户需求,参考以下参考文件:
- 创建轨道: 参考
references/增加轨道.md - 遍历轨道: 参考
references/轨道遍历.md - 设置轨道颜色: 参考
references/轨道颜色.md - 统计轨道数量: 参考
references/统计轨道.md