封面 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 天
发新版 / 发公告的顺序
- 先把新镜像/新包推出去(用户点下载链接要能拉到东西)
- 再在 CardAuth 里写
ca_project_versions(新版本is_latest=1、旧版置 0)→ 客户端 6 小时内(或重启后)看到提示 - 公告写
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