封面 AI 助手 · cover-ai

🌐 在线体验(经「米图设计」编辑器右下角 ✨ 按钮打开):https://mitu.88531.cn

给封面/配图用的 AI 生图与修图服务。零依赖单文件 Node + 一个 HTML 页面,Docker 一条命令跑起来。 AI 接口不在服务端配置:使用者在页面顶部「API 设置」里填自己的接口地址 + API Key + 模型, 默认接口 https://ai.88531.cn/v1、默认模型 mimo-v2.6-flash,没 Key 只能用素材库等基础功能, 页面会引导去 https://ai.88531.cn/register 免费注册获取 Key。

典型用法:做公众号/知乎/头条/小红书/B站封面时缺一张配图,或者拿一张参考图要求「换个背景、保留主体」。


一、能力

页签 做什么 实现
AI 生图 文字描述 → 图,可选尺寸/模型,一次出 1 张,可连点 POST {base}/images/generations(模型取「API 设置」里所选)
AI 修图 上传一张图 + 改图要求 → 新图,左右对比看效果 所选模型走 {base}/chat/completions 看图出描述 → 再文生图(看图失败自动降级为纯文字重画)
素材库 历史生成图,可预览/下载/删除 本地 gallery/ 目录 + gallery.json 元数据(基础功能,不需要 Key)

出图后可直接:下载、按平台精确尺寸居中裁切(浏览器 canvas 完成,不额外消耗算力)、复制直链。

二、为什么"修图"是重画而不是像素级修

真·像素级修图要走 {base}/images/edits,是否可用取决于你在「API 设置」里填的接口和模型:

  • 通道不支持 edits → 明确报错(例如旧 omniroute 内置 provider 硬拦 Image edit is not supported for built-in provider);
  • 模型余额/额度不足 → 报 402 并翻译成中文提示。

所以默认实现走「看图 → 出描述 → 重画」,构图和配色跟随原图,但不是像素级。 想升级成真修图不用改代码:在「API 设置」里换一个支持 images/edits 的接口/模型(或换有该能力的 Key)即可。

三、接口

GET  /                  UI(单页)
GET  /api/ai-config     默认接口地址/模型/注册链接(服务端 env 下发)
GET  /api/health        健康检查
GET  /api/models        拉模型清单        要求头 x-ai-base + x-ai-key
POST /api/gen           {prompt, size, model} → 生成          要求 x-ai-key
POST /api/redraw        {image, prompt, size, model} → 重画    要求 x-ai-key
POST /api/edit          {image, prompt} → 真·修图              要求 x-ai-key
GET  /api/gallery       历史图列表(基础功能,不要 Key)
DELETE /api/gallery/:name   删图
GET  /img/:name         取图(供编辑器跨端口反代)

Key 的处理:前端把 x-ai-base / x-ai-key / x-ai-model 放在请求头里发给服务端, 服务端只做转发,不写日志、不落盘、不进镜像;没带 Key 的 AI 请求一律 403 {needKey:true} 并附注册链接。 未配置时 /api/models、/api/gen 等 AI 接口全部拒绝,只有素材库/健康检查可用。

