Files
jinghui dde45fb4e9 feat(quickvideo): AI一键出片自动生成视频封面
- aiQuickVideo.ts 新增 generateQuickVideoCover(): 标题+图片→封面
  (视觉模型看图/纯文本降级/标题模板兜底, 远程图转dataURL防过期)
- QuickVideo.tsx: 第1步封面与文案并行生成, 第4步封面预览行,
  封面插时间轴最前3秒, 未就绪拦截确认, resetAll清理
- 新增 E2E 脚本 scripts/e2e_quickvideo_cover.py (mock网关, 10项断言全过)
- lint: doc.88531.cn 入 allowlist, lan 文档示例豁免 (external_refs=0)
- 文档: CHANGELOG/README/about.md 教程同步
2026-11-17 17:50:51 +08:00

28 KiB
Raw Permalink Blame History

米剪 MiCut

免登录 · 开箱即用的 AI 视频剪辑器(基于开源项目 UNICUT 二次开发)

把多轨剪辑、动画特效、智能处理与 AI 创作带进浏览器,打开网页就能剪视频,工程与素材留在你的电脑里。

🚀 在线体验:https://cut.88531.cn · 本次更新 · 快速开始 · 更新日志

React 18 TypeScript 5 Vite 4 开源免费

米剪编辑器界面

🌐 在线体验

无需下载安装,也无需注册登录,桌面浏览器打开即用:

🚀 立即体验 → https://cut.88531.cn

建议使用最新版 Chrome 或 Edge。首次创建本地项目时,按页面提示选择一个文件夹并授予读写权限(工程与素材都保存在你自己的电脑里),随后即可导入素材,体验多轨时间轴、画布编辑、动画、滤镜、特效、字幕和视频导出等流程。

Note

剪辑、字幕、转场、配音、抠图、导出全部免费,且大部分离线可用;AI 对话 / 生图 / 生视频在编辑器右上角「配置模型」粘贴一个 API Key 即可解锁——接口地址与模型已默认填好官方 AI 网关,只需填 Key。

🆕 本仓库更新了什么

本仓库是 UNICUT 的二次开发版(产品名:米剪 MiCut),围绕"开放给所有人直接使用"做了大量本地化改造,完整列表见 更新日志,主要包括:

更新 说明
免登录使用 打开即用,注册登录环节全部移除
素材不出本机 工程与素材保存在浏览器授权的本地文件夹(IndexedDB + 本地目录),不上传服务器
离线可用 本地存储、媒体处理、配音、抠图、导出不依赖任何在线服务;产物通过断网 lint(外链为 0)门禁
官方 AI 网关默认 AI 默认接入官方网关 https://ai.88531.cn/v1,对话 / 视觉 / 生图 / 生视频模型全部预填,用户只需粘贴自己的 API Key
「配置模型」统一入口 编辑器右上角一个按钮,统一管理接口地址、API Key 与四个模型
开源入口 编辑器右上角新增「开源地址」按钮,一键直达源码仓库 gitee.com/jinghui111/unicut
AI 面板瘦身 左侧「AI创作」移除「AI 视频生成 / AI 图片生成」页签,保留一键出片与生成结果;生图 / 生视频走 AI 助手对话
首页去背书 移除首页「受到众多大品牌信赖」与 UCAP / 圆通 / 中国电信 / 中国移动 品牌 logo 背书区
AI 一键出片 添加图片 → AI 生成口播文案 + 按标题和图片自动生成视频封面(片头 3 秒)→ 13 种人声配音试听 → 一键排入时间轴,转场 / 动效 / 字幕样式可调
模板导入修复 修复"导入第一个模板后,再导入会把浏览器拖崩"的问题,支持连续换模板
品牌与首页 产品名改为米剪,首页新增导航站 / 开源地址入口,移除收费栏目与账号类外链
接入授权中心 版本号、公告、检查更新(授权中心不可达时静默降级,绝不拦功能)
MCP 接入 新增 unicut-mcp 服务:Claude / Cursor / Hermes 等 AI 客户端经 https://<站点>/mcp 调用抓取文章、生成口播、edge-tts 配音、生成米剪工程 ZIP;端点强制 Authorization: Bearer 鉴权(公网必须授权)

