Auto-Editor：自动视频剪辑命令行工具

项目简介

Auto-Editor 是一个命令行应用程序，通过分析音频响度等多种方式，自动完成视频和音频的剪辑。

在正式剪辑前，通常需要先切掉素材里的「死区」（多数是静音段），这一步被称为 first pass。素材越长，这项工作越枯燥，Auto-Editor 就是为这一步准备的：

auto-editor path/to/your/video.mp4

主要功能

基础剪切与节奏控制

用 --margin 调整成片的节奏，在剪切点前后补入少量「静音」区间，让剪辑更自然：

# 前后各补 0.2 秒，0.2s 是 --margin 的默认值
auto-editor example.mp4 --margin 0.2sec

# 前补 0.3 秒，后补 1.5 秒
auto-editor example.mp4 --margin 0.3s,1.5sec

多种自动裁剪方式

--edit 决定如何自动裁剪。例如按画面运动量剪掉静止部分：

# 剪掉总运动量低于 2% 的片段
auto-editor example.mp4 --edit motion:threshold=0.02

# 默认使用 --edit audio:threshold=0.04,stream=all
auto-editor example.mp4

多轨道素材可以为不同轨道设置不同属性，多种方式也能组合使用，并支持视频剪辑师熟悉的 dB 单位（区分大小写）：

auto-editor example.mp4 --edit "(or audio:0.03 motion:0.06)"
auto-editor example.mp4 --edit audio:-19dB

标签（Labels）

每个时刻都会得到一个整数标签：0 表示静音（默认剪掉），1 表示活跃（保留）。--edit 决定什么是标签 1，-w:0 / -w:1 设置各自的动作；通过 --edit:N 和 --when:N 可以叠加更多类别（N 最大 255），重叠处高标签优先。

# 剪掉静音、保留语音，并额外加速响亮的片段
auto-editor example.mp4 --edit:2 audio:-12dB --when:2 speed:1.5

导出为剪辑软件工程

可以生成可导入 Adobe Premiere Pro 等剪辑软件的 XML 文件，也支持 DaVinci Resolve、Final Cut Pro、ShotCut、Kdenlive，以及导出为单个媒体片段序列：

auto-editor example.mp4 --export premiere
auto-editor example.mp4 --export resolve
auto-editor example.mp4 --export final-cut-pro
auto-editor example.mp4 --export shotcut
auto-editor example.mp4 --export kdenlive
auto-editor example.mp4 --export clip-sequence

查看被剪掉的内容

把 --when-active 设为 cut、--when-inactive 设为 nil，可以导出通常会被剪掉的部分：

auto-editor example.mp4 --when-active cut --when-inactive nil

安装与使用

安装方式请参考官方文档：Installing。

安装完成后，最基本的用法就是给出一条素材路径，其余交给默认参数；需要更精细控制时，再按上面的示例添加 --margin、--edit、--export 等选项。

查看全部可用选项：

auto-editor --help

README 还提供了一个技能安装命令：

npx skills add WyattBlue/auto-editor

注意事项

• 仓库内容采用公共领域（Unlicense）授权；「Releases」中的二进制产物可能适用不同的开源许可证。
• 也可以通过官网在线运行或下载应用：在线使用、下载应用。官网提到这两个产品使用本仓库（Unlicense）的资源，其自有资源另按专有许可证授权。
• 更多资料：全部选项说明、文档、博客。

---

本作品整理自 GitHub 开源项目 WyattBlue/auto-editor，原作者 @WyattBlue，许可证 Unlicense。中文介绍由 AI 根据项目 README 整理，以原仓库为准。