JZSub：一键把视频链接变成最高画质 + 双语字幕 MP4（支持 YouTube / B站 / TikTok）

摘要

JZSub 是一个视频自动化处理工具：粘贴一个链接，自动下载最高画质视频、提取封面、生成 GPT 双语字幕并烧录成 MP4，覆盖 YouTube、B 站、Vimeo、TikTok 等平台。

把一个视频链接丢给 JZSub，它会自动帮你把最高画质的视频文件、视频封面、以及由 GPT 生成的中英双语字幕整合在一起，最终输出一份带字幕烧录的 MP4 文件，全程基本不用你动手。

此外，只要 yt-dlp 能识别的网站，JZSub 一般也能处理。不过具体能不能下载、能不能拿到字幕、需不需要登录，最终还是要看对应平台的规则。

极致画质：自动挑选平台上可用的最佳视频流和音频流，能无损封装的情况下直接封装成 MP4。
按需交付：通过 --deliver 参数，你可以选择四种交付方式——完整烧录版、只要视频（含平台原始字幕文件）、只要原始字幕、或者只要翻译好的双语字幕文件。
GPT 双语字幕：把字幕拆成紧凑的小批次进行翻译，批次之间会带上下文衔接，最后再按句子边界重新切分。原文保持原样不动，默认翻译成中文，也可以通过 --target-lang 指定日语、法语等任意语言。
字幕自动烧录：使用 MiSans 字体、底部双语堆叠排版、自适应竖屏布局、精确背景框、由 libass 渲染输出。
轻量运行：模型只读取紧凑后的字幕文档，不会一次性加载完整清单；烧录过程每完成 5% 就汇报一次进度。
封面自动抓取：从平台直接拉取封面图，并自动转成通用的 封面.jpg，你不用再手动截图保存。
静默登录：遇到需要登录才能下载的内容时，直接读取本地 Chrome 浏览器里的登录态，不会把 Cookie 导出到别处。
没字幕也能跑：万一平台没有提供字幕，JZSub 也不会卡住，它会正常交付视频、MP4 和封面。

Text烧录 [██████████░░░░░░░░░░]  50%  01:11 / 02:23  0.68x

横屏视频

原片与 JZSub 双语字幕烧录后的效果对比：

竖屏视频

YouTube Shorts 竖屏原片与 JZSub 竖屏双语字幕成片对比：

截图来自视频 Parking Sensor (DIY)。

JZSub 会自动从平台选一张最合适的封面图，转成通用 JPEG 格式，作为 封面.jpg 跟视频一起交付，不用你再单独从网页上另存图片。

在 Codex 里使用

Bashnpx skills add pengchujin/jzsub --skill jzsub -g -a codex -y

要求 Node.js 18 及以上版本。执行后会自动从 GitHub 拉取最新版本，并把 JZSub 全局安装到 Codex 里。

Bashgit clone https://github.com/pengchujin/jzsub.gitmkdir -p ~/.codex/skillscp -R jzsub/skills/jzsub ~/.codex/skills/

在 Codex 的新任务里发送：

Text$jzsub https://www.youtube.com/watch?v=VIDEO_ID

JZSub 会一路把下载、模型翻译、字幕渲染、烧录和交付检查全部跑完。翻译是通过紧凑队列逐批推进的，不会把整个字幕清单一次塞给模型，也不会停在只下完视频的中间状态。

默认的中文交付物包括 封面.jpg 和 双语字幕版「视频名」.mp4 两个文件，文件名由下载清单统一声明，续传和最终交付验证都使用同一套命名。

你可以在 Codex 里直接告诉 agent 你需要什么，它会自动选择对应的 --deliver 目标；也可以手动调用脚本：

Bashpython3 skills/jzsub/scripts/fetch_video.py "<url>" \  --output-dir job --deliver video --browser-cookies auto

video 和 subs 走的是“下载完就结束”的流程；full 和 bilingual-subs 则会继续往下走翻译流程，交付检查会按你声明的目标来判断是否完成。如果选了 subs 类的目标，但平台恰好没有合适的字幕，JZSub 会明确报错而不是静默交付空文件。