proofcut

一款能验证剪辑结果的 AI 视频编辑器。 输入录制素材，输出完成并精修的影片：按转录文本剪辑，添加 B-roll、卡片、音乐和字幕，并且每一步都可由 Agent 调用。proofcut 在你自己的机器上渲染，然后转录渲染结果，并检查影片内容是否与剪辑内容一致。

https://github.com/user-attachments/assets/4153d180-3d7c-4c70-af5f-54d63d0a8bd5

一个 Agent 根据目标，不经人工干预、不需步骤，剪辑演示视频。

在开发所用的 Linux 上运行。macOS 和 Windows 均通过 CI 测试套件；各平台的手动测试进度见 § 需要帮助：在 Mac 或 Windows 上运行。

快速开始

安装 uv 后：

uvx proofcut doctor          # only looks: what is missing, and the fix for each
uvx proofcut setup --plan    # what an install would fetch, and its size; touches nothing
uvx proofcut setup           # installs it for you alone, no sudo; --uninstall reverses it

然后制作两分钟演示，或通过 Claude Code 插件为 Agent 提供工具。§ 试用 介绍了完整流程。

项目缘起

无论是随笔、教程、屏幕录制还是演讲，旁白视频的大部分工作都是整理素材。找出重录部分并干净地剪掉。为每句旁白配上合适的画面。在人声下调整音乐音量，添加字幕，以片尾卡结束，渲染并精修。只要有一个可驱动的编辑器，Agent 现在就能完成这些整理工作。

但 Agent 无法独自确认渲染出的文件是否就是它想要的影片。ffmpeg、melt 和 auto-editor 在某些失败情况下仍会以 0 退出，因此渲染结果可能漏掉一句话、保留一段重录内容、多出一帧黑屏或没有字幕，却依然报告成功。所有读取项目而非文件的检查都会与项目内容一致。通常只有看完整部影片才能发现问题。

proofcut 是一款专为解决这一差距而设计的编辑器。你或 Agent 可以按照时间线中的文字进行编辑。proofcut 在你的机器上渲染时间线，然后转录渲染结果、统计帧数，并指出文件与剪辑内容不一致之处。

来看它在演示项目中的表现。重录内容已从剪辑中删除，而 verify 检查的是剪辑前生成的渲染结果：

proofcut -C proj cut vo 11:23 --pad 0.1
proofcut -C proj verify stale.mp4

"expected_words": 34,
"heard_words": 47,
"similarity": 0.84,
"diff": ["--- timeline", "+++ render", "@@ -10,4 +10,17 @@",
         " video", " editor",
         "+every", "+cut", "+you", "+make", "+names", "+a", "+um", "+no",
         "+let", "+me", "+try", "+that", "+again",
         " every", " cut"]

文件中仍包含剪辑删去的 13 个词，verify 会将它们指出。按照当前剪辑内容重新渲染后，转录会识别全部 34 个词 （DEMO.md 第 7 步）。

运行，而非暂存

TRIAL.md 记录了三次无人值守运行的评分。每次运行只给出一个目标，没有提供步骤，且每次都通过了所有检查：

• 演示剪辑，即上文所示的那个。
• 真实素材。 96 秒的旁白保留了说错的片段，另有四段电影素材。Agent 将其剪到 45 秒，根据每句内容选择素材，烧录字幕，并检查了自己的渲染结果：预期的 123 个词全部都能听到。
• 一部完整影片。 将演示素材加上配乐，要求制作成可上传的成片。Agent 用 192 秒和 2.27 美元完成剪辑，将音乐铺在旁白下方，以片尾卡结束，将响度母带处理至 −16 LUFS，并进行了检查。配乐、响度和片尾卡都在交付文件中实际测量，而非依据项目文件判断。

对比情况

COMPETITORS.md 会从原始来源读取每个条目，最近一次读取日期为 2026-09-28。简而言之：

