JavaScript · 项目报告

ronak-create/FableCut

Zero-dependency browser video editor that AI agents can drive — JSON timeline, MCP + REST, live-reloading UI

已完成 打开 GitHub
R
356星标
26Fork
9Issue
MIT许可证

分析结果

项目分析

FableCut 是一个零 npm 依赖的浏览器端非线性视频编辑器,核心特点是把整个视频工程表示为一个可读写的 JSON 时间线。用户可以通过网页 UI 手动剪辑,也可以让 AI Agent 通过 MCP、REST API 或直接修改 project.json 来自动完成剪辑、加字幕、调色、转场、配乐节奏匹配等任务。项目使用 JavaScript 编写,Node 18+ 即可运行,适合希望构建 AI 驱动视频工作流、短视频自动化生产工具或本地化视频编辑实验平台的开发者。

适用领域 浏览器视频编辑 / AI Agent 工具调用 / 短视频自动化生产 / 非线性剪辑 NLE / MCP 工具集成 / REST API 驱动的媒体编辑 / Canvas/Web 视频合成 / 字幕与动效生成 / 参考视频分析与复刻 / 本地创作者工具
配置难度 中等。基础运行非常简单,只需要 Node 18+ 和浏览器;但如果要深入接入 AI Agent、理解 JSON 时间线 schema、实现自动剪辑策略、处理导出质量和性能优化,则需要较强的前端、媒体处理和 Agent 工具调用经验。
商业价值 商业价值较高,尤其适合短视频自动化、AI 剪辑助手、营销视频批量生成、本地创作者工具和 Agent 工作流产品。它的最大价值不只是一个浏览器编辑器,而是把视频编辑抽象成可被 AI 和程序直接操作的 JSON 时间线,这使其适合作为 AI 视频生产系统的底层原型或本地执行层。对于中国开发者而言,可围绕抖音、快手、视频号、小红书、B站等平台的短视频模板化生产、爆款参考复刻、自动字幕包装、素材批处理等场景做二次开发。不过若要商业化,还需要重点补强稳定性、权限控制、中文字体与字幕体验、国内网络资源适配、批量任务调度和版权合规能力。
01

技术亮点

  • 零 npm 依赖,启动方式极简:node server.js。
  • 以 JSON 时间线作为核心接口,天然适合 AI Agent、脚本和自动化系统操作。
  • 同时支持 UI、MCP、REST API 和直接文件修改,多种控制方式适合不同工作流。
  • 支持热重载,AI 或脚本修改 project.json 后,浏览器 UI 可实时更新。
  • 内置 MCP Server,面向 Claude Code、Claude Desktop 等 Agent 场景设计,工具包括获取工程、增量 patch、导入媒体、分析参考视频等。
  • 功能覆盖较完整:多轨时间线、裁剪、分割、吸附、撤销重做、音频波形、关键帧、转场、滤镜、调色、字幕动效、SVG 动画、绿幕、背景移除等。
  • 支持参考视频分析,可提取镜头边界、音乐节拍、BPM、能量曲线和音乐轨道,适合复刻爆款短视频结构。
  • 提供并发编辑冲突保护,通过 revision 机制避免 UI 和 Agent 互相覆盖修改。
  • 浏览器端合成与预览一致性较高,导出时通过浏览器渲染帧再由 ffmpeg 编码。
  • MIT 许可证,对商业改造和二次开发较友好。
02

目标用户

  • 想把 LLM/AI Agent 接入视频剪辑流程的开发者
  • 需要批量生成 Reels、TikTok、YouTube Shorts、B站短视频的内容团队
  • 希望研究 JSON 时间线、浏览器视频合成、Canvas 编辑器的前端工程师
  • 正在开发 AI 剪辑助手、自动字幕工具、视频模板生成器的创业团队
  • 使用 Claude Code、Claude Desktop 或 MCP 生态的开发者
  • 希望拥有本地可控、无需云端 API 的视频编辑工具的个人创作者
  • 需要快速原型验证视频编辑产品的独立开发者
03

