From bd1acbd9ca878d71cf4f1b18d7e430e6b61f3f04 Mon Sep 17 00:00:00 2001 From: personal827 Date: Thu, 29 Oct 2026 15:44:55 +0800 Subject: [PATCH] =?UTF-8?q?README/CHANGELOG=20=E5=85=A8=E9=9D=A2=E6=94=B9?= =?UTF-8?q?=E7=89=88=E5=B9=B6=E6=8E=A8=E9=80=81=EF=BC=9A=E7=B1=B3=E5=89=AA?= =?UTF-8?q?=E5=AE=9A=E4=BD=8D+=E6=9C=AC=E6=AC=A1=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E6=B8=85=E5=8D=95+Docker/=E6=BA=90=E7=A0=81=E4=B8=A4=E7=A7=8D?= =?UTF-8?q?=E5=AE=89=E8=A3=85+=E4=BD=93=E9=AA=8C=E5=9C=B0=E5=9D=80=20cut.8?= =?UTF-8?q?8531.cn+=E6=9B=B4=E6=96=B0=E6=97=A5=E5=BF=97=E5=85=A5=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 功能更新(随本次提交入库): - 「配置模型」统一入口:编辑器右上角一个弹窗管接口地址/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 补录以上条目;贡献规范要求每次改动同步更新日志 --- CHANGELOG.md | 22 ++ README.md | 197 +++++++++++------- docker-compose.yml | 3 +- entrypoint.sh | 14 +- nginx.conf | 46 ++-- public/local-ai.json.example | 27 ++- src/components/ai-settings/index.tsx | 88 ++++---- .../editor/components/ai-chat/AIChat.tsx | 5 +- src/pages/editor/components/header/Header.tsx | 3 + .../editor/components/sources/ai/AiMain.tsx | 6 +- .../components/sources/template/Template.tsx | 32 ++- src/pages/editor/server.ts | 6 +- src/pages/home/Home.tsx | 8 +- src/utils/aiAuth.ts | 30 +-- src/utils/aiQuickVideo.ts | 2 +- src/utils/localAi.ts | 57 ++--- 16 files changed, 305 insertions(+), 241 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3aebd6d..28403e1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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/.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`),不需要登录,也不经过服务端;提供订阅机制,改完立即生效 diff --git a/README.md b/README.md index 0a809e0..a3bf741 100644 --- a/README.md +++ b/README.md @@ -1,57 +1,84 @@
-

UNICUT · 无界云剪

+

米剪 MiCut

-

AI 驱动的开源 Web 视频编辑器

-

把多轨剪辑、动画特效、智能处理与 AI 创作带进浏览器,让视频生产无需安装、打开即用。

+

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

+

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

- 在线体验 + 🚀 在线体验:https://cut.88531.cn · - 核心能力 + 本次更新 · 快速开始 · - 二次开发 - · - 参与共建 + 更新日志

- GitHub Stars - GitHub Forks - GitHub Issues React 18 TypeScript 5 Vite 4 + 开源免费

-![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。 - ## ❓ 常见问题
-UNICUT 可以完全离线使用吗? +可以完全离线使用吗? -本地工程、素材管理以及部分浏览器端媒体 / AI 处理能力可以在本地运行;在线素材、账号、AI 对话、生成式 AI、语音服务和云端合成等能力仍需要网络及对应服务。 +可以。本地工程、素材管理、剪辑、字幕、转场、配音(TTS)、抠图和视频导出全部在本机完成,不依赖任何在线服务。仅 AI 对话 / 生图 / 生视频需要网络,并需在右上角「配置模型」里配置 API Key(默认官方网关)。
可以部署到自己的服务器吗? -可以部署前端并进行二次开发。若要提供完整的平台能力,需要自行实现或接入项目、素材、用户、AI 和渲染等服务端接口。 +可以。Docker 一条命令即可部署(见「快速开始」),部署后整个站点归你所有,数据完全自主。
素材会自动上传吗? -本地存储模式下,工程和素材保存在用户授权的本地文件夹中。当你主动使用在线素材、云端 AI、语音识别、生成或云合成等能力时,相关数据可能需要发送到对应服务。私有化部署方应根据自己的服务实现提供清晰的隐私说明。 +不会。本地存储模式下,工程和素材保存在你授权的本地文件夹。只有你主动使用 AI 功能时,相关提示词 / 图片才会发送到你配置的接口(默认官方网关 `ai.88531.cn`)。 +
+ +
+AI 功能要收费吗? + +编辑器本身完全免费。AI 对话 / 生图 / 生视频使用你自己的 API Key(BYOK):去 `ai.88531.cn` 注册领取 Key,在右上角「配置模型」粘贴即可;剪辑链路(含配音、抠图、导出)不消耗任何额度。
@@ -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、多租户或品牌定制前,请务必先阅读协议;如有疑问,请通过仓库联系维护者确认授权边界。 ---
-

让专业视频创作留在浏览器,也让每个人都能参与塑造下一代开源剪辑工具。

-

Made with creativity by the UNICUT community.

+

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

+

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

diff --git a/docker-compose.yml b/docker-compose.yml index 700b8eb..0ee8d05 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -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 替换进前端包,用于公告/装机统计归属 diff --git a/entrypoint.sh b/entrypoint.sh index bee171f..fccbb03 100644 --- a/entrypoint.sh +++ b/entrypoint.sh @@ -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 的反代头,不进前端包;缺失时授权中心接口会失败, diff --git a/nginx.conf b/nginx.conf index b766dae..ec04168 100644 --- a/nginx.conf +++ b/nginx.conf @@ -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; diff --git a/public/local-ai.json.example b/public/local-ai.json.example index 466f253..6666b94 100644 --- a/public/local-ai.json.example +++ b/public/local-ai.json.example @@ -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" } } diff --git a/src/components/ai-settings/index.tsx b/src/components/ai-settings/index.tsx index 6597aeb..f33823b 100644 --- a/src/components/ai-settings/index.tsx +++ b/src/components/ai-settings/index.tsx @@ -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 ( - - 免费注册领 Key → - - ); -} - -/** 设置弹窗:接口地址 / 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 ( -
- - 没有 Key? - -
+ 推荐官方 AI(ai.88531.cn),Key 只存你本机浏览器
-
- 注册即送体验金,Key 只保存在你本台浏览器,不经过我们的服务器;也可以填你自己的 OpenAI 兼容网关地址。 + 填好后编辑器右上角「配置模型」随时可再打开修改;接口需 OpenAI 兼容(例如 {AI_PLACEHOLDER_BASE_URL} 或你自建网关的 /v1 地址);用「一键出片」看图写文案时,模型需支持图片输入。
); diff --git a/src/pages/editor/components/ai-chat/AIChat.tsx b/src/pages/editor/components/ai-chat/AIChat.tsx index dfb44e3..b5426b5 100644 --- a/src/pages/editor/components/ai-chat/AIChat.tsx +++ b/src/pages/editor/components/ai-chat/AIChat.tsx @@ -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() {
AI 助手
-
-
- -
+ {/* 模型配置统一收口在编辑器右上角「配置模型」,面板内不再放按钮,避免多处分散 */} 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]; diff --git a/src/pages/home/Home.tsx b/src/pages/home/Home.tsx index 3e6db5b..8123337 100644 --- a/src/pages/home/Home.tsx +++ b/src/pages/home/Home.tsx @@ -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: '需要安装客户端吗?', diff --git a/src/utils/aiAuth.ts b/src/utils/aiAuth.ts index a99bfb7..bcd9770 100644 --- a/src/utils/aiAuth.ts +++ b/src/utils/aiAuth.ts @@ -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); } /** 订阅配置变化 */ diff --git a/src/utils/aiQuickVideo.ts b/src/utils/aiQuickVideo.ts index 21eea7a..f36058f 100644 --- a/src/utils/aiQuickVideo.ts +++ b/src/utils/aiQuickVideo.ts @@ -1,7 +1,7 @@ /** * AI 一键出片:看图写文案 + 本机配音 * - * - 文案:本机对话模型(带图时自动切视觉模型 deepseek-v4-flash-vision-exp) + * - 文案:用户在「AI 设置」填的对话模型(带图时直接用该模型,需其支持图片输入) * - 配音:本机 unicut-tts(edge-tts),走同源 /localtts 反代,无需登录、无需密钥 */ import { localChatCompletion } from '@utils/localAi'; diff --git a/src/utils/localAi.ts b/src/utils/localAi.ts index d9e6e98..4063a6f 100644 --- a/src/utils/localAi.ts +++ b/src/utils/localAi.ts @@ -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 { * 用户配置存在浏览器 localStorage,每次调用都重新叠加,用户改完立即生效。 * 对话的接口地址/密钥一律以用户填的为准;模型用 AI 设置里填的那个 * (调用方传进来的模型名是本站私有 ID,用户网关上没有,一律忽略)。 - * 视觉模型沿用站点默认 deepseek-v4-flash-vision-exp —— 默认网关上确实有这个模型; - * 换成别的网关没有它时,会自动降到主模型,不会直接报错。 + * 视觉模型不再内置:公网部署不预设任何模型,带图请求直接用用户填的主模型 + *(主模型需支持图片输入;不支持时调用会明确报错,不会偷偷换用别人的模型)。 */ export async function loadLocalAiConfig(): Promise { const base = await loadBaseConfig(); @@ -106,6 +106,10 @@ export async function loadLocalAiConfig(): Promise { 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;