• 转录编辑器（Descript 模式及其开源重实现）通过删除词语来剪辑，供人手动操作。没有任何开源版本提供 Agent 接口，也没有任何一个会检查渲染结果。
• 通过 MCP 操作的 Agent 编辑器允许 Agent 驱动剪辑。其中最接近的渲染检查方式是，在容差范围内比较时长，或转录疑似接缝附近的短片段。没有任何一个会将完整渲染结果中的词语与剪辑稿进行差异比较。
• NLE（Kdenlive、Resolve、Premiere）是供人手动完成影片剪辑的工具，而 DaVinci Resolve 21.1 现在也自带 MCP 服务。proofcut 会导出到这些工具，而不是取而代之；通过 import-edit 恢复裁剪后，verify 会检查它们交付的内容。
• auto-editor 会在无头模式下移除静音。proofcut 将其用作渲染后端。

proofcut 相比其他工具缺少的一项检查：检测渲染结果中冻结或静音的片段。

能做什么

从首次导入到交付文件的每个阶段，都由 proofcut 命令完成。无需使用 NLE 完成影片，也不会有其他工具触碰渲染结果。每一行都链接到逐步介绍该阶段的手册章节。

两部时长为 5 至 6 分钟的视频随笔，最初在 Kdenlive 中完成，现已仅使用这些命令重新制作，并与交付文件进行了比对。一部的时长与原片逐帧一致。另一部的 63 段配音区间均精确到毫秒匹配，且配音与采样点对齐。两部作品的母版响度都与原片的 −16 LUFS 一致。测量结果见 HISTORY.md。

除上述阶段外：

• 剪辑片段始终可定位。 单词的索引永远不会重新编号，因此无论之前剪辑过多少次，cut vo 111:114 指向的都是同一组单词，而附加到短语上的提示词在其前后每次剪辑中都能保持定位。
• 能看画面的 Agent。 shot-sheet 会将整条画面轨道绘制为一张带标签的网格，footage-sheet 则可浏览尚未剪辑的片段。两者都会通过 MCP 返回图像本身，而不是 Agent 无法打开的路径。
• 按描述查找 B-roll。 describe 会写出素材每个约 10 秒窗口中的画面内容，让 Agent 能根据一行内容的主题选择片段。
• 转录内容自检。 附加转录文本时，会报告重拍接缝、臆造词语、漏掉的重复内容和可疑时长；unspoken 则让渲染结果本身揭示没人说过的词语。
• 适配其他宽高比。 提供逐镜头裁剪窗口、人脸感知建议（reframe-detect）、审核表，以及用于两位说话者的堆叠分屏。卡片会按新画面尺寸重新绘制，绝不会拉伸。
• 屏幕录制。 可命名特定时刻（events），并将裁剪、声音或变速附加到这些时刻；还可将片段嵌入录屏，并对较慢部分重新定时。
• 动态图形。 由 Agent 编写或通过模板（打字、高亮扫过、逐字构建、标签）填充的网页，会逐帧采集并叠加在一段词语上。它会以动画形式进入，在这段词语的时长内保持显示，然后以动画形式退出，因此剪辑永远不会打断它。网页可以精确到帧地显示项目自身的素材，保存的图形也能在不同项目间复用。
• 静态图和贴纸。 照片和抠图只需导入一次，方向正确，可全屏播放或叠加在影片上：可放置、调整大小、旋转、加上相框式照片卡片效果，以及弹出或滑入。将图片粘贴到 Agent 的提示词中即可添加。
• 专为 Agent 打造。 提供 132 个 MCP 工具，具备类型化输入、结构化返回和读写注解，因此 Claude Code、Codex 或你自己的 Agent 都能驱动它，权限层也能区分查看与更改操作。
• 不受供应商锁定。 时间线采用 OpenTimelineIO，清单为 JSON，渲染则由 ffmpeg 和 MLT 完成。导出 .kdenlive 或 OTIO 文件，即可在任何地方完成制作。

人们如何使用它

告诉 Agent 你想制作什么影片。 在 Claude Code 中安装插件，然后描述影片：哪段录音是旁白、哪些是 b-roll、音乐从哪里开始、结尾是什么。Agent 会导入素材、转录、剪掉重录片段、将画面素材关联到对应台词、配乐、母带处理并检查渲染结果，全程只使用 proofcut 的工具。工作时，它可以将画面轨道显示为带标签的网格，因此它看到的是自己放入的内容，而不是文件名。每个 MCP 客户端运行的都是同一个服务；插件无需任何设置（§ 在 Claude Code 中）。

在 Shell 中通过指定词语剪辑。 每个工具也都是一个会输出 JSON 的 proofcut 子命令，因此剪辑脚本清晰易读、可重新运行，也可进行差异比较。--plan 会在任何更改发生前打印出某个范围的内容，undo 则可以撤销操作。

