Files
2026-10-28 11:30:16 +08:00

5.7 KiB
Raw Permalink Blame History

米图设计 · 封面工坊版(本地化改造)

基于 ikuaitu/vue-fabric-editor(MIT,作者 秦少卫)二次开发, 目标:在自己机器上离线跑一套中文封面编辑器,模板、接口、AI 出图全部本地,不依赖上游 Strapi 云服务。

镜像:kuaitu-editor(容器名同名),端口 8126,数据只读挂载。前端 5MB,构建后约 144MB。


一、改了什么

1. 本地模板接口(新增 server/index.js,零依赖 Node)

上游前端所有模板/素材都请求一个远程 Strapi(/api/templs、/api/templ-types、/api/web-site、/api/sizes…), 没有后端就无法用。这里用一个单文件 Node 服务完整实现了 Strapi 的返回结构({data:[{id,attributes:{...}}], meta:{pagination}}), 所以前端一行代码没改,直接把请求指过来就能跑:

接口 作用
GET /api/templ-types 10 个平台分类:公众号 900×383 / 小红书 / 知乎 / 头条 / B站 / 方形 / 竖版海报 / 视频封面 / 朋友圈 / 横版头图
GET /api/templs?filters[...]&pagination[...] 模板列表,支持分类筛选、关键词搜索、分页
GET /api/templs/:id 单模板 fabric JSON(直接塞进画布)
GET /api/sizes 从模板库反推尺寸清单,自带宽度高度
GET /preview/:id.png 模板预览图
其它 /api/* 统一返回空集,避免编辑器对缺失接口报错

模板数据就是普通文件(data/index.json + data/tmpl/*.json + data/preview/*.png), 加模板 = 丢文件,不用重启数据库、不用跑迁移。

2. 内置 106 套本地模板(data/)

上游开源版不带模板(模板是商业版的卖点)。这里用 data/gen_templates_v2.py 程序化生成: 10 种平台尺寸 × 每类 10 套以上版式,覆盖居中大标题、左文右图、色块分割、渐变底、杂志大字、极简留白等。 data/render_preview.js 把每个 fabric JSON 渲染成 PNG 预览。改颜色/字体只需改脚本重新生成。

3. 模板缩略图不显示的修复(APP_PATCH 注入 CSS)

上游模板卡片外层 .tmpl-img-box 初始高度是 0,而 iView 的 <Image> 用 IntersectionObserver 懒加载, 高度为 0 就永远不触发 → 模板列表一片空白,但控制台无报错。 处理:服务端在 index.html 的 </head> 前注入一段 CSS,强制 .tmpl-img-box{height:112px} 并让内层图片 object-fit:contain。 不改构建产物、不污染源码,重建前端也不会丢。

4. 素材面板接入 AI 出图(/api/material-types + /api/materials + /ai-img/*)

编辑器左侧「素材」面板原来也是空的(上游要付费素材库)。现在:

  • /api/material-types 返回一个分类「AI 生成」
  • /api/materials 实时去 cover-ai(8128)的 /api/gallery 拉最新 AI 图,转成 Strapi 格式
  • /ai-img/<file> 反代 8128 的图片,绕开跨端口同源限制 结果:AI 生成或 AI 重绘的图,不用下载上传,直接在素材面板点一下就进画布。 安全细节:图片名走 path.basename 过滤,防目录穿越。

5. 右下角悬浮「✨ AI 生图 / 修图」按钮(APP_PATCH 注入 HTML)

一键弹出全屏 iframe 面板(指向 8128),Esc 关闭。不用装插件、不用改 Vue 路由, 面板和编辑器两个独立服务,各自重启互不影响。

6. 构建与部署(Dockerfile.kuaitu + docker-compose.cover.yml)

注意 .env.production 里 APP_APIHOST= 必须留空。上游 .env 默认指向 https://github.kuaitu.cc, 不置空的话构建出来的包会去请求上游云服务,本地模板和 AI 素材全部取不到(表现是模板列表空白)。

  • 多阶段构建:node18 里 pnpm install && pnpm build → node20 只带 dist + server
  • 内网镜像源 registry.npmmirror.com,构建不需要代理
  • TEMPLATE_DIR=/app/data,模板目录可外部挂载替换
  • 上游自带的 Dockerfile(nginx 版)保留,两者不冲突

二、相比原版和商业版

上游开源版 快图商业版 本项目
模板 无(空列表) 云端模板库 106 套本地模板,可脚本批量生成
后端 需自建 Strapi 官方云服务 单文件 Node,零依赖,返回结构兼容 Strapi
离线可用 否 否 是,全内网
AI 出图 无 增值付费 接入自建 8128(grok-imagine),图直接进素材面板
数据归属 — 云端 模板和图片都在自己硬盘
费用 免费 订阅 0 元(只有 AI 出图消耗自己的 API)

对自媒体流水线的实际价值:封面从「打开网页→找模板→手动改字→下载→上传」变成 「脚本批量渲染(8127 封面工坊)→ 需要精修才开 8126 → AI 缺图就在同一个面板画 → 点一下入画布」。


三、跑起来

docker build -f Dockerfile.kuaitu -t kuaitu-editor:1.0 .
docker run -d --name kuaitu-editor --restart always -p 8126:80 \
  -v $PWD/server:/app/server:ro \
  -v /path/to/kuaitu-editor-data:/app/data:ro \
  -e COVER_AI=http://<你的封面AI地址>:8128 \
  kuaitu-editor:1.0
  • server/ 用只读挂载,改接口后 docker restart kuaitu-editor 即生效,不用重新构建
  • COVER_AI 不填则默认 http://192.168.68.19:8128,取不到 AI 图时素材面板返回空数组,不影响编辑器本身
  • 生成模板:python3 data/gen_templates_v2.py(需要 PIL)→ node data/render_preview.js(需要 node + canvas)

四、许可

上游 MIT(Copyright (c) 2022 秦少卫),本项目改动同样 MIT。上游 README、LICENSE 原样保留。