从连接 DAW，
到第一场彩排。

快速入门

开发测试版 Windows 旧版与 macOS 0.2.3 开发测试版均通过项目交付获取，尚未公开托管或完成 Mac 签名公证。打开场序 CueOrder 后，可从状态窗口进入本机网页控制端。更名后的 Mac 应用名为 CueOrder.app；旧版 StagePilot 歌单会复制到新数据目录，原文件保留；Mac 用户也可从菜单栏图标，Windows 用户从系统托盘图标再次打开状态与连接向导。

1. 先在「模拟模式」熟悉歌单、预选和 GO。
2. 备份 Live 工程，在 Arrangement 中放好歌曲与段落定位点。
3. 按「连接 Live 12」章节启用 AbletonJS 桥接。
4. 切换到「真实模式」，确认界面同时显示真实模式与 Live 已连接。
5. 完整排练每首歌的起点、段落、歌词及停止行为。

连接 Ableton Live 12

场序 CueOrder 使用 AbletonJS 控制界面与 Live 通信。它是场序 CueOrder 使用的独立桥接组件，不是 AbleSet 插件。请不要把两者混淆，也不要覆盖 AbleSet 的文件。

1. 启动 Ableton Live 12，并打开准备好的工程。
2. 在场序 CueOrder 中打开「连接向导」，点击「安装 AbletonJS 插件」。安装过程应只写入当前用户的 Live Remote Scripts 目录。
3. 重启 Live。在 Live 设置的「Link, Tempo & MIDI」中，将一个 Control Surface 设为 AbletonJS。
4. 返回场序 CueOrder，点击「连接真实 Live」。核对顶部状态，不要仅凭按钮已按下就判断连接成功。

Live 12 官方手册说明，Control Surface 在「Link, Tempo & MIDI」中启用；查看 Ableton 官方说明 ↗

切换模式时

模拟模式无需启动 Live，适合学习。真实模式只在连接成功后控制实际工程。演出前请确认只有一份场序 CueOrder 服务连接同一个 Live 工程，避免指令来源混乱。

连接 Logic Pro

场序现可通过本机虚拟 MIDI 控制 Logic Pro 的歌曲与段落定位、播放和停止。先打开 连接向导，选择「Logic Pro」。首次排练可使用源码目录 examples/logic/CueOrder Logic 单编号跳转演示.logicx 中的工程和同目录的 Logic 实际导出 MIDI。

1. 在 Logic 标记列表中，用普通名称标记歌曲起点，用 > 主歌、> 副歌 标记段落，用 停止 标记结束。至少保留一个延伸到最后标记之后的 MIDI 片段。
2. 打开 Logic「键盘命令」，分别为「播放」「停止」学习场序连接向导里的按钮（CC 20、21）。在场序启用「单编号跳转」后，按 ⌘0 打开 Logic MIDI Environment，在「节拍与端口」层选「新建 → 推子 → 特殊 → 跳到标记」；输入设 Control / 通道 1 / 编号 70，输出保持默认 Meta 51（Go to Marker），范围设 0–127；把 Physical Input 的 CueOrder Control 专用输出接入推子。先用「发送测试标记」核对播放头位置。此后场序以 CC 70 的控制值发送 Marker 编号，免去逐个学习。先用演示工程核对跳转，再将设置保存进模板。演示工程为快速测试连接了全部 MIDI 输入；正式工程请使用 CueOrder Control 专用输出，以免其他控制器误触发跳转。若暂未配置 Environment，可在向导切回「逐个映射」：按旧方式分别学习 CC 41–60。
3. 在 Logic「文件 → 项目设置 → 同步 → MIDI」，将目的位置设为 CueOrder Sync，勾选「时钟」，保留「乐曲位置指针」模式。每个 Logic 工程都要保存这项设置。
4. 用 Logic「文件 → 导出 → 所有 MIDI 轨道为 MIDI 文件」导出 .mid，并在场序连接向导导入。修改 Marker 后重新导出导入。
5. 预选歌曲或段落，双击 GO 确认。单编号 GO 会先跳转并启动 Logic，再核对开始播放时的目标位置回传；如果位置不符，场序立即发送停止；没有回报则在超时后停止。停止状态下单独定位可能因 Logic 不发送位置回报而失败；停止与紧急停止可直接执行。

单编号方式最多定位前 127 个 Marker；逐个映射方式最多定位前 20 个。Logic 的 Marker 编号按其列表顺序排列；同一位置有多个标记时，请以列表编号为准。导入不会改动 Logic 工程。正式演出前逐曲测试跳转和停止。

