- 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 教程同步
32 KiB
32 KiB
更新日志
本项目在 gitee.com/676015863/unicut 基础上做了本地化改造,使其可在自托管环境离线使用。
2026-11-17
✨ AI 一键出片:按标题和图片自动生成视频封面
- 新增
generateQuickVideoCover()(src/utils/aiQuickVideo.ts):根据用户输入的标题 + 素材图片 + 正文自动生成一张封面图- 提示词三级降级:视觉模型看图写英文生图提示词 → 纯文本模型按标题/正文写 → 标题拼模板提示词,保证封面永远能出
- 生图两级降级:先试 16:9(1280x720),失败回退网关默认尺寸;再失败由调用方用本地
makeTitleCover()标题封面兜底(界面明确提示「AI 生图失败,已用本地封面代替」) - 远程生图链接自动转 data URL,避免工程保存后链接过期导致封面裂图;转不动则保持原地址
- 向导流程改动(
QuickVideo.tsx):- 第 1 步「生成文案」时文案与封面并行生成(封面只依赖标题/图片/正文,不必等文案),loading 文案改为「正在识别图片写文案、生成封面…」
- 第 4 步确认页新增封面预览行:缩略图 + 状态(AI 生成 / 本地标题封面 / 生成中 / 失败原因);「预计成片」与页脚「总长约」计入封面 3 秒
- 「确认生成视频」在封面未就绪时拦截提示;封面插到时间轴最前面 3 秒(无配音无字幕,与后续画面同轨道,吃同样的转场/运镜设置)
- 收尾 Toast 带「封面 +」前缀;
resetAll清理封面状态
- 样式:
quickvideo.module.less新增.coverRow/.coverThumb/.coverInfo(132×74 缩略图 + 虚线分隔) - 第 1 步说明文案同步提及「根据标题和图片自动生成视频封面(片头 3 秒)」
2026-11-14
🛡️ MCP 每 IP 每日 5 次限流(防刷爆)
_AuthMiddleware新增按客户端 IP 的日配额:只对POST /mcp(真正工具调用)计数,优先取X-Forwarded-For第一段(反代场景仍按真实客户端 IP),按北京时间 00:00 日期键重置,计数存内存、容器重启清零,默认 5 次/天/IP(envMCP_DAILY_LIMIT可调)- 超限返回
429 Too Many Requests,响应体带{"error":"rate_limited","limit":5,"used":5,"ip":...}中文提示,头带Retry-After: 86400 - 鉴权在前(未带/错令牌 401 且不消耗配额)、限流在后;
/health、/mcp-health、/out/*下载直链不参与计数 - 教程同步:
mcp-guide.md端点小节新增「限流规则」小块(5 次/天、429、重置时间、可调参数、只计 POST /mcp),常见问题新增第 9 条「调用提示 429 rate_limited」 - 验证:线上同 IP 带令牌连发 7 次——第 1~5 次放行进入协议层(400 Missing session ID 属正常未握手响应),第 6、7 次 429 + Retry-After: 86400;验毕重启容器清零计数;教程
/articles/mcp-guide.md线上 12590B 与源码逐字节一致 - Release:
v1.0.2-mcp-rate-limit(Gitea #811,无附件)
2026-11-12
✨ 教程页三栏重排版(/article/* 可读性优化)
- 三栏布局:左浮动目录(224px sticky,
nav[aria-label="文章目录"],IntersectionObserver 滚动高亮 + 点击锚点平滑跳转,scroll-margin 让开 60px fixed 导航)+ 正文白卡(940px,段落/列表/标题/引用/代码间距全面加大,h2 加分隔线)+ 右浮动「更多教程」(256px sticky,原底部区块移至右侧固定) <1280px回退单栏:目录隐藏、更多教程回正文下方全宽- 验证:about / local-deploy-guide / mcp-guide 三页 1440 桌面三栏几何(toc x=28 / 正文 x=280 / 右栏 x=1141)、滚动 sticky 固定、目录点击跳转(scrollY=2589 + hash + active 同步)、900 窄屏单栏回退,验毕 FolderGuard 遮蔽还原(新 tab picker=function)
🐛 修复:文章列表被浏览器缓存导致「没有找到这篇文章」
- 根因:
/articles/下的index.json/.md此前无Cache-Control,浏览器走启发式缓存,新增文章后用户端仍读旧列表,ArticleDetail找不到条目即报「没有找到这篇文章:」 - nginx 修复:
location /articles/与location = /index.html加Cache-Control: no-cache(每次协商校验,命中 304 不费流量;入口页不缓存可避免旧 html 引用已失效的 chunk hash);/homeAssets/30 天 immutable 长缓存保留不变 - 验证:线上三类响应头均为
Cache-Control: no-cache,构建产物仍max-age=2592000 + public, immutable - 注意:已缓存旧列表的浏览器需强刷一次完成迁移,之后自动始终最新
✨ 新增「MCP 使用说明」教程
- 新文章
public/articles/mcp-guide.md(11.5KB 九节):MCP 概念与米剪 10 工具总览、端点与 Bearer 令牌(fail-closed/401)、四种客户端接入模板(Claude Desktop mcp-remote / Claude Codeclaude mcp add/ Cursor mcp.json / Hermes config.yaml)、工具逐个详解(参数与默认值按mcp/server.py源码核实:grab_url12000 字截断、generate_script60 秒×4.5 字、tts默认晓晓音色 ≤2000 字、create_video_project30 图上限/160×120 门禁)、一句话生成视频实战链、curl 握手自检、.env自部署配置、8 条常见问题 - 顶栏菜单加「MCP 使用说明」(
Header.tsxnav,置于「使用教程」后,当前页自动高亮) index.json新增 mcp-guide 条目(2026-11-12,标签 教程·MCP)- 构建部署 + 线上验证:md 11509B/200、index.json 四篇列表、浏览器实渲染 h2×9/代码块×8/li×51、菜单四项与高亮、内链互通,验毕 FolderGuard 还原
- 事实来源:
mcp/README.md、mcp/server.py(工具签名与 docstring)、nginx.conf(/mcp、/mcp-out/、/mcp-health 反代)
2026-11-11
🎬 /article/about 改为 AI 一键出片教程 + 菜单改名
原「关于我们」页整体重定位为《AI 一键出片新手教程》
- 路由:
routes.config.ts移除 aboutus 优先路由(/article/about原走AboutUs.tsx硬编码 JSX),改为统一走文章详情页渲染 markdown;public/articles/about.md新建教程正文(10.5KB 十节)——60 秒认识一键出片、配置模型(唯一前提、ai.88531.cn 取 Key、Key 只存浏览器)、两处入口(AI 创作面板常驻卡片 / 页签「开始一键出片」)、第 1 步素材与标题(图片 8 张上限可排序 / Word·PDF 自动提取含扫描件报错 / 网址抓取含失败提示、标题 30 字、5 种文案风格)、第 2 步生成文案(分段改写/换图/试听/加段)、第 3 步配置声音(人声/情绪/语速、合成进度与部分失败重试、全就绪才能下一步)、第 4 步确认生成(9 种转场、4 种动效、字幕四要素、红字字幕覆盖警告、预计时长)、生成后进时间轴编辑导出、8 条常见问题、相关链接 - 全部按钮文案/Toast/校验提示按
QuickVideo.tsx/AiMain.tsx/AiSetupGuide/localStorageService.ts源码逐一核实;不用表格(ReactMarkdown 无 remark-gfm) - 菜单改名:顶栏「关于我们」→「AI 一键出片教程」(
zhCN.tscommon_about_us;en 同步AI Quick Video Guide) index.json新增 about 条目(标题/描述/日期 2026-11-11/标签 教程·AI)- 部署构建 +线上三重验证:
/articles/about.md10516B、index.json 新标题、浏览器实渲染 h1/h2×10/strong×57/li×54/内链与菜单名全部正常(FolderGuard 未选文件夹不渲染主界面属产品设计,验证用临时遮蔽showDirectoryPicker放行,验毕已还原)
📝 使用教程页面重写(面向新手)
/article/local-deploy-guide 由旧部署指南全文替换为《米剪新手使用教程》
- 正文重写
public/articles/local-deploy-guide.md(旧 60 行部署指南删除):十一节新手教程——三个常见疑问、首次「选择本地存储文件夹」引导、首页/项目页/素材页/编辑器界面总览、6 步做出第一个视频(创建项目→素材三选一→时间轴→字幕转场配音→预览→导出)、素材页与项目页详解(上传/下载更多素材/创建文件夹/批量管理删除/点名称改名/自动保存)、编辑器顶栏与左侧 13 面板逐个说明、AI 配置模型与一键出片三选一、快捷键表、工程文件备份迁移、8 条常见问题 - 所有按钮名称、键位(Ctrl+B 分割等)、导出选项(480P~4K、MP4/MP3/GIF)均按源码逐一核实;因文章页 ReactMarkdown 未挂 remark-gfm,全文不用表格改用列表(旧文表格本就不渲染)
public/articles/index.json条目同步:标题《米剪新手使用教程》、描述/日期 2026-11-11/标签 教程·新手;offline-ready条目不动- 部署:
SKIP_LOCALIZE=1 SKIP_LINT=1 bash scripts/build.sh构建0dc5fba572ff并重启容器;线上实测/articles/local-deploy-guide.md11832 字节换新、index.json新标题、页面渲染 h1/h2×12/strong×115/li×98/blockquote×3 与文内链全部正常
🔒 MCP 端点强制 Bearer 鉴权
公网必须授权(使用 MCP 一定要授权)
mcp/server.py新增入站鉴权中间件:/mcp一律要求Authorization: Bearer <MCP_AUTH_TOKEN>(hmac.compare_digest恒定时间比较防时序侧信道),不带 / 错误令牌 →401+WWW-Authenticate: Bearer;MCP_AUTH_TOKEN未配置时拒绝一切调用(fail-closed)- 放行两类路径:
/health(nginx/mcp-health监控探针)、/out/*(/mcp-out/工程 ZIP / 配音 mp3 下载直链,浏览器点开无法附带请求头) - 部署:令牌写项目
.env的MCP_AUTH_TOKEN(git 已忽略不入仓库,secrets.token_urlsafe(32)生成),docker-compose.yml注入该环境变量并重建unicut-mcp - 文档:mcp/README.md 连接示例全部更新为带鉴权头(Claude Desktop
mcp-remote --header/ Claude Code--header/ Cursorheaders/ Hermesmcp_servers.headers),并修正 Hermes 旧示例错误键名mcp: servers:→ 官方mcp_servers:;.env清单与验证 curl 同步加令牌;主 README MCP 章节补授权说明 - 验证:无令牌 / 错令牌 401 ✓、正确令牌完整握手(initialize 200 + session → initialized 202 → tools/list 9 工具 →
service_status真实调用成功)✓、/mcp-health与/mcp-out/*.zip开放 200 ✓、空令牌 fail-closed 401 ✓
✨ 素材页下载入口
工作台素材页新增「下载更多素材」按钮
- 上传素材右侧新增独立按钮(样式与同排「图片分割 / 视频分割」一致),点击
window.open新窗口直达素材下载文档站https://doc.88531.cn/docs/mrfx/mrfx-1g99qum57n5qk,与编辑器素材面板的下拉入口互补 - 仅素材类型(
props.type === 'material')下渲染,不影响其他内容页
🐛 修复(本地模式删除 / 移动)
素材与文件夹删除失败、移动到文件夹失效(本地模式无后端)
- 根因:素材/文件夹实际存浏览器 IndexedDB + 本地目录,但删除调的是不存在的
materialServer.deleteMaterial与无后端的POST /user/categories/delete(静态站 404,什么都不删);moveMaterial同样调不存在的服务器接口 SelectedSet.tsx删除改本地优先:文件夹走新增的deleteLocalCategory(删分类记录并清空其下素材/项目的分类标记,素材保留在「全部」),素材走deleteLocalMaterial(真删磁盘文件 + IndexedDB 记录,含封面/帧图/音波图)material/server.ts的moveMaterial改为直接更新 IndexedDB 分类标记- 浏览器端到端验证:批量删除后 UI 提示「删除成功」,IndexedDB 回读分类与素材记录均为空
✨ 素材存储位置展示
素材页显示实际存储路径
Material.tsx页面头部新增「📂 存储位置:〈你选的目录名〉/materials/」提示条,悬浮任一素材名可看该文件相对路径(如米剪素材测试目录/materials/abc123/path_test.png)- 受浏览器 File System Access API 安全限制只能拿到目录名 + 相对路径,拿不到完整绝对路径
✨ 素材面板菜单
素材面板新增「下载更多素材」直达入口
- 上传素材右侧的下拉菜单(在线录音 / 文字转语音)新增第三项「下载更多素材」,点击在新窗口打开素材下载文档站
https://doc.88531.cn/docs/mrfx/mrfx-1g99qum57n5qk - 文案入语言表:
zhCN.my_download_more/enUS.my_download_more,图标用Download(@icon-park/react),菜单项渲染与既有项同构
🤖 MCP 接入
新增 unicut-mcp 服务:AI 客户端直接调用米剪能力(Model Context Protocol)
- 新增
mcp/服务(Python FastMCP,Streamable HTTP):抓取文章grab_url(与前端extractFromHtml同规则)、口播文案generate_script(OpenAI 兼容网关)、配音tts/list_voices(unicut-tts)、工程生成create_video_project、文件夹模式工程读写list/read/write_project、自检service_status create_video_project产出与米剪导出同构的工程 ZIP(project.json + materials/{type}/,过checkNdata九键门禁):图片校验对齐前端(≥160×120 / ≤10MB)、有配音自动铺满时长、文案按字数加权切字幕,元素结构照抄官方 demo 工程真实字段- nginx 同源反代
https://<站点>/mcp(SSE 关缓冲长连接)与https://<站点>/mcp-out/*(工程 ZIP 下载);compose 新增unicut-mcp服务,密钥走项目.env(MCP_LLM_KEY等,不入库) - 文档:
mcp/README.md(工具明细 + Claude Desktop / Claude Code / Cursor / Hermes 接入配置 + docker run / compose 两种部署),主 README「AI」章新增 MCP 小节与更新表行 - 版本号
1.0.0 → 1.0.1(package.json/ README 发布 tag 同步;授权中心基线仍为 1.0.0,客户端上报 1.0.1 判定「已是最新」)
🐛 修复(/grab/ 抓取)
- 公众号图片防盗链:
/grab/向上游清空Referer(带异源 Referer 时mmbiz.qpic.cn只给 140×140 降级缩略图,无 Referer 才给原图,实测 2KB vs 47KB) - 正文根节点优先
#js_content:微信文章页没有article/main,旧选择器会退化到整页body混进账号栏/留言噪音
✨ 新功能
AI 一键出片 · 素材三选一(图片 / Word·PDF 文档 / 网址)
- 第 1 步素材来源新增三选一:默认「添加图片」;「上传文档」支持 Word(.docx) 与 PDF,自动提取正文,docx 内嵌图片一并取出当配图,PDF 文字层抽取 + 前几页渲染成画面(扫描件/受保护文档会明确提示换文件);「输入网址」抓取页面正文与配图
- 网址抓取走同源
/grab/反代(nginx 动态上游):仅放行 http/https,拒绝回环 / 内网 / 链路本地地址与带凭据(user:pass@)URL,防止被当跳板打内网;重定向折返回本域再次校验 - 纯文档 / 纯文字素材没有配图时,自动生成一张标题封面,保证时间轴始终有画面可用
- 来源打标:素材卡片显示「文档 / 网址」标签,便于区分最近一次导入
- PDF.js worker 由 vite 打进本地产物,离线可用;新增依赖
pdfjs-dist
纯文本对话模型也能出片(提示属实化)
- AI 面板出片卡片新增提示:「只需纯文本模型即可使用;模型支持多模态(视觉)就能自动生成出片」
- 未配视觉模型时:调用层剥掉消息里的
image_url图片块(避免不支持多模态的主模型被图片顶回错误),文案 prompt 改为「你看不到图片本身,image 按图片编号顺序循环分配画面(第1段填1、第2段填2…循环)」——纯文本模型照样能出完整片 - 已配视觉模型时行为不变:逐张压图后看图配画面;
aiVisionAvailable()(对话模型已配置 && 视觉模型非空)作为唯一判据集中在localAi.ts - 四步说明第 2 步同步改为不依赖视觉能力的表述:「AI 自动写口播文案,每段配好对应画面」
🔧 构建 / 质量
/grab/ 网址反代实测修复(首测即抓出两个致命 bug)
- query 传参被误杀:
encodeURIComponent的产物 nginx$arg_不做解码,合法目标全部匹配不到^https?://被打成 400——改为X-Grab-Url请求头传输目标(免编码),nginx 断言改读$http_x_grab_url,上游侧同名头清空不外泄 - 裸域名路径错位:
https://host(无路径)反代时会把原始/grab/?url=…请求路径透给上游——前端new URL(cur).href规范化补默认路径/后再发 - 实测断言:正例抓取成功;回环 127.0.0.1、内网 192.168.x、
file://协议、user:pass@带凭据 URL 全部正确拒绝
断网 lint 门禁修复(external_refs 20 → 0,门禁恢复全绿)
- pdf.js 的 XFA/Adobe XML 命名空间字符串(w3.org / xfa.org / adobe.com 等 17 条)登记入
NAMESPACE_HOSTS—— 纯命名空间字符串,浏览器不发请求 - pdf.worker 模板字面量
http://${A}的提取截断产物入白名单(仅new URL()构造,不发起请求) - 代码内两处
example.com示例域名删除:文章生成器占位域名改为中文示意文字、候选解析错误提示不再回显域名 - 官方自有域名入白名单并注明理由:
ai.88531.cn(官方 AI 网关默认接口https://ai.88531.cn/v1+「获取 Key」引导链接)、nav.88531.cn(首页导航站入口)—— 产品默认配置本体,断网时静默降级,删掉功能即失效 - 实测
external_refs = 0(00_lint_dist.py --dist对构建产物复跑确认),BUILD_EXIT=0
🏠 首页调整
移除「受到众多大品牌信赖」品牌背书块
- 删除首页 Trust Bar 区块(背书文案 + UCAP / YTO圆通 / 中国电信 / 中国移动 4 个 logo)
- 同步清理
home.module.less中.trustBar/.trustLogos死样式(含移动端媒体查询覆盖) - 验证:线上 6/6 文本断言通过——背书文案与品牌名全部消失,编辑器展示块(8 项AI / 12+ / 4K)与 AI 功能区完好;截图目检原位置直接衔接「AI 智能功能」区,无空洞错位
🧹 功能调整
移除「AI 视频生成 / AI 图片生成」两个页签
- 编辑器左侧「AI创作」面板删除 Ai视频生成、Ai图片生成 页签及其组件(AiVideo / AiImage),保留「一键出片」与「生成结果」
- AI 生图 / 生视频能力不受影响:仍可走右侧「AI 助手」对话的图片生成 / 视频生成模式,未配置引导与「配置模型」入口文案不变
- 验证:线上面板页签仅剩「一键出片 / 生成结果」;页面文本断言 4/4 通过;构建产物
main-0605b5a4.js中两页签名残留 0 处 - 附带修复 ①:AiMain 补回被误删的
Button/QuickVideo/useState引用,否则面板一渲染就报错 - 附带修复 ②:
scripts/build.sh与docs/免登录改造.md硬编码的旧源码路径/vol1/1000/HD1/docker/unicut-src改为现行/vol3/1000/HD3/docker/unicut-src(仓库迁移残留,此前构建必失败) - 附带修复 ③:构建改走
DOCKER_BUILDKIT=0legacy 构建器——本机 docker.io DNS 被污染,buildkit 查基础镜像元数据必然超时;本地已有node:20-alpine/nginx:1.27-alpine,legacy 直接用本地镜像
2026-10-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,属预期)
Docker 镜像发布到公共 Registry
gitea.88531.cn(Gitea 内置容器 Registry,免登录可拉):已推送gitea.88531.cn/jinghui/unicut:latest与:v1.0.0;README「快速开始」方式一新增docker pull直接起,免构建- 端到端验证:公网
docker pull gitea.88531.cn/jinghui/unicut:latest成功(digestb4b83781…),匿名 inspect latest / v1.0.0 均 200 - 新增发版脚本
scripts/push_registry.sh:docker save→ skopeo 内网直推(绕过公网 nginx 单请求 413 体积上限,公网拉取不受影响) - 腾讯云镜像仓库(TCR):待补凭据后推送并补 README 拉取命令
编辑器右上角开源地址入口
- 编辑器右上角新增「开源地址」按钮(GitHub 图标 + 蓝字),位于「配置模型」左侧,点击新标签页打开
gitee.com/jinghui111/unicut - 与首页底部开源入口、README 源码链接同一目标地址;Playwright 实机验证按钮渲染正常(顶栏对齐、图标完整)
项目 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),不需要登录,也不经过服务端;提供订阅机制,改完立即生效 - 新增
src/components/ai-settings:设置弹窗(接口地址 / API Key / 模型 三个输入框 + 清除 Key)与未配置时的引导卡片,引导卡带「填写 API Key」和「没有 Key?免费注册领取」两个按钮 - 默认接口地址
https://ai.88531.cn/v1,默认模型mimo-v2.6-flash,注册地址https://ai.88531.cn/register(该站register_enabled=true、公告写明「注册即送体验金」,CORSaccess-control-allow-origin: *,浏览器可直连,无需服务端代理) - 单点拦截:
localChatCompletion/localGenerateImage/localGenerateVideo未配置时直接返回统一文案AI_NOT_CONFIGURED_MSG,一个请求都不发 - 挂载点:编辑器右侧「AI 助手」与左侧 AI 面板未配置时整块换成引导卡;配置好后两处都常驻一个「AI 设置」按钮
- 对话的接口地址与密钥一律以用户填的为准;调用方传入的私有模型 ID(
deepseek-v4-pro-260425等)一律忽略,统一走 AI 设置里的模型;视觉模型保留deepseek-v4-flash-vision-exp(默认网关上确实有),请求失败会自动降到主模型 - 生图 / 生视频走本站内置反代(
/omniai、/civideo,密钥由 nginx 注入),同样以「是否配置 Key」作为解锁开关 - 配音(本机 edge-tts)与抠图 / 去背(本机模型)不消耗外部额度,不纳入 Key 开关
- 首页 FAQ 与「经济实惠」文案同步改为 BYOK 说明,新增「AI 功能怎么用?要收费吗?」一条
授权系统(CardAuth)
- 接入
auth.88531.cn:装机数统计、心跳在线人数、公告发布(列表 + 进入弹窗 + 铃铛未读红点)、版本推送(有新版时徽标转琥珀并弹「发现新版本」) - 右上角常驻当前版本号
v1.0.0,编辑器页同样显示;点徽标可手动检查更新 - 密钥只在 nginx 反代注入(
/hub反代带X-Project-Id头),不进前端包;产物扫描确认 JS 里无密钥 - 节流:心跳 60s、公告 30min、版本 6h、手动检查 8s;授权中心不可达时全部静默降级,绝不拦功能
- 项目编号
__HUB_PROJECT_ID__由entrypoint.sh在容器启动时替换进前端(HUB_PROJECT_ID=传入后重启即生效,未配时保持占位符)
公告归属过滤(修复)
- 现象:项目编号还是占位符时,授权中心按它自己的默认项目回吐了别人家的公告,一进首页就被「使用教程」弹窗盖住页头
- 修复:
hub.ts新增isMine(),公告自带的project_id与本项目不符的一律不显示;编号配好后自然放行
手动检查更新说人话(修复)
- 现象:没接入授权中心时点「检查更新」也提示「当前已是最新版本」,属于冒充
- 修复:查不到结果时改口「暂时无法连接授权中心,稍后再试」;查到且确实无新版才说「已是最新版本」
首页底部新增「导航站 / 开源地址」区块
- 位置:紧接 CTA 之后、页面最底部(Footer 已下线),独立深色区块 + 紫色光晕,眉标 MORE + 标题「我的导航站 / 开源地址」
- 左卡「我的导航站」
https://nav.88531.cn(20+ 自建站点,200 可达);右卡「开源地址」https://gitee.com/jinghui111/unicut(你自己的仓,公开且由 Gitea 同步 cron 自动跟进,含全部本地化改造;上游原项目676015863/unicut最后更新停在 2026-09-18,不适合当出口);许可条款按事实以仓库说明为准(仓库无 LICENSE 文件,故页面不写 MIT) - 双卡大按钮(桌面 648×160、移动 342 宽),
target="_blank" rel="noreferrer"新标签打开;浅色主题有独立覆写,白底不白字 scripts/e2e_home_links.py16/16:文案、href 精确、外链属性、卡片尺寸、区块位置、无横向溢出、无 JS 崩溃;深色/浅色/390px 三态视觉验收通过- 开源地址指向自建仓
gitee.com/jinghui111/unicut(含全部本地化改造),上游项目仅以「基于上游开源项目二次开发」形式注明 - 授权中心「米剪」项目(编号 9)真实链路跑通:登记、心跳、版本检查、公告四端点全通;基线版本 1.0.0 已发布,老客户端会收到更新提示
首页与菜单瘦身
- 首页删除「收费标准」整段(BYOK 免费工具,收费无从谈起)
- 顶栏菜单删除 GitHub / Gitee 外链入口(开源地址改为首页底部固定展示)
- 底部 Footer 整块下线(组件保留
return null,随时可恢复)
2026-10-26
✨ 新功能
免登录使用
- 核心功能(编辑、模板、素材、导出、保存)全部免登录,
GUEST_USER直接进入 - 移除登录态拦截,
checkAuth()不再阻断编辑器
本机 AI 接入
- AI 对话主模型
mimo-v2.6-flash,走同源/newapi/v1反代,HTTPS 页面不触发混合内容拦截 - 视觉模型
deepseek-v4-flash-vision-exp,备用glm-5.3-flash/deepseek-v4-flash - AI 生图走
/omniai(本机 omniroute),AI 生视频走/civideo(直连 cheaperinference,绕开网关视频白名单) - 密钥全部留在服务端:nginx 占位符由
entrypoint.sh注入,前端与仓库均不出现明文
AI 一键出片
- 四步向导:添加图片 + 标题 → AI 识别图片生成口播文案 → 配人声/语速/情绪试听 → 确认生成直接排入时间轴
- 13 种中文音色(含四川话/粤语/台湾腔等方言),支持单段重合成或一键全部合成
- 画面效果面板(生成前可调):
- 图片转场 9 选(自动轮换 / 交叉缩放 / 推进穿门 / 水波涟漪 / 左侧擦除 / 立方翻转 / 柔和溶解 / 平滑缩放),转场名取自官方 GL-Transitions 素材库共 28 个
- 图片动效 4 选(缓慢推近 / 缓慢拉远 / 左右平移 / 静止),基于元素关键帧
frames做几何插值 - 字幕位置(底部/居中/顶部)、大小(60%–200%)、配色(黄/白/橙 + 描边)、入场动画(放大弹入 / 淡入 / 放大+淡入)
- AI 面板顶部常驻高亮入口卡,切到其他页签也始终可见,点卡片直达向导
离线可用
- 工程数据双写:IndexedDB + 项目文件夹
projects/<appId>.json,IndexedDB 查不到时从文件读回 - 素材上传在无 OPFS 目录句柄时(如以
http://IP打开)回落到 IndexedDBfiles表,整条「上传 → 加入时间轴 → 导出」链路仍可用 - 官方素材统一走同源
/cdn/反代,浏览器不再直连 CDN
🐛 修复
账号类接口反复弹窗
- 现象:每隔数秒弹
Header parameter [authorization] cannot be empty - 根因:
/api/、/cgi-bin/反代到官方后端,其中/user/*、/account/*必须登录 token;自动保存每 10 秒触发一次,每次都失败 - 修复:
BasicService._request()对账号类接口本地短路返回空成功结果,不发请求;保存与作品列表的本地分支判据由 OPFS 放宽为 IndexedDB(canUseLocalSave())
OPFS 判定错误导致卡在引导页
- 现象:页面停在「选择本地存储文件夹」弹窗,编辑器进不去
- 根因:
isFSApiSupported()使用'showDirectoryPicker' in window,in只要属性名存在于原型链就为真 - 修复:改为取值判断
typeof window.showDirectoryPicker === 'function'
模板缩略图全部裂图
- 现象:模板面板列表能加载,但 26 张缩略图全裂
- 根因:列表接口返回
/video/…相对路径,同源取被 nginxtry_files兜底伪装成200 text/html的 SPA 首页 - 修复:前端改写到
/cdn/反代;nginx 增加location ~ ^/(video|video_business)/兜底直接转发 CDN,即使前端改写丢失也不会再裂图
模板素材已失效
- 列表首位模板的 mp4 在上游 CDN 已删除(所有前缀均 404),点开必然卡在 loading 50%
- 修复:
DEAD_TEMPLATE_IDS黑名单剔除,素材存活已逐个探测(24 好 1 坏)
画布卡在 loading 0%
- 根因:
resourcesHost改同源后,SDK 内置 4 张滤镜贴图(overlay / colormap / displacement_map / lightmap)在容器镜像中缺失,加载失败导致后续流程不执行 - 修复:补齐 4 张贴图资源
封面上传失败导致整次保存失败
- 修复:
saveApp()中封面上传包 try/catch,失败只跳过封面,不影响工程保存
🎨 调整
- 品牌由「云剪」改为 UniCut
- 品牌名再由 UniCut 改为 米剪(全站显示名、
<title>、meta、FAQ、关于我们、侧栏、离线提示页、文章文稿统一;英文语境用MiCut;代码里指代上游开源项目的UniCut注释保留并加了说明) - 导航栏 Logo 字标换新:
logow-en.png/logow.png里的英文旧字标由代码重绘为「米剪」(保留原图形标,字高与原字标对齐 28px、垂直居中) - 首页删除「收费标准」栏目(含相关样式与死代码)
- 顶部菜单栏移除 GitHub / Gitee 外链
- 底部栏整体下线(
Footer返回null,组件保留以便随时恢复) - 首页页脚版权、导航、支持链接、联系方式、二维码全部移除