● MIT 开源 · 浏览器端视频剪辑器 · 测试版

FreeCut Video Editor

免费开源的网页视频剪辑器:多轨道时间线、关键帧动效、调色均衡,浏览器本地渲染导出 MP4/MOV/WebM/MKV——视频不经过服务器。以下展示站托管其构建版本,附完整部署适配记录。

01这是什么,能干什么

定位 · 难点 · 框架

定位浏览器里的剪映:打开网页就能剪

  • 免费开源(MIT):无订阅、无水印,9 国语言 UI(含简体中文,浏览器自动检测)。
  • 8 大功能面:时间线编辑、关键帧、语义场景搜索、音频均衡、快捷键、动效工作区、色彩分级、网页导出。
  • 本地优先:项目存于你电脑的文件夹(File System Access)或浏览器 OPFS,渲染导出全在本地完成。
  • 周更:应用内【最新变化】可查 24 个周版本(详见说明书版本历史页)。
FreeCut 主界面

主界面:左侧素材、中间预览、底部时间线

难点 root 构建假设 vs 子路径托管

官方构建按 / 根路径打包,而本站把每个项目托管在 /s/<项目>/ 子路径下——直接上传的结果是 JS/CSS/图片全 404 的空白页,外加路由 404 与 file 权限三连坑(详见 §3)。

框架技术栈与运行形态

  • 前端:Vite + React + TanStack Router,PWA 可安装(manifest + sw.js)。
  • 重活全在 Worker/WASM:解码、波形、升采样、场景检测、字幕(mediabunny/ort/whisper/kokoro TTS)。
  • 存储:File System Access 工作区文件夹优先,OPFS 兜底——两者都要求 https / localhost 安全上下文。
  • 托管:Leon-Web-Host 静态托管 604 个文件;公网经 Caddy https://leyon.top:8443 反代。

02数据怎么流,难点压在哪一层

三条链路 · 优化重心在部署适配层

链路 A页面:网关 → 托管 → 分块 → 路由

浏览器 → Caddy https → Web-Host /s/freecut/ → editor/index.html → main 入口 → 按需加载 290+ chunks(mapDeps 预加载表)→ TanStack Router basepath /s/freecut/editor 匹配 → 落地页/项目页/编辑器

链路 B存储:文件夹引用,视频不上服务器

用户选本地文件夹授权 → 项目/素材以引用方式管理 → OPFS 存元数据与缓存。http 下 showDirectoryPicker 与 OPFS 均不可用——这就是 http 入口打不开编辑器的根因,必须走 https。

项目管理

项目管理:多项目列表(需先选工作区文件夹)

链路 C导出:时间线 → 本地渲染 → 下载

容器编码质量
MP4 / MOV / WebM / MKVH.264 / H.265 / VP8 / VP9 / AV1低 / 中 / 高 / 超高

音频可单独导出 MP3 / AAC / WAV(PCM);视频支持字幕烧录。渲染在浏览器本地完成。

导出

导出:容器/编码/质量预设(落地页截图)

模块难点分布

  • 预加载表(18 个文件的 m.f=[...]):Vite base 拼接 / + dep,前导斜杠会拼出 //s/… 废 URL。
  • 路由 basepath:默认 /,子路径下全路由 Not Found。
  • 入口 https:Caddy 反代是编辑器可用的前提。
时间线

多轨道时间线(视频/音频/文本/形状)

03三段部署适配代码

本站托管适配:无源码重编,只改构建产物

C1子路径前缀:303 个文本文件扫出 31 个绝对路径

# 绝对根路径改子路径前缀(sw.js / manifest 另有特殊项)
"你 /assets/x"  →  "你 /s/freecut/assets/x"

C2预加载表去前导斜杠:适配 Vite 的 base 拼接

# 预加载 helper:i = e => '/' + e   ← base 硬拼 '/'
# dep 若带前导斜杠 → '//s/…' 被当成协议相对 URL(host 变成 s)
# 修正:m.f=[...] 数组内改相对形式 "s/freecut/assets/x"
# '/' + 's/freecut/assets/x' = '/s/freecut/assets/x'  ✓

C3路由 basepath:默认 / → /s/freecut/editor

# app-shell 两处兜底(update + mount,全仓唯一)
n = this.basepath ?? t?.basepath ?? `/s/freecut/editor/`
o = this.options.basepath ?? `/s/freecut/editor/`
三段修改全部可回滚:修前快照 05429107a7,分步提交 ecd8add8a6 / 775b42c683 / 3c7875ae2d。

04主要优化与踩坑

已验证结论,可复现

  • http 入口只能看落地页:编辑器需 isSecureContext=true,公网请走 https://leyon.top:8443/s/freecut/,内网落地页走 http://192.168.11.70:5070/s/freecut/。
  • 深层页面不要刷新:展示站无 SPA 回退,刷新深层路由会 404——始终从 /s/freecut/ 或 /editor/ 首页进。
  • 旧缓存白屏:Ctrl+Shift+R 硬刷新;PWA 安装的旧版请重装。
  • Workspace root is not set:http 下的必然报错,切 https 并选工作区文件夹授权。
  • 公网 502:隧道/反代故障时全站不可用,与本项目无关,内网直连验证。
关键帧

关键帧编辑器(曲线/摄影表视图)

📖 说明书📐 说明文档🕘 日志