一次剪辑,9个平台:ffmpeg-skill多平台交付完全指南(TikTok、Reels、Shorts、YouTube)
一次剪辑,9个平台:ffmpeg-skill多平台交付完全指南(TikTok、Reels、Shorts、YouTube)
一条素材,手工重导 9 遍?TikTok 的竖版、Reels 的安全区、Shorts 的 3 分钟上限、YouTube 的横版……ffmpeg-skill 把「一次剪辑,9 个平台」变成一条命令。这是一份面向新手的多平台交付完全指南,不用写复杂命令,也能让每个平台拿到各自合规的成片。
01 · 为什么需要「一次剪辑、多平台交付」
同一个成片,过去要手动干 9 遍:
- TikTok:9:16 竖版裁切 + 字幕避开右侧点赞列 + 响度归一
- Instagram Reels:竖版 + 自己的安全区
- YouTube Shorts:竖版、≤3 分钟
- YouTube 正片:16:9 横版、下三分之一字幕
- X / LinkedIn / Facebook / 播客:又各有各的规格……
手工重复导出,参数记错一个就是事故。而 ffmpeg-skill 的思路是:一份交付表 + 一套平台模板——你只剪辑一次,render.py 负责把同一个成片分别适配到 TikTok、Reels、Shorts、YouTube 等 9 个交付目标,逐个编码、逐个校验,最后还能打包出一张清单。
三条核心理念,新手记住就够:
- 先测后剪:每个任务先
probe.py实测时长、帧率、分辨率、色彩与音轨,不靠文件名猜; - 无损优先:能不重编码就不重编码,只在必须时才重新编码;
- 交付自动校验:每个平台模板自带
check步骤,上传前就知道文件是否达标。
工作流长这样:
原始素材 → 剪辑一次 → render.py --template(9 张平台模板)→ 每平台自动 check 校验 → 9 个平台文件 + 打包清单
02 · 9 个平台交付模板一览(竖版 / 横版 / 播客)
模板就放在 templates/ 目录里,每个平台一个 JSON:
| 平台 | 画幅 | 处理方式 | 模板文件 |
|---|---|---|---|
| TikTok | 9:16 竖版 1080×1920 | 中心裁切 + 逐词弹出字幕 | templates/tiktok.json |
| Instagram Reels | 9:16 竖版 1080×1920 | 中心裁切 + 弹出字幕 | templates/reels.json |
| YouTube Shorts | 9:16 竖版 1080×1920 | 中心裁切 + 弹出字幕 | templates/shorts.json |
| YouTube Shorts(别名写法) | 9:16 竖版 | 同上 | templates/youtube-shorts.json |
| YouTube 正片 | 16:9 横版 1920×1080 | 补背景不裁切 + 下三分之一字幕 | templates/youtube.json |
| X(Twitter) | 16:9 横版 1280×720 | 补背景 + 下三分之一字幕 | templates/x.json |
| 1:1 方形 1080×1080 | 中心裁切 + 下三分之一字幕 | templates/linkedin.json | |
| 16:9 横版 1920×1080 | 补背景 + 下三分之一字幕 | templates/facebook.json | |
| 播客(纯音频) | 无画面 | 去静音 + 章节标记 | templates/podcast.json |
每个模板自动完成四件事:调画幅 → 烧字幕(自动避开平台 UI)→ 响度归一 → 按平台预设导出,最后再跑一次该平台规格的校验。
02.1 各平台硬性规格速查表
数据来自唯一的交付表 scripts/_platforms.py,新手不用再到处翻平台文档:
| 平台 | 最大时长 | 输出分辨率 | 响度目标 | 文件大小上限 |
|---|---|---|---|---|
| TikTok | 10 分钟 | 1080×1920 · 30fps | −14 LUFS / −1 dBTP | 4 GB |
| Reels | 90 秒 | 1080×1920 · 30fps | −14 LUFS / −1 dBTP | 4 GB |
| YouTube Shorts | 3 分钟 | 1080×1920 · 30fps | −14 LUFS / −1 dBTP | 256 GB |
| YouTube 正片 | 12 小时 | 1920×1080 起(≥720p) | −14 LUFS / −1 dBTP | 256 GB |
| X(Twitter) | 约 2 分 20 秒 | 1280×720 · 30fps | −14 LUFS / −1 dBTP | 512 MB |
| 10 分钟 | 1080×1080 · 30fps | −14 LUFS / −1 dBTP | 5 GB | |
| 4 小时 | 1920×1080 · 30fps | −14 LUFS / −1 dBTP | 4 GB | |
| 播客 | 不限 | 纯音频 | −16 LUFS / −1 dBTP | — |
💡 短视频三件套(TikTok / Reels / Shorts)都是 9:16、30fps、−14 LUFS;X 只有 H.264 且文件要压到 512 MB 内,最容易超标——这也是「上传前体检」特别有价值的原因。
03 · 各平台字幕为什么不能放同一个位置(安全区)
新手最常问:「字幕放屏幕底部不就完事了?」——在 TikTok 上,底部会被应用自己的标题栏盖住;右侧还有点赞、评论、转发那一列。把字幕放在「通用底部」,等于把一半的字藏起来了。
ffmpeg-skill 的解决办法:每个平台都内置了「安全区」,即 App 自身界面会占掉的那部分画面。字幕、logo、片头钩子卡会自动避开这些区域:
- TikTok:避开底部 22% 的描述区、右侧 14% 的点赞评论列;
- Reels:避开底部 20% 与右侧 12%;
- Shorts:避开底部 18% 与右侧 12%;
- YouTube / X / LinkedIn / Facebook:无常驻遮挡,按传统 5% 标题安全边距。
安全区数据与平台规格存在同一张表 scripts/_platforms.py 里,caption.py、graphics.py、look.py 都读这一份——不会出现「字幕按 A 规则排、校验按 B 规则算」的偏差。不确定效果时,用 look.py --safe tiktok 把遮挡区直接画在帧上,一眼就能看出字幕会不会被 UI 盖住。
04 · 一键出全平台:一条命令的打包渲染
装好之后,多平台交付就是一条命令:
python3 ~/.claude/skills/ffmpeg-skill/scripts/render.py master.mp4 --template all
--template all 会把同一份剪辑渲染到全部 9 个交付目标,输出:
- 9 个平台各自的成品文件(默认落在输入文件旁边);
- 一张
<name>_pack.md打包清单:每个平台产出了什么、时长、分辨率、响度检查是否通过。
只想发其中几个?把 all 换成逗号分隔的列表即可,比如:
python3 $S/render.py master.mp4 --template tiktok,reels,shorts,youtube
另外,--dry-run 会先把每条计划执行的 ffmpeg 命令打印出来、但不写任何文件——第一次用,强烈建议先 dry-run 看一眼计划再正式跑。
平台别名随便写:youtube-shorts = shorts、ig = reels、twitter = x、fb = facebook,所有 --platform / --preset / --template 参数都认。
05 · 上传前体检:check.py 的 PASS / WARN / FAIL
文件生成 ≠ 能上传。每个平台模板最后一步都是自动体检;你也可以手动对任何文件跑:
python3 $S/check.py output.mp4 --platform tiktok
它会按该平台规格逐行报告 PASS / WARN / FAIL:时长、宽高比、最小分辨率、帧率、编码、文件大小、响度(LUFS)与真峰值——每一项 FAIL 都附带具体修复建议。比如 Reels 超过 90 秒会直接 FAIL,并告诉你该用哪条命令裁短。任何一项 FAIL 都别赌上传,先修再发。
06 · 环境准备与安装步骤(新手照做即可)
只需要两样东西:FFmpeg 5.0+ 和 Python 3.9+(纯标准库,无第三方依赖),全程本地处理、不上传、无 API key。
1)安装 FFmpeg
| 系统 | 命令 |
|---|---|
| macOS | brew install ffmpeg-full(普通 ffmpeg 缺少字幕/调色等滤镜) |
| Ubuntu / Debian | sudo apt install ffmpeg |
| Windows | winget install Gyan.FFmpeg |
2)安装 ffmpeg-skill
- 给 AI 编程助手装技能:
npx ffmpeg-skill(Cursor 加--cursor,Codex 加--codex,全装用--all); - 也可以走 Claude Code 插件:
claude plugin install kajisho5/ffmpeg-skill; - 完全不想用 Agent?clone 仓库 https://gitcode.com/gh_mirrors/ff/ffmpeg-skill ,把
SKILL.md、scripts/、references/、mcp/复制进你的 skills 目录即可——工具本来就是独立 Python 脚本,随时可以直接跑,例如python3 $S/probe.py input.mp4 --compact。
3)自检
npx ffmpeg-skill doctor
它会逐行列出 FFmpeg 组件(libass 字幕、loudnorm 响度、libx264 等)是否齐全,并给出每个工具「可用 / 缺什么 / 怎么修」的结论——比等渲染失败后再排查省心得多。
07 · 新手常见坑(避坑清单)
- 横版转竖版会丢画面:16:9 → 9:16 的中心裁切会丢掉约 70% 宽度。要保住主体就用
fit.py --fit crop --crop-x/--crop-y对准主体,或者--fit blur用模糊背景填充、一点不裁; - 先改画面、后烧字幕:字幕在裁切/缩放之前烧进去,位置就会跑偏——正确的顺序是先重排版再上字幕;
- 各平台响度标准不同:短视频 −14 LUFS,播客 −16 LUFS,广播 −23 LUFS。模板里已经写好,手动处理时别用错;
- HDR 素材:平台预设是 SDR,HDR 输入会被提醒。先
color.py --to-sdr做色调映射再交付; - 输出文件已存在会被拒绝:这是刻意的保护,确认要覆盖时显式传
--overwrite; - 长链路别手搓:三步以上的手工串联既掉画质又难改。整段剪辑交给
render.py,--dry-run可以先看到全部命令。
08 · 常见问题(FAQ)
Q:一次剪辑真的能同时出 9 个平台的版本吗?
能。render.py --template all 读同一张交付表,为每个平台分别算出画幅、字幕安全区、导出预设与响度目标,逐份独立编码和校验,最后生成 <name>_pack.md 汇总。
Q:没有 AI Agent 也能用吗?
可以。probe / cut / fit / caption / export / check / render 等全部是独立脚本,命令行里逐个跑就是完整工作流;Agent 只是帮你「听懂人话、自动排命令」。
Q:素材会上传到云端吗? 不会。所有处理都在本机完成,无云、无 API key,适合不想上传原始素材的场景。
09 · 文件资料速查
| 内容 | 位置 |
|---|---|
| 平台交付表(规格 / 安全区 / 字幕默认 / 预设) | scripts/_platforms.py |
| 9 个平台模板 | templates/ |
| 一键渲染 / 打包 | scripts/render.py |
| 平台预设导出 | scripts/export.py |
| 平台规格体检 | scripts/check.py |
| 安全区可视化 / 联系表 | scripts/look.py |
| 每个工具的逐参数参考 | references/scripts.md |
| 自然语言请求 → 命令示例 | examples/README.md |
| 前后对比演示画廊 | docs/demos.md |
| 执行契约(面向 Agent 框架) | docs/contract.md |

