文档

米剪 (UNICUT) 使用教程

它是什么、适合谁

米剪（MiCut）是一个打开网页就能用的视频剪辑器：不用装桌面软件、不用注册登录，剪辑、字幕、转场、配音、抠图、导出全部在浏览器里完成，而且工程和素材只保存在你授权的本地文件夹，不上传服务器。它基于开源项目 UNICUT 二次开发，保留了原版全部剪辑能力（多轨时间轴、关键帧、GL 转场、LUT 滤镜、AI Agent 语音剪辑等）。

适合三类人：想快速剪短视频/口播/课程的内容创作者；想学习 WebGL 渲染与浏览器音视频工程的前端开发者；想在自己服务器上搭一套内部剪辑工具的团队（Docker 一条命令即可私有化）。

快速开始

三选一：

方式一：拉镜像直接起（推荐，免构建）

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 即用（3005 是 HTTPS 端口，自签证书需接受一次警告）。

方式二：源码 compose 构建

git clone https://gitee.com/jinghui111/unicut.git
cd unicut
docker compose up -d unicut     # 首次构建含前端打包，约几分钟

方式三：本地开发

yarn install && yarn dev        # 需要 Node 18+ 与 Yarn Classic
# 浏览器访问 https://localhost:3005

在线版无需部署，直接打开 https://cut.88531.cn （建议最新版 Chrome / Edge）。

界面速览

首页（Hero 区、编辑器界面示意与分步教程）：

01-home

编辑器（打开后的编辑视图）：

02-editor

常用操作

  1. 首次创建本地项目：按页面提示选择一个文件夹并授予读写权限，之后工程与素材都保存在该文件夹（元数据用 IndexedDB 管理），关掉浏览器不丢。
  2. 导入素材：本地批量导入或直接拖进时间轴，支持悬停预览、搜索、收藏；素材无法解码时先转成 H.264 + AAC 的 MP4。
  3. 多轨剪辑：视频、图片、音频、文字、字幕、贴纸、特效多轨混排，拖拽/分割/复制/多选、轨道隐藏与锁定、撤销重做、快捷键齐备；画布中直接移动、缩放、旋转。
  4. 配置 AI（用到 AI 才需要）：编辑器右上角「配置模型」→ 粘贴一个 API Key 即可，接口地址与四个模型（对话 mimo-v2.6-flash、视觉 deepseek-v4-flash-vision-exp、生图 flux-schnell、生视频 inkling）都已预填官方网关 ai.88531.cn，可自行换成任意 OpenAI 兼容接口。
  5. AI 一键出片：AI 面板顶部入口卡 → 添加图片 + 标题 → AI 生成口播文案 → 试听 13 种中文音色（含方言）→ 确认后直接排入时间轴，生成前可调转场、动效、字幕位置与配色。
  6. AI Agent 语音剪辑：直接说「在 3 秒的位置剪一刀」「复制这个元素 5 份，开始时间依次增加 0.2 秒」，Agent 已接入近 30 个编辑工具。
  7. 导出：按分辨率、帧率等参数在浏览器本地导出，可截取当前帧作封面。

常见问题

更新与版本

以下为 CHANGELOG.md 最近两个日期的要点（当前在线版对应 2026-10-28 改造）：