面向音乐制作人的中文使用指南。本文按 AIbleton 的实际界面和能力整理。
AIbleton 是运行在 Ableton Live 里的 AI 音乐制作助手。你可以像和制作搭档聊天一样让它理解当前 Set、提出建议，或直接创建、编辑、编曲、混音和分析内容。
.ablx 扩展：在 Live 中打开 设置 → Extensions 安装。现在有哪些轨道？ 确认 AI 能返回当前工程概览。如果你使用 Custom provider，必须填写 API 地址和模型；本地服务（例如 Ollama）可按服务要求不填 API Key。AIbleton 使用 OpenAI-compatible chat/completions 协议与 Custom 服务通信。
第一次请这样做： 先把 Set 另存一个版本，关闭 YOLO，发送一个只读问题确认连接正常；第一次实际改动只限定 4 小节。这样即使结果不合意，也容易试听、撤回和比较。
| 区域 | 用法 |
|---|---|
| 顶栏 | + 新建对话；时钟图标打开历史；齿轮打开设置。关闭对话框不会停止已在后台运行的任务。 |
| 输入框 | Enter 发送，Shift+Enter 换行。描述音乐目标即可，不需要写 tool 名或 JSON。 |
| 模型 / Effort | 点击模型名可直达 AI 配置；Effort 越高，推理通常更充分但会更慢。Custom provider 不显示 Effort，因为没有统一标准。 |
| 附件 | 点击回形针、拖入窗口或粘贴图片 / 文件。详见“附件与参考”。 |
| YOLO | 开启时 AI 可直接执行非付费操作；关闭时每一次会改动 Set 的操作都会出现“允许 / 拒绝”。确认栏只显示摘要，重要改动前仍应要求 AI 明确列出目标轨道、范围和文件。 |
| 发送 / 停止 | 任务进行中，发送箭头变为停止按钮。停止会取消等待中的请求与确认，但已完成的 Live 改动不会自动撤回。 |
在 设置 → AI 配置 中选择：
gpt-5-codex。claude-sonnet-5。gemini-flash-latest。在 设置 → 语言 可切换界面与回复语言。模型、provider、语言和常用设置会保存，重新打开界面后恢复。
YOLO 默认开启，适合你已经明确知道要做的、可快速撤销的操作。初次使用或进行大范围重排时，建议先关闭它：
首次音频生成无论 YOLO 是否开启都会提示确认，因为它消耗外部 API credits。若开启“自动迭代”，你是在预授权同一个目标后续最多 6 次额外付费生成；这些后续生成不会逐次再弹确认。
推荐先从一个小而可验证的任务开始：
建一条叫 Drums 的 MIDI 轨，加载 909 鼓组，写一个 4 小节 124 BPM house groove。保持 kick 不变，让 hats 更有律动，轻微 swing。这条提示同时给出了角色、目标、长度、速度和风格。相比“做点 house 鼓”，这样的约束能让首次结果更稳定。
按需要提供以下信息，没必要每次全写：
| 目的 | 示例 |
|---|---|
| 了解工程 | 分析当前 Set：调性、段落、各轨角色，以及最值得先处理的两个问题。 |
| 新建 bass | 在 A minor 写一条 4 小节、124 BPM 的 melodic techno bassline；放在第 1 小节，留出 kick 空间。 |
| 改现有素材 | 保持 Bass 轨的音色和长度，把旋律改得更少音、更有呼吸感。 |
| 编曲 | 用现有 clips 排一个 64 小节结构：16 小节 intro、16 小节 build、32 小节 drop；先给我计划和 dry run。 |
| 混音起点 | 检查 Kick、Bass、Pad 的关系；只做保守的音量和声像调整，不添加轨道。 |
| 音色设计 | 给 Synth 加 Auto Filter，做一个从暗到亮的上升感；先查看参数范围，再做少量改动。 |
| 找 sample | 找一个 124 BPM、A minor、dark 的 pad loop，先列出候选，不要导入。 |
| 生成音频 | 用 AI 生成 32 秒、120 BPM、A minor、无 vocal 的 seamless industrial percussion loop，并放到 Texture 音频轨第 33 小节。 |
下面两种说法尤其适合大改动：
先分析当前编曲。只告诉我应该如何让 Drop 更有冲击力，暂时不要改 Set。
为 33–64 小节重排一个 Drop：先给计划和 dry run；确认后再执行。
AI 会在需要多步创作、编曲或修复时，先建立可检验的目标并规划步骤。你可以随时要求它停在分析 / 计划阶段，或要求它说明准备修改哪些轨道。
分析当前 Set 的段落、track roles、能量对比和重复问题。让 Drop 比 Intro 更有能量，但保持现有 kick 与 tempo 不变。先给计划。AI 的结构分析优先使用 Live cue points；没有 cue points 时，会用 8 小节能量块推断段落。若你希望稳定地按 Intro / Build / Drop 工作，建议在 Live 里使用有意义的 cue 名称。
如果你想了解音色或混音问题，可以要求 AI 同时分析音频，例如：分析音频的响度、真峰值、动态、立体声相关性和潜在相位问题。 源文件足够长时会提供 LUFS 等测量值。这些测量基于音频片段的源文件，发生在 Warp、增益和设备处理之前。只有 MIDI 的乐器轨没有可供此项分析的音频源文件。
让 AI 重排时，不要只说“编一下”。先指定范围和保留策略：
分析所有 Arrangement 和 Session clips，然后用现有素材重排 1–64 小节。
保留源素材；先 dry run，列出每个 placement 的来源、目标小节和冲突。
dry run 不会修改 Set。真正执行前要检查：
clear_range_bars 清除整个范围。清除区间警告：
clear_range_bars会影响所有轨道的指定小节（含起止小节），并会裁剪相交 clip。若 source 本身落在清除范围内，AI 可以用已读取的内容创建新 placement，但原 Arrangement source clip 仍会被清除。dry run 只能预览，不能恢复已执行的清除；真正执行后请用 Live Undo 回退。只在明确“重建这一段”时使用。
808 / 909 / 707 / 606 / DMX 鼓组后再写 pattern。返回的 drum pad map 才是可用音高的最终依据。在 A minor、C2–C3 之间写 4 小节 bass，八分音符为主。先描述听感问题，再限制改动范围：
Pad 太亮、挡住 lead。只在 Pad 轨插入或调整内置设备；先查参数，
再用 EQ Eight 或 Auto Filter 做温和处理，别改音符。
AI 可操作 Live 内置设备（例如 Operator、Wavetable、Impulse、Reverb、Auto Filter、Compressor、EQ Eight、Delay），不支持第三方插件。对大型乐器 / 效果器，应先读取并筛选参数，再做少量精确设置。一次需要调整多个参数时，AI 会优先作为一个批量动作执行。
set_track_mixer 的音量为 0–1 的归一化数值，约 0.85 ≈ 0 dB，不是直接输入 dB。它只改音量 / 声像，不写 automation、send 或 master chain。
找 124 BPM、A minor、warm 的 pad loop。导入第 2 个候选到 Texture 音频轨，第 33 小节，开启 warp。把第 1 个候选加载到 Vocal Chop 轨的 Simpler。本地搜索会查已同步的 Splice、Ableton User Library、Factory Packs 和 Core Library；不会浏览 Splice 在线目录。导入 Arrangement 的目标必须是 Audio track；加载到 Simpler 的轨道则用于 MIDI 演奏。
在 设置 → 音频生成 选择 provider 并填好 key。建议先生成目标明确、便于试听的素材：
要调用付费 AI 音频服务，请明确说“用 AI 生成……”。只说“生成一个 loop/sample”会先搜索本地素材；如果没有合适结果，AIbleton 会先询问你是否改用 AI 生成。
用 AI 生成 32 秒 seamless loop：120 BPM、A minor、dry industrial percussion，
不要人声。生成后直接导入 Texture 音频轨第 33 小节。
instrumental 可要求无 vocal；lyrics 仅适用于 MiniMax。“自动迭代”适合有明确可测目标的生成任务，不适合你还在探索风格时盲开。开启它等于预授权同一目标最多额外 6 次付费生成，后续不会逐次确认；先设定时长与预算，再审听每次结果。
比较 Lead Vocal 轨上的录制人声和 Reference Vocal 轨上的参考人声。报告源文件在电平、动态和频谱上的差异，并列出需要我试听确认的齿音或喷麦线索。不要修改 Set。 如果轨道上有多个片段，先确定对应段落，再告诉 AI 要比较哪些片段。人声比较读取完整源文件（每个文件最多 180 秒），测量不考虑 Warp、片段裁切、增益和设备处理。电平和频谱线索仅供试听排查，不是诊断；工具不测量逐音符的音高或节奏，也无法验证效果器处理后的声音。
支持点击、拖放或粘贴，最多 10 个附件：
.mid / .midi / .als；单个不超过 10 MB。系统先解析为文字摘要，而不是把二进制工程原样交给模型。Live 内置 webview 可能不能弹出原生文件选择框；在 Live 中优先用拖放或粘贴。若希望基于参考音频作分析，告诉 AI 本地 WAV / AIFF / MP3 / FLAC / OGG Vorbis / M4A（AAC 或 ALAC）的绝对路径以及要比较的段落；参考只用于分析差距和给出保守建议，不应要求复制一首现有作品。
在 设置 → 联网搜索 开启后，AI 才能搜索近期教程、版本、release notes、新闻等，并可读取静态网页正文。默认关闭。
开启意味着搜索词与抓取的 URL 会发送给对应网站；不会使用账号或 Cookie。不需要实时网页信息时建议保持关闭。本地 sample 文件一律使用 AIbleton 的 sample search，不使用网页搜索。
在 设置 → 音乐人记忆 中填写艺名、风格、BPM 范围、常用调性、音色偏好、参考艺人和备注。也可直接对 AI 说：
记住我主要做 124–128 BPM 的 melodic techno，偏好 909 鼓和温暖的 analog pad。
记忆会成为后续对话的默认创作上下文。只保存稳定的长期偏好；例如本次 Set 临时选择 A minor，不应自动变成永久偏好。需要清除或修改时，在设置中直接编辑即可。
AIbleton 将你的聊天请求、工具读取到的 Set 信息，以及你发送的图片 / 附件交给所选 AI provider 处理；请只使用你有权分享的工程、采样和参考素材。文本附件会进入本地聊天历史，图片和二进制附件只用于当前请求；.mid / .als 会先在本机转换为文本摘要再发送。
扩展会在本机保存对话历史、音乐人记忆、provider / 音频生成配置和 Move pairing token，便于下次继续使用。共享电脑时，建议使用权限受限的专用 API key，避免上传未授权素材；离开设备前删除不需要的会话，并在系统或扩展配置中妥善管理凭据。
AIbleton 对 Move 有两条独立工作流：USB-C MIDI 编排 与 Wi‑Fi 文件 / Set 管理。
前提：Move firmware ≥1.5、Standalone Mode、USB-C 连接。一次性设置：
建一条通道 1 的 Move 轨。Ableton Move，Output Channel 设为 1。Shift 并按轨道按钮，将该轨 MIDI In 设为同一 channel 或 Auto。这条链路会发送 notes、velocity、poly aftertouch；Move 不接收 MIDI CC，AI 也不能经 SDK 自动设置 Live 的 Output Routing。详细说明见 Move Guide。
电脑和 Move 必须在同一 Wi‑Fi。首次配对与上传时：
检查我的 Move 是否在线。配对我的 Move。列出 Move 的 Samples/Drums 文件夹。把刚生成的文件上传到 Move 的 Samples/Drums 文件夹，不要覆盖同名文件。配对 token 会保存；如果再次提示未配对，重新走一次 code 流程即可。上传是对 Move 文件系统的真实写入，不能通过 Live Undo 撤回。同名文件默认不覆盖；只有明确要求覆盖时才会替换。Move 没有 Arrangement View，读取到的 clips 会按 Session clips 分析。
+。适合切换到完全不同的制作目标，避免旧上下文干扰。/，选择本地已安装的 skill；选中后会插入 /skill-name。SKILL.md 可以不写 YAML frontmatter；AIbleton 会从正文的“技能描述”和“触发关键词”字段提取信息。显式调用或关键词匹配都没有命中时，AIbleton 会额外调用当前模型一次，并发送本轮请求和本地技能名称/简介（不含全文）来选择相关 skill。安装入门 Skills：仓库的 skills/ 目录提供了三个可直接使用的 Skill。从仓库根目录把需要的文件夹复制到 ~/.aibleton/skills/（macOS/Linux）或 %USERPROFILE%\.aibleton\skills\（Windows）。例如：
mkdir -p ~/.aibleton/skills
cp -R skills/bossa-nova-producer ~/.aibleton/skills/
cp -R skills/dark-techno-kit ~/.aibleton/skills/
cp -R skills/techno-production ~/.aibleton/skills/
New-Item -ItemType Directory -Force "$HOME\.aibleton\skills" | Out-Null
Copy-Item -Recurse -Force ".\skills\bossa-nova-producer" "$HOME\.aibleton\skills\"
Copy-Item -Recurse -Force ".\skills\dark-techno-kit" "$HOME\.aibleton\skills\"
Copy-Item -Recurse -Force ".\skills\techno-production" "$HOME\.aibleton\skills\"
只想安装一个时，只复制对应文件夹即可。复制后在 AIbleton 输入 /，即可查找并选择该 Skill。编辑 SKILL.md 可以按需定制。
不要改 kick / tempo / key 比“别改太多”更可靠。arrange_song 在执行前会完整校验；一旦开始执行则按 SDK 规则逐步提交。若后续步骤失败，之前已完成的修改会保留，可在 Live 中逐步 Undo 回退。| 现象 | 排查与处理 |
|---|---|
| 顶部显示未找到认证信息 | 齿轮 → AI 配置，选择正确 provider 并填写 key；或确认本机 CLI / 环境变量已登录、重开窗口。Custom 必填 API 地址与模型。 |
| AI 只回答、不改 Set | 检查你的话是否要求执行；若任务在计划 / 分析阶段，明确说“现在执行”。关闭 YOLO 时还需要点“允许”。 |
| AI 等待不动 | 查看是否有确认条；没有时用停止按钮中止并缩小任务范围后重试。 |
| 操作落到错误的轨道 | 先让 AI get overview / 分析当前 Set，再用轨道名指代；新增、删除、重排轨道后不要沿用旧索引。 |
| Arrangement 重排被拒绝 | 检查 dry run：来源 clip 是否存在、clip_index / scene_index 是否只给一个、同一轨道是否 overlap。重新分析后再生成新 plan。 |
| sample 导入失败 | 确认文件实际存在；loop / stem 目标必须是 Audio track。one-shot 需要放到 Simpler 时，改用“加载到 Simpler”。 |
| 找不到本地 sample | AIbleton 只能查已安装 / 已同步的本地库；检查 Splice 是否完成同步、User Library / Pack 是否在本机。 |
| 音频生成报 key 或 provider 错误 | 齿轮 → 音频生成，确认选择的 provider 与 key 对应；Custom 还需检查请求 URL、body template 和响应字段路径。 |
| 生成成功但没有出现在 Arrangement | 文件已保存；让 AI 使用返回文件重新导入，并确认目标是 Audio track。 |
| Move 提示未配对或不可达 | 确认同一 Wi‑Fi、设备已开机；先检查状态，再重新发起配对并输入设备屏幕 code。 |
| macOS 看不到 Ableton Move MIDI 端口 | 拔掉 Move，在“音频 MIDI 设置 → MIDI 工作室”删除旧的 Ableton Move 设备，再重新连接。 |
当你已经习惯基础流程，试试一个完整但仍受控的任务：
分析当前 Set，找出 Drop 与 Intro 的能量差、bass role 和重复问题。
目标是在不改 tempo、key 和 Kick 轨的前提下，让 Drop 更有冲击力。
先给 3 步计划；如果涉及重排 Arrangement，再给 dry run。我确认后再执行，每一步完成后简短汇报。
这会充分利用 AIbleton 的优势：先理解音乐上下文，再用可检查、可撤销的动作完成制作任务。