操作手册
本手册按"从零到一场演出"的顺序编排：先装好并激活，再认识界面，然后导入媒体、打 Cue、接时间码， 最后录制或导出给灯光台／视频服务器。每一节都可以单独查阅。
适用于 CueWrie 1.0 及以上 · Windows 10/11 x64
01安装与激活
安装
- 从下载页取得
CueWrie-Setup-<版本>.exe，双击安装。 - 默认安装到
C:\Program Files\CueWrie，可改路径；安装完勾选"立即启动"。 - 首次启动会弹出 3 步上手指引，关掉后再也不会出现。
激活
- 主界面「帮助 → 关于」里可以复制本机机器码；也可以在激活窗里直接看到。
- 打开「文件 → 激活」或点击提示弹窗中的输入激活码，粘贴形如
CPCN-XXXXX-XXXXX-XXXXX-XXXXX的激活码。 - 激活成功后会显示「许可有效（pro）· 剩余 N 天」，状态栏的红色角标消失。
激活码与机器码绑定。换电脑时先在旧机「账号 → 释放本机许可」，再在新机激活；
或者把新机器码发给客服在后台重置。
试用期 14 天，到期后进入只读模式：仍可打开工程、播放、查看 Cue，但录制／保存／导出需要有效许可。
02界面总览
主窗口分四块：顶部菜单、左侧轨道栏、中间时间线、右侧 Cue 表；底部是传输控制与状态栏。
| 区域 | 作用 | 要点 |
|---|---|---|
| 菜单栏 | 文件／编辑／工具／轨道／视图／窗口／协作／帮助 | 几乎所有功能都有菜单入口，菜单右侧显示快捷键 |
| Cue 类型胶囊条 | 时间线正上方，显示 7 类 Cue 的颜色与顺序 | 可拖动排序、点击高亮同类型；Ctrl+Alt+L 控制标签显隐 |
| 左栏 TRACKS | 轨道列表 + 每轨三路媒体槽（主／备／第三路） | 支持拖文件进来直接建轨；右键可改色、重命名、删除 |
| 时间线 | 波形 + Cue 标记 + 播放头 | 滚轮缩放、拖动平移；Cue 可直接拖动微调 |
| 右侧 Cue 表 | 逐条列出时间、类型、标签、OSC、备注 | 双击单元格就地编辑；列宽可拖拽，列序可拖动重排 |
| 传输条 | 播放／暂停／停止、进度、速率、A-B 循环、LTC 输出 | 红色键是录制；空格 播放、Esc 停止 |
| 状态栏 | 操作回执、时码状态、许可、电平、音频设备 | 长文本自动省略，鼠标悬停看完整内容 |
03轨道与媒体
新建与排序
- 左下「＋ 新建轨道」或 Ctrl+N 建轨；F2 重命名。
- 按住轨道上下拖动可重排（有插入指示线与滑动动画）。
- 左栏可整体折叠，给时间线腾出高度（工具栏或「视图」菜单）。
三路媒体槽
每条轨道有主路 / 备路 / 第三路三个媒体槽，用途是同一个 Cue 触发多画面或多轨音频的备份与切换：
- 把文件拖到对应行即可载入；时长、波形、缩略图自动生成。
- 槽上右键：替换、设为主路、移除、在资源管理器中显示。
- 缺失文件会在行上标红，用「工具 → 媒体缺失管理」批量重新定位。
视频与音频可以混放：
.mp4 .mov .mkv .mxf .wav .mp3 .flac 等都支持。
载入后状态栏会显示"解码中 / 已就绪"。
04打 Cue 点
三种打点方式
| 方式 | 操作 | 适用 |
|---|---|---|
| 实时打点 | 播放时按 1–9，就在播放头位置落一个对应类型 Cue | 边看边打，最快 |
| 点击打点 | Cue 类型胶囊条上按某类型，再点时间线位置 | 精确定位 |
| 手输时间码 | 选中 Cue 后 Enter，输入 HH:MM:SS:FF | 已有台本时间 |
Cue 字段
- 类型：决定颜色与默认 OSC 消息；在「工具 → 自定义 Cue 类型」里可增删改。
- 标签：显示在 Cue 表与时间线上，可留空。
- 淡入（Fade）：给灯光／视频的过渡时长，单位秒。
- OSC / 备注：勾选后按类型消息或自定义消息发送。
- TrigDelay：相对 Cue 位置的延迟触发（± 帧）。
批量操作
- 框选多条：拖动选择框；Ctrl+A 全选。
- Del 删除、Ctrl+D 复制、方向键 ±1 帧微调。
- 右键菜单支持"按类型筛选""跳到同类型下一条""锁定类型"。
05播放与传输控制
| 控件 | 说明 |
|---|---|
| 播放 / 暂停 | 空格 切换；暂停时画面冻结在当帧 |
| 停止 | Esc，回到起点（可在设置里改成"停在当前位置"） |
| 速率 | 0.25×–2×，非 1× 时时间线上方出现角标提醒 |
| 步进 | 按帧前后移动，可手输步长 |
| A-B 循环 | 设 A、设 B、开关循环；适合反复排练一段 |
| 电平表 | OUT 为输出峰值 dBFS，无输出显示 −∞ |
06时间码（LTC / MTC / Art-Net）
作为主时钟输出
- LTC：设置中心 → 时间码 → 选输出设备与声道，传输条右侧可调输出电平。
- MTC：设置中心 → MIDI → 选输出端口（默认跳过 Microsoft GS Wavetable）。
- Art-Net：设置中心 → 时间码 → 填流 ID，用于灯光网络内同步。
作为从时钟跟随
- 接外部 LTC：设置中心选输入设备，状态栏显示锁定状态与偏差。
- 接 MTC：选输入端口，支持 24/25/29.97/30 fps。
- Art-Net 输入会在状态栏显示最近一次收到的时间码。
帧率必须与素材一致（常见 25 fps 与 24 fps 混用会整体漂移）。改帧率后请重新对一次 Cue。
07录制与叠加烧录
- 传输条红色键 = 开始录制；录制中红点闪烁，右下角显示计时与预估大小。
- 录制会自动新建一条以时间命名的轨道，停止后把文件挂回该轨道并生成波形。
- 设备与码率在「工具 → 录制设置」：摄像头、分辨率、帧率、像素格式、左右声道设备与增益。
- 需要把叠加层烧进画面：勾选"烧录叠加（bake overlay）"，并指定输出路径。
暂停后继续录会写成同一个文件的后续片段；终止（不保存）会丢弃当前片段。
录制依赖随包的
CuePointsRecorder 边车进程（安装目录下）。若被安全软件拦截，
可在「工具 → 边车状态」查看并重启。
08NDI 输出
- 「视图 → NDI 输出」勾选要输出的画面（主路／备路／第三路／整窗）。
- 设置中心 → NDI：选网络适配器、分辨率、帧率；改分辨率会让正在输出的源重启。
- 接收端（vMix／OBS／Resolume／Disguise）在同一网段即可看到源名
HOSTNAME (CueWrie …)。
切换网络适配器需重启程序（NDI 运行库在启动时读取环境变量），这是已知限制。
09OSC 与 MIDI 控制
OSC 输出（CueWrie → 灯光台／QLab）
- 设置中心 → OSC：填目标 IP 与端口，勾选"启用"。
- 每个 Cue 类型有默认消息模板，例如
/cue/go、/cue/fire <id>；单条 Cue 可覆盖。 - OSC 日志台（工具菜单）实时显示发出的每条消息，便于对码。
OSC 输入（灯光台 → CueWrie）
- 设置中心 → OSC → 接收端口；支持
/cue/play、/cue/stop、/cue/goto i f。 - Server Mode 打开后会监听并回显状态，适合被主控台编排。
MIDI
- MTC 与 MMC 都可收发；设备选择见设置中心 → MIDI。
- 用 IAC／loopMIDI 建虚拟端口可做本机联调。
10叠加层编辑
- 「工具 → 编辑叠加项」打开编辑器：10 个固定槽位，每槽可选时间码／Cue 标签／自定义文本／图片。
- 定位用九宫格（左上、上中、右上…），字号、颜色、透明度、阴影可调。
- 「工具 → 叠加窗口」单独开一个透明置顶窗，用于现场监视或录制烧录。
- 整套设置可存成预设，下次一键套用。
11导入与导出
导入 Cue 表
- 「文件 → 导入 Cue 表」选 CSV／TAB。
- 在列映射向导里把源列拖到字段（位置／时间码是必需项），右侧可预览前几行。
- 选择目标轨道 → 开始导入；冲突时可选择追加或覆盖。
- 可从视频画面 OCR 读台本文字自动生成 Cue（工具 → 从视频读取 Cue）。
导出格式
| 目标 | 文件 | 说明 |
|---|---|---|
| 通用 | CSV / TAB | 任意表格软件可读 |
| ETC Eos | .csv | 按 Eos 的 cue/时码列 |
| grandMA2 / MA3 | .xml | Timecode 事件 |
| HOG 4 / Vista / ChamSys | .csv / .txt | 控制台时间码表 |
| Avolites / Reaper | .txt / .csv | 标记表 |
| QLab | AppleScript | 一键生成 cue |
| Adobe CC（Premiere/AE） | .xml | 标记导入 |
| Disguise / Pixera | .csv / Live Link | Pixera 走网络直发 |
| Unreal Engine | .py | Python 脚本写入 Level Sequence |
| CuePilot / InqScribe | .json / .txt | 播控与台本工具 |
导出前会做一次校验：空类型、重复时间码、超范围帧会列出来，可取消或强制继续。
12协作与云端工程
- Members and Sharing：把当前工程共享给团队，生成加入码；成员凭码加入。
- Start Cloud Project：以云端工程为源，多人同时维护同一份 Cue 表。
- Sync Notices：显示合并结果与被本地保留的改动，最新的在最上面。
- Permissions：按 Cue 类型分配"可见／可编辑"权限，避免误改别人负责的类型。
账号在「协作 → 账号」里注册／登录；登录后可在多台机器查看自己的设备列表并释放许可。
13许可与只读模式
| 状态 | 表现 | 可做什么 |
|---|---|---|
| 有效（Active） | 状态栏"许可有效 · 剩余 N 天" | 全部功能 |
| 宽限（Grace） | 到期后 3 天内离线也能用 | 全部功能，尽快联网复核 |
| 只读（到期／被锁／未激活） | 居中提示窗 + 状态栏红字 | 打开、播放、查看；录制／保存／导出／对外输出被拦下 |
到期后不会锁死软件：演出前仍可打开旧工程核对 Cue、导出台本给同事，只是不能再产出新内容。
正在推流的 NDI 不会被强停，避免现场黑屏。
14设置中心
左侧 8 个页签：外观／音频输出／时间码／MIDI／OSC／NDI／录制／Cue 点。
- 改动即时生效（MIDI 端口切换会重开设备；LTC 正在输出会自动重启输出流）。
- 所有设置写在
%APPDATA%\CuePointsCN\preferences.json，换机时可直接拷。 - 「工具 → 备份」可把工程与设置一起打包备份。
15快捷键
| 操作 | 快捷键 |
|---|---|
| 播放 / 暂停 | 空格 |
| 停止 | Esc |
| 新建轨道 | Ctrl+N |
| 打开工程 | Ctrl+Shift+O |
| 保存 / 另存为 | Ctrl+S / Ctrl+Shift+S |
| 重命名轨道 | F2 |
| 全选 Cue | Ctrl+A |
| 删除 Cue | Del |
| 打点（类型 1–9） | 1 … 9 |
| 标签显隐 | Ctrl+Alt+L |
| 设 A / 设 B / 循环 | [ / ] / \ |
全部动作快捷键可在「设置 → 快捷键」里改，改完写入偏好。
16排错速查
| 现象 | 原因 | 处理 |
|---|---|---|
| 点录制没反应 | 没有可用摄像头／麦克风，或未选设备 | 「工具 → 录制设置」确认设备；看「边车状态」是否在运行 |
| 录出来没声音 | 声道设备选错 | 设置里分别选左／右声道设备与通道 |
| 播放只有静帧、时长 0 | 文件损坏或解码失败 | 用资源管理器试播；换文件或重新载入 |
| 时间码不锁 | 帧率不一致／电平过低 | 统一 25/30 fps；调 LTC 输入电平 |
| NDI 接收端看不到 | 不同网段／防火墙 | 同网段；放行 CueWrie 与 NDI 端口 |
| OSC 发了没反应 | IP／端口错，或灯台未开监听 | 看 OSC 日志台是否显示已发送；对端抓包确认 |
| 激活失败 | 码过期／机器码不匹配／本机时间偏差 >5 分钟 | 校时后重试；或把机器码发客服重置 |
| 许可显示"已失效" | 本机许可与服务器密钥不匹配 | 用新激活码重新激活（旧 token 会自动清除） |
17常见问题
换电脑怎么办？
旧机「账号 → 释放本机许可」，新机重新激活；额度用完请联系客服在后台重置。
能不能离线用？
可以。许可在本地用公钥验签，离线也能用；到期后有 3 天宽限，最好定期联网一次。
工程文件在哪？
你保存的位置（默认 文档\CueWrie）。工程是 SQLite 单文件，可直接拷贝给别人。
能导出给哪些控制台？
Eos、grandMA2/3、HOG4、Vista、ChamSys、Avolites、QLab、Adobe CC、Disguise、Pixera（Live Link）、Unreal、CuePilot、InqScribe，加上通用 CSV/TAB。
支持多路同时播放吗？
支持。每条轨道有主／备／第三路，可在设置里分别开关是否允许同时出声。
为什么切换 NDI 网卡要重启？
NDI 运行库在进程启动时读取网络配置，这是它的限制，不是软件 bug。
还有问题？把复现步骤、截图与「关于」里的版本号／机器码发到
联系我们，通常 1 个工作日内回复。