最近更新(2026-11-11)

  • 工作台素材页「下载更多素材」按钮:上传素材旁新增独立按钮,点击新窗口直达素材下载文档站 https://doc.88531.cn/docs/mrfx/mrfx-1g99qum57n5qk;
  • 本地素材/文件夹删除修复:批量删除原本调不存在的 deleteMaterial 与无后端的服务器接口,实际什么都没删;现改为本地删除(分类记录 + 磁盘文件 + 封面/帧图/音波图),端到端验证通过;
  • 素材页显示实际存储路径:页面头部显示「📂 存储位置:〈目录名〉/materials/」,悬浮素材名可看单个文件路径;
  • 移动素材到文件夹修复:moveMaterial 原调不存在的服务器接口,现直接更新本地分类标记;
  • 素材面板「下载更多素材」入口:上传素材旁的下拉菜单(在线录音 / 文字转语音)新增第三项,点击新窗口直达素材下载文档站 https://doc.88531.cn/docs/mrfx/mrfx-1g99qum57n5qk;
  • AI 一键出片素材三选一:图片 / Word·PDF 文档(自动提取正文与配图,扫描件有提示)/ 网址自动抓取正文和配图(同源 /grab/ 反代,拒绝内网回环目标);纯文字素材自动补标题封面;
  • 纯文本模型也能出片:出片卡片新增提示「只需纯文本模型即可使用;模型支持多模态(视觉)就能自动生成出片」;未配视觉模型时剥掉图片块、按图片编号循环分配画面,纯文本主模型不再被顶回错误;
  • 断网 lint 门禁修复:external_refs 20 → 0(PDF.js 命名空间入册、示例域名清除、官方自有域名注明理由入白名单),构建门禁恢复全绿;
  • 首页移除品牌背书块:删掉「受到众多大品牌信赖」与 UCAP / 圆通 / 中国电信 / 中国移动 logo 区,功能展示与 AI 功能区直接衔接;
  • 移除 AI 视频生成 / AI 图片生成页签:左侧「AI创作」面板只保留「一键出片」与「生成结果」,生图 / 生视频走 AI 助手对话;
  • AI 默认接入官方网关:接口地址与模型全部预填,用户只需粘贴 API Key;
  • 「配置模型」统一入口:AI 面板里分散的设置按钮下线,全部收进编辑器右上角;
  • 模板导入连环崩溃修复:连续导入多个模板不再拖崩浏览器;
  • AI 生视频接口适配:视频生成路由修正,对话长请求预扣费问题修复;
  • 更多历史变更见 CHANGELOG.md。

💡 为什么值得用

  • 零门槛:不用装软件、不用注册登录,打开 https://cut.88531.cn 就开始剪;
  • 隐私友好:素材和工程不离开你的电脑,只有你主动使用 AI 时,相关文本 / 图片才会发给你配置的接口;
  • 免费:剪辑链路完全免费;AI 只需一个 API Key(去官方网关 ai.88531.cn 注册领取即可);
  • 完整链路:多轨时间轴、关键帧动画、GL 转场、LUT 滤镜、字幕、配音、抠图、二维码、图表到视频导出一条龙;
  • AI 真正融入剪辑:AI Agent 用自然语言直接操作时间轴("在 3 秒的位置剪一刀""复制 5 份依次延迟 0.2 秒");
  • 可私有化:Docker 一条命令部署到自己的服务器,数据完全自主。

✨ 关于米剪

米剪(MiCut)基于开源项目 UNICUT(无界云剪) 二次开发,保留其全部剪辑能力,并做了免登录、本机存储、离线可用、官方 AI 网关等面向公网开放使用的本地化改造。

UNICUT 是一款面向创作者、开发者与企业团队的在线视频编辑器。项目以剪映 / CapCut 一类产品的创作工作流为参照,将桌面剪辑软件常见的多轨时间轴、关键帧、转场、字幕、抠图、音视频处理和实时特效带到 Web 端,并进一步加入 AI Agent、生成式 AI 与浏览器端视觉模型。

