Cue 与标记
打点是每天重复最多的动作，所以键位、列布局和触发器都做成可配置的。
标记类型
- 名称 / 颜色 / 形状 / 排序：一套演出可以有几组视觉上可区分的 Cue 类型。
- 倒计时属性：距下一条 Cue 的剩余时间，颜色随剩余时间变化。
- 默认 OSC 消息：同类 Cue 到点即发，无需逐条填写。
每条 Cue 的字段
- 位置 / 淡入 / 淡出：位置按帧对齐，淡入淡出可逐条设置。
- 备注 / 长备注 / 信息：短提示给执行，长备注给交接。
- 触发器与跟随：到点触发另一条 Cue 或轨道，可设触发延迟。
- 命令与 OSC：到点执行外部命令，或发送自定义 OSC 消息。
- 手动 CueID 与导出映射：可写入控制台侧的 Exec / Page / Sequence 编号。
列表操作
- 列可拖动重排：拖动列名换位（带位移过渡），拖右边缘改宽，松手即保存。
- 数字快捷键打点：按当前类型直接打标记，播放中可暂停等待输入标签。
- 多选与相对移动：多选 Cue 后按偏移整体移动（可反向），保持相对间距、不会推到负帧。
- 自动滚动与删除确认：播放时列表自动跟随；防误删可开确认。
跳转与循环
- 跳转到指定 Cue：按编号或列表点选定位。
- 列表循环：彩排反复走同一段时不必手动回起点。
- 切轨回起点：切换轨道时自动回到 0，减少误操作。
- 跳过量三档：默认 10 帧 / 1 秒 / 1 秒，可逐组改数值。
播放引擎与时间线
主时钟按真实经过时间换算帧，长时间跑不漂移；三路媒体各有独立增益与偏移。
多轨与三路媒体
每个工程可有任意条轨道，可重命名、排序；每轨同时载入主路、备用路、第三路， 分别设增益与偏移，可叠加或按需切换。
时间线与波形
后台生成波形缓存，支持双通道与高清波形、垂直缩放；时间线可缩放，播放头可拖动， 拖动时可选是否出声。
时钟与帧率
支持 23.976 / 24 / 25 / 29.97（含丢帧换算）/ 30 等帧率；每轨可覆盖帧率与轨道偏移， 末帧自动停止。
音频输出
WASAPI 共享 / 独占与 ASIO 两条路径，多输出槽可分配不同设备；输出延迟补偿与 主音量单独可调。
媒体与缓存
预解码缓存有上限（超限按最近最少使用清理），缓存目录可改； 可把工程里的 WAV 批量转成 MP3 以缩小素材体积。
定位与循环
A-B 循环区间可拖手柄调整，视频跟随循环；进度条点击即定位，跳转步长可配置。
时间码：LTC / MTC / Art-Net
三种时码都能读也能发；LTC 还可以"打"进媒体音轨，让播放与外部系统锁在一起。
LTC
- 读取：选音频输入设备与声道解码 LTC，状态栏实时显示时码与锁定状态。
- 生成：可输出 LTC 到指定设备（waveOut 或 ASIO 通道），支持静音但继续计数。
- 条纹：把时码写进媒体音轨（仅 LTC / 左声道 / 右声道），导出为 16-bit WAV 保证逐样本正确。
- 预卷：播放前预卷若干秒，供外部系统锁相。
- 时码时钟窗：独立大字时间码窗口，可全屏给演职人员看。
MTC 与 Art-Net
- MTC 生成 / 监听：通过 MIDI 端口收发，设备按名字记忆（插拔后索引变化也不丢）。
- 跳过软波表：未指定设备时自动避开 GS Wavetable 之类的软件合成器端口。
- Art-Net 时间码：默认 UDP 6454，支持目标 IP、端口与流号（流号按端口偏移，多流互不干扰）。
- 同步校准：用波形与外部时码测量漂移，量出的偏移可作为工程偏移落盘。
--io-probe 诊断，会列出 MIDI 端口、逐条返回码并试播 2 秒 LTC。
画面输出与叠加层
NDI 三路、本机多屏、以及一层可拖拽的叠加内容（标题、时码、倒计时、图片）。
NDI 广播
主路 / 副路 / 第三路各自一路 NDI 源，分辨率可选，网卡适配器可指定（网卡切换需重启软件生效）。
多显示器
枚举系统显示器，指定哪个屏输出哪路画面，支持全屏与独立窗口两种形态。
叠加层编辑器
可视化添加文本、图片、时码与倒计时元素，拖拽定位、按对齐方式吸附； 单个元素可弹出为独立窗口，方便放到第二块屏。
纯叠加输出
只输出叠加层（透明或纯色底），交给外部切换台 / 合成软件叠加，避免二次压缩。
静帧与视频叠加
导出静帧（单帧或批量）与视频时可选是否烧入叠加层，静帧还可叠加时码水印作为留档。
视频后端
视频解码与渲染走独立进程（libmpv 系），主界面卡顿不会带崩画面输出。
控制协议：OSC / MIDI / Art-Net / Pixera
既能被别人控制（收到就动作），也能控制别人（到点发消息）。
OSC
- 收发一体：UDP（可选 TCP framing），默认端口 3037，可绑定指定网卡。
- 入站自动打点：收到约定地址即打一个 Cue，适合灯控台推进。
- Cue 携带 OSC：每条 Cue 可带自定义消息，到点按延时发送。
- 预设库与日志台：常见设备一键套用预设，收发内容在日志台里逐条可查。
MIDI / Art-Net / 外部联动
- MIDI 输入触发：按键、Note、CC 触发播放或打点，可做学习。
- MIDI 输出反馈：状态变化回送控制台，指示灯与软件同步。
- Art-Net：除时间码外，也用于与灯光网络共处同一网段。
- Pixera 联动：通过 Pixera 原生 API 建 Cue、设编号、取时间线信息。
录制与自动打标签
彩排录一份、演出留档，录下来的文件可直接拖回轨道比对。
录制即建轨
点录制会新建一条以本地时间命名的轨道（如 2026-10-26 17:09:01），录完自动挂到这条轨上 并生成波形，可立刻回放核对。
预览窗与电平
录制同时弹出预览窗，左上角红点 + 计时；下方 L / R 电平表是只读仪表， 用于确认麦克风与线路是否真有信号。
编码与文件
默认 H.264 + AAC 的 MP4，分辨率与画质可分档；未启用专业录制通道时自动回退到 ffmpeg 链路，保证仍有文件产出。
热启动
预热编码器，避免起录瞬间丢帧；录制中可以暂停 / 继续，状态在状态栏以 REC 角标常驻。
录制中打标签
录制时按快捷键直接打 Cue，可自动带默认类型与命名规则，不必事后补点。
OCR 识别命名
框选画面区域做文字识别（提词器、计时器、字幕条），命中的文字直接作为 Cue 名称； 识别区域与模板可保存复用，也能先"测试识别"再启用。
批量导入与素材维护
导演组给的 Cue 表通常是 Excel 导出的表格，导入要能一次吃多个文件。
Cue 表导入
- 格式：CSV、TSV、TAB、TXT（按扩展名判定分隔符）。
- 列匹配：表格列与字段逐一映射，映射可存成预设反复使用。
- 批量：一次选多个文件，逐文件套默认映射导入到目标轨，状态栏给逐项进度与失败原因。
素材与工程
- 兼容原版工程：可直接导入 CuePoints v2 的
.cptsp工程，自动解密并映射到本软件模型。 - 缺失素材：扫描工程引用的媒体，逐条重新定位或批量替换。
- 媒体升级：老工程里的 WAV 可批量转成同名 MP3，原文件保留、失败逐条报告。
导出格式清单
Cue 表导出分两类：模板驱动的表格（列顺序与表头可改）和针对具体设备的专用格式； 媒体产物另算一类。
| 格式 | 典型用途 | 说明 |
|---|---|---|
| Full Export | 完整字段留档 / 交给制作方 | 含位置、淡入淡出、备注、类型等全部列 |
| Generic CSV | 再加工、导入其他软件 | 精简列，字段名稳定 |
| Reaper CSV Markers | 音频工作站里对标记 | REAPER 标记 / 区域导入格式 |
| MagicQ | ChamSys MagicQ 控制台 | Cue 编号与时间列 |
| ETC Eos Cuelist Only | Eos 家族 Cue 列表 | 仅 Cue 列表部分，可再导入 Eos |
| Disguise TAB Markers | disguise 媒体服务器 | TAB 分隔标记表 |
| InqScribe TAB | 采访 / 转写字幕对点 | 帧分隔的时间格式 |
| Vista | Jands Vista | 全字段加引号，避免解析歧义 |
| 格式 | 目标系统 | 文件 |
|---|---|---|
| Eos ASCII | ETC Eos / Ion | .txt |
| Hog 4 Cuelist XML | High End Hog 4 | .xml |
| grandMA2 / grandMA3 | MA 系列（含非法字符清洗） | .xml / .txt |
| Adobe CC Markers | Premiere Pro / After Effects 序列标记 | .xml |
| CuePilot | CuePilot 时间线 | .cue（JSON） |
| QLab 4 / QLab 5 | QLab（AppleScript 批量建 Memo） | .applescript |
| Unreal CSV | Unreal Engine 过场 / Sequencer | .csv |
| 产物 | 格式 | 选项 |
|---|---|---|
| 音频母版 | .wav |
把三路槽位混成一个文件，可选范围与时间码 |
| 带叠加的视频 | .mp4 |
可选是否烧入叠加层 |
| 静帧叠加 | .png / .jpg |
单帧或批量，可加时码水印 |
| 录制文件 | .mp4（H.264 + AAC） |
分辨率与画质分档，可暂停 / 继续 |
导出模板是外部文件：替换模板即可增删列或调整表头，无需改程序。
工程、备份与诊断
演出工程不大，但丢一次就够难受，所以保存、备份、日志都做成默认可靠。
单文件工程
工程为一个 .cpc 单文件（内嵌 SQLite），可直接拷给同组人员；
标题栏用 * 标记未保存状态，最近使用可回溯。
自动备份
后台按间隔生成快照并保留 N 份，位置可选工程子目录或自定义目录；保存走临时文件后原子替换， 无改动不写盘。
撤销与重做
打点、移动、改属性都进撤销栈，误操作可逐步回退。
运行诊断
主线程卡顿日志与运行日志落在本地；--io-probe 可一次列出
MIDI / LTC / NDI 的实测状态。
离线授权
授权与机器码绑定，激活不需要联网；换机时在管理账号里解绑旧机器码即可。 详见 激活步骤。
更新与版本
可手动检查新版本，安装包从本站在线下载；更新不改变已有工程与偏好设置。