# 云映 VTT 注释块练习：分清 NOTE 说明与屏幕提示

语言：zh-CN
原文：[云映 VTT 注释块练习：分清 NOTE 说明与屏幕提示](<https://allluckly.cn/guides/icouldplay-webvtt-note-block-boundary/>)
中文：[中文 HTML](<https://allluckly.cn/guides/icouldplay-webvtt-note-block-boundary/>)
English: [English HTML](<https://allluckly.cn/en/guides/icouldplay-webvtt-note-block-boundary/>)
发布于: 2026-11-07T00:00:00+08:00
内容更新于: 2026-11-07T00:00:00+08:00
署名：Bison

用一份带NOTE的自制字幕检查空行边界，避免把编辑注释当台词，并用无注释副本对照。

整理字幕时，可能希望记下“这段已核对”而不让观众看到。WebVTT的NOTE块用于文件注释，但正确边界和播放器实际解析都需要核对。本篇把编辑工作留在外部文本工具，用云映观察自制样本；不声称应用新增注释编辑、审校协作或自动隐藏任意文本的功能。

## 准备不含私人资料的注释内容

先复制一份已有可播VTT，或为至少十秒自制片段新建练习文件。把想记的内容压缩为“practice checked”这样的中性说明，不把私人姓名、服务器地址或账号塞进字幕。注释只是通常不显示的文件文本，不是保密容器；发送整个文件时它仍随文件一起交出去。保存原字幕和第一份无注释样本，后续对照仅改变注释块，不改变视频和时间。

## 按空行建立最小文件

下面的NOTE块位于文件头和第一条提示之间，并以空行结束。照录为纯文本，不把三个反引号写入文件，也不要把NOTE与后面的时间行连在同一块。两条提示时间不交叠，便于把格式错误和同时出现分开检查。

```vtt
WEBVTT

NOTE practice checked
This comment is not a caption.

00:01.000 --> 00:03.000
Open the notebook

00:05.000 --> 00:07.000
Keep the original
```

## 先在文本里标明三种角色

打开外部编辑器，依次指出WEBVTT头、NOTE说明和带时间的两条提示。NOTE不是普通字幕条目的名字，因为后面跟的是注释块内容；也不能把时间行放在注释里后期待仍按原时间出现。给笔记列出两条应见台词与一段不应作为台词显示的文本。这个预期来自格式规则，实际应用是否如预期解析还要回放验证，不把文件保存成功当成播放器检查通过。

## 顺播检查正文与中间空白

在云映载入练习字幕，从开头到第八秒顺播。记录第一至第三秒和第五至第七秒看到什么，以及两段之间是否有残留注释。不要只在第六秒看到一句正确台词就判整份文件无误。若安装版本不接受该VTT，保留错误状态并回到已验证的入门文件，不把失败结果改写成注释一定可用。只用公开字幕选择入口，不寻找不明插件强行解析。

## 另存无注释副本做对照

复制文件后，仅删除NOTE行、注释正文和多余空行，保留头与两条时间提示。给第二份取不同名字，重新选中后播放相同区间，比较正文和时机。若第二份正常而第一份异常，回查块边界与所选文件；不能立即把所有差异归因应用不支持注释。不要通过重写成另一种字幕格式来做这一步，那会同时改变过多条件，丢掉本题要验证的边界。

## 排查被注释吞掉的条目

若第一条台词消失，检查NOTE之后是否缺少空行，以致时间和正文都落在同一注释块；若注释变成可见台词，检查是否误贴到某条时间行之下。保留错误文件为带标记副本，用修正后的另一份回放，不在唯一正式字幕上反复试错。更正后重新检查第二条也还存在，避免删注释时顺带删掉正常条目。记录具体哪一行被移动或补空行，比只记“重新保存好了”更能复现。

## 交付前检查文件而非只看画面

最后同时保存正确源文件、无注释对照、实际显示记录和当前安装版本。若准备发送字幕，用外部编辑器检查全部注释确实适合公开；屏幕上没显示不等于别人无法读取。恢复正式观看所需字幕，不让实验文件混入同名目录。[W3C WebVTT](<https://www.w3.org/TR/webvtt1/>)用于说明NOTE与空行边界，本文不提供隐私擦除保证，也不把静态文件检查说成全部播放引擎验收。

## 区分块起点和普通单词

本例的NOTE使用大写并位于一个新块的开头，后接空格和说明。不要把小写note或NOTES当成必然相同的语法，也不要把正文中一句“take a note”自动解释为注释。检查时保留原始大小写和行首位置，避免输入法自动替换符号。若想加第二段编辑说明，可以另建独立NOTE块并保留空行；本次先使用一块完成基线，不扩大成多块混排后再排查。

## 检查编辑器保存后的真实内容

某些编辑器会另存为带格式文稿，或显示扩展名却实际附加TXT后缀。保存后关闭并从文件位置重新打开，确认第一行、空行和时间箭头都仍为纯文本，再交给云映载入。不要只凭编辑窗口标题就认定正确文件已经写盘。若系统共享面板只提供预览，先核实最终导出的那个文件，而不是截图中的草稿；对照副本也各自检查，避免两个名称其实指向同一个未保存文档。

## 相关教程与资料

[参照短片](<https://allluckly.cn/guides/icouldplay-playback-reference-clip/>)、[字幕时间诊断](<https://allluckly.cn/guides/icouldplay-subtitle-offset-drift/>)。

资料核对：2026 年 11 月 7 日，依据 [云映官方 App Store 说明](<https://apps.apple.com/cn/app/id6755653178>)与 [Apple 公开版本查询](<https://itunes.apple.com/lookup?id=6755653178&country=cn>)，当前版本 1.1.1，最低要求 iOS / iPadOS 15.0。1.1.1 的公开更新列出 Kodi、OpenList / AList 与 S3 兼容存储，并改进来源切换及跳转后的字幕显示；本文按这些公开范围与现有播放能力组织任务，具体入口以安装版本为准。自制样本、手工记录与外部文件整理不是应用新增自动功能；未声称已完成真机或私人服务器实测。