这不是一个只能演示"裁剪 + 拼接"的概念项目。当前仓库已经包含完整的编辑器界面、实时画布、素材与属性面板、多轨时间轴、项目工作区、本地文件存储、媒体 Worker 和导出流程,可直接用于学习、体验,也可作为行业视频工具和企业内容平台的开发基础。

适合谁使用

角色 可以用米剪做什么
内容创作者 在浏览器中完成短视频、宣传片、课程、口播和社交媒体内容制作
前端 / 音视频开发者 学习 WebGL 渲染、Web 音视频处理、复杂时间轴与浏览器 AI 工程实践
企业研发团队 快速搭建内部剪辑平台、品牌内容工具、模板化生产系统或行业解决方案
生态开发者 扩展素材源、业务面板、自定义元素、特效、模板和 AI 工作流

🚀 核心价值

核心价值 说明
浏览器即用 无需安装大型桌面客户端,在线体验地址打开即可创作
完整剪辑链路 从素材导入、画布编排、多轨剪辑到视频导出形成闭环
实时视觉编辑 基于 PixiJS / WebGL 的所见即所得画布,操作结果即时反馈
AI 深度融入 AI 不仅生成素材,还能理解自然语言并直接操作编辑器(默认官方网关,仅需一个 API Key)
本地数据能力 工程和素材保存在用户授权的本地文件夹,元数据由 IndexedDB 管理,不上传服务器
面向业务扩展 支持注入 API、品牌配置、自定义侧边栏、资源地址和编辑器插件

🎬 核心能力

多轨时间轴与画布

  • 视频、图片、音频、文字、字幕、贴纸、特效等多类型轨道混合编排;
  • 拖拽、拉伸、分割、复制、删除、多选、批量移动和轨道排序;
  • 视频帧缩略图、音频波形、时间刻度、吸附对齐和时间轴缩放;
  • 轨道隐藏与锁定、撤销与重做、键盘快捷键;
  • 冻结帧、提取音频、画面裁剪、时间裁剪、静音和封面设置;
  • 在画布中直接移动、缩放、旋转、多选和调整图层关系。

元素、动画与视觉效果

类别 能力
视频 裁剪、分割、调色、变速、抠图、静音、音频分离、帧预览
图片 常见静态图片、GIF / APNG、滤镜、动画、裁剪与特效
文字 / 花字 字体、字号、描边、阴影、渐变、排版与逐字动画
音频 音量、淡入淡出、变速、波形、录音与 TTS
字幕 独立字幕轨道、样式编辑、手动打轴与语音识别生成
Lottie 贴纸 Lottie JSON 动画、播放速度和循环模式
转场 多种 GL Transitions 过渡效果与时长控制
滤镜 / 特效 LUT、基础调色、图层混合和 WebGL 实时效果
镜头 / 机位 多视角组织与镜头切换
二维码 内容、颜色、尺寸和容错级别配置
图表 基于 ECharts 的图表元素,目前仍在持续完善

动画系统支持入场、出场、强调、逐字、Lottie、转场和自定义关键帧动画。元素的位置、缩放、旋转、透明度等属性均可参与动画,并可通过贝塞尔曲线或直线路径创建自定义运动轨迹。

视觉处理覆盖基础调色、LUT 滤镜、图层混合、边框、阴影、渐变、绿幕 / 蓝幕抠像、形状蒙版、视频曲线变速以及多种 PixiJS / WebGL 实时特效。

抠图与智能处理

  • 钢笔路径抠图与魔棒相似色选区;
  • 常规画面裁剪与形状蒙版;
  • AI 主体抠图与人像分离;
  • AI 智能擦除与图像超分辨率;
  • 视频目标轨迹追踪。

素材、工程与导出

  • 视频、图片、音频、文字、贴纸、滤镜、特效、转场、字幕和模板分类;
  • 本地批量导入、拖拽添加、悬停预览、搜索和收藏;
  • 浏览器内录音、从视频提取音频、二维码扫码上传;
  • 新建、保存、另存为、复制、移动和删除工程;
  • 草稿、素材、模板和导出作品工作区;
  • 截取当前帧作为海报或视频封面;
  • 按分辨率、帧率等参数在浏览器本地导出。