uv run proofcut -C myproject cut vo 111:114 --plan

在工作区中手动编辑。 在转录文本中划掉词语，在时间线上拖动修剪并使用剃刀工具，在原位置检查每个裁剪画面，然后从 Finish 导出。它会在编辑过程中播放源素材，因此查看剪辑无需渲染；真相条会在编辑时提醒你影片是否会以错误的状态交付。Agent 位于同一窗口的侧边栏中。

uv run proofcut -C myproject open

在其他软件中完成制作，同时仍能验证文件。 在这里粗剪，导出 .kdenlive 或 OpenTimelineIO 文件，在 Kdenlive、Resolve 或 Premiere 中完成制作，再用 import-edit 导回修剪结果。然后对交付文件运行 verify，这样任何保留在成片中的重录片段都会在有人观看前被发现。

uv run proofcut -C myproject verify final.mp4

从影片中剪出竖屏预告片。 reel 会将成片中的一段复制到另一个画布尺寸的第二个项目中，因此无需为了单次渲染而改变影片本身的画幅。它会标出预告片中不会出现的每个画面，并将保留的画面固定到影片中出现的对应帧上，确保预告片呈现影片中已有的内容。随后，帧模式会根据源素材本身的帧逐一检查每个裁剪画面。

uv run proofcut -C myproject reel ../teaser 1:32+44 --canvas 1080x1920

将一堆录音拆分成短片。 将每段录音作为一个时间线素材导入，先一次性剪掉重录片段，然后按首词和末词用 split 拆分。每个短片都会成为素材堆旁边的独立项目，只保留它用到的录音；任何未被短片使用的片段都会被标出，而不会丢失。

uv run proofcut -C dump seed reel1 reel2 reel3
uv run proofcut -C dump split intro=reel1:0..reel1:46 demo=reel2:0..reel3:88

前三种用法见§ 试用；reel、拆分和往返编辑见手册。

它坚守的原则

• 文件就是证据。 检查读取渲染结果，绝不读取项目。 verify、frames 和 hold check 报告的内容都基于交付的文件测量得出，因为项目可以声称字幕已烧录或某句台词已加入，但文件里可能根本没有。
• 剪辑你的录制内容，不凭空创作。 proofcut 不制作素材，也不编写脚本。它会按你或你的 Agent 选择的顺序，把你录制的内容剪成影片。它不是文本转视频生成器。
• 用你的机器，不按量计费。 商业 AI 编辑器是围绕按量计费的云服务构建的应用。proofcut 在本地转录、剪辑和渲染：无需账号、无需按分钟计费，也没有自带的云服务。只有你选择运行的 Agent 会与模型提供商通信，你的素材始终留在原处。
• Agent 的任何操作都在你的掌控之中。 MCP 服务、命令行和工作区调用相同的操作，测试会确保每个工具都有对应的命令输出 JSON。更改会先通过 --plan 显示将要执行的操作；凡是按词指定的内容，都会回显解析出的词语；undo --steps N 则会撤销 Agent 整个回合的操作。
• 明确说明未测量的内容。 设计记录公开可查：包括计划，以及记录已发布内容和证据结论的带日期历史，其中也包括失败。如果某项操作只有 CI 运行器执行过，文档会说明是运行器执行的，而不是由人执行；如果某项检查是模型对图像的解读，就会如实报告，绝不会作为门槛。

试用

在你明确同意之前，以下步骤都不会安装任何内容，而且每一步都会先打印将要执行的操作。§ 它会在你的机器上安装什么介绍了全部安装内容及如何撤销。

在克隆任何内容之前，先检查你的机器。 proofcut doctor 会探测 proofcut 使用的每个工具（列表见 § 要求），并打印缺少项目的修复方法。它只会检查，不会写入任何内容。安装好 uv 后：

uvx proofcut doctor

首次运行时，如果 uv 没有 Python 3.13，就会下载该版本，此外还会下载 proofcut 的依赖项。总计约 230 MB，全部存放在 uv 自己的缓存中，可用 uv cache clean 清空。

然后查看安装将执行的操作。 在 Linux、Windows 和两种 Mac 上，proofcut setup --plan 都会打印将下载的每一项内容、其大小，以及对应的 doctor 检查项，然后停止，不会触碰任何内容：

