quick_cut

项目概述

Quick Cut 把 mpv 播放器变成一台轻量剪辑台，输入是随手标记的入点与出点，输出是切好的视频、音频、动图、图片或字幕，全程不导入素材、不建工程。脚本用纯 Lua 编写，剪辑台、时间轴、裁剪框与导出面板都画在 mpv 的 OSD 图层上。只调起止点时默认流复制，秒级完成且不损画质；需要滤镜、变速或帧级精度时才转为重新编码。未安装 FFmpeg 时会回退到 mpv 内置编码器，界面按实际能力自动裁剪。

项目	内容
当前版本	v1.2
宿主	mpv ≥ 0.38
外部依赖	FFmpeg、FFprobe ≥ 5.1，可选
许可	MIT
实测平台	Windows

播放、标记、导出都在同一个窗口里完成。

支持的宿主

• mpv 原生 OSC：在 input.conf 绑定 script-binding quick_cut/cut_menu 即可进入剪辑台
• uosc：在 script-opts/uosc.conf 的 controls= 中加入 button:quick_cut 出现工具栏按钮
• ModernZ 等第三方 OSC：与原生 OSC 一样走快捷键绑定，不依赖具体界面方案
• mpv 0.38 下限：时间码输入框依赖 mp.input，低于该版本脚本仍可加载但相关输入功能被禁用

主要功能

• 播放即标记：[ 与 ] 设入点出点，ENTER 加入片段，支持切分、删除、排序与撤销重做
• 画面裁剪：在播放画面上拖动裁剪框，提供 16:9、9:16、4:3、1:1、21:9 等固定比例与自定义矩形
• 快速复制：仅改起止点时直接流复制封装，秒级完成，入点受关键帧位置限制
• 消除切点偏移：针对 H.264 源对起始 GOP 做局部重编码再拼接，让快速复制的入点对齐到帧
• 变速导出：0.25 到 4 倍速，音频经 atempo 补偿，变速不变调
• 多类型输出：视频、音频、动图、图片序列、拼图、单帧与字幕各有独立参数
• 限定体积：填目标大小后按总时长反算码率，默认 50 MB，两遍编码尽量贴近目标
• 会话记忆：进度写入 quick_cut_sessions.json，再次打开同一文件恢复片段与裁剪

安装与启用

1. 把整个 quick_cut 文件夹放进 mpv 的 scripts/ 目录，便携模式路径为 portable_config/scripts/quick_cut/
2. 常规安装路径为 %AppData%/mpv/scripts/quick_cut/，macOS 与 Linux 放在配置目录的 scripts/ 下
3. uosc 用户在 script-opts/uosc.conf 的 controls= 中加入 button:quick_cut
4. 其他界面在 input.conf 写入 c script-binding quick_cut/cut_menu
5. 把 script-opts/quick_cut.conf 复制到 mpv 的 script-opts/ 后按需修改，重启 mpv 生效
6. 播放视频后按 c 或点击控制栏按钮进入剪辑台

权限与影响范围

• 配置写入：只在脚本目录写 quick_cut_sessions.json 与预设文件，不改动 mpv 原有配置
• 外部进程：导出时按片段调用 FFmpeg 或 mpv 自身编码进程，视频编码窗口以最小化方式启动
• 离线运行：没有遥测与网络请求，图标来自内置的 fonts/Quickcut_icons.ttf
• 文件保护：同名输出自动追加 _cut_1、_cut_2，已有文件不会被覆盖

注意事项

• 关键帧限制：快速复制的入点只能落在关键帧上，需要帧级精确时改用重新编码或开启消除切点偏移
• FFmpeg 缺失：未安装 FFmpeg 时快速复制、合并导出、字幕导出与限体积两遍编码均不可用，界面会置灰
• 字幕格式：PGS 等图形字幕只能用 copy 封装进 mkv，无法转成 SRT
• 平台实测：项目仅在 Windows 上开发与实测，macOS 与 Linux 的适配代码尚未全面验证