CJK 字幕安全烧录：字体缺字、UTF-8 预检与解码帧验收

01 · 环境与输入

• 将原创 SRT、Node 脚本、未修改 Noto Sans CJK SC Regular OTF 与 OFL/版权声明下载到同一目录。再分发字体时保留其独立许可。

• 准备 Node.js 24 和已有带 libass/libx264 的 FFmpeg 6.0；配方不安装或再分发 FFmpeg。本次实际使用 Node v24.14.0、libass 0.17.0 和字体 2.004。

• 选择新的本地输出目录。样例为静音、1280×720、3.6 秒短片；该脚本不是完整视频交付导出器。

• 先读懂四条预期字幕。SC 字体有非零码点映射，不等于采用日语、韩语或繁体中文场景偏好的地区字形。

02 · 执行与检查

1. 01 · 保留准确字体，先核对字幕文本

   NotoSansCJKsc-Regular.otf 必须和 OFL.txt、FONT-COPYRIGHT.txt 一起保存。官方 Sans2.004 未修改字体通过 SHA-256 与字体族名固定。先以 UTF-8 打开 sample.srt，对照四条正文和时间范围，再开始渲染。解析器明确拒绝标记、重叠字幕和变体序列，不猜未知编码，也不会悄悄改写字幕。 SRT 起止必须按 10 毫秒对齐，因为 ASS 使用厘秒精度；更细的数值会被拒绝，不直接取整。

   node --version

   node run-preflight-tests.mjs

2. 02 · 将码点覆盖当作一项预检

   subtitle-check.mjs 读取字体 Unicode cmap format 4/12，检查非零且在范围内的字形 ID。本例 43 个不重复非空白码点均有映射。22 项实跑场景包括已知缺字、字体缺失/修改、错误 UTF-8/UTF-16、重叠、危险路径和参数边界。覆盖不是整形或排版证明：错误的地区字形或难读布局，仍可能有有效映射。

3. 03 · 用固定滤镜文件名实际烧录

   传入 FFmpeg 绝对路径和新输出目录。脚本生成原创几何测试片，把支持的纯文本 SRT 转成固定样式 ASS，再使用 libass 烧录。用户路径先复制成临时目录里的常量文件名，不直接拼进滤镜表达式。子进程使用 shell:false，编码/滤镜各一个线程，日志有上限，单进程限时一分钟。本次 macOS 字体提供者为 CoreText；日志确认加载配套字体并选中其 PostScript 字体名，但不宣称完全隔离系统字体。

   node run-recipe.mjs --ffmpeg /absolute/path/to/ffmpeg --out ./fresh-output

   node run-recipe.mjs --ffmpeg /absolute/path/to/ffmpeg --out ./another-fresh-output --input ./sample-source.mp4 --srt ./sample.srt --font ./NotoSansCJKsc-Regular.otf

4. 04 · 解码后读回文字，再保存执行回执

   逐一对照 keyframe-01 至 keyframe-04 与预期的中英、简体/繁体、日语/韩语字幕。脚本实际解码 PNG，并和无字幕源片比较字幕区域像素；这种变化不证明字形身份。还需查看真实字体选择日志和覆盖报告。回执包含 7 项媒体断言、22 项预检、文件尺寸/哈希和真实工具版本。本次记录了有限目视读回，地区排版与其他字幕仍需独立审核。

03 · 验证输出

• sample.srt 严格按 UTF-8 解码，字幕时间有序、有效、不重叠，22 项预检通过。
• 配套字体字节与固定 SHA-256 一致，再分发时保留 OFL 许可和版权声明。
• 本例 43 个非空白码点均有有效非零字形 ID，不因此推导全 Unicode 或地区字形覆盖。
• 真实 FFmpeg 烧录完成，日志记录选中的配套 Noto 字体；缺字诊断或无法确认字体选择时失败。
• 四张指定时刻关键帧均实际解码，且字幕区域相较源片有测量得到的像素变化。
• 目视核对预期文字、方框缺字、裁切和标点；PNG 非空或像素变化不能单独完成验收。
• 回执标识实际版本与输出哈希，明确没有运行生产/提供商任务，区分本地字幕渲染和生成质量证据。

查看实际执行记录

04 · 边界与排错

还没渲染，文本已经出现替换符。

从源文件明确导出 UTF-8，再跑预检；不要只改编码标签而保留未知字节。

覆盖报告发现某个 U+ 码点缺字。

找到准确码点，选择合法且覆盖它的字体，重新核对族名、哈希、渲染和画面。不接受未记录的系统回退。

字体有字形，但与目标语言习惯不符。

把默认码点覆盖与地区 CJK 字形分开；选择对应语言版本，并由熟悉该语言排版的人核对。SC 样例不证明地区字形正确。

渲染成功退出，但看不到字幕或被裁切。

查看实际时间范围、字体选择诊断和解码帧。适配真实短片前，先核对 1280×720、3.6 秒示例限制与字幕位置。

命令被路径、字体或已有输出检查拒绝。

使用新的受控目录、原配字体、普通本地文件和 FFmpeg 绝对路径。脚本拒绝覆盖、软链接、穿越和网络输入。

样例正常，但完整交付会丢掉音频或 3.6 秒之后内容。

不要原样用示例脚本交付完整视频。另行验证导出命令中的时长、音频映射、尺寸与字幕安全区域。

201–209 毫秒的字幕在转换前被拒绝。

使用按 10 毫秒对齐且时长为正的起止。示例不对毫秒边界直接取整，避免两端都折叠成 ASS 的 0.20 秒。

将源字幕、准确字体/许可、渲染日志、四张解码帧与执行回执一起保存。配套哈希只标识本次本地运行，不同平台/构建可能改变输出字节。没有宣称模型生成、生产计费或搜索流量结果。

文件与依据

• Noto CJK official Sans2.004 license
• Noto CJK official language/font download guide
• FFmpeg official subtitle and ASS filter documentation
• OpenType official cmap specification