uvx proofcut setup --plan

proofcut setup — installs into /home/you/.local/share/proofcut/deps

Will install
  ffmpeg — n8.1.2 (BtbN autobuild-2026-08-31-13-27), about 126 MB
      because: ffmpeg is not on PATH. ffprobe is not on PATH.
  whisper — openai-whisper (uv tool, Python 3.12, cpu torch), about 1.9 GB
      because: whisper is not on PATH.
  auto-editor — 31.6.0, about 46 MB
      because: auto-editor is not on PATH.
  melt — Shotcut 26.8.1 (melt 7.41.0), about 155 MB
      because: melt is not on PATH.
  total: about 2.2 GB

这是在一台空白机器上的结果。你的清单会更短，因为 setup 不会安装 doctor 检查通过的项目，因此你已有且可正常工作的 ffmpeg 或 melt 不会受到影响。如果配有 NVIDIA GPU，whisper 项目使用的是 CUDA torch，总量约为 5.8 GB。

去掉 --plan 即可继续。它会重新打印计划、询问一次，然后仅为你安装，无需 sudo 或管理员权限；proofcut setup --uninstall 只会移除它添加的内容，不会移除你原有的任何内容。

uvx proofcut setup

演示和你自己的录制内容都可以从代码库检出目录运行：

git clone https://github.com/tydude001/proofcut && cd proofcut
uv sync

两分钟演示

无需准备素材。docs/DEMO.md 会生成包含真实重录片段、b-roll 和配乐的旁白，然后带你完成一部完整的小短片：通过指定台词中的词语剪掉重录片段，在某个短语处插入 b-roll，在旁白下铺设配乐，渲染并混音，在结尾加上片尾卡，并检查渲染结果是否与时间线一致。

uv run python scripts/make_demo.py ~/proofcut-demo

在 Claude Code 中使用

该插件会注册 proofcut 的 MCP 服务，无需你自行设置即可使用所有工具：

/plugin marketplace add tydude001/proofcut
/plugin install proofcut@proofcut

首次启动会下载约 175 MB 的 Python 依赖项，而 Claude Code 只给服务 30 秒时间连接。网络较慢时，可用 MCP_TIMEOUT=300000 claude 启动首次会话，或者等下载完成后，在 /mcp 中重新连接 proofcut。

其他任何 MCP 客户端都可以运行同一个服务，无论是从代码库检出目录运行，还是完全不检出代码库：

uv run --project /path/to/proofcut proofcut mcp
uvx proofcut mcp

查看自己的录制

uv run proofcut init myproject
uv run proofcut -C myproject import VO.wav --clip-id vo
uv run proofcut -C myproject transcribe vo                  # whisper, word-timed
uv run proofcut -C myproject seed vo                        # auto-editor strips silences
uv run proofcut -C myproject transcript vo --search "here's the thing"
uv run proofcut -C myproject cut vo 111:114 --plan          # what do those indices say?
uv run proofcut -C myproject cut vo 111:114 --pad 0.1       # inclusive word range
uv run proofcut -C myproject export final.mp4 --render      # or a .kdenlive to finish in an NLE
uv run proofcut -C myproject verify final.mp4               # did the render say what you edited?

如果想查看剪辑而不是观看，请打开工作区：

uv run proofcut -C myproject open        # server plus an app window
uv run proofcut -C myproject web --open  # the same page in a browser tab

proofcut 是 0.x 软件。遇到旧版本创建的项目时，它会拒绝处理，而不会自行猜测；运行 proofcut migrate 可将项目升级到当前版本。

它会在你的机器上安装什么

proofcut 是一款本地工具，需要实际的媒体二进制文件，因此在一台全新机器上运行 proofcut setup 会下载约 2.2 GB 的内容，其中大部分是 whisper。下面列出了全部内容、安装位置和卸载方式。大小数据适用于全新的 Linux x86_64 机器；运行 proofcut setup --plan 可查看你的实际情况。

“setup 的目录”指一个目录：~/.local/share/proofcut/deps（如果你设置了 $XDG_DATA_HOME，则使用该目录），Windows 上则为 %LOCALAPPDATA%\proofcut\deps。除了 whisper 以外的所有内容都存放在这里；whisper 以 uv 工具的形式提供。