🤖 AI:从生成素材到直接剪辑

米剪将 AI 放进真实编辑流程,而不是把它作为一个孤立的生成入口。

AI Agent:用自然语言操作编辑器

你可以直接向编辑器下达指令:

在 3 秒的位置剪一刀
把选中的文字改成「Hello MiCut」
复制这个元素 5 份,开始时间依次增加 0.2 秒
删除 2 到 5 秒之间的所有元素
给这个元素添加一段抖动动画
把这些元素的开始时间对齐

当前 Agent 已接入近 30 个底层编辑工具,覆盖元素查询与增删改、播放控制、时间定位、字幕管理、关键帧、动画、分割、复制、移动、轨道布局和批量时间段操作。AI 可以把复杂指令拆解为一系列编辑动作,减少重复、机械的时间轴操作。

AI 对话剪辑

AI 能力矩阵

场景 能力
自然语言剪辑 AI Agent 调用编辑器工具,直接修改元素、时间轴、字幕与动画
图片生成 文生图、图生图、多图参考生成(模型 flux-schnell)
视频生成 文文生视频、图生视频、首帧 / 首尾帧生视频(模型 inkling)
音频与字幕 语音识别字幕、文字转语音、多音色配音(本机 TTS,免费)
浏览器端视觉处理 人像分离、主体抠图、智能擦除、图像超分辨率
智能编辑 素材分析、自动化编辑流程、视频目标跟踪

Important

AI 对话、AI 一键出片、AI 生图 / 生视频默认接入官方 AI 网关(ai.88531.cn),在编辑器右上角「配置模型」粘贴一个 API Key 即可解锁,对话 mimo-v2.6-flash、视觉 deepseek-v4-flash-vision-exp、生图 flux-schnell、生视频 inkling 均已预填。配音(本机 edge-tts)、抠图、字幕、导出等能力不消耗任何外部额度。

MCP:让 AI 客户端直接调用米剪

米剪内置 MCP(Model Context Protocol)服务 unicut-mcp,站点同源端点 https://<站点>/mcp。接入后,Claude Desktop、Claude Code、Cursor、Hermes 等 AI 客户端可以把米剪当工具用:

🔒 端点强制授权:/mcp 暴露在公网,请求必须携带 Authorization: Bearer <MCP_AUTH_TOKEN>(令牌在项目 .env,未配置时拒绝一切调用),否则返回 401;各客户端带鉴权头的接入示例见 mcp/README.md。

工具 能力
grab_url 抓网页正文与配图(公众号文章可用,规则与编辑器内抓取一致)
generate_script 大模型生成短视频口播文案
tts / list_voices edge-tts 多音色配音(本机免费)
create_video_project 图片 + 文案 + 配音 → 生成米剪工程 ZIP,米剪「工程文件」一键导入即可出片
list_projects / read_project / write_project 工作文件夹模式下的工程读写

典型工作流:AI 抓文章 → 写口播 → 配音 → 生成工程 ZIP → 你在米剪导入。部署、客户端接入配置与工具明细见 mcp/README.md。

🧰 技术实现

米剪采用 React + TypeScript 构建编辑器界面与业务层,通过 MobX 管理复杂编辑状态;画布由 PixiJS / WebGL 实时渲染,音视频解码、处理和导出由 Web Worker、FFmpeg WebAssembly、MediaBunny 等能力协同完成。素材文件可写入用户授权的本地目录,工程元数据和文件句柄通过 Dexie / IndexedDB 管理。

主要技术栈

领域 技术
前端工程 React 18、TypeScript、Vite
UI 与状态 Semi Design、MobX、Less
画布与特效 PixiJS、WebGL、Three.js、GL Transitions
音视频处理 FFmpeg WebAssembly、MediaBunny、MP4 Muxer、Howler、Web Worker
浏览器 AI MediaPipe Tasks Vision、ONNX Runtime Web、OpenCV、Tesseract
本地数据 File System Access API、IndexedDB、Dexie
内容能力 Lottie、ECharts、GIF / APNG、JSZip、XLSX

