JZSub：把这四步收进一条指令、给它一个公开视频链接

平时刷外网教程、海外科普或者 B 站长视频，想留一份能对照着看的版本，往往要走四步：先把视频存下来，再单独导出字幕，然后逐句翻译，最后把字幕重新压回画面。一步步手动做，半小时很容易就过去了。JZSub 把这四步收进一条指令：给它一个公开视频链接，它按顺序完成下载、翻译和双语字幕烧录，最后连封面一起交出来，适合经常要处理外语视频的人。

JZSub 是什么

JZSub 是跑在 Codex 里的开源 Skill，专门解决“外语视频加双语字幕”这件重复劳动。它不做成带界面的应用，而是一套本地执行的任务流程：你在 Codex 的任务框里给它一个视频链接，它就依次做完下载、字幕翻译、画面烧录和素材整理，全程不用在几个软件之间来回切换。项目采用 MIT 开源协议，个人和商用场景都可以免费使用，没有功能上的付费门槛。处理结束一次性交付两样东西：已经烧好双语字幕的成品视频，以及一张转换好的封面图，两者放在同一目录，开箱就能剪辑、归档或者再发布。需要注意的是，它只处理用户拥有合法访问权限的公开视频，这个边界在后文还会单独说明。

基本信息与版本选择

JZSub 不按版本号分版本卖功能，选法应该按你的视频类型来定，不同情况走同一条指令、结果各有侧重：

双语字幕是怎么做的

字幕是 JZSub 最花心思的一环，整个过程分三步走。第一步是取字幕：优先使用平台提供的官方字幕，原文一字不动地保留下来。第二步是翻译：翻译按 80 条一批分批进行，每一批都带着只读的上下文往下走，这样长视频翻到后面也不会前后脱节；遇到纯声音标注，例如音乐声、掌声这类没有对白的提示，会直接过滤掉，混有对白的则保留。第三步是重新切分：翻译完的字幕会按句尾标点对齐，一条字幕不跨句子，句中的短片段按时长和宽度上限合并，保证读起来不断句、不串句。

烧录环节调用 libass 渲染，搭配 MiSans 字体，排版是底部双层堆叠：原文紧贴中文上方，整体贴底，行数变化时也不会互相重叠。字号与换行宽度按视频宽高比生成，竖屏视频的字号会按比例缩小，不会出现横屏字幕硬搬到竖屏上溢出的情况。中文行宽与英文行宽对齐，短句不会被无意义地折行。烧录过程每完成 5% 输出一次进度，运行只读取紧凑的字幕文档，不拖大量缓存，低配设备也能稳定跑完。

安装步骤

安装分四步，装一次之后长期可用。第一步是补齐依赖：macOS 用户按仓库说明用包管理器补齐运行环境，并逐项核对 Python 3.10 以上、Deno 2.3 以上、带 libass 的完整 FFmpeg 是否就位；MiSans 字体需要自行从官方渠道下载，仓库里不附带字体文件。第二步是拉取仓库并把 Skill 放进 Codex 的全局目录：

git clone https://github.com/pengchujin/jzsub.git
mkdir -p ~/.codex/skills
cp -R jzsub/skills/jzsub ~/.codex/skills/

第三步是跑一遍内置自测脚本，快速校验环境依赖和功能是否完整，出问题先看自测输出再排查，比盲目重装省时间。第四步是正式使用：在 Codex 的任务框里输入 $jzsub 加视频链接，工具就会串行执行下载、字幕翻译、画面烧录和素材导出，全程不需要人工干预。

跑之前先定好的几项设置

1. 先确认 MiSans 字体已经装好。烧录前会校验声明的字体是否安装，缺失会直接失败；只有确实没有字体、又愿意接受字形效果打折时，才用放行参数跳过校验。
2. 确认 FFmpeg 是带 libass 的完整版。字幕渲染依赖 libass，精简版 FFmpeg 会在烧录这一步走不通，装前核对一次比跑到一半报错划算。
3. 核对 Python 与 Deno 的版本下限。Python 低于 3.10、Deno 低于 2.3 都可能让流程起不来，装完先看版本号再往下走。
4. 先想清楚字幕来源。优先用平台官方字幕；如果原视频本来就没有官方字幕，就接受纯视频加封面的交付结果，不要指望工具凭空生成对白。
5. 跑完先验交付物。确认成品 MP4 和 cover.jpg 在同一目录且文件真实存在，长视频中途失败可以用续跑参数接着跑，过期中间文件会被清理掉。

一条指令出成品：使用流程

日常使用只有一步：把公开视频链接交给 JZSub。工具先解析链接，匹配平台最优的视频与音频轨道，封装成标准 MP4，不用你手动挑清晰度。接着取官方字幕做分批翻译，再按句子边界重新切分，最后把双语字幕烧进画面，同时把平台官方封面转成通用 JPG 格式，和成品放在一起交付。整个链条里你不需要导出字幕文件，也不需要另开压制软件。如果原视频没有官方字幕，或者字幕全是纯声音标注，流程会优雅降级为纯视频交付，不会因为一张空字幕表就中断。下载器、字幕、烧录与交付在仓库里都有对应的自测项，跑自测能提前发现环境问题。

注意事项与使用边界

• 使用边界要先说清楚：JZSub 不会绕过 DRM、付费墙、平台验证码，仅处理合法访问权限的视频。需要登录后才可见的内容、会员专属内容不在本文介绍的用法之内，不要拿它去碰这类视频。
• 下载内容的使用要合法合规。拿到手的视频和字幕建议只用于个人学习、剪辑素材和课程归档，尊重原作者与平台规则，不要把他人的作品原样二次分发或者商用。
• 机器翻译结果要人工过一遍。分批翻译能保证上下文不断裂，但专业术语、人名和固定说法仍可能翻得不到位，公开发布前先校对关键句子。
• 长视频跑之前确认网络和磁盘空间。分批翻译加高清下载耗时较长，中途断网或磁盘写满都会让流程停下，跑之前留足空间更稳妥。
• 字体与依赖缺失不要硬跑。缺字体、缺 libass 时先补环境再跑，放行参数只是应急，不是常规用法。

适合谁用，和手动做法比强在哪

三类人用它最划算：一是自学外语的人，对照双语字幕看原片比只看译文记得牢；二是剪辑和自媒体从业者，经常要把外网视频做成带字幕的素材；三是喜欢归档线上课程的人，一次拿到成片加封面，后续整理省事。反过来，如果你只是偶尔看一个视频，直接在平台上开字幕就够了，没必要专门装一套流程。

JZSub 的价值不在某一个单点功能，而在把四件重复劳动串成一条不用守着的流水线。装好环境之后，每多处理一条视频，省下的就是原来手动切换软件的那半小时。

关注公众号软件教程管家，回复【JZSub】即可获取下载链接

推广

关注「软件教程管家」

回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。

相关推荐

开源项目WallpaperMachine 免费下载开发node-rs 免费下载｜Rust 原生绑定包集合开发Roundhouse 免费下载｜Ruby 静态分析开发Flatcar Container Linux 免费下载开发Nature Skills 免费下载开发bddisasm 免费下载｜轻量级 C 指令解码库