五个步骤
-
安装
运行
CuePointsCN-Setup-1.0.0.exe，按向导走完即可。 向导里三个可选勾选：桌面快捷方式、关联.cptsp工程文件、 安装 FlexASIO（MIT 许可的通用 ASIO 驱动）。机器上已有 ASIO 驱动时，FlexASIO 会自动不勾。完成标志：开始菜单出现 CuePointsCN，启动后能看到启动屏与版本号。
-
激活（机器码 + 激活码）
打开「帮助 → 许可与激活」，窗口里显示本机机器码（形如 XXXX-XXXX-XXXX-XXXX）， 点「复制机器码」把它交给交付方；收到激活码后，在同一窗口粘贴并确认。 整个过程不需要联网，授权文件保存在本机。
完成标志：许可状态显示「已授权」，到期日与授权时长一致。 详细流程见 激活引导。
-
打开工程
三条路径任选：新建工程（可从模板起步）、打开已有
.cpc工程、 或把 Cue 表拖进来（CSV / TSV / TAB / TXT，导入时做列匹配，映射可存成预设）。 也能直接导入原版 CuePoints v2 的.cptsp工程。完成标志：轨道列表出现媒体、时间线画出波形、Cue 列表按位置排序。 媒体找不到时会提示缺失，可在「缺失素材」里重新定位。
-
录制
先在「设置 → 录制」选好视频设备、分辨率与画质。点工具栏红点开始录制： 软件会新建一条以本地时间命名的轨道，并弹出预览窗（左上角红点 + 计时，下方 L / R 电平表）。 状态栏同时出现 REC mm:ss 角标。
完成标志：停止后提示「已保存：record_YYYYMMDD_HHMMSS.mp4」， 文件自动挂到那条新轨并生成波形，可以直接回放核对。
-
导出
走「文件 → 导出」：Cue 表按模板导出（Full / Generic CSV / Reaper / MagicQ / Eos / Disguise / InqScribe / Vista），或选专用格式（Eos ASCII、Hog 4 XML、MA2/MA3、QLab AppleScript、 CuePilot、Adobe CC、Unreal CSV）。媒体产物可导音频母版 WAV、带叠加视频与静帧。
完成标志：目标文件出现在你选的目录，格式清单见 功能页的导出格式表。
设置与快捷键
设置中心按页签分组，改动即时生效并持久化，不需要重启（网卡适配器除外）。
设置页签
常规、轨道、音频输出、时间码、OSC、NDI、叠加层编辑器、录制、备份、快捷键、侧栏、标记类型。 右下角有「恢复默认值」，提交前可「重新载入」放弃改动。
快捷键
所有键位都在「设置 → 快捷键」里列出，可自行改；改完会做冲突检测，也能导入导出整套键位 给同组的其他机器复用。
端口与本地路径速查
现场排障时最先要确认的几项。
| 项 | 默认值 | 说明 |
|---|---|---|
| OSC | 3037 / UDP |
可换端口与网卡；可选 TCP framing |
| Art-Net 时间码 | 6454 / UDP |
流号按"端口 + 流号"偏移，多流互不干扰 |
| 录制输出 | %USERPROFILE%\Videos\CuePointsCN\ | 文件名为 record_日期_时间.mp4 |
| 偏好与缓存 | %APPDATA%\CuePointsCN\ | 偏好 JSON、许可文件、波形缓存索引 |
| 诊断日志 | %TEMP%\cuepoints-*.txt | --io-probe / 录制诊断的输出 |
| NDI | 自动发现（无需端口） | 网卡适配器改动需重启软件生效 |
常见问题
每条都给出"先查什么、再做什么"，避免在演出前瞎试。
激活失败怎么办？
先核对三件事：① 激活码是否对应这台机器的机器码（换过硬件就会变）； ② 激活码是否已过期或被解绑；③ 是否粘贴时多了空格或换行。
仍然失败时，把「许可与激活」窗口里的机器码、激活码尾四位、软件版本号一起发给交付方， 我们能在管理后台看到该机器码的绑定与到期状态。
换了新机器（或重装了系统）怎么继续用？
在管理后台解绑旧机器码（年付每年 1 次、永久每年 2 次免费），然后在新机器上 「帮助 → 许可与激活」复制新机器码重新激活。旧机器上的授权随即失效。
重装系统通常不会改变机器码；更换主板、系统盘会被识别为新机器。换机额度用完可以单独购买。
离线宽限期是多久？断网会影响使用吗？
已激活的设备断网完全不影响使用：授权在本地校验，光靠离线就能确认状态， 所以演出场地没有网络也不会被拦。
授权到期后仍有一段宽限期（默认 7 天，可在授权策略中调整），宽限期内功能不受影响； 请在宽限期内续费，续费后时长直接叠加到原机器码，无需重新激活。
端口被占用 / OSC 收不到消息
同一台机器上跑两套播控软件时，3037 与 6454 会撞。先用命令查占用进程：
netstat -ano | findstr :3037 netstat -ano | findstr :6454
然后在「设置 → OSC」把端口改到空闲值（例如 3040），并在控制台侧同步改； Art-Net 时间码改端口时注意流号也会按偏移变化。改完发送一条测试消息， 在 OSC 日志台里应能看到收发记录。
没有声音 / LTC 时码收不到
时间码类问题先用自带诊断跑一遍，它会列出 MIDI 端口、逐条返回码，并试播 2 秒 LTC：
CuePointsCN.exe --io-probe 2
报告会写到 %TEMP%\cuepoints-io-probe.txt。
常见原因是没在「设置 → 时间码 / 音频输出」里选设备：LTC 输出未指定时会回退到系统默认输出，
而 LTC 输入必须明确选到接了时码的那一路。
录制没有文件 / 文件是静音
先看录制预览窗的 L / R 电平表有没有起伏：平坦说明采集端没信号，检查设备选择与系统隐私设置里 是否允许应用访问摄像头与麦克风。
文件默认落在 %USERPROFILE%\Videos\CuePointsCN\，
停止后会提示「已保存：record_….mp4」。若提示失败，请把
%TEMP% 下的录制诊断文件一并发给我们。
NDI 接收端找不到本机输出的源
确认接收端与本机在同一网段、NDI Runtime 已安装；多网卡机器要指定适配器， 而适配器设置在重启软件后才会生效（这是 NDI 运行库在初始化时读环境变量的限制）。
改分辨率会立即重开正在推流的通道，状态栏会提示「已重开 N 路推流」。
时间码对不上 / 画面比声音早一点
先确认三处帧率一致：工程 / 轨道的帧率覆盖、外部时码源的帧率、以及导出时选的时间码格式 （29.97 要区分丢帧与非丢帧）。
再用「同步校准」量一次漂移，把量出的偏移写成轨道偏移； 长距离线缆或采集卡引入的固定延迟，用「音频输出延迟」补偿。
升级安装会覆盖我的设置和工程吗？
不会。覆盖安装保留偏好、许可与工程文件；工程与偏好都在用户目录下，不随安装目录卸载删除。 升级前建议把重要工程另存一份快照（软件本身也有自动备份）。