🛠 快速开始

方式一:拉取镜像直接起(推荐,免构建)

docker pull gitea.88531.cn/jinghui/unicut:latest
docker run -d --name unicut -p 3006:80 -p 3005:443 \
  gitea.88531.cn/jinghui/unicut:latest

打开 http://服务器IP:3006 即用。Registry 地址 gitea.88531.cn 免登录可拉;镜像与源码构建产物完全一致,每次发版同步更新 latest 与 v1.0.1 两个 tag。

方式二:Docker Compose部署(源码 compose 构建)

完整 docker-compose.yml(含全部参数,与仓库根目录文件一致):

services:
  unicut:
    build: .
    container_name: unicut
    restart: always
    ports:
      - "3005:443"
      - "3006:80"
    environment:
      # 公网部署:不注入任何模型密钥,AI 功能一律用户自带 Key
      # 授权中心(auth.88531.cn)项目密钥:只注入 nginx 反代头,不进前端
      - HUB_KEY=${HUB_KEY:-}
      # 项目编号(非机密):启动时由 entrypoint 替换进前端包,用于公告/装机统计归属
      - HUB_PROJECT_ID=${HUB_PROJECT_ID:-}
    volumes:
      - certs:/etc/nginx/certs

  # 本机语音合成(edge-tts),给免登录版提供配音能力;源码在 ../unicut-tts
  unicut-tts:
    build: ../unicut-tts
    container_name: unicut-tts
    restart: always
    volumes:
      - ../unicut-tts/audio:/data/audio

  # MCP 服务(Model Context Protocol):AI 客户端经 https://<站点>/mcp 调用米剪能力
  # (抓取正文配图 / 大模型口播文案 / edge-tts 配音 / 生成米剪工程 ZIP)。
  # 密钥与站点地址从项目 .env 注入(MCP_LLM_KEY 等,勿提交仓库)。
  unicut-mcp:
    build: ./mcp
    container_name: unicut-mcp
    restart: always
    environment:
      - MCP_LLM_BASE=${MCP_LLM_BASE:-http://192.168.68.19:3099/v1}
      - MCP_LLM_KEY=${MCP_LLM_KEY:-}
      - MCP_LLM_MODEL=${MCP_LLM_MODEL:-mimo-v2.6-flash}
      - MCP_PUBLIC_URL=${MCP_PUBLIC_URL:-https://127.0.0.1:3005}
      - MCP_AUTH_TOKEN=${MCP_AUTH_TOKEN:-}
      - MCP_PROJECTS_DIR=${MCP_PROJECTS_DIR:-}
    volumes:
      # 生成的工程 ZIP / 配音 mp3 落盘(nginx /mcp-out/ 提供下载)
      - ./mcp-out:/data/out

volumes:
  certs:
git clone https://gitee.com/jinghui111/unicut.git
cd unicut
docker compose up -d unicut     # 只启动编辑器
docker compose up -d            # 全量(含配音 unicut-tts 与 MCP unicut-mcp)

首次构建包含前端打包,约需几分钟。完成后浏览器访问:

http://服务器IP:3006
  • 端口映射:3006 → 80(HTTP)、3005 → 443(HTTPS,自签证书,首次访问需接受一次证书警告);
  • 首次进入按提示选择一个本地文件夹并授权,工程与素材即保存在该文件夹;
  • 可选:在 .env 里配置 HUB_KEY / HUB_PROJECT_ID 接入授权中心(公告 / 版本检查),不配置不影响任何功能;
  • 可选:在 .env 里配置 MCP_LLM_KEY(OpenAI 兼容网关 Key)启用 MCP 的文案生成,AI 客户端连接 https://<站点>/mcp,工具明细见 mcp/README.md;不配置则除大模型类工具外均可使用;
  • 完整版另含配音服务 unicut-tts(本机 edge-tts),需单独部署该服务后用 docker compose up -d 全量启动;只用编辑器按上面的 up -d unicut 即可。

方式三:本地开发

环境要求:Git、Node.js 18+(推荐当前 LTS)、Yarn Classic、最新版 Chrome / Edge。File System Access API、部分 WebCodecs / WebGL 能力和本地 AI 推理依赖现代浏览器。

git clone https://gitee.com/jinghui111/unicut.git
cd unicut
yarn install
yarn dev

Vite 默认监听 3005 端口。请以终端实际输出为准,在浏览器中访问 https://localhost:3005。开发环境请通过 localhost 或 HTTPS 访问,不建议直接双击 index.html。

构建与预览

yarn build
yarn preview

构建产物位于 dist/,预览服务默认使用 8080 端口。

⚙️ 能力边界与私有化说明

当前仓库主要包含编辑器前端、浏览器媒体处理、本地工程 / 素材存储,以及 AI 客户端接入层。各类能力的默认边界如下:

能力 默认实现
画布、时间轴、属性编辑 浏览器前端与 video-core-sdk
本地素材与工程 File System Access API + IndexedDB(不上传服务器)
本地媒体处理与导出 Web Worker + 浏览器媒体能力 + FFmpeg WebAssembly
配音(TTS) 本机 edge-tts 服务,免费
浏览器端视觉模型 仓库内置模型资源与前端推理逻辑
AI 对话、生图、生视频 用户 API Key,默认官方网关 ai.88531.cn,也可换成任意 OpenAI 兼容接口
账号、云端合成 已下线(免登录、本地导出)

私有化部署时,可以替换 src/config/index.ts 中的域名配置,并按需接入自己的模型服务。请勿把 API Key、访问令牌或真实账号数据提交到仓库。

🧩 二次开发与集成

编辑器预留了多种注入点,适合企业集成、品牌定制与行业扩展:

配置项 用途
apiServer 接入自己的项目、素材、上传、AI 与导出服务
plugins 注册自定义编辑器元素和渲染能力
sides 增加自定义侧边栏入口和业务面板
resourcesHost 替换素材与公共资源域名
workerPath 指定媒体解码 Worker 地址
exConfig 控制 Logo、语言、项目按钮和品牌交互
movieData / appid 通过工程 JSON 或业务项目 ID 加载编辑器
saveAppCallback 保存后衔接企业内部工作流

仓库内置的二维码元素是一个可参考的插件实现:

src/pages/editor/plugins/qrcode

📁 目录结构

unicut/
├── docs/                         # 功能说明、产品文章与截图
├── public/
│   ├── assets/                   # FFmpeg、AI 模型、滤镜、蒙版等运行资源
│   └── worker/                   # 音视频解码 Worker
├── src/
│   ├── components/               # 通用组件(含 ai-settings 配置模型弹窗)
│   ├── config/                   # 运行配置与编辑器 SDK 类型
│   ├── database/                 # IndexedDB 数据结构
│   ├── language/                 # 中英文国际化
│   ├── layout/                   # 首页、用户、工作区和编辑器布局
│   ├── pages/
│   │   ├── editor/
│   │   │   ├── components/
│   │   │   │   ├── ai-chat/      # AI Agent
│   │   │   │   ├── canvas/       # 实时画布与播放器
│   │   │   │   ├── options/      # 元素属性、动画、滤镜和蒙版
│   │   │   │   ├── sources/      # 素材与 AI 面板
│   │   │   │   └── timeline2/    # 多轨时间轴与编辑工具
│   │   │   └── plugins/          # 编辑器插件
│   │   ├── home/                 # 产品首页
│   │   ├── user/                 # 账号与消息
│   │   └── workspace/            # 草稿、素材和作品管理
│   ├── server/                   # API 客户端基础层
│   ├── services/                 # 本地文件与工程服务
│   ├── stores/                   # MobX 状态
│   ├── theme/                    # 明暗主题
│   └── utils/                    # 导出、鉴权、事件与通用工具
├── package.json
└── vite.config.ts

🌍 浏览器与媒体兼容性

  • 推荐使用最新版桌面 Chrome;Edge 同样支持本地文件夹访问;
  • 移动端更适合预览和上传素材,完整剪辑建议使用桌面浏览器;
  • 媒体格式兼容性受浏览器解码器、WebCodecs 和 FFmpeg WebAssembly 支持情况影响;
  • 遇到素材无法解码时,建议先转换为 H.264 + AAC 编码的 MP4 或常见 Web 格式;
  • 大分辨率、长时长、多图层与复杂 AI 任务会占用较多内存和 GPU 资源。

🗺️ 欢迎共建的方向

  • 完善图表元素与更多数据可视化模板;
  • 扩展特效、转场、Lottie、滤镜和行业模板;
  • 增加编辑器插件示例与开发文档;
  • 提升大工程性能、稳定性与浏览器兼容性;
  • 补充单元测试、端到端测试、无障碍与国际化;
  • 改进 AI Agent 工具、提示词和可复用自动化流程。

🤝 参与共建

欢迎 Bug 修复、功能建议、性能优化、文档完善、设计改进,以及新的插件、素材和 AI 能力:

  1. Fork 本仓库(Gitee),并从 main 创建功能分支;
  2. 保持改动聚焦,必要时补充测试或复现步骤;
  3. 前端改动请附截图或录屏,说明浏览器和测试素材;
  4. 提交前运行 yarn build,并确认没有提交密钥、账号数据或未获许可的素材;
  5. 发起 Pull Request,清楚描述问题、方案和影响范围;
  6. 每次功能 / 修复改动都同步更新 CHANGELOG.md,写清改了什么、为什么。

提交 Issue 时,请尽量附上:

  • 浏览器与操作系统版本;
  • 可复现的最小工程或素材信息;
  • 操作步骤、期望行为与实际行为;
  • 控制台错误、截图或录屏。

❓ 常见问题

可以完全离线使用吗?

可以。本地工程、素材管理、剪辑、字幕、转场、配音(TTS)、抠图和视频导出全部在本机完成,不依赖任何在线服务。仅 AI 对话 / 生图 / 生视频需要网络,并需在右上角「配置模型」里配置 API Key(默认官方网关)。

可以部署到自己的服务器吗?

可以。Docker 一条命令即可部署(见「快速开始」),部署后整个站点归你所有,数据完全自主。

素材会自动上传吗?

不会。本地存储模式下,工程和素材保存在你授权的本地文件夹。只有你主动使用 AI 功能时,相关提示词 / 图片才会发送到你配置的接口(默认官方网关 ai.88531.cn)。

AI 功能要收费吗?

编辑器本身完全免费。AI 对话 / 生图 / 生视频使用你自己的 API Key(BYOK):去 ai.88531.cn 注册领取 Key,在右上角「配置模型」粘贴即可;剪辑链路(含配音、抠图、导出)不消耗任何额度。

为什么推荐 Chrome / Edge?

本地文件夹读写依赖 File System Access API,部分媒体处理和 AI 推理也依赖较新的 WebGL、WebAssembly、WebCodecs 或 WebGPU 能力。Chromium 系浏览器目前能提供更完整、稳定的体验。

🔗 相关链接

📜 开源协议与授权说明

本项目沿用上游 UNICUT 的项目专属开源协议:基于 Apache License 2.0 修改,不是未经修改的标准 Apache 2.0 许可证。除 Apache 2.0 的一般条款外,仓库协议还包含额外条件,包括但不限于:

  • 未经书面授权,不得使用源码运营多租户环境;
  • 使用前端时,不得移除或修改产品 Logo 与版权信息;
  • 符合协议所述条件的场景需要获得商业授权;
  • 产品交互设计受外观专利保护;
  • 贡献代码可能被项目方用于商业用途。

阅读完整协议文件 → LICENSE

Warning

下载、使用、部署、二次开发或贡献代码,即表示你需要遵守仓库中的完整协议。用于生产、商用、SaaS、多租户或品牌定制前,请务必先阅读协议;如有疑问,请通过仓库联系维护者确认授权边界。


米剪 MiCut · 打开网页就能剪视频,素材留在你的电脑里。

在线体验:https://cut.88531.cn · 基于 UNICUT 二次开发