同源问题:快图设计(8126)通过 /ai-img/* 反代本服务的 /img/*,避免画布 canvas 被跨域污染。

四、跑起来

docker build -t cover-ai:1.0 .
docker run -d --name cover-ai --restart always --memory 384m -p 8128:3000 \
  -v $PWD:/data \
  -e PUBLIC_BASE=http://<本机地址>:8128 \
  -e AI_BASE=https://ai.88531.cn/v1 \
  -e AI_MODEL=mimo-v2.6-flash \
  -e REGISTER_URL=https://ai.88531.cn/register \
  -e VERSION=1.0.0 \
  -e HUB_PROJECT_ID=<授权中心项目id> \
  -e HUB_API_KEY=<项目 api_key> \
  cover-ai:1.0

本仓生产实例(8128)已接授权中心项目 id=10。重建一律用 restart.sh:它从 CardAuth 库按 HEX 读 KEY 注入 env——明文密钥经终端/文本通道会被自动打码成掩码(表现为 403「API密钥无效」),不要手工把 ak_... 写进命令。

  • 没有 OMNI_KEY 这类服务端密钥了——Key 由每个使用者在页面里自己填(存浏览器 localStorage)
  • AI_BASE / AI_MODEL / REGISTER_URL 只是「表单默认值 + 引导链接」,可改
  • HUB_* 是授权中心(版本推送 / 公告 / 安装与在线统计),不配也能跑,只是没有更新提示和公告;HUB_DISABLED=1 可彻底关掉上报
  • server.js / ui.html 是 COPY 进镜像的,改完要重新 docker build
  • 生成图落在 /data/gallery/(宿主目录),容器删了图还在

五、授权中心(版本号 / 新版本提示 / 公告 / 安装与在线统计)

复用自建 CardAuth 的「免费工具遥测」三接口,右上角常驻当前版本,有新版本自动提示。

能力 表现
当前版本 右上角徽章 v1.0.0,点击弹出版本信息(当前 / 最新)
版本推送 有新版本 → 徽章变黄 + 顶部黄色横幅「发现新版本 vX」(说明 + 下载链接 + 知道了,按版本记忆)
公告 右上角 🔔,有公告亮橙点;点开面板看全部;popup 公告只弹一次(按 id 记忆);后台删公告 → 面板自动关、铃铛回「暂无公告」
安装数 首次启动登记 + 版本检查写 ca_installations
在线数 开机一次 + 每 30 分钟心跳写 ca_online_logs(按天去重)
  • 节流:更新检查 6 小时(失败 30 分钟重试)、心跳 30 分钟、公告 60 秒;授权中心不可达不影响任何功能(版本照常显示、公告保留上次结果、更新提示消失)
  • 机器码 13 位数字只存服务端 /data/hub.json,不下发浏览器、不在 UI 展示;hub.json 已进 .gitignore
  • 管理接口:POST /api/hub/refresh 绕过节流强刷一次;GET /api/health 看 version 与 hub 状态(on / unconfigured / off)

看统计(安装数 / 今日在线 / 近 7 天在线)

统计落在 CardAuth 库里,只读 SQL(进 cardauth-db 容器执行):

SELECT COUNT(*) FROM ca_installations WHERE project_id=<本项目id> AND status='active';           -- 累计安装
SELECT COUNT(DISTINCT machine_id) FROM ca_online_logs WHERE project_id=<id> AND online_date=CURDATE();   -- 今日在线
SELECT COUNT(DISTINCT machine_id) FROM ca_online_logs WHERE project_id=<id> AND online_date >= CURDATE()-INTERVAL 7 DAY;  -- 近 7 天

发新版 / 发公告的顺序

  1. 先把新镜像/新包推出去(用户点下载链接要能拉到东西)
  2. 再在 CardAuth 里写 ca_project_versions(新版本 is_latest=1、旧版置 0)→ 客户端 6 小时内(或重启后)看到提示
  3. 公告写 ca_announcements,status 必须 = 1(默认 0 = 静默隐身,接口返回空且不报错)

六、为什么这么写(几个刻意的选择)

  • 零依赖:只用 Node 内置 http/fetch,不装 express、不带 node_modules,镜像几十 MB,构建 3 秒
  • 不做用户体系:内网单用户工具,加登录只会让"笨用户"用不了
  • 裁切在前端做:模型返回的尺寸是近似的(要 720×1280 实际可能回 864×1152),用 canvas 居中裁切才能拿到平台精确规格,且不额外花钱
  • 中文提示词兜底:服务端固定追加「不要出现文字/水印」「主体占画面主要面积」等约束,减少脏图

七、更新日志

每次功能更新都会在下方追加条目,同步更新页面右上角版本号。

2026-10-28

  • ✨ 右上角新增「开源」链接(Gitee 仓库,新窗口打开),紧邻公告铃铛与版本号
  • 🎨 修复 ui.html 残留旧品牌「快图设计」→「米图设计」
  • 🔧 重启脚本改为从 CardAuth 库动态注入授权 KEY(明文不落盘、不进镜像)

2026-10-27

  • ✨ 接入 CardAuth 授权中心:右上角版本号 + 新版本提示 + 公告铃铛 + 安装 / 在线统计(失败开放,6h / 30min / 60s 节流)
  • ✨ AI 改为使用者自配 Key:接口 / Key / 模型可在页面配置(默认 https://ai.88531.cn/v1 + mimo-v2.6-flash),无 Key 仅用基础功能并引导免费注册;错误提示中文化
  • 🎨 页脚去掉上游版权,改为「我的导航站 · 开源地址」

2026-10-26

  • ✨ 首版:AI 生图 / AI 重画 / 素材库,零依赖单文件 Node
S
Description
封面 AI 助手:AI 生图/AI 重画,走自建 omniroute + cheaperinference,可被快图设计素材面板直接调用
Readme
159 KiB
0 Stars 1 Watchers 0 Forks
Latest
2026-11-02 16:00:04 +08:00
Languages
HTML 61.4%
JavaScript 36.5%
Shell 1.9%
Dockerfile 0.2%