Repolode
提交项目
0xSero

0xSero/video-edit

将原始 macOS 屏幕录制自动剪辑、脱敏并校验输出的 Agent 技能与脚本工具包。

在 GitHub 查看
Star
85
Fork
4
未关闭 Issue
0
最近提交
3天前

这是什么？

video-edit 是一套 Python 与 ffmpeg 脚本加一个 Agent 技能，用于把 45 到 90 分钟的 macOS 屏幕录制（OBS，屏幕加摄像头画中画）处理成 20 到 30 分钟、可直接上传的视频。流程以转录文本为依据：由 Agent 决定保留哪些片段，脚本据此生成剪辑决策表、渲染并校验结果，全部在本地运行。

针对原始录屏的常见问题，工具包提供了相应处理：通过帧差分析识别长时间画面静止的窗口，这与单纯的静音不同；只在增强后音频音量较低的地方缩短停顿；对主机名、API Key 等敏感文字使用模糊遮挡，并在渲染结果上用 OCR 复检。手部姿态和人脸检测基于 Apple Vision，用于标记需要人工复核的候选片段。音频依次经过 DeepFilterNet3 降噪、均衡、去齿音、压缩，并以两遍 loudnorm 归一到 −16 LUFS。

渲染按分组进行，中断后可续跑；校验脚本会重新计算预期帧数、比对两条音轨时长，并对成品重新做 OCR，发现泄露即以非零状态退出。自测脚本可在合成录像上跑通完整流程。

核心功能

  • 01通过单个 job.json 文件定义基于转录的保留区间与隐私剪切。
  • 02用帧差检测画面静止段，与静音检测分开处理。
  • 03对敏感文字做整窗模糊，并对成片 OCR 复检是否泄露。
  • 04音频链路包含 DeepFilterNet3 降噪与两遍 loudnorm，目标 −16 LUFS。
  • 05基于 macOS VideoToolbox 的分组 h264 渲染，支持断点续跑，并附带校验脚本。

适用场景

  • 把较长的 OBS 编程或演示录屏剪成适合 YouTube 发布的短视频。
  • 发布录屏前遮挡主机名、令牌等屏幕上的敏感信息。
  • 在 Mac 上录制的分享视频中去掉空闲段并压缩停顿。

快速上手

  1. 1

    将仓库克隆到你的 agent 技能目录

    git clone git@github.com:0xSero/video-edit.git ~/.agents/skills/video-edit
  2. 2

    安装 Python 依赖

    python3 -m pip install mlx-whisper deepfilternet pillow numpy soundfile pyobjc-framework-Vision pyobjc-framework-Quartz
  3. 3

    运行自检脚本（基于合成录像）验证安装

    bash scripts/selftest.sh /tmp/ved-selftest

使用前须知

  • 需要 macOS 14+；目前不支持原生 Linux。
  • 专为特定的 OBS 风格 macOS 屏幕录制工作流设计。
  • 需要另行安装 ffmpeg 6.0+ 和 Python 3.10+。

收录于专题

开源 Mac 应用隐私与本地优先工具PDF、OCR 与文档处理工具AI 视频与音频工具

标签

#video-editing#screen-recording#ffmpeg#audio-processing#privacy#ocr#macos#automation

常见问题

video-edit 是什么？
将原始 macOS 屏幕录制自动剪辑、脱敏并校验输出的 Agent 技能与脚本工具包。 video-edit 是一套 Python 与 ffmpeg 脚本加一个 Agent 技能，用于把 45 到 90 分钟的 macOS 屏幕录制（OBS，屏幕加摄像头画中画）处理成 20 到 30 分钟、可直接上传的视频。流程以转录文本为依据：由 Agent 决定保留哪些片段，脚本据此生成剪辑决策表、渲染并校验结果，全部在本地运行。
video-edit 可以免费使用吗？用的什么许可证？
video-edit 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
video-edit 还在维护吗？
活跃维护中。video-edit 最近一次提交是在 2026年11月4日。
video-edit 适合用来做什么？
把较长的 OBS 编程或演示录屏剪成适合 YouTube 发布的短视频。 发布录屏前遮挡主机名、令牌等屏幕上的敏感信息。 在 Mac 上录制的分享视频中去掉空闲段并压缩停顿。
video-edit 怎么安装和运行？
将仓库克隆到你的 agent 技能目录: git clone git@github.com:0xSero/video-edit.git ~/.agents/skills/video-edit 安装 Python 依赖: python3 -m pip install mlx-whisper deepfilternet pillow numpy soundfile pyobjc-framework-Vision pyobjc-framework-Quartz 运行自检脚本（基于合成录像）验证安装: bash scripts/selftest.sh /tmp/ved-selftest
在哪里获取 video-edit？
源代码和安装说明在 GitHub 上：https://github.com/0xSero/video-edit

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目