配置要求

  • Node.js 18+ 是必需条件。
  • 需要 Chromium 系浏览器以获得较好的 Canvas、Media、导出和兼容性表现。
  • ffmpeg 非必需,但强烈推荐安装,用于快速 MP4 导出、音频混合、上传素材转封装和参考视频分析。
  • AI 背景移除功能首次使用时会从 CDN 获取 MediaPipe 模型,因此需要网络访问。
  • 默认服务只绑定 127.0.0.1,本地安全性较好;如需局域网访问必须配置 HOST 和 FABLECUT_ALLOWED_HOSTS。
  • 项目数据主要位于 project.json、media/、library/、analysis/、exports/ 等目录,应根据团队协作方式决定是否纳入版本管理或备份。
  • MCP 集成需要 Claude Code、Claude Desktop 或其他支持 MCP 的 Agent 客户端。
  • 如要稳定进行生产级导出,应确认浏览器后台渲染、ffmpeg 编码和本机性能足够支持目标分辨率与时长。
04

适用场景

  • 让 AI 根据素材自动剪辑短视频,例如按节奏点切分镜头、添加字幕、转场和音效
  • 把一个参考短视频分析成剪辑蓝图,再用自己的素材复刻相同节奏和结构
  • 通过 project.json 批量生成不同版本的视频模板,例如营销视频、产品介绍、社媒广告
  • 为 Claude Code 或 Claude Desktop 增加视频剪辑能力,使其能直接操作时间线
  • 构建本地短视频生产流水线,减少对 SaaS 视频平台的依赖
  • 研究浏览器端视频合成、关键帧动画、字幕动效、SVG 动画叠加等实现方式
  • 为自有应用提供一个可嵌入或可改造的视频编辑器原型
  • 在前端可视化界面中实时查看 AI 对时间线的修改结果
05

部署与配置

  • 确保本机已安装 Node.js 18 或更高版本。
  • 可选但推荐安装 ffmpeg,并确保 ffmpeg 在系统 PATH 中,用于快速导出和视频转封装。
  • 克隆仓库:git clone https://github.com/ronak-create/FableCut.git
  • 进入目录:cd FableCut
  • 启动服务:node server.js
  • 在 Chromium 内核浏览器中打开 http://localhost:7777。
  • 将素材拖入浏览器窗口,或放入项目的 media/ 目录。
  • 如需接入 Claude MCP,可执行:claude mcp add -s user fablecut -- node "<path-to>/fablecut/mcp-server.js"。
  • 如需局域网访问,使用 HOST=0.0.0.0 FABLECUT_ALLOWED_HOSTS=<your-ip> node server.js 显式开启。
06

风险与注意事项

  • 项目星标数量中等,生态和长期维护稳定性仍需观察,不应直接假设为成熟生产级工具。
  • 虽然号称零依赖降低了安装复杂度,但也意味着许多功能由项目自身实现,复杂场景下可能存在隐藏 bug 或性能瓶颈。
  • 浏览器端视频编辑对内存、GPU、解码能力和长视频处理能力要求较高,长时长或高分辨率项目可能不稳定。
  • 导出链路依赖浏览器渲染和 ffmpeg,本地环境差异可能导致导出速度、音画同步或编码兼容性问题。
  • AI 背景移除依赖 CDN 模型,离线环境或国内网络环境可能需要自行处理模型下载与托管。
  • REST/MCP 能够修改工程文件,如果开放到局域网或公网,必须严格控制访问权限和 allowed hosts。
  • 参考视频分析、自动复刻等功能可能涉及版权、音乐授权和平台合规风险。
  • 作为 AI Agent 可驱动工具,生成结果质量高度依赖提示词、素材质量和模型能力,不一定能稳定达到专业剪辑师水平。
  • 项目主要面向 Chromium 浏览器,其他浏览器兼容性可能有限。
  • 如果用于商业生产,需要额外验证字体、素材、SVG、音效和导出内容的授权情况。

历史记录

热榜历史快照

2026-07-13 第23名 新收录 · github_search
2026-07-12 第24名 新收录 · github_search