Apple 参考：Meta 51 跳到 Marker、Fader 转换 MIDI、键盘命令分配、Marker 快捷键、MIDI 时钟同步。

歌曲与段落怎么命名

场序 CueOrder 读取 Live Arrangement 的定位点。普通名称是歌曲起点；名称以 > 开头是段落，例如 > 主歌。两个大于号 >> 副歌 表示快速跳转段落。中文输入法输入的全角 ＞ 也可使用。定位点请放在准确的拍点，尽量落在小节第一拍。

青花瓷
> 前奏
> 主歌 {主唱进入}
>> 副歌
继续
成都
> 主歌
> 尾奏
停止

也可在歌名或段落名后写 +继续 或全角 ＋继续（兼容 +CONTINUE、+SEGUE），在自然曲末接歌单下一首。全局“每首歌结束都停止”设置优先。备注写在花括号中，例如 > 主歌 {主唱进入}；* 或 [nosong] 开头的辅助定位点不会进入曲库。命令需单独成名，因此《继续前行》仍是普通歌曲名。

安全边界：这些词由运行中的场序 CueOrder 解释，Live 本身不会因为定位点叫“停止”就停播。场序 CueOrder 只支持这里列出的 AbleSet 式定位点子集；AbleSet 的 +LOOP、+PAUSE、. 歌名、+JUMP 和 Sections MIDI 轨道尚未实现。不要在正式工程直接试新命名，先用测试工程逐曲验证。参考 AbleSet 官方定位点说明 ↗ 和 Ableton Live 12 Arrangement 手册 ↗。

管理歌单与安全跳转

1. 停止播放后进入「歌单编辑」，拖拽歌曲行调整顺序。播放时编辑会锁定。
2. 演出视图的「歌单预览」可查看歌曲和段落；点击目标只会预选，不会立即跳转。
3. 确认目标名称和所在歌曲，再在 3 秒内二次点击 GO 执行。键盘 G 使用同样的二次确认；Esc 可紧急停止。

如果跳转后从 Live 的光标位置播放，请先停止操作并回到定位点命名与连接状态检查。正式演出前必须逐个验证歌曲和段落起点，特别是启用了循环、量化或其他 Live 控制脚本时。

演出视图

演出视图显示当前歌曲、段落、BPM、拍号、已播放与剩余时间、歌曲进度和下一首。顶部「显示设置」可按岗位打开或关闭歌词、段落、歌单预览、时钟等字段，设置保存在当前浏览器，不会更改 Live 工程。

进度条会在 Live 同步之间做视觉平滑；一旦 Live 停止或连接中断，界面不会继续假装播放。复杂变速工程中的时长估算可能与 Live 实际时间有偏差，以 Live 和排练结果为准。

导入同步歌词

1. 停止播放，进入「歌单编辑」，选中歌曲。
2. 在「同步歌词 · LRC」中选择 UTF-8 或 GB18030 编码的 .lrc 文件。
3. 文件不超过 64 KB，至少包含一行时间戳歌词；可在演出视图中检查当前句和下一句。
4. 如果整体偏早或偏晚，在歌曲设置中以 0.5 秒为步长校准。

[00:12.50]第一句歌词
[00:18.00]第二句歌词

LRC 以歌曲在 Live 中的起点为零点。当前换算适合恒定 BPM；变速自动化歌曲请逐曲校对。歌词保存在场序 CueOrder 本地数据中，不写入 Live 工程。

试用与商业授权

桌面测试版采用每次启动 15 分钟、可重新启动的试用原型。试用到期不会自动停止 Live 播放，但会拒绝新的播放和跳转；紧急停止仍可用。开发源码启动的控制端没有这项限制，所以目前不是正式的防破解授权系统。

目前没有正式价格、付款、授权码发放、离线激活或设备席位管理。购买入口 只公开上线状态，不接受付款。发布正式许可前，还需要确定商户、价格与售后条款、签名和发证服务，并测试离线场景。

常见问题

官方参考资料

场序 CueOrder 的产品界面和文案为独立设计；下列资料用于核对 Live 的操作方式，以及比较同类产品的文档覆盖面：

• Ableton Live 12 — Arrangement 与定位点
• Ableton Live 12 — MIDI 与 Control Surface
• AbleSet 官方使用文档

场序 CueOrder 与 Ableton、AbleSet 没有隶属、认可或授权关系。