AutoClip 使用教程

把长视频切成最多十条竖屏短视频,封面和发布文案一起出

长视频切片

📖 项目简介

AutoClip 是 zhouxiaoka 维护的开源剪辑工具,协议 MIT。一条长视频丢进去,它在你自己的电脑上挑出值得发的片段,按平台剪成竖屏或横屏,配上字幕、封面、标题和话题,打成发布包。评分最高的自动做,最多十条,其余列成备选。

它先拿到字幕:有作者字幕就直接用,没有就用本机 Whisper 或 SenseVoice 转写,也可以接你已经配好的云端转写。然后让大模型把全文通读一遍,按完整的问答和观点打分,从问题的第一句接到回答说完。竖屏会跟着说话的人取景;没有人脸,或者原片字幕不能裁,就保留完整画面。中文平台出中文,英文平台出英文。

桌面版、命令行和 MCP 走同一条出片链路,产物在同一个数据目录里,桌面首页能看到命令行做出的项目。仓库里自带一份 skills,Codex 读完就知道该调哪条命令。适合播客、访谈、课程和口播;游戏录屏、很少说话的素材要另开画面识别,选段仍要自己看一遍。

✨ 核心亮点

🔟
最多自动做十条
按分数先做合格片段,其余留着,点一下再做
📱
按平台出画幅
抖音、小红书走竖屏,B 站和 YouTube 长视频保持横屏
🖼️
封面和文案一起出
每条带封面、标题、简介、话题,再打成一个发布包
💻
剪辑留在本机
取景和渲染在你的电脑上,模型可以选云端,也可以接本机

🧩 它能做什么、输出什么

项目说明
输入本地视频,或一条 YouTube、B 站链接。已有字幕可另附字幕文件,跳过转写
适用类型访谈、播客、课程、口播。说话少的素材要开画面识别,并换一个能看图的模型
输出成片、封面、发布文案、ZIP 发布包。竖屏可选访谈式或满屏播客式
语言 / 平台中文平台出中文,英文平台出英文。平台 id:douyin、xiaohongshu、bilibili、tiktok、instagram_reels、youtube_shorts、youtube_long
一次做几条每个平台自动做分数最高的片段,最多 10 条。一次只提交一条素材,不要并行开多条

🖥️ 环境要求

环境建议配置
操作系统桌面版:Windows 10 / 11 x64,或 macOS 13 及以上的 Apple Silicon。Intel Mac 用命令行或 Docker
运行环境命令行要 Python 3.10 以上,建议 3.11,再加 FFmpeg。桌面安装包自带 Python 和 FFmpeg
硬件剪辑和渲染在本机完成,不强制独显。本机转写有显卡会快一些
没有独显有作者字幕就跳过转写。分析模型可以接云端接口,也可以接本机 Ollama 或 LM Studio
关键依赖FFmpeg、FFprobe。没有字幕时再装 faster-whisper,或在桌面设置里装转写

🚀 如何使用

💡
先装命令行和 skills,配一次模型,再对一条有字幕的访谈跑 produce。桌面版则去 Releases 下安装包,设置里填模型后贴链接。
1

装上命令行

一行装工具。第一次会拉依赖,多等一会儿。装完用 doctor 看 FFmpeg 和模型通不通。

bash uvx autoclip-mcp
autoclip doctor
2

装上 skills

在 GitHub 搜索 zhouxiaoka/autoclip。给 Codex 用的说明在仓库 skills 目录里,用下面这一行装进 skills 目录。桌面版去 Releases 页面下安装包:Windows 选 x64 安装包,Mac 选 Apple Silicon。

bash npx skills add zhouxiaoka/autoclip
3

跑通一条

模型密钥放在桌面设置里,或环境变量 AUTOCLIP_API_KEY,不要写进命令。已有字幕就带上 --srt。把 PROJECT_ID 换成上一条结果里的项目编号。

bash autoclip produce talk.mp4 --srt talk.srt --platform douyin --portrait-style interview --json
autoclip outputs PROJECT_ID --export-kits

常用参数:

参数作用
--platformdouyin、xiaohongshu、bilibili、tiktok、instagram_reels、youtube_shorts、youtube_long。可重复写多个
--portrait-style竖屏版式:auto、interview(访谈式)、podcast(满屏播客)。不改横屏
--templateeditorial 杂志风、street 街头快剪、classic 经典。命令行不写则是经典
--srt已有字幕文件,跳过转写
--json结果只打一份 JSON,方便 Codex 读
4

多条素材排队

没有一次传入多条素材的参数。做完一条、导出发布包,再提交下一条。youtube_long 只要至少 180 秒的完整片段,短素材改 youtube_shorts 或 bilibili。

bash autoclip produce live.mp4 --platform douyin --platform youtube_shorts --json
5

结合 Codex 使用

把上面两行安装命令发给 Codex,让它装工具、把 skills 放进自己的 skills 目录。模型接口填一次。之后直接说人话,例如:把这个文件夹里的直播回放切成抖音短视频,每条都要封面和文案,分数不够的别硬凑。

✅
它会跑 produce,轮询到做完,再导出每条的视频、封面、文案和发布包路径。

🎯 典型应用场景

🎙️
一期访谈拆短视频
录完一场对谈,挑出能单独发的几段问答
🎧
播客改竖屏
长播客按说话的人取景,字幕两行一页
📚
课程切知识点
一节课切成几条能单独看完的短视频
📡
直播回放
一小时回放丢进去,留下分数最高的几条
🌐
同一条发多个平台
抖音竖屏和小红书、B 站横屏可以一次指定
📦
交给 Codex 排队
文件夹里有好几条,做完一条再做下一条

📈 性能表现

指标表现
有作者字幕作者记录:1 小时 43 分的访谈,做出 10 条,约 7.5 分钟。2026-10-01,Apple Silicon Mac
没有字幕同一台机器、本地 Whisper base:2 小时 52 分的访谈,做出 10 条,约 29.5 分钟
和旧链路比新链路把挑片改成一次通读全文,不再把字幕拆成上百次调用
🧠
有字幕就跳过转写,分析只读文字。取景和渲染用电脑自己的编码器,在本机完成。

❓ 常见问题

Q: 和自己拖时间轴有什么不一样?

你给一条长视频和目标平台,它交回成片、封面和文案。片段从一句完整的问题接到回答说完,不是按固定秒数一刀切。

Q: 支持哪些来源和平台?

本地文件,以及 YouTube、B 站链接。平台有抖音、小红书、B 站、TikTok、Reels、YouTube Shorts 和 YouTube 长视频。中文平台出中文,英文平台出英文。

Q: 为什么一条都没生成?

先看转写有没有成功、模型是否连上、FFmpeg 和磁盘是否正常,以及候选是否满足这个平台的时长。YouTube 长视频要求片段至少 180 秒,短素材改 Shorts 或 B 站。

Q: 没有显卡怎么办?

有作者字幕就不必转写。分析可以走云端接口。一定要本机转写时,用更小的 Whisper 模型,时间会更长。

Q: 竖屏版式怎么选?

抖音和小红书默认访谈式,TikTok、Reels、Shorts 默认满屏播客式。想指定就用 --portrait-style interview 或 podcast。这只改竖屏布局。

Q: 怎么和 Codex 一起用?

把安装命令和 skills 那一行发给它,模型接口只填一次。之后用一句人话描述要切的文件夹、平台,以及分数不够就不要硬凑。

Q: 桌面版和命令行是两套吗?

不是。两边共用同一条出片链路和同一个数据目录。命令行做出的项目,打开桌面首页就能看到。版本以 autoclip --version 为准。

Q: 我的原片会被上传吗?

剪辑、取景和渲染在本机。用云端分析会送出相关字幕和文案;用本机模型和本机转写则不送。只有你点了投稿,成片才上传到已连接的平台。

Q: 第一次打开为什么被系统拦住?

安装包还没有做公证和代码签名。Mac 在应用上右键选「打开」;Windows 点「更多信息」再选「仍要运行」。之后不会每次都问。

Q: 可以商用吗?

软件是 MIT 协议。你自己的素材可以用来做片。别人的访谈、播客,版权在原作者,能不能发出去要看你有没有授权。