快速剪辑（Quick Cut）

快速剪辑是一个完全本地运行的跨平台视频片段裁切与合并工具。选择一个源视频后，可以通过独立的“时 / 分 / 秒”输入框设置时间段，也可以拖动高清原视频预览，手动反复标记任意数量的开始点和结束点，再按列表顺序输出为一个新视频。

下载

请前往 GitHub Releases 下载当前版本：

• macOS Apple Silicon：Quick-Cut-1.5.0-macOS-arm64.dmg 或 .zip
• macOS Intel：Quick-Cut-1.5.0-macOS-x64.dmg 或 .zip
• Windows 64 位：Quick-Cut-1.5.0-Windows-x64-Setup.exe 为安装版，Quick-Cut-1.5.0-Windows-x64-Portable.exe 为免安装版

当前版本未进行 Apple Developer ID 或 Windows 代码签名，首次运行时系统可能显示“开发者未验证”或 SmartScreen 提示。

已实现功能

三种剪辑模式

• 精准剪辑：重新编码以获得准确切点；支持硬件加速、CPU 回退以及画质、分辨率、帧率和音频码率设置。
• 极速剪辑：直接复制原始视频和音频码流，速度快、画质不变；切点受关键帧位置限制。
• 手动标记：拖动高清等比例预览，反复标记任意数量的开始点和结束点；支持片段跳转、排序和删除，并使用极速模式导出。

通用能力

• 完全本地运行，支持 Windows 与 macOS；FFmpeg 和 FFprobe 已随应用打包。
• 支持拖放读取 MP4、MOV、MKV、AVI、WebM、M4V、MTS、M2TS 等常见格式。
• 支持任意数量片段、起止时间校验、最高 1080p 起止帧预览及正确显示宽高比。
• 支持自定义文件名和保存位置、实时进度与取消操作，以及可记忆的深色/浅色主题。

关于“保持原编码”

精准模式为了让 HH:MM:SS 指定的切点准确生效，会重新编码，而不是只在关键帧处截断。输出会使用与源文件相同的编码类型（例如 H.264 仍输出 H.264、HEVC 仍输出 HEVC）、分辨率、帧率、像素格式和接近源文件的目标码率。编码器的具体实现参数不可能从所有成品视频中完整反推，因此文件哈希和最终文件大小不会与源文件完全一致。

极速模式使用 FFmpeg concat demuxer 的 inpoint/outpoint 和 -c copy，不进行视频或音频重新编码。它通常只需普通文件复制所需的时间，但受 GOP/关键帧位置限制，实际切点可能比输入值提前或延后数秒。

常见视频编码映射：H.264、HEVC/H.265、VP8、VP9、AV1、MPEG-4、ProRes、MJPEG、Theora。常见音频编码映射：AAC、MP3、Opus、Vorbis、FLAC、ALAC 和 PCM。

本地开发

需要 Node.js 20.19 或更高版本（推荐使用 Node.js 22 LTS）。

npm install
npm run dev

测试和检查：

npm test
npm run lint
npm run build:web

打包

在 macOS 上生成 .dmg 和 .zip：

npm run build

在 64 位 Windows 上生成 x64 NSIS 安装包和免安装版：

npm run build

也可以显式执行：

npm run build:win:x64

产物位于 release/。建议分别在对应系统上构建；仓库中的 GitHub Actions 配置会生成 macOS Intel、macOS Apple Silicon 和 Windows x64 三套版本。不支持 Windows 32 位。

当前项目没有配置 Apple Developer ID 和 Windows 代码签名证书，因此直接分发时系统可能显示“开发者未验证”或 SmartScreen 提示。正式发布前应在构建环境中配置对应签名证书。

项目结构

electron/
  main.cjs       Electron 窗口、文件选择和 IPC
  preload.cjs    安全的渲染层接口
  theme.cjs      原生窗口主题和偏好持久化
  ffmpeg.cjs     元数据、帧提取、裁切合并和进度
src/
  App.jsx        桌面界面和交互
  theme.js       页面主题切换和本地偏好
  time.js        HH:MM:SS 解析与校验
  styles.css     响应式视觉样式

隐私与安全

视频选择、预览帧提取和剪辑导出均在本机完成。本项目不包含账号系统、云端上传或遥测代码。

如果发现安全问题，请不要在公开 Issue 中披露利用细节，请参阅 SECURITY.md。

参与贡献

欢迎提交 Issue 和 Pull Request。开始前请阅读 CONTRIBUTING.md。

第三方组件

应用通过 ffmpeg-static 和 @ffprobe-installer/ffprobe 使用 FFmpeg/FFprobe。FFmpeg、FFprobe 及其他第三方依赖适用各自的许可证，具体以对应上游项目和依赖包中的许可信息为准。

许可证

本项目源码采用 MIT License 开源。