场景：你的 AI Agent 还只会写代码？FableCut 让 Claude Code 直接剪视频、加特效、导出一气呵成
AI Agent 的能力边界一直在扩展——从写代码、修 Bug，到读文档、跑测试。但你有没有想过，让 AI Agent 帮你剪视频？
传统的 AI 视频工具把编辑逻辑藏在 API 后面，Agent 只能提交任务、等结果，根本看不到时间线发生了什么。而 FableCut 走了完全不同的路子：它是一个零依赖的浏览器视频编辑器，把整条时间线暴露为一个 JSON 文档。AI Agent 可以直接读写这个 JSON，实时看到剪辑效果，还能和你一起编辑同一条时间线。
为什么 FableCut 对 AI Agent 友好？
FableCut 的核心设计理念是「项目文件即接口」（Project File as Interface）。整个编辑器的状态保存在一个 project.json 文件中，包含了媒体资源、剪辑片段、轨道、特效、关键帧和转场——任何能读写 JSON 的进程都可以操作视频编辑。
FableCut 为 AI Agent 提供了三种等价的控制方式：
- MCP 协议（最适合 Claude Code / Claude Desktop）——注册一个零依赖的 MCP 服务器，Agent 通过工具调用直接操控时间线
- 直接写文件——读取
project.json，修改，递增revision，写入即可。浏览器 UI 约 150ms 内热重载 - REST API——
GET/PUT /api/project、POST /api/upload、事件流SSE /api/events
这三种方式可以混用。你可以在 UI 上拖拽一段素材，同时让 Agent 在后台调整另一段的关键帧——revision 计数器确保不会覆盖彼此的修改。
快速上手
安装和使用非常简单：
git clone https://github.com/ronak-create/FableCut.git cd FableCut node server.js # → http://localhost:7777
要求：Node 18+ 和 Chromium 内核的浏览器。建议安装 ffmpeg 以获得快速导出能力。
启动后，把媒体文件拖入窗口（或放入 ./media/ 目录），把剪辑片段拖到时间线上，就可以开始编辑了。
让 Claude Code 帮你剪片
注册 MCP 服务器只需要一条命令：
claude mcp add -s user fablecut -- node "$(pwd)/mcp-server.js"
之后你就可以直接对 Claude Code 说：
“把这几段素材按照节拍标记切好，加一层青橙色调，在顶部加一个逐字弹出的字幕，每个转场加一个嗖声效果”
Claude Code 会调用 fablecut_set_project 修改时间线，fablecut_patch_project 做增量更新。你会在浏览器中看到时间线实时刷新。
MCP 工具一览
FableCut 的 MCP 服务器提供了七个专用工具：
| 工具 | 作用 |
|---|---|
fablecut_status | 检查编辑器是否运行，如有需要自动启动 |
fablecut_docs | 获取 CLAUDE.md 中指定章节的文档 |
fablecut_get_project | 读取当前项目，支持 compact:true 以紧凑格式查看 |
fablecut_set_project | 设置完整的项目 JSON |
fablecut_patch_project | 增量修改——只发送变更部分，不来回传输整个文档 |
fablecut_import_media | 导入媒体文件到项目中 |
fablecut_analyze_reference | 分析参考视频，提取镜头边界、节拍、BPM、能量曲线等 |
其中 fablecut_patch_project 是管理 Agent Token 效率的关键设计——Agent 只需发送小操作补丁，而不必每次往返都传输整份 JSON。
从参考视频重建
FableCut 还有一个杀手级功能：参考视频分析。你提供一个喜欢的参考视频，它会生成一个「编辑蓝图」——包含镜头边界、音乐节拍 + BPM、响度曲线、每镜能量、高潮点，还会把参考视频的背景音乐提取出来，放入你的媒体库。
node analyze.js ref.mp4
或者通过 API 调用：
POST /api/analyze # 上传参考视频
然后 Agent 可以拿着这个蓝图，用你的素材逐镜头重建同样的剪辑结构：
“这里有一段参考视频——分析它，然后用我的素材按同样的节奏和结构重剪一遍”
Agent 调用 fablecut_analyze_reference 获取蓝图，再逐镜重建，甚至复用同样的音乐轨。
编辑功能有多强？
虽然 FableCut 主打 AI 驱动的编辑，但它本身也是一个功能完整的非线性视频编辑器：
轨道与剪辑：4 条视频轨 + 3 条音频轨，支持拖拽、修剪、分割、吸附、多选（橡皮筋框选、Ctrl+点击加减选）、撤销/重做。
视觉效果：12 种一键滤镜（电影色调、青橙、黑白、复古、赛博朋克等）、调节层（一个剪辑调节它下方所有素材）、完整色彩控制（亮度/对比度/饱和度/色相/色温/色调）、模糊、暗角、胶片颗粒、混合模式、色度键（绿幕抠像）——以及基于 MediaPipe 的浏览器端 AI 背景消除。
运动动画：25 种属性的关键帧动画 + 缓动函数、速度斜坡（关键帧控制播放速度，慢动作到快放的无缝过渡）、镜头抖动、RGB 分离效果。17 种转场（淡入淡出、滑入、擦除、缩放、光圈、旋转、模糊、故障效果、弹出）。
文字与字幕：动态字幕（打字机、逐词弹出、逐字弹出、卡拉 OK、波浪、弹跳、抖动）、霓虹文字效果、Google Font 自动加载、渐变填充、轮廓、背景胶囊、字距行高等完整排版控制。
动画 SVG 覆盖层：支持 CSS @keyframes 动画的 SVG 片段——Agent 可以自己编写矢量覆盖层（下三分之一标题、五彩纸屑、闪光效果）。
导出：浏览器每帧渲染 + ffmpeg 编码 CRF-18 MP4（切到后台也继续渲染），也可用 MediaRecorder 实时录制作为回退方案。
并发编辑安全
多个 Agent 和你同时编辑时，revision 计数器确保不会互相覆盖：
- Agent 的 MCP 写入携带当前
revision，如果 UI 已经修改了项目，Agent 的写入会被拒绝（409 Conflict） - UI 在 Agent 写入后检测到项目变更，会用 toast 通知你，而不是静默丢弃你的编辑
这种冲突感知的设计在 AI 工具中相当少见，是一个非常实用的产品细节。
总结
FableCut 代表了一种新的 AI 工具范式：不是让 AI 替你操作一个闭源工具，而是让工具本身变成 AI 可以读写的数据结构。项目文件即接口的设计思路，让它不仅是一个视频编辑器，更是一个 AI 可以理解和操作的创作平台。
如果你已经在用 Claude Code 写代码，不妨试试让它帮你剪条视频——打开一个浏览器就能用，一分钱不花。
相关链接