一次剪辑,9个平台:ffmpeg-skill多平台交付完全指南(TikTok、Reels、Shorts、YouTube)

原创2026-10-09 19:44:301,385 阅读
文章标签:音视频视频处理音频处理AI 技能MCP 服务CLI

一次剪辑,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 个交付目标,逐个编码、逐个校验,最后还能打包出一张清单。

ffmpeg-skill 多平台交付项目标识

三条核心理念,新手记住就够:

  1. 先测后剪:每个任务先 probe.py 实测时长、帧率、分辨率、色彩与音轨,不靠文件名猜;
  2. 无损优先:能不重编码就不重编码,只在必须时才重新编码;
  3. 交付自动校验:每个平台模板自带 check 步骤,上传前就知道文件是否达标。

ffmpeg-skill 媒体处理引擎 Logo

工作流长这样:

原始素材 → 剪辑一次 → 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
LinkedIn 1:1 方形 1080×1080 中心裁切 + 下三分之一字幕 templates/linkedin.json
Facebook 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
LinkedIn 10 分钟 1080×1080 · 30fps −14 LUFS / −1 dBTP 5 GB
Facebook 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 · 新手常见坑(避坑清单)

  1. 横版转竖版会丢画面:16:9 → 9:16 的中心裁切会丢掉约 70% 宽度。要保住主体就用 fit.py --fit crop --crop-x/--crop-y 对准主体,或者 --fit blur 用模糊背景填充、一点不裁;
  2. 先改画面、后烧字幕:字幕在裁切/缩放之前烧进去,位置就会跑偏——正确的顺序是先重排版再上字幕;
  3. 各平台响度标准不同:短视频 −14 LUFS,播客 −16 LUFS,广播 −23 LUFS。模板里已经写好,手动处理时别用错;
  4. HDR 素材:平台预设是 SDR,HDR 输入会被提醒。先 color.py --to-sdr 做色调映射再交付;
  5. 输出文件已存在会被拒绝:这是刻意的保护,确认要覆盖时显式传 --overwrite;
  6. 长链路别手搓:三步以上的手工串联既掉画质又难改。整段剪辑交给 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
登录后查看全文
ffmpeg-skill