如要在移除发生前预览：

proofcut setup --uninstall --plan

setup 特意不做两件事：它需要由你输入命令来运行，绝不会作为 MCP 工具，因此 Agent 无法启动 2 GB 的下载，也无法更改你的 PATH；此外，它不会触及你用户账户以外的任何内容。

征集帮助：在 Mac 或 Windows 上运行

GitHub 的 macOS 和 Windows 运行器能让演示从运行到渲染完成，但运行器不会阅读说明。目前的手动测试情况：

• Mac： 1 人，在一台 Intel Mac（i7-8850H，macOS 15.7.9）上测试。Apple 芯片设备上只有运行器测试过。
• Windows： 作者自己的 Windows 11 笔记本，测试过 2 次，其他人的 PC 尚未测试。Windows 10 和 ARM64 PC 完全没有测试过。

如果你有其中一台设备，并能花半小时运行，一个脚本就能安装 proofcut 所需的内容、制作一段短测试视频、让 proofcut 剪辑、评分、制作母版并检查视频，最后在桌面上生成报告。脚本会在开始前征求同意、记录新增的内容，并在收到请求后只删除这些内容，不会删除你已有的任何内容。如果运行在第一步就停止，也同样有帮助，因为停止的位置就是发现结果。

git clone https://github.com/tydude001/proofcut
bash proofcut/scripts/mac_trial.sh

git clone https://github.com/tydude001/proofcut
powershell -ExecutionPolicy Bypass -File proofcut\scripts\windows_trial.ps1

proofcut 在 Linux（基于 Fedora 的桌面系统）上开发。在 macOS 和 Windows 上，测试套件可在 CI 中通过；手动测试的状态见上文的 § 需要帮助：在 Mac 或 Windows 上运行，详情见 docs/plans/PORTABILITY.md。

编辑器的所有复杂功能都已有成熟的开源工具实现；proofcut 是一个让 Agent 能够驱动这些工具并检查其输出的层。proofcut doctor 会一次性检查以下所有项目。在 Linux、Windows 和任意一种 Mac 上，proofcut setup 都会安装前四项中 proofcut doctor 标记为 ✗ 的项目：静态版 ffmpeg、whisper、auto-editor 的发布二进制文件，以及 Shotcut 的 melt。Linux 上的 melt 是无需显示器即可渲染的便携版 （见§ 它会在你的机器上安装什么； docs/plans/INSTALL.md）。

从 CONTRIBUTING.md 开始：了解代码的位置、如何运行检查，以及拉取请求需要符合哪些规则。编码 Agent 可从 CLAUDE.md 开始；Claude Code 会自动加载该文件，其中记录了此代码库已经踩过的坑。SECURITY.md 说明了如何报告漏洞。

文档：

• docs/MANUAL.md：介绍每条命令及其设计原因。
• docs/DEMO.md：两分钟了解完整流程。

proofcut 的设计思路也是其交付内容的一部分，因此设计记录对外公开：

• PLAN.md：架构、技术栈决策和待解决的问题。
• HISTORY.md：记录已交付内容及相关证据的日期记录。
• COMPETITORS.md：该领域的其他产品，以及 proofcut 与它们的不同之处。
• NEXT.md：队列清空后的后续方向，按优先级排序。
• TRIAL.md：Agent 如何在无人值守的情况下端到端剪辑视频并接受评分。
• docs/plans/：进行中和已完成的计划。已完成的步骤会标注“Shipped”，并注明对应的 HISTORY.md 章节。

许可证

PolyForm Shield 1.0.0。proofcut 可查看源代码，但不是开源软件：你可以出于任何目的阅读、运行、修改和再分发它，但不得用它构建与之竞争的产品。剪辑自己的视频、为客户运行它、基于它构建产品，以及分叉它来修复错误，都没有问题。如需商业许可证，请联系我。

随附的字体不属于 proofcut，因此不能重新授权。src/proofcut/fonts/ 中的字幕字体和 src/proofcut/web/ 中的三种浏览器字体均采用 OFL-1.1 许可证；每种字体的许可证文本都与字体文件放在一起，源文件则位于对应目录的 FONTS.md 中。

表达感谢

如果 proofcut 曾为你剪辑视频，你可以在 Ko-fi 上请我喝杯咖啡。