章节标题带井号或等号就少半句，怎样检查FFmetadata转义

章节标题含井号、分号、等号或反斜线时，FFmetadata需要按自己的语法转义。它不是CSV，也不是JSON；照搬其他文件格式的引号规则可能让标题被截断或改变，最可靠的判断是封装后读取原始文字是否往返一致。

这组文件怎样比较

本例原创标题同时含几种特殊字符，以title.txt保存未转义原文，再生成正确转义的FFmetadata。标题进入两秒MKV的章节，随后导回metadata。输入串、写入文件和导回文件都保留，方便区分语法表示与真正标题内容。

按原始结构逐项检查

1. 先把标题当Unicode文字读取，确定哪些字符需要语法转义，再逐字符处理。反斜线自身也要考虑，不能先替换井号后又把新增反斜线全部重复替换；处理顺序错误会使文件看似转义更多，实际解出的文字反而不一致。

2. 将处理后的值写在title等号右侧，保留正确文件头与章节节名。不要通过拼接shell命令把复杂标题再过一层解释，本题直接写文本文件并将路径交给FFmpeg；这样可避免引号在命令行和metadata之间发生两次不同的转义。

3. 封装后用show_chapters读取title，与title.txt逐字符比较，再查看工具导回的FFmetadata。导回文件可能使用不同的时间基或附带encoder字段，只要标题解码后相同即可；不要要求整份metadata字节完全相同来证明文字没有损失。

容易误读的地方

一个反例是只检查导回文件中出现“第一章”，便忽略后面等号与反斜线是否还在。另一个是把开头井号的标题行写成独立行，结果成了注释。应比较完整字符串、长度和关键字符位置，不能以一个子串匹配替代全文校对。

下载与本地读回

escaped.ffmeta、generation.json、observed.csv、observed.json、roundtrip.ffmeta、source.mkv、title.txt、titled.mkv。

下载全部附件到同一个独立目录，用 python verify.py 运行本题独立核验脚本。依赖为Python 3.12.4、PATH中的FFmpeg及ffprobe 8.0.1；程序不联网、不连接设备，读取本题文件并在终端输出检查结果。本地实际执行回执保存实际命令、退出码和完整输出。

本地脚本确认章节读回标题与原始文本完全一致，并输出真实导回metadata，源片和结果都通过完整解码。没有测试第三方编辑器再保存时是否保留同一转义方式；若之后经GUI修改，仍需重新读回，而不能沿用本轮结论。

命令已在原创短片上实际执行并读回文件。官方文档为滚动版本，本文所列选项已用本地8.0.1确认；未测试目标硬解、网络起播或现场实时性能。

把结果带回交付

交付中把人类可读的标题清单与用于导入的转义文件分别命名，避免编辑人员直接修改转义串时误删符号。若标题需要换行，必须按规范另处理换行转义及目标界面呈现；本例没有把单行测试扩大为所有多行标题支持保证。

相关背景见展厅视频编码与封装怎么选（H.264 / H.265 / HAP），还可从多媒体播放专题继续查找文件处理方法。需要核对实际工程的接收条件时，可携带本题文件与读回结果进行工程对接咨询。

一级依据

• FFmetadata对等号、分号、井号、反斜线和换行等字符规定反斜线转义。

来源核对日期：2026-10-24。引用支持文件机制；原创输入的本地结果不代表客户素材或现场系统已经通过验收。