Files
unicut/CHANGELOG.md
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

32 KiB
Raw Permalink Blame History

更新日志

本项目在 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(env MCP_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 Code claude mcp add / Cursor mcp.json / Hermes config.yaml)、工具逐个详解(参数与默认值按 mcp/server.py 源码核实:grab_url 12000 字截断、generate_script 60 秒×4.5 字、tts 默认晓晓音色 ≤2000 字、create_video_project 30 图上限/160×120 门禁)、一句话生成视频实战链、curl 握手自检、.env 自部署配置、8 条常见问题
  • 顶栏菜单加「MCP 使用说明」(Header.tsx nav,置于「使用教程」后,当前页自动高亮)
  • 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.ts common_about_us;en 同步 AI Quick Video Guide)
  • index.json 新增 about 条目(标题/描述/日期 2026-11-11/标签 教程·AI)
  • 部署构建 +线上三重验证:/articles/about.md 10516B、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.md 11832 字节换新、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 / Cursor headers / Hermes mcp_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=0 legacy 构建器——本机 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 成功(digest b4b83781…),匿名 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、公告写明「注册即送体验金」,CORS access-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.py 16/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 打开)回落到 IndexedDB files 表,整条「上传 → 加入时间轴 → 导出」链路仍可用
  • 官方素材统一走同源 /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/… 相对路径,同源取被 nginx try_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,组件保留以便随时恢复)
  • 首页页脚版权、导航、支持链接、联系方式、二维码全部移除