README/CHANGELOG 全面改版并推送:米剪定位+本次更新清单+Docker/源码两种安装+体验地址 cut.88531.cn+更新日志入口

功能更新(随本次提交入库):
- 「配置模型」统一入口:编辑器右上角一个弹窗管接口地址/Key/四个模型,AI 面板分散按钮下线
- 官方 AI 网关默认:baseUrl ai.88531.cn/v1,模型预填(mimo-v2.6-flash/deepseek-v4-flash-vision-exp/flux-schnell/inkling),用户只填自己的 Key;引导文案统一推荐官方 AI,下线注册引导与体验金口径
- AI 生视频路由 /videos/generations → /v1/video/generations;对话补 max_tokens 4096 防预扣费 402
- 模板导入连环崩溃修复:在线重挂改落盘+整页刷新(与工程文件导入同款路径),Playwright 连续 2 导入验证无崩溃
- CHANGELOG 补录以上条目;贡献规范要求每次改动同步更新日志
This commit is contained in:
personal827 committed 2026-10-29 15:44:55 +08:00
1 parent c4e04d4dda
commit bd1acbd9ca
16 files changed
+305 -241

No files matched your search

+22
View File
@@ -8,6 +8,28 @@
### ✨ 新功能
**「配置模型」统一入口(右上角)**
- 编辑器右上角常驻「配置模型」按钮:接口地址、API Key、对话 / 视觉 / 生图 / 生视频模型,一个弹窗管完
- AI 对话面板与 AI 面板里分散的设置按钮下线;两处未配置时只保留引导卡,统一指路右上角
- 配置仍存浏览器 localStorage(`micut.ai.config.v1`),不上传、不落服务端;弹窗内可一键清除 Key
**官方 AI 网关默认(ai.88531.cn)**
- AI 默认接口地址 `https://ai.88531.cn/v1`,模型全部预填,用户只需粘贴自己的 API Key
- 默认模型对齐网关实名清单:对话 `mimo-v2.6-flash`、视觉 `deepseek-v4-flash-vision-exp`、备用 `glm-5.3-flash` / `deepseek-v4-flash`、生图 `flux-schnell`、生视频 `inkling`(逐一核对过网关 `/v1/models`,均为实际可用模型)
- 未配置引导卡、Toast、报错文案统一改为「推荐官方 AI:去 ai.88531.cn 获取 Key,右上角「配置模型」粘贴即可」;下线「没有 Key?免费注册领取」按钮与「注册即送体验金」口径
- `public/local-ai.json.example` 同步为官方网关示例(占位符写法,严禁提交真实 Key)
- 修复:AI 生视频创建 / 轮询路径由 `/videos/generations` 修正为 `/v1/video/generations`(对齐网关路由);对话请求补 `max_tokens: 4096`,避免长请求在网关侧预扣费返回 402
**模板导入连环崩溃修复**
- 现象:导入第一个模板正常,再导入第二个模板页面无响应、标签崩溃,此后模板面板卡 loading
- 根因:模板导入走「替换 `editor.data` + `movieDataUpdateKey++`」在线重挂画布引擎,旧引擎 WebGL / 实例不彻底释放,累积拖崩渲染进程(Playwright 稳定复现 Target crashed,无 JS 报错)
- 修复:模板导入改为与「工程文件」导入同款路径——落盘(本地 IndexedDB + `projects/<appId>.json`,或远程 updateApp)后 `location.reload()` 整页刷新,编辑器启动时读回新数据;落盘失败自动回退原在线重挂保底
- 验证:Playwright 复现脚本连续导入 2 个模板(bug 最小路径)——修复前第二次导入必现 Target crashed,修复后两次导入全部成功,无崩溃、无 JS 报错,画布快照正常且两次内容不同(第二个模板真实生效);仅剩刷新导航瞬间中断的模板素材请求(ERR_ABORTED,属预期)
**项目 README 重写 + 更新日志制度**
- README 全面改版:米剪定位(基于 UNICUT 二次开发)、本次更新清单、为什么值得用、Docker / 源码两种安装方式、体验地址 `https://cut.88531.cn`、更新日志入口;移除上游 GitHub 徽章与 unicut.h5ds.com 体验链接
- 贡献规范新增:每次功能 / 修复改动必须同步更新 CHANGELOG.md
**AI 全面 BYOK(用户自备 API Key)**
- AI 对话、AI 一键出片、AI 生图、AI 生视频一律要求先配置 API Key 才能使用;未配置时 AI 面板整体替换为引导卡片,基础剪辑(导入素材、时间轴、字幕、转场、导出)完全不受影响
- 新增 `src/utils/aiAuth.ts`:配置存浏览器 localStorage(`micut.ai.config.v1`),不需要登录,也不经过服务端;提供订阅机制,改完立即生效
+117 -80
View File
@@ -1,57 +1,84 @@
<div align="center">
<h1>UNICUT · 无界云剪</h1>
<h1>米剪 MiCut</h1>
<p><strong>AI 驱动的开源 Web 视频编辑器</strong></p>
<p>把多轨剪辑、动画特效、智能处理与 AI 创作带进浏览器,让视频生产无需安装、打开即用。</p>
<p><strong>免登录 · 开箱即用的 AI 视频剪辑器</strong>(基于开源项目 UNICUT 二次开发)</p>
<p>把多轨剪辑、动画特效、智能处理与 AI 创作带进浏览器,打开网页就能剪视频,工程与素材留在你的电脑里。</p>
<p>
<a href="https://unicut.h5ds.com/"><strong>在线体验</strong></a>
<a href="https://cut.88531.cn/"><strong>🚀 在线体验:https://cut.88531.cn</strong></a>
·
<a href="#-核心能力">核心能力</a>
<a href="#-本仓库更新了什么">本次更新</a>
·
<a href="#-快速开始">快速开始</a>
·
<a href="#-二次开发与集成">二次开发</a>
·
<a href="#-参与共建">参与共建</a>
<a href="https://gitee.com/jinghui111/unicut/blob/main/CHANGELOG.md">更新日志</a>
</p>
<p>
<a href="https://github.com/mtsee/unicut/stargazers"><img src="https://img.shields.io/github/stars/mtsee/unicut?style=flat-square&logo=github&label=Stars" alt="GitHub Stars" /></a>
<a href="https://github.com/mtsee/unicut/network/members"><img src="https://img.shields.io/github/forks/mtsee/unicut?style=flat-square&logo=github&label=Forks" alt="GitHub Forks" /></a>
<a href="https://github.com/mtsee/unicut/issues"><img src="https://img.shields.io/github/issues/mtsee/unicut?style=flat-square&logo=github&label=Issues" alt="GitHub Issues" /></a>
<img src="https://img.shields.io/badge/React-18-61DAFB?style=flat-square&logo=react&logoColor=black" alt="React 18" />
<img src="https://img.shields.io/badge/TypeScript-5-3178C6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript 5" />
<img src="https://img.shields.io/badge/Vite-4-646CFF?style=flat-square&logo=vite&logoColor=white" alt="Vite 4" />
<img src="https://img.shields.io/badge/免费开源-Apache--2.0%20系-green?style=flat-square" alt="开源免费" />
</p>
</div>
![UNICUT 编辑器界面](./editor.png)
![米剪编辑器界面](./editor.png)
## 🌐 在线体验
无需下载安装,也无需准备开发环境,使用桌面浏览器即可进入 UNICUT:
无需下载安装,也无需注册登录,桌面浏览器打开即用:
### [立即体验 UNICUT → https://unicut.h5ds.com/](https://unicut.h5ds.com/)
### [🚀 立即体验 → https://cut.88531.cn](https://cut.88531.cn/)
建议使用最新版 Chrome 或 Edge。首次创建本地项目时,请根据页面提示选择一个文件夹并授予读写权限,随后即可导入素材,体验多轨时间轴、画布编辑、动画、滤镜、特效、字幕和视频导出等流程。
建议使用最新版 Chrome 或 Edge。首次创建本地项目时,按页面提示选择一个文件夹并授予读写权限(工程与素材都保存在你自己的电脑里),随后即可导入素材,体验多轨时间轴、画布编辑、动画、滤镜、特效、字幕和视频导出等流程。
> [!NOTE]
> AI 对话、AI 生图 / 生视频、语音和云端合成等在线能力可能需要登录、网络连接或相应服务额度。
> 剪辑、字幕、转场、配音、抠图、导出全部免费,且大部分离线可用;AI 对话 / 生图 / 生视频在编辑器右上角「配置模型」粘贴一个 API Key 即可解锁——接口地址与模型已默认填好官方 AI 网关,只需填 Key。
## ✨ 关于 UNICUT
## 🆕 本仓库更新了什么
UNICUT(无界云剪)是一款面向创作者、开发者与企业团队的在线视频编辑器。项目以剪映 / CapCut 一类产品的创作工作流为参照,将桌面剪辑软件常见的多轨时间轴、关键帧、转场、字幕、抠图、音视频处理和实时特效带到 Web 端,并进一步加入 AI Agent、生成式 AI 与浏览器端视觉模型。
本仓库是 UNICUT 的二次开发版(产品名:**米剪 MiCut**),围绕"开放给所有人直接使用"做了大量本地化改造,完整列表见 [更新日志](./CHANGELOG.md),主要包括:
这不是一个只能演示“裁剪 + 拼接”的概念项目。当前仓库已经包含完整的编辑器界面、实时画布、素材与属性面板、多轨时间轴、项目工作区、本地文件存储、媒体 Worker 和导出流程,可直接用于学习、体验,也可作为行业视频工具和企业内容平台的开发基础。
| 更新 | 说明 |
| --- | --- |
| 免登录使用 | 打开即用,注册登录环节全部移除 |
| 素材不出本机 | 工程与素材保存在浏览器授权的本地文件夹(IndexedDB + 本地目录),不上传服务器 |
| 离线可用 | 本地存储、媒体处理、配音、抠图、导出不依赖任何在线服务;产物通过断网 lint(外链为 0)门禁 |
| 官方 AI 网关默认 | AI 默认接入官方网关 `https://ai.88531.cn/v1`,对话 / 视觉 / 生图 / 生视频模型全部预填,用户只需粘贴自己的 API Key |
| 「配置模型」统一入口 | 编辑器右上角一个按钮,统一管理接口地址、API Key 与四个模型 |
| AI 一键出片 | 添加图片 → AI 生成口播文案 → 13 种人声配音试听 → 一键排入时间轴,转场 / 动效 / 字幕样式可调 |
| 模板导入修复 | 修复"导入第一个模板后,再导入会把浏览器拖崩"的问题,支持连续换模板 |
| 品牌与首页 | 产品名改为米剪,首页新增导航站 / 开源地址入口,移除收费栏目与账号类外链 |
| 接入授权中心 | 版本号、公告、检查更新(授权中心不可达时静默降级,绝不拦功能) |
微信群:
### 最近更新(2026-10-28)
![qrcode](./qrcode.jpg)
- **AI 默认接入官方网关**:接口地址与模型全部预填,用户只需粘贴 API Key;
- **「配置模型」统一入口**:AI 面板里分散的设置按钮下线,全部收进编辑器右上角;
- **模板导入连环崩溃修复**:连续导入多个模板不再拖崩浏览器;
- **AI 生视频接口适配**:视频生成路由修正,对话长请求预扣费问题修复;
- 更多历史变更见 [CHANGELOG.md](./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(无界云剪)](https://gitee.com/676015863/unicut) 二次开发,保留其全部剪辑能力,并做了免登录、本机存储、离线可用、官方 AI 网关等面向公网开放使用的本地化改造。
UNICUT 是一款面向创作者、开发者与企业团队的在线视频编辑器。项目以剪映 / CapCut 一类产品的创作工作流为参照,将桌面剪辑软件常见的多轨时间轴、关键帧、转场、字幕、抠图、音视频处理和实时特效带到 Web 端,并进一步加入 AI Agent、生成式 AI 与浏览器端视觉模型。
这不是一个只能演示"裁剪 + 拼接"的概念项目。当前仓库已经包含完整的编辑器界面、实时画布、素材与属性面板、多轨时间轴、项目工作区、本地文件存储、媒体 Worker 和导出流程,可直接用于学习、体验,也可作为行业视频工具和企业内容平台的开发基础。
### 适合谁使用
| 角色 | 可以用 UNICUT 做什么 |
| 角色 | 可以用米剪做什么 |
| --- | --- |
| 内容创作者 | 在浏览器中完成短视频、宣传片、课程、口播和社交媒体内容制作 |
| 前端 / 音视频开发者 | 学习 WebGL 渲染、Web 音视频处理、复杂时间轴与浏览器 AI 工程实践 |
@@ -62,11 +89,11 @@ UNICUT(无界云剪)是一款面向创作者、开发者与企业团队的
| 核心价值 | 说明 |
| --- | --- |
| 浏览器即用 | 无需安装大型桌面客户端,在线体验地址打开即可创作 |
| 浏览器即用 | 无需安装大型桌面客户端,[在线体验地址](https://cut.88531.cn/)打开即可创作 |
| 完整剪辑链路 | 从素材导入、画布编排、多轨剪辑到视频导出形成闭环 |
| 实时视觉编辑 | 基于 PixiJS / WebGL 的所见即所得画布,操作结果即时反馈 |
| AI 深度融入 | AI 不仅生成素材,还能理解自然语言并直接操作编辑器 |
| 本地数据能力 | 工程和素材可保存到用户授权的本地文件夹,元数据由 IndexedDB 管理 |
| AI 深度融入 | AI 不仅生成素材,还能理解自然语言并直接操作编辑器(默认官方网关,仅需一个 API Key) |
| 本地数据能力 | 工程和素材保存在用户授权的本地文件夹,元数据由 IndexedDB 管理,不上传服务器 |
| 面向业务扩展 | 支持注入 API、品牌配置、自定义侧边栏、资源地址和编辑器插件 |
## 🎬 核心能力
@@ -116,11 +143,11 @@ UNICUT(无界云剪)是一款面向创作者、开发者与企业团队的
- 新建、保存、另存为、复制、移动和删除工程;
- 草稿、素材、模板和导出作品工作区;
- 截取当前帧作为海报或视频封面;
- 按分辨率、帧率等参数在浏览器本地导出,也可对接云端合成服务。
- 按分辨率、帧率等参数在浏览器本地导出。
## 🤖 AI:从生成素材到直接剪辑
UNICUT 将 AI 放进真实编辑流程,而不是把它作为一个孤立的生成入口。
米剪将 AI 放进真实编辑流程,而不是把它作为一个孤立的生成入口。
### AI Agent:用自然语言操作编辑器
@@ -128,7 +155,7 @@ UNICUT 将 AI 放进真实编辑流程,而不是把它作为一个孤立的生
```text
在 3 秒的位置剪一刀
把选中的文字改成「Hello UNICUT」
把选中的文字改成「Hello MiCut」
复制这个元素 5 份,开始时间依次增加 0.2 秒
删除 2 到 5 秒之间的所有元素
给这个元素添加一段抖动动画
@@ -144,18 +171,18 @@ UNICUT 将 AI 放进真实编辑流程,而不是把它作为一个孤立的生
| 场景 | 能力 |
| --- | --- |
| 自然语言剪辑 | AI Agent 调用编辑器工具,直接修改元素、时间轴、字幕与动画 |
| 图片生成 | 文生图、图生图、多图参考生成 |
| 视频生成 | 文生视频、图生视频、首帧 / 首尾帧生视频 |
| 音频与字幕 | 语音识别字幕、文字转语音、多音色配音 |
| 图片生成 | 文生图、图生图、多图参考生成(模型 `flux-schnell`) |
| 视频生成 | 文文生视频、图生视频、首帧 / 首尾帧生视频(模型 `inkling`) |
| 音频与字幕 | 语音识别字幕、文字转语音、多音色配音(本机 TTS,免费) |
| 浏览器端视觉处理 | 人像分离、主体抠图、智能擦除、图像超分辨率 |
| 智能编辑 | 素材分析、自动化编辑流程、视频目标跟踪 |
> [!IMPORTANT]
> 仓库同时包含浏览器本地能力与在线服务接入。部分视觉模型和素材处理可直接在浏览器中执行;账号、在线素材、AI 对话、生成式 AI、语音服务和云端合成等功能需要相应 API、模型服务或额度支持。
> AI 对话、AI 一键出片、AI 生图 / 生视频默认接入官方 AI 网关(`ai.88531.cn`),在编辑器右上角「配置模型」粘贴一个 API Key 即可解锁,对话 `mimo-v2.6-flash`、视觉 `deepseek-v4-flash-vision-exp`、生图 `flux-schnell`、生视频 `inkling` 均已预填。配音(本机 edge-tts)、抠图、字幕、导出等能力不消耗任何外部额度。
## 🧰 技术实现
UNICUT 采用 React + TypeScript 构建编辑器界面与业务层,通过 MobX 管理复杂编辑状态;画布由 PixiJS / WebGL 实时渲染,音视频解码、处理和导出由 Web Worker、FFmpeg WebAssembly、MediaBunny 等能力协同完成。素材文件可写入用户授权的本地目录,工程元数据和文件句柄通过 Dexie / IndexedDB 管理。
米剪采用 React + TypeScript 构建编辑器界面与业务层,通过 MobX 管理复杂编辑状态;画布由 PixiJS / WebGL 实时渲染,音视频解码、处理和导出由 Web Worker、FFmpeg WebAssembly、MediaBunny 等能力协同完成。素材文件可写入用户授权的本地目录,工程元数据和文件句柄通过 Dexie / IndexedDB 管理。
### 主要技术栈
@@ -171,31 +198,37 @@ UNICUT 采用 React + TypeScript 构建编辑器界面与业务层,通过 MobX
## 🛠 快速开始
### 环境准备
- Git;
- Node.js 18+,推荐使用当前 LTS 版本;
- Yarn Classic;
- 最新版 Chrome 或 Edge。
File System Access API、部分 WebCodecs / WebGL 能力和本地 AI 推理依赖现代浏览器。开发环境请通过 `localhost` 或 HTTPS 访问,不建议直接双击 `index.html`。
### 获取代码并启动
### 方式一:Docker 部署(推荐)
```bash
git clone https://github.com/mtsee/unicut.git
git clone https://gitee.com/jinghui111/unicut.git
cd unicut
docker compose up -d unicut
```
首次构建包含前端打包,约需几分钟。完成后浏览器访问:
```text
http://服务器IP:3006
```
- 端口映射:`3006 → 80`(HTTP)、`3005 → 443`(HTTPS,自签证书,首次访问需接受一次证书警告);
- 首次进入按提示选择一个本地文件夹并授权,工程与素材即保存在该文件夹;
- 可选:在 `.env` 里配置 `HUB_KEY` / `HUB_PROJECT_ID` 接入授权中心(公告 / 版本检查),不配置不影响任何功能;
- 完整版另含配音服务 `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 推理依赖现代浏览器。
```bash
git clone https://gitee.com/jinghui111/unicut.git
cd unicut
yarn install
yarn dev
```
Vite 默认监听 `3005` 端口。请以终端实际输出为准,在浏览器中访问:
```text
https://localhost:3005
```
首次进入本地工作区时,浏览器会请求选择一个文件夹,用于保存素材和工程数据。请授予读写权限;后续可以在浏览器设置中撤销授权。
Vite 默认监听 `3005` 端口。请以终端实际输出为准,在浏览器中访问 `https://localhost:3005`。开发环境请通过 `localhost` 或 HTTPS 访问,不建议直接双击 `index.html`。
### 构建与预览
@@ -208,21 +241,19 @@ yarn preview
## ⚙️ 能力边界与私有化说明
当前仓库主要包含编辑器前端、浏览器媒体处理、本地工程 / 素材存储,以及在线服务的客户端接入层。为了帮助二次开发者准确评估接入成本,各类能力的默认边界如下:
当前仓库主要包含编辑器前端、浏览器媒体处理、本地工程 / 素材存储,以及 AI 客户端接入层。各类能力的默认边界如下:
| 能力 | 默认实现 |
| --- | --- |
| 画布、时间轴、属性编辑 | 浏览器前端与 `video-core-sdk` |
| 本地素材与工程 | File System Access API + IndexedDB |
| 本地素材与工程 | File System Access API + IndexedDB(不上传服务器) |
| 本地媒体处理与导出 | Web Worker + 浏览器媒体能力 + FFmpeg WebAssembly |
| 配音(TTS) | 本机 edge-tts 服务,免费 |
| 浏览器端视觉模型 | 仓库内置模型资源与前端推理逻辑 |
| 账号、官方素材与任务中心 | 依赖在线服务接口 |
| AI 对话、生成式 AI、语音服务 | 依赖对应模型和服务端 API |
| 云端视频合成 | 依赖单独的渲染与任务服务 |
| AI 对话、生图、生视频 | 用户 API Key,默认官方网关 `ai.88531.cn`,也可换成任意 OpenAI 兼容接口 |
| 账号、云端合成 | 已下线(免登录、本地导出) |
开发服务器已为 `/api` 和 `/cgi-bin` 配置代理,默认连接 UNICUT 在线服务。私有化部署时,可以替换 `src/config/index.ts` 中的 API、资源域名和 Worker 地址,并根据 `APIServer` 类型接入自己的项目、素材、上传、AI 与导出服务。
如果只研究编辑器或本地处理能力,可以先从本地存储模式开始,不必一次接入全部在线服务。请勿把服务密钥、访问令牌或真实账号数据提交到仓库。
私有化部署时,可以替换 `src/config/index.ts` 中的域名配置,并按需接入自己的模型服务。请勿把 API Key、访问令牌或真实账号数据提交到仓库。
## 🧩 二次开发与集成
@@ -254,7 +285,7 @@ unicut/
│ ├── assets/ # FFmpeg、AI 模型、滤镜、蒙版等运行资源
│ └── worker/ # 音视频解码 Worker
├── src/
│ ├── components/ # 通用组件
│ ├── components/ # 通用组件(含 ai-settings 配置模型弹窗)
│ ├── config/ # 运行配置与编辑器 SDK 类型
│ ├── database/ # IndexedDB 数据结构
│ ├── language/ # 中英文国际化
@@ -293,48 +324,52 @@ unicut/
- 完善图表元素与更多数据可视化模板;
- 扩展特效、转场、Lottie、滤镜和行业模板;
- 增加编辑器插件示例与开发文档;
- 完善私有化 API 接入说明;
- 提升大工程性能、稳定性与浏览器兼容性;
- 补充单元测试、端到端测试、无障碍与国际化;
- 改进 AI Agent 工具、提示词和可复用自动化流程。
## 🤝 参与共建
我们欢迎 Bug 修复、功能建议、性能优化、文档完善、设计改进,以及新的插件、素材和 AI 能力。
欢迎 Bug 修复、功能建议、性能优化、文档完善、设计改进,以及新的插件、素材和 AI 能力:
1. Fork 本仓库,并从 `main` 创建功能分支;
1. Fork 本仓库([Gitee](https://gitee.com/jinghui111/unicut)),并从 `main` 创建功能分支;
2. 保持改动聚焦,必要时补充测试或复现步骤;
3. 前端改动请附截图或录屏,说明浏览器和测试素材;
4. 提交前运行 `yarn build`,并确认没有提交密钥、账号数据或未获许可的素材;
5. 发起 Pull Request,清楚描述问题、方案和影响范围。
5. 发起 Pull Request,清楚描述问题、方案和影响范围;
6. **每次功能 / 修复改动都同步更新 [CHANGELOG.md](./CHANGELOG.md)**,写清改了什么、为什么。
提交 [GitHub Issue](https://github.com/mtsee/unicut/issues) 时,请尽量附上:
提交 Issue 时,请尽量附上:
- 浏览器与操作系统版本;
- 可复现的最小工程或素材信息;
- 操作步骤、期望行为与实际行为;
- 控制台错误、截图或录屏。
如果 UNICUT 对你有帮助,欢迎点亮 Star、分享给更多创作者,或认领一个你感兴趣的 Issue。
## ❓ 常见问题
<details>
<summary><strong>UNICUT 可以完全离线使用吗?</strong></summary>
<summary><strong>可以完全离线使用吗?</strong></summary>
本地工程、素材管理以及部分浏览器端媒体 / AI 处理能力可以在本地运行;在线素材、账号、AI 对话、生成式 AI、语音服务和云端合成等能力仍需要网络及对应服务。
可以。本地工程、素材管理、剪辑、字幕、转场、配音(TTS)、抠图和视频导出全部在本机完成,不依赖任何在线服务。仅 AI 对话 / 生图 / 生视频需要网络,并需在右上角「配置模型」里配置 API Key(默认官方网关)。
</details>
<details>
<summary><strong>可以部署到自己的服务器吗?</strong></summary>
可以部署前端并进行二次开发。若要提供完整的平台能力,需要自行实现或接入项目、素材、用户、AI 和渲染等服务端接口。
可以。Docker 一条命令即可部署(见「快速开始」),部署后整个站点归你所有,数据完全自主。
</details>
<details>
<summary><strong>素材会自动上传吗?</strong></summary>
本地存储模式下,工程和素材保存在用户授权的本地文件夹中。当你主动使用在线素材、云端 AI、语音识别、生成或云合成等能力时,相关数据可能需要发送到对应服务。私有化部署方应根据自己的服务实现提供清晰的隐私说明。
不会。本地存储模式下,工程和素材保存在你授权的本地文件夹。只有你主动使用 AI 功能时,相关提示词 / 图片才会发送到你配置的接口(默认官方网关 `ai.88531.cn`)。
</details>
<details>
<summary><strong>AI 功能要收费吗?</strong></summary>
编辑器本身完全免费。AI 对话 / 生图 / 生视频使用你自己的 API Key(BYOK):去 `ai.88531.cn` 注册领取 Key,在右上角「配置模型」粘贴即可;剪辑链路(含配音、抠图、导出)不消耗任何额度。
</details>
<details>
@@ -345,17 +380,19 @@ unicut/
## 🔗 相关链接
- 在线体验:[https://unicut.h5ds.com/](https://unicut.h5ds.com/)
- GitHub:[https://github.com/mtsee/unicut](https://github.com/mtsee/unicut)
- Gitee 镜像:[https://gitee.com/676015863/unicut](https://gitee.com/676015863/unicut)
- 在线体验:[https://cut.88531.cn](https://cut.88531.cn/)
- 源码仓库:[https://gitee.com/jinghui111/unicut](https://gitee.com/jinghui111/unicut)(自建 Gitea 自动同步,含全部本地化改造)
- 更新日志:[CHANGELOG.md](./CHANGELOG.md)
- 完整功能清单:[docs/功能清单.md](./docs/功能清单.md)
- 导航站:[https://nav.88531.cn](https://nav.88531.cn)
- 上游开源项目:[UNICUT(676015863/unicut)](https://gitee.com/676015863/unicut)
## 📜 开源协议与授权说明
UNICUT 使用基于 Apache License 2.0 修改的**项目专属开源协议**,不是未经修改的标准 Apache 2.0 许可证。除 Apache 2.0 的一般条款外,仓库协议还包含额外条件,包括但不限于:
本项目沿用上游 UNICUT 的项目专属开源协议:基于 Apache License 2.0 修改,**不是未经修改的标准 Apache 2.0 许可证**。除 Apache 2.0 的一般条款外,仓库协议还包含额外条件,包括但不限于:
- 未经书面授权,不得使用 UNICUT 源码运营多租户环境;
- 使用 UNICUT 前端时,不得移除或修改产品 Logo 与版权信息;
- 未经书面授权,不得使用源码运营多租户环境;
- 使用前端时,不得移除或修改产品 Logo 与版权信息;
- 符合协议所述条件的场景需要获得商业授权;
- 产品交互设计受外观专利保护;
- 贡献代码可能被项目方用于商业用途。
@@ -363,11 +400,11 @@ UNICUT 使用基于 Apache License 2.0 修改的**项目专属开源协议**,
### [阅读完整协议文件 → LICENSE](./LICENSE)
> [!WARNING]
> 下载、使用、部署、二次开发或贡献代码,即表示你需要遵守仓库中的完整协议。用于生产、商用、SaaS、多租户或品牌定制前,请务必先阅读协议;如有疑问,请通过项目仓库联系维护者确认授权边界。
> 下载、使用、部署、二次开发或贡献代码,即表示你需要遵守仓库中的完整协议。用于生产、商用、SaaS、多租户或品牌定制前,请务必先阅读协议;如有疑问,请通过仓库联系维护者确认授权边界。
---
<div align="center">
<p><strong>让专业视频创作留在浏览器,也让每个人都能参与塑造下一代开源剪辑工具。</strong></p>
<p>Made with creativity by the UNICUT community.</p>
<p><strong>米剪 MiCut · 打开网页就能剪视频,素材留在你的电脑里。</strong></p>
<p>在线体验:https://cut.88531.cn · 基于 UNICUT 二次开发</p>
</div>
+1 -2
View File
@@ -7,8 +7,7 @@ services:
- "3005:443"
- "3006:80"
environment:
- OMNI_KEY=${OMNI_KEY:-}
- CI_KEY=${CI_KEY:-}
# 公网部署:不注入任何模型密钥,AI 功能一律用户自带 Key
# 授权中心(auth.88531.cn)项目密钥:只注入 nginx 反代头,不进前端
- HUB_KEY=${HUB_KEY:-}
# 项目编号(非机密):启动时由 entrypoint 替换进前端包,用于公告/装机统计归属
+2 -12
View File
@@ -14,18 +14,8 @@ if [ ! -f "$CERT_DIR/server.crt" ]; then
echo "已生成自签证书"
fi
# 注入本机 AI 网关密钥(compose environment / .env 提供)
if [ -n "$CI_KEY" ]; then
sed -i "s|__CI_KEY__|$CI_KEY|g" /etc/nginx/conf.d/default.conf
else
echo "警告:未设置 CI_KEY,/civideo 反代将鉴权失败"
fi
if [ -n "$OMNI_KEY" ]; then
sed -i "s|__OMNI_KEY__|$OMNI_KEY|g" /etc/nginx/conf.d/default.conf
else
echo "警告:未设置 OMNI_KEY,/omniai 反代将鉴权失败"
fi
# 公网部署不再注入任何模型密钥:AI 对话/生图/生视频一律由用户自带 Key 直连自己的网关
# (/civideo、/omniai 反代已在 nginx.conf 中移除)。
# 授权中心项目密钥(安装统计/在线人数/公告/版本推送):
# 只进 nginx 的反代头,不进前端包;缺失时授权中心接口会失败,
+20 -26
View File
@@ -1,7 +1,24 @@
server {
listen 80;
server_name _;
return 301 https://$host$request_uri;
# 本端口(host 3006)供 NPS 隧道(cut.88531.cn)以「明文 HTTP」接入:
# NPS 在服务端终结 TLS 后向目标转发明文,故这里绝不能再 301 跳 https
# (否则隧道侧无限重定向)。改为内部回环代理到本容器的 443,
# 复用下面 443 server 块的全部站点/AI/CDN 反代逻辑,无需重复配置。
# 浏览器侧地址仍是 https://cut.88531.cn(由 NPS 服务端提供 TLS),
# 因此 File System Access API 的「安全上下文」要求依然满足。
location / {
proxy_pass https://127.0.0.1:443;
proxy_ssl_server_name on;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto https;
proxy_read_timeout 300s;
proxy_send_timeout 300s;
client_max_body_size 2048m;
}
}
server {
@@ -32,31 +49,8 @@ server {
# 生视频:直连 cheaperinference(omniroute 的视频白名单不含该渠道,故绕开)
location /civideo/ {
proxy_pass https://api.cheaperinference.com/v1/;
proxy_ssl_server_name on;
proxy_http_version 1.1;
proxy_set_header Host api.cheaperinference.com;
proxy_set_header Authorization "Bearer __CI_KEY__";
proxy_set_header Content-Type "application/json";
proxy_read_timeout 600s;
proxy_send_timeout 600s;
client_max_body_size 50m;
}
# 本机 AI 网关(omniroute,OpenAI 兼容):生图/生视频走 cheaperinference 渠道
# 密钥由 entrypoint.sh 在容器启动时注入,浏览器侧不出现
location /omniai/ {
proxy_pass http://192.168.68.19:20139/v1/;
proxy_http_version 1.1;
proxy_set_header Host 192.168.68.19;
proxy_set_header Authorization "Bearer __OMNI_KEY__";
proxy_set_header Content-Type "application/json";
proxy_read_timeout 300s;
proxy_send_timeout 300s;
client_max_body_size 20m;
}
# 公网部署不内置 AI 通道:/civideo、/omniai 反代已移除(AI 生图/生视频改由
# 用户在「AI 设置」填自己的网关地址直连,服务端不再注入任何模型密钥)。
# 官方素材 CDN(模板工程 JSON、模板缩略图)同源反代:
# 浏览器只请求 https://<站点>/cdn/**,不再直连 cdn.h5ds.com;
+13 -14
View File
@@ -1,26 +1,25 @@
{
"_说明": "站长级默认配置示例(public/local-ai.json 会部署到站点根)。米剪默认引导官方 AI:接口地址/模型名预填 ai.88531.cn(OpenAI 兼容),用户在「配置模型」里填自己的 API Key 即可使用;也可换成任意 OpenAI 兼容网关。此文件仅供站长覆盖默认通道时参考,切勿在公网版写入任何真实密钥。",
"chat": {
"baseUrl": "/newapi/v1",
"apiKey": "sk-你的密钥",
"baseUrl": "https://ai.88531.cn/v1",
"apiKey": "***",
"model": "mimo-v2.6-flash",
"visionModel": "deepseek-v4-flash-vision-exp",
"fallbackModels": [
"glm-5.3-flash",
"deepseek-v4-flash"
]
"fallbackModels": ["glm-5.3-flash", "deepseek-v4-flash"]
},
"image": {
"baseUrl": "/omniai",
"model": "cheaperinference/grok-imagine",
"baseUrl": "https://ai.88531.cn/v1",
"apiKey": "***",
"model": "flux-schnell",
"size": "1024x1024"
},
"video": {
"baseUrl": "/civideo",
"baseUrl": "https://ai.88531.cn/v1",
"apiKey": "***",
"resolution": "720p",
"models": [
"grok-imagine-video",
"veo-3.1-lite-generate-001",
"seedance-2.0-fast"
]
"models": ["inkling"]
},
"tts": {
"baseUrl": "/localtts"
}
}
+38 -50
View File
@@ -1,18 +1,21 @@
/**
* AI 设置(API Key 配置)——米剪 BYOK 的唯一入口
* AI 设置(模型配置)——米剪 BYOK 的唯一入口
*
* 两块东西:
* 1. AiSettingsButton:一个按钮 + 弹窗,填 接口地址 / API Key / 模型;
* 2. AiSetupGuide:未配置 Key 时替代 AI 面板的引导卡片,把用户带到注册或填 Key。
* 1. AiSettingsButton:右上角「配置模型」按钮 + 弹窗,填 接口地址 / API Key / 模型;
* 编辑器 Header 右上角是唯一放按钮的地方,AI 面板/AI 助手里不再单独放按钮(避免分散)。
* 2. AiSetupGuide:未配置时替代 AI 面板的引导卡片,把用户带到填写入口。
*
* 公网原则:默认引导官方 AI——接口地址/模型名预填官方值(ai.88531.cn),
* 用户只需填自己的 API Key(也支持换成任意 OpenAI 兼容接口),缺 Key 时 AI 不开闸。
*
* 配置存在浏览器 localStorage(见 utils/aiAuth),不登录、不经过服务端。
*/
import React, { useEffect, useState } from 'react';
import { Button, Modal, Input, Toast, Tag } from '@douyinfe/semi-ui';
import {
AI_DEFAULT_BASE_URL,
AI_DEFAULT_MODEL,
AI_REGISTER_URL,
AI_PLACEHOLDER_BASE_URL,
AI_PLACEHOLDER_MODEL,
readAiSettings,
saveAiSettings,
clearAiConfig,
@@ -21,15 +24,7 @@ import {
const hint: React.CSSProperties = { fontSize: 12, color: 'rgba(148,163,184,.9)', lineHeight: 1.7 };
function RegisterLink() {
return (
<a href={AI_REGISTER_URL} target="_blank" rel="noreferrer" style={{ color: '#60a5fa' }}>
免费注册领 Key →
</a>
);
}
/** 设置弹窗:接口地址 / API Key / 模型 三项 */
/** 设置弹窗:接口地址 / API Key / 模型 三项(均为必填) */
export function AiSettingsModal({ visible, onClose }: { visible: boolean; onClose: () => void }) {
const [form, setForm] = useState(() => readAiSettings());
const [showKey, setShowKey] = useState(false);
@@ -45,11 +40,15 @@ export function AiSettingsModal({ visible, onClose }: { visible: boolean; onClos
}, [visible]);
const onSave = () => {
const base = form.baseUrl.trim() || AI_DEFAULT_BASE_URL;
const model = form.model.trim() || AI_DEFAULT_MODEL;
const base = form.baseUrl.trim();
const model = form.model.trim();
const key = form.key.trim();
if (!base || !key || !model) {
Toast.error('接口地址、API Key、模型三项都要填写(推荐使用官方 AI:到 ai.88531.cn 获取 Key)');
return;
}
saveAiSettings(base, key, model);
Toast.success(key ? 'AI 配置已保存' : '已保存,但还没填 API Key,AI 功能仍不可用');
Toast.success('AI 配置已保存');
onClose();
};
@@ -61,19 +60,13 @@ export function AiSettingsModal({ visible, onClose }: { visible: boolean; onClos
return (
<Modal
title="AI 设置"
title="AI 设置(填你自己的 Key)"
visible={visible}
onCancel={onClose}
width={520}
footer={
<div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center' }}>
<div style={{ display: 'flex', gap: 8, alignItems: 'center' }}>
<Button theme="borderless" type="danger" onClick={onClear}>
清除 Key
</Button>
<span style={hint}>没有 Key?</span>
<RegisterLink />
</div>
<span style={hint}>推荐官方 AI(ai.88531.cn),Key 只存你本机浏览器</span>
<div style={{ display: 'flex', gap: 8 }}>
<Button onClick={onClose}>取消</Button>
<Button type="primary" onClick={onSave}>
@@ -85,43 +78,41 @@ export function AiSettingsModal({ visible, onClose }: { visible: boolean; onClos
>
<div style={{ fontSize: 13, lineHeight: 1.8, color: '#cbd5e1' }}>
<div style={{ marginBottom: 10 }}>
AI 对话、AI 一键出片、AI 生图、AI 生视频都属于 AI 功能,必须先配置 API Key 才能用;没配置时只能用基础剪辑(导入素材、时间轴、字幕、转场、导出都不受影响)。AI 对话和一键出片会用下面的接口地址与 Key 直连你填的网关;生图、生视频走本站内置通道,配置 Key 后解锁。
推荐使用官方 AI:接口地址与模型名已默认填好官方服务(ai.88531.cn),到该站获取 API Key 后粘贴即可使用 AI 对话、AI 一键出片、AI 生图、AI 生视频;也支持换成任意 OpenAI 兼容接口。没填 Key 时只能用基础剪辑(导入素材、时间轴、字幕、转场、导出都不受影响);配音(本机合成)与抠图(本机模型)免费,不需要 Key。
</div>
<div style={{ marginBottom: 4 }}>
接口地址
接口地址(必填)
{ready ? <Tag color="green" style={{ marginLeft: 8 }}>已配置</Tag> : <Tag color="orange" style={{ marginLeft: 8 }}>未配置</Tag>}
</div>
<Input
value={form.baseUrl}
placeholder={AI_DEFAULT_BASE_URL}
placeholder={AI_PLACEHOLDER_BASE_URL}
onChange={(v: any) => setForm(f => ({ ...f, baseUrl: typeof v === 'string' ? v : v?.target?.value || '' }))}
style={{ marginBottom: 12 }}
/>
<div style={hint}>OpenAI 兼容接口,留空则用默认 {AI_DEFAULT_BASE_URL}</div>
<div style={hint}>OpenAI 兼容接口地址,例如 {AI_PLACEHOLDER_BASE_URL},或你自建网关的 /v1 地址</div>
<div style={{ margin: '12px 0 4px' }}>API Key</div>
<div style={{ margin: '12px 0 4px' }}>API Key(必填)</div>
<Input
mode={showKey ? 'text' : 'password'}
value={form.key}
placeholder="粘贴你的 Key,例如 sk-xxxx"
placeholder="粘贴你的 Key,例如 sk-xxxx(官方 AI 到 ai.88531.cn 获取)"
onChange={(v: any) => setForm(f => ({ ...f, key: typeof v === 'string' ? v : v?.target?.value || '' }))}
style={{ marginBottom: 12 }}
/>
<div style={hint}>
只保存在你这台浏览器里,不上传服务器。没有 Key?<RegisterLink />
</div>
<div style={hint}>只保存在你这台浏览器里,不上传服务器。本站无法代付,Key 由你自行向对应服务商申请。</div>
<div style={{ margin: '12px 0 4px' }}>模型</div>
<div style={{ margin: '12px 0 4px' }}>模型(必填)</div>
<Input
value={form.model}
placeholder={AI_DEFAULT_MODEL}
placeholder={AI_PLACEHOLDER_MODEL}
onChange={(v: any) => setForm(f => ({ ...f, model: typeof v === 'string' ? v : v?.target?.value || '' }))}
/>
<div style={{ ...hint, marginTop: 6 }}>留空则用默认 {AI_DEFAULT_MODEL}</div>
<div style={{ ...hint, marginTop: 6 }}>对话所用模型名,例如 {AI_PLACEHOLDER_MODEL};需与你的接口地址匹配</div>
<div style={{ ...hint, marginTop: 12 }}>
默认的 {AI_DEFAULT_BASE_URL} 注册即送体验金,可直接用来跑 mimo-v2.6-flash;也可以填你自己的其它 OpenAI 兼容网关。
生图、生视频会用同一个接口地址按 OpenAI 兼容方式调用,需要你的网关支持对应接口(/images/generations、/videos/generations),不支持时会明确报错;用「一键出片」的看图写文案时,模型需支持图片输入。
</div>
</div>
</Modal>
@@ -149,16 +140,16 @@ export function AiSettingsButton({
);
}
/** 未配置 Key 时顶替 AI 面板的引导卡片 */
/** 未配置时顶替 AI 面板的引导卡片 */
export function AiSetupGuide({ title }: { title?: string }) {
return (
<div style={{ padding: '32px 24px', color: '#e2e8f0', fontSize: 14, lineHeight: 1.9 }}>
<div style={{ fontSize: 18, fontWeight: 600, marginBottom: 12 }}>
{title || 'AI 功能需要配置 API Key'}
{title || 'AI 功能需要你自己的 API Key'}
</div>
<div style={{ color: '#94a3b8', marginBottom: 16 }}>
基础剪辑不受影响:导入素材、时间轴编辑、字幕、转场、导出照常用。
AI 对话、AI 一键出片、AI 生图、AI 生视频属于 AI 功能,要先填上你自己的 Key。
基础剪辑不受影响:导入素材、时间轴编辑、字幕、转场、导出照常用;配音与抠图免费,不需要 Key。
AI 对话、AI 一键出片、AI 生图、AI 生视频需要先填上你自己的配置。
</div>
<div
@@ -172,21 +163,18 @@ export function AiSetupGuide({ title }: { title?: string }) {
color: '#bfdbfe',
}}
>
默认已为你填好:接口地址 <b>{AI_DEFAULT_BASE_URL}</b>,模型 <b>{AI_DEFAULT_MODEL}</b>
,只要补一个 API Key 就能用。
推荐使用官方 AI:接口地址与模型名已默认填好(ai.88531.cn),到该站获取 <b>API Key</b> 后填入即可;也支持换成你自己的 OpenAI 兼容接口与模型
额度。Key 只保存在你本台浏览器,不上传服务器。
</div>
<div style={{ display: 'flex', gap: 10, alignItems: 'center', flexWrap: 'wrap' }}>
<AiSettingsButton type="primary" size="large">
填写 API Key
填写我的接口与 Key
</AiSettingsButton>
<a href={AI_REGISTER_URL} target="_blank" rel="noreferrer">
<Button size="large">没有 Key?免费注册领取</Button>
</a>
</div>
<div style={{ ...hint, marginTop: 16 }}>
注册即送体验金,Key 只保存在你本台浏览器,不经过我们的服务器;也可以填你自己的 OpenAI 兼容网关地址。
填好后编辑器<b>右上角「配置模型」</b>随时可再打开修改;接口需 OpenAI 兼容(例如 {AI_PLACEHOLDER_BASE_URL} 或你自建网关的 /v1 地址);用「一键出片」看图写文案时,模型需支持图片输入。
</div>
</div>
);
@@ -16,7 +16,7 @@ import type { ChatMessage, MediaContent } from './ChatMessages';
import { util } from '@utils/index';
import { utils } from 'video-core-sdk';
import localforage from 'localforage';
import { AiSetupGuide, AiSettingsButton } from '@components/ai-settings';
import { AiSetupGuide } from '@components/ai-settings';
import { useAiConfigured } from '@utils/aiAuth';
const POLL_INTERVAL = 5000; // 5 秒轮询
@@ -1062,7 +1062,7 @@ export default function AIChat() {
replaceThinking(aiMsg);
}
} else if (aiMode === 'video') {
// 免登录改造:视频生成走本机代理直连 cheaperinference(/civideo),不再请求官方云端任务
// 自带 Key:视频生成走用户在「AI 设置」填的网关(localGenerateVideo),不请求任何官方云端
const placeholderMsgId = (Date.now() + 1).toString();
const { localGenerateVideo } = await import('@utils/localAi');
const [vidRes, vErr] = await localGenerateVideo({
@@ -1120,7 +1120,6 @@ export default function AIChat() {
<div className={styles.chatHeader}>
<div className={styles.headerTitle}>AI 助手</div>
<div className={styles.headerActions}>
<AiSettingsButton />
<Button
theme="borderless"
icon={<Plus theme="outline" size="14" />}
@@ -22,6 +22,7 @@ import KeyboardModal from './KeyboardModal';
import { stores } from '@stores/index';
import { saveProject, canUseLocalSave } from '@services/localStorageService';
import HubStatus from '@components/hub';
import { AiSettingsButton } from '@components/ai-settings';
import { reURL } from '@utils/util';
export interface IProps {}
@@ -245,6 +246,8 @@ function Header(props: IProps) {
</section>
{/* <section className={styles.center}></section> */}
<section className={styles.right}>
{/* 右上角:统一的模型配置入口(BYOK 唯一配置入口,打开 AI 设置弹窗) */}
<AiSettingsButton size="small">配置模型</AiSettingsButton>
{/* 右上角:当前版本 + 新版本提示 + 公告(授权中心,拿不到就安静降级) */}
<HubStatus />
{/* <a>
@@ -7,7 +7,7 @@ import AiImage from './AiImage';
import Tasks from './Tasks';
import { IllustrationNoAccess, IllustrationNoAccessDark } from '@douyinfe/semi-illustrations';
import Login from '@components/login';
import { AiSetupGuide, AiSettingsButton } from '@components/ai-settings';
import { AiSetupGuide } from '@components/ai-settings';
import { useAiConfigured } from '@utils/aiAuth';
import { language, Intl } from '@language/index';
import { stores } from '@stores/index';
@@ -47,9 +47,7 @@ export default function AiMain() {
<div className={styles.qvCta}>立即生成 →</div>
</div>
<div style={{ display: 'flex', justifyContent: 'flex-end', padding: '6px 12px 0' }}>
<AiSettingsButton />
</div>
{/* 模型配置统一收口在编辑器右上角「配置模型」,面板内不再放按钮,避免多处分散 */}
<Tabs keepDOM={false} lazyRender={true} className={styles.tabs} type="line" defaultSelectedKey="0">
<TabPane
@@ -2,6 +2,7 @@ import Source from '@pages/editor/common/source';
import styles from './template.module.less';
import $ from 'jquery';
import type { MovieData } from 'video-core-sdk';
import { helper } from 'video-core-sdk';
import { util } from '@utils/index';
import { rewriteCdnPaths } from '@utils/cdnAssets';
import { transaction } from 'mobx';
@@ -28,11 +29,36 @@ export default function Template() {
const fetched = await $.get(editor.movie.reURL(item.url + '?t=' + +new Date()));
// $.get 会把 JSON 解析成对象,字符串正则匹配不到;统一交给 rewriteCdnPaths 处理
const json = rewriteCdnPaths(fetched);
const data = util.reJSON(json) as MovieData;
transaction(() => {
editor.data = util.reJSON(json) as MovieData;
editor.movieDataUpdateKey = util.randomID();
// editor.editMode = 'template';
editor.data = data;
});
// 模板替换需要重建画布引擎;在线 remount 时旧引擎不彻底释放,
// 导入第二个模板会把渲染进程拖崩(表现为"导入第一个模板后,后面导入不了")。
// 改为与"工程文件"导入一致:先落盘,再整页刷新,编辑器启动时读回新数据。
try {
const { saveProject, canUseLocalSave: localSaveOk } = await import(
'@services/localStorageService'
);
if (editor.useLocalStorage || localSaveOk()) {
await saveProject(editor.appid, data);
} else {
await editor.apiServer.updateApp({
id: editor.appid,
name: (data as any).title,
data,
width: (data as any).width,
height: (data as any).height,
duration: helper.getTotalTime(data),
});
}
location.reload();
return;
} catch (saveErr) {
console.warn('模板落盘失败,回退在线重载', saveErr);
}
// 落盘失败时退回原在线重挂(保底仍可用)
editor.movieDataUpdateKey = util.randomID();
} catch (e) {
console.error('模板加载失败', item && item.id, e);
Modal.error({ title: '模板加载失败', content: '该模板的素材已失效,请换一个模板重试。' });
+3 -3
View File
@@ -429,7 +429,7 @@ class Server extends BasicService {
const prompt = String(taskParams.prompt || contentText || '').trim();
if (!prompt) return [null, '请填写生成提示词'];
// 生视频:本机代理直连 cheaperinference(/civideo)
// 生视频:走用户在「AI 设置」填写的网关(localGenerateVideo)
if (taskType.includes('video')) {
const refImage = contentList.find(c => c?.type === 'image_url' && (c?.image_url?.url || c?.image_url));
const imageUrl =
@@ -552,10 +552,10 @@ class Server extends BasicService {
return this.openAiChat(params);
};
// 一次性返回(免登录:直连本机 OpenAI 兼容服务)
// 一次性返回(自带 Key:直连用户在「AI 设置」填写的 OpenAI 兼容接口)
openAiChat = async (params: st.AiChatParams) => {
// 模型一律用用户填的那个:公网部署不内置模型名(忽略调用方硬编码的 model)
const [data, err] = await localChatCompletion({
model: (params as any)?.model,
messages: (params as any)?.messages || [],
});
if (err) return [null, err];
+4 -4
View File
@@ -40,8 +40,8 @@ const allFeatures = [
'TTS',
'混音',
'语音识别',
'seedance',
'deepseek',
'AI 视频生成',
'AI 视觉理解',
'二维码',
'插件扩展',
'逐字动画',
@@ -90,7 +90,7 @@ const coreFeatures = [
{
label: 'Value',
title: '经济实惠',
desc: '剪辑功能终身免费,AI 走你自己的 API Key(默认接口注册即送体验金),我们不设会员墙、不抽成。',
desc: '剪辑功能终身免费,AI 推荐使用官方 AI(接口已默认填好,去 ai.88531.cn 获取 Key 粘贴即用),我们不设会员墙、不抽成。',
emoji: '💰',
},
];
@@ -102,7 +102,7 @@ const faqList = [
},
{
q: 'AI 功能怎么用?要收费吗?',
a: 'AI 对话、AI 一键出片、AI 生图、AI 生视频属于 AI 功能,需要你自己的 API Key 才能调用。打开编辑器右侧「AI 助手」或左侧 AI 面板,点「AI 设置」填写即可,接口地址默认 https://ai.88531.cn/v1、模型默认 mimo-v2.6-flash,没有 Key 可以免费注册领取(注册即送体验金)。不填 Key 时,全部基础剪辑功能照常可用。',
a: 'AI 对话、AI 一键出片、AI 生图、AI 生视频需要 API Key:打开编辑器,点右上角「配置模型」——推荐使用官方 AI,接口地址与模型名已默认填好(ai.88531.cn),到该站获取 Key 粘贴即可;也支持换成你自己的 OpenAI 兼容接口与模型。Key 只存你本台浏览器。不填 Key 时,全部基础剪辑功能照常可用,配音与抠图免费可用。',
},
{
q: '需要安装客户端吗?',
+17 -13
View File
@@ -2,34 +2,37 @@
* AI 功能的用户级配置(BYOK:用户自带 Key)
*
* 规则:
* - AI 对话、AI 一键出片、AI 生图、AI 生视频都属于 AI 功能,必须先配置 API Key 才能使用;
* - 没配置 Key 时只能用基础剪辑(导入素材、时间轴、字幕、导出等),AI 面板显示引导而非功能;
* - AI 对话、AI 一键出片、AI 生图、AI 生视频都属于 AI 功能,需要 API Key 才能使用;
* - 接口地址与模型名默认指向官方 AI(ai.88531.cn,OpenAI 兼容),引导用户使用官方 AI:
* 去 ai.88531.cn 获取 API Key,点右上角「配置模型」粘贴即可;也支持换成任意 OpenAI 兼容接口;
* - 未填 Key 时只能用基础剪辑(导入素材、时间轴、字幕、导出等),AI 面板显示引导而非功能;
* - 配置存 localStorage(按浏览器维度),不需要登录,也不经过服务端;
* - 默认接口地址 https://ai.88531.cn/v1,默认模型 mimo-v2.6-flash;
* - 没有 Key 的用户去 https://ai.88531.cn/register 免费注册,注册即送体验金。
* - Key 只存用户浏览器,不上传服务端。
*
* 配音(本机 edge-tts)与抠图/去背(本机模型)不消耗外部额度,不在此开关限制内。
*
* 写法说明:本文件刻意不写「apiKey 紧跟冒号」的形式,因为写文件工具会把
* 「apiKey: <值>」中的值脱敏成 ***,直接损坏源码语法(已踩坑,勿改回)。
* 「apiKey: ***,直接损坏源码语法(已踩坑,勿改回)。
*/
import { useEffect, useState } from 'react';
const LS_KEY = 'micut.ai.config.v1';
/** 默认引导官方 AI(接口/模型预填官方值,用户只需填自己的 API Key) */
export const AI_DEFAULT_BASE_URL = 'https://ai.88531.cn/v1';
export const AI_DEFAULT_MODEL = 'mimo-v2.6-flash';
/** 免费注册领 Key 的地址(New API 实例,站内公告写明「注册即送体验金」) */
export const AI_REGISTER_URL = 'https://ai.88531.cn/register';
/** 输入框占位示例(与默认一致,强化官方引导) */
export const AI_PLACEHOLDER_BASE_URL = 'https://ai.88531.cn/v1';
export const AI_PLACEHOLDER_MODEL = 'mimo-v2.6-flash';
/** 未配置 Key 时所有 AI 调用统一返回的错误文案 */
export const AI_NOT_CONFIGURED_MSG = 'AI 功能未配置:请先在「AI 设置」里填写 API Key(基础剪辑不受影响)';
/** 未配置时所有 AI 调用统一返回的错误文案 */
export const AI_NOT_CONFIGURED_MSG = 'AI 功能需要 API Key:推荐使用官方 AI——去 https://ai.88531.cn 获取 Key,点右上角「配置模型」粘贴即可(基础剪辑不受影响)';
/** 用户配置:接口地址 + 密钥 + 模型 */
export type AiUserConfig = {
/** OpenAI 兼容接口地址,例如 https://ai.88531.cn/v1 */
/** OpenAI 兼容接口地址,例如 https://api.example.com/v1 */
baseUrl: string;
/** 默认模型,例如 mimo-v2.6-flash */
/** 对话模型名(用户自填,例:deepseek-chat) */
model: string;
} & Record<'apiKey', string>;
@@ -115,9 +118,10 @@ export function clearAiConfig(): void {
emit();
}
/** 是否已配置 Key —— 所有 AI 功能的总闸 */
/** 是否已配置齐全 —— 所有 AI 功能的总闸(三项缺一不可,防止空地址打到本站) */
export function isAiConfigured(): boolean {
return !!getAiConfig().apiKey;
const c = getAiConfig();
return !!(c.apiKey && c.baseUrl && c.model);
}
/** 订阅配置变化 */
+1 -1
View File
@@ -1,7 +1,7 @@
/**
* AI 一键出片:看图写文案 + 本机配音
*
* - 文案:本机对话模型(带图时自动切视觉模型 deepseek-v4-flash-vision-exp)
* - 文案:用户在「AI 设置」填的对话模型(带图时直接用该模型,需其支持图片输入)
* - 配音:本机 unicut-tts(edge-tts),走同源 /localtts 反代,无需登录、无需密钥
*/
import { localChatCompletion } from '@utils/localAi';
+31 -26
View File
@@ -24,34 +24,34 @@ export interface LocalAiConfig {
tts?: { baseUrl?: string };
}
const EMPTY_KEY = '';
const DEFAULTS: LocalAiConfig = {
chat: {
// 同源反代 /newapi/ → 本机 NewAPI(nginx 注入),避免 HTTPS 页面直连 HTTP 被浏览器拦,
// 也保证站点在只有本机网络时依旧可用
baseUrl: '/newapi/v1',
apiKey: '',
// 默认指向官方 AI(ai.88531.cn,OpenAI 兼容 /v1,CORS 允许浏览器直连):
// 接口地址/模型名预填官方值,用户只需在「配置模型」里填自己的 API Key 即可用;
// 也支持整项换成任意 OpenAI 兼容网关。
baseUrl: 'https://ai.88531.cn/v1',
apiKey: EMPTY_KEY,
model: 'mimo-v2.6-flash',
visionModel: 'deepseek-v4-flash-vision-exp',
fallbackModels: ['glm-5.3-flash', 'deepseek-v4-flash'],
},
// 生图:omniroute(OpenAI 兼容)→ cheaperinference 渠道
// 走同源 /omniai 反代,密钥由 nginx 注入,浏览器里不出现
// 生图:官方 AI(NewAPI OpenAI 兼容 /v1/images/generations)
image: {
baseUrl: '/omniai',
apiKey: '',
model: 'cheaperinference/grok-imagine',
baseUrl: 'https://ai.88531.cn/v1',
apiKey: EMPTY_KEY,
model: 'flux-schnell',
size: '1024x1024',
},
// 生视频:直连 cheaperinference(其 /v1/videos/generations 可用,但 omniroute 的视频白名单不含该渠道)
// 走同源 /civideo 反代,密钥由 nginx 注入;模型名为上游裸名,不带 provider 前缀
// 生视频:官方 AI(NewAPI 视频端点 /v1/video/generations,单数)
video: {
baseUrl: '/civideo',
apiKey: '',
baseUrl: 'https://ai.88531.cn/v1',
apiKey: EMPTY_KEY,
resolution: '720p',
models: ['grok-imagine-video', 'veo-3.1-lite-generate-001', 'seedance-2.0-fast'],
models: ['inkling'],
},
// 本机 TTS 服务,经 nginx 同源反代(/localtts/ -> unicut-tts:8000),
// 用相对路径是为了避免 HTTPS 页面加载 HTTP 音频被浏览器拦截
// 本机 TTS 服务(edge-tts,免费、不消耗任何模型额度),经 nginx 同源反代保留
tts: {
baseUrl: '/localtts',
},
@@ -91,8 +91,8 @@ function loadBaseConfig(): Promise<LocalAiConfig> {
* 用户配置存在浏览器 localStorage,每次调用都重新叠加,用户改完立即生效。
* 对话的接口地址/密钥一律以用户填的为准;模型用 AI 设置里填的那个
* (调用方传进来的模型名是本站私有 ID,用户网关上没有,一律忽略)。
* 视觉模型沿用站点默认 deepseek-v4-flash-vision-exp —— 默认网关上确实有这个模型;
* 换成别的网关没有它时,会自动降到主模型,不会直接报错。
* 视觉模型不再内置:公网部署不预设任何模型,带图请求直接用用户填的主模型
*(主模型需支持图片输入;不支持时调用会明确报错,不会偷偷换用别人的模型)。
*/
export async function loadLocalAiConfig(): Promise<LocalAiConfig> {
const base = await loadBaseConfig();
@@ -106,6 +106,10 @@ export async function loadLocalAiConfig(): Promise<LocalAiConfig> {
fallbackModels: [user.model],
};
cfg.chat = applyUserKey(chat);
// 生图/生视频同样回落到用户填的网关(需网关支持对应 OpenAI 兼容接口),
// 站点不内置任何通道,密钥一律用用户自己的
cfg.image = applyUserKey({ ...cfg.image, baseUrl: user.baseUrl });
cfg.video = applyUserKey({ ...cfg.video, baseUrl: user.baseUrl });
return cfg;
}
@@ -136,7 +140,7 @@ export async function localChatCompletion(params: {
const res = await fetch(`${cfg.chat.baseUrl}/chat/completions`, {
method: 'POST',
headers: withAuth(cfg.chat.apiKey),
body: JSON.stringify({ model, messages: params.messages, stream: false }),
body: JSON.stringify({ model, messages: params.messages, stream: false, max_tokens: 4096 }),
});
const text = await res.text();
let data: any = null;
@@ -152,7 +156,7 @@ export async function localChatCompletion(params: {
}
return [data, null];
} catch (e: any) {
lastErr = `无法连接本机模型服务(${cfg.chat.baseUrl}):${e?.message || e}`;
lastErr = `无法连接你填写的接口(${cfg.chat.baseUrl}):${e?.message || e}`;
}
}
return [null, lastErr || '本机模型服务不可用'];
@@ -199,10 +203,10 @@ export async function localGenerateImage(params: {
if (!url) return [null, '本机图片服务未返回图片地址'];
return [{ url }, null];
} catch (e: any) {
return [null, `无法连接本机图片服务(${cfg.image.baseUrl}):${e?.message || e}`];
return [null, `无法连接你填写的接口(${cfg.image.baseUrl}):${e?.message || e}`];
}
}
/** 本机视频生成(omniroute /videos/generations,cheaperinference 渠道),返回 [视频地址, 错误] */
/** 视频生成(官方 NewAPI 的 /video/generations,OpenAI 兼容),返回 [视频地址, 错误] */
export async function localGenerateVideo(params: {
prompt: string;
model?: string;
@@ -212,7 +216,8 @@ export async function localGenerateVideo(params: {
}): Promise<[{ url: string } | null, string | null]> {
if (!isAiConfigured()) return [null, AI_NOT_CONFIGURED_MSG];
const cfg = await loadLocalAiConfig();
const base = cfg.video?.baseUrl || '/omniai';
const base = cfg.video?.baseUrl || '';
if (!base) return [null, AI_NOT_CONFIGURED_MSG];
const models = params.model ? [params.model] : (cfg.video?.models || []);
const errors: string[] = [];
for (const model of models) {
@@ -228,7 +233,7 @@ export async function localGenerateVideo(params: {
if (params.imageUrl) {
body.image_url = params.imageUrl;
}
const res = await fetch(`${base}/videos/generations`, {
const res = await fetch(`${base}/video/generations`, {
method: 'POST',
headers: withAuth(cfg.video?.apiKey || ''),
body: JSON.stringify(body),
@@ -275,7 +280,7 @@ export async function localGenerateVideo(params: {
errors.push(`${model}:${e?.message || e}`);
}
}
return [null, errors.length ? `视频生成失败:${errors.join(';')}` : '未配置视频模型'];
return [null, errors.length ? `视频生成失败:${errors.join(';')}` : '未配置视频模型:请点右上角「配置模型」填入 API Key(接口已默认官方 AI:ai.88531.cn;也可换网关,需支持 video/generations 接口)'];
}
/** 轮询视频任务(最多 5 分钟) */
@@ -288,7 +293,7 @@ async function pollLocalVideo(
while (Date.now() < deadline) {
await new Promise(r => setTimeout(r, 5000));
try {
const res = await fetch(`${base}/videos/generations/${encodeURIComponent(taskId)}`, {
const res = await fetch(`${base}/video/generations/${encodeURIComponent(taskId)}`, {
headers: withAuth(apiapiKey),
});
if (!res.ok) continue;