更新日志

每次发布新版本时, 这一页会自动追加更新内容。最新版本在最上面。

v0.11.0 — 2026-09-12

woodchen/imagic:0.11.0

本版完全兼容 v0.10.x 所有 license / 配置 / 数据库, 旧版本仍可正常使用, 无强制升级. 升级后老渠道、老计费规则、老历史记录都保持原样, 用户看到的默认模型也和升级前一致.

【新增两个生图型号】

• OpenAI 新出了两个生图型号, 本版接上了: 一个出图更快更清晰, 一个改图更精准适合成片
• 两个新型号默认是下架状态, 不会打扰你现有的运营节奏; 想用的时候自己上架
• 新型号多出两档更高的画质选择 (超清 / 顶配), 老型号仍是原来的三档
• 新型号支持透明背景出图, 老型号不支持; 用户选了透明背景时输出格式会自动限制到能存透明的那两种

【后台新增"生图模型"页】

• 决定用户在创造页能选哪些型号, 每个型号叫什么名、配什么角标和卖点文案, 都能自己改
• 拖拽调顺序, 一键上下架, 指定哪个是用户默认选中的
• 每个型号可以单独开关"透明背景 / 流式草图 / 局部重绘", 并设置改图时最多能传几张参考图 — 这些开关只管界面显示, 让用户不会看到当前型号其实用不了的选项
• 删掉一个型号不会删它的价格设置, 万一删错了重建同名型号价格还在

【创造页】

• 右侧"生成设置"顶部的模型从固定一个变成可点选的卡片组, 显示名字、角标和一句话卖点
• 切换型号后可选尺寸、画质档位、背景选项、参考图张数上限都会跟着重算, 不会让用户选到用不了的组合
• 换成参考图上限更小的型号时, 已经选超的图不会被自动删掉, 只红字提示手动去掉多余的
• 画质胶囊从三档扩到最多五档, 中文标签: 标准 / 进阶 / 极致 / 超清 / 顶配
• 高级设置里的"背景"与"审核程度"下拉改为中文 (自动 / 不透明 / 透明, 标准 / 宽松), 之前是英文字面量

【渠道 - 支持模型白名单】

• 渠道表单新增一组模型勾选框: 不勾 = 这条渠道支持全部型号 (升级上来的老渠道就是这个状态, 行为不变); 勾了就是白名单
• 解决的问题: 渠道商只开通了部分型号时, 以前请求会先白跑一趟不支持的渠道再换下一家, 用户多等好几秒, 而且这次失败还会算进那条渠道的失败次数, 攒够了会把一条本来好好的渠道自动禁用
• 某个型号一条渠道都没勾上时, 用户会直接收到"该模型暂无可用渠道"的提示, 不再白等

【计费】

• 升级后系统会自动补上新型号的默认价格, 一个字都不会动你已经改过的老型号价格
• 计费规则的"模型"字段从手打改成下拉选择, 避免型号名打错造出永远用不上的规则
• 价格表从三档扩到五档; 某档留空 = 不开放该档, 用户在创造页就看不到这个画质
• 新型号两档高画质的默认点数是估算值: OpenAI 只公布了按 token 计费的单价、没有每张图的价目表, 内置值按"极致档的 2 倍 / 3.5 倍"保守定的 (宁可先定高, 往低调不会让你亏钱), 上架后请按实际消耗校准

【生图历史 - 看真实成本】

• 详情页新增 Token 用量 一行 (总量 + 输入 / 输出分项), 这是校准上面那两档估算价的依据: 同一段描述各档各生几张, 记下用量乘渠道单价就知道真实成本
• 不少中转渠道不透传用量信息, 这种情况该行不显示 (显示 0 会让人误以为真的没消耗)
• 详情页同时补上 上游请求 ID, 向渠道商反馈问题时直接报这个号, 不用再对时间

【改图功能补齐】

• 改图 / 局部重绘现在也支持背景、审核程度、压缩等级三项设置, 以前只有文字出图能调
• 改图失败时也会记下请求 ID 与用量, 之前这条路径漏了

v0.10.4 — 2026-06-11

woodchen/imagic:0.10.4

本版完全兼容 v0.10.x 所有 license / 配置 / 数据库, 旧版本仍可正常使用, 无强制升级.

【管理后台 - 订单清理】

• 充值订单页每行新增 "删除" 按钮, 可删掉待支付 / 已取消 / 已退款的订单, 让订单列表保持清爽
• 已支付订单不提供删除 (涉及用户积分入账记录, 删了会让账目对不上), 这类订单只能查看
• 工具栏新增 "清理已取消" 按钮, 一键清空所有已取消订单, 不影响待支付与已支付订单
• 删除与清理都有二次确认, 避免误操作

v0.10.3 — 2026-05-24

woodchen/imagic:0.10.3

本版完全兼容 v0.10.x 所有 license / 配置 / 数据库, 旧版本仍可正常使用, 无强制升级.

【管理后台 - 翻页修复】

• 用户管理页之前没有翻页按钮, 用户超过 20 个时后面的看不到, 这版补上 "上一页 / 下一页" 与 "第 X / Y 页" 指示
• 充值订单页之前固定取前 200 条, 订单超过这个数后老订单无法翻阅, 这版改为每页 50 条 + 翻页
• 兑换码页之前固定取前 200 条, 大批量生成后旧码无法翻阅, 这版改为每页 50 条 + 翻页
• 模板中心管理页之前固定取前 100 条, 模板增多后无法翻阅, 这版改为每页 30 条 + 翻页
• 筛选条件 (状态 / 关键词 / 分类) 变化时自动回到第 1 页, 避免在原页码上得到空结果

v0.10.2 — 2026-05-19

woodchen/imagic:0.10.2

本版完全兼容 v0.10.x 所有 license / 配置 / 数据库, 旧版本仍可正常使用, 无强制升级.

【我的作品 - 2 图卡片高度对齐】

• 一次生成 2 张图时, "我的作品" 页该卡片明显比同行的单图卡 / 4 图卡矮一截, 视觉上像缺了一块
• 这版把 2 图卡的图片区域改成与单图 / 4 图严格同高: 两张图在方形容器内上下平分, 每张呈横向构图缩略图
• 缩略图按内容居中裁切显示, 点击进大图预览仍能看到完整图

v0.10.1 — 2026-05-19

woodchen/imagic:0.10.1

本版完全兼容 v0.10.x 所有 license / 配置 / 数据库, 旧版本仍可正常使用, 无强制升级.

【我的作品 - 多图显示修复】

• 一次生成多张图时, "我的作品" 页只能看到第一张, 后面的图既看不到也无法编辑, 这版补齐
• 一条记录里的图全部展开显示, 每张右上角带 "1/N" 序号标记, 一眼能看出共生成了几张
• 点任意一张进入大图预览, 在预览里可以左右切换看同一条记录的其它图 (支持键盘方向键和触屏左右滑)
• 大图预览里点 "编辑" 会精确把当前看的那一张作为参考图带到创造页, 不再固定只能编辑第一张

v0.10.0 — 2026-05-15

woodchen/imagic:0.10.0

本版完全兼容 v0.9.x 所有 license / 配置 / 数据库, 旧版本仍可正常使用, 无强制升级. 升级后用户当前 cookie 不会被踢, 7 天内自然过渡到新会话模型.

【多设备登录限制 (新功能)】

• 在 admin "系统设置 → 安全" 新增一组开关, 可限制同一账号在多台设备同时在线
• 默认关闭, 站长按需打开; 上限默认 3 台, 范围 1-100
• 超额时自动把最早登录的设备踢下线, 用户在新设备上正常登录不受阻
• 整套机制基于会话槽位, 不影响已有积分 / 历史 / 订单数据

【登录设备审计 (新功能)】

• 用户个人中心新增 "登录设备" 标签页: 看自己的活跃设备 (浏览器型号 / 操作系统 / IP / 归属地 / 最近活跃时间), 一键注销其它设备
• 当前正在用的设备不可在此注销 (防误操作), 退出当前设备走 "退出登录"
• 管理员在 "用户管理" 每行新增 "设备" 按钮, 弹窗展示该用户全部历史登录记录 (含被踢 / 已登出), 可强制下线单台或一键全部下线 (账号被盗紧急踢光)
• 设备记录保留 60 天供运营复盘, 之后自动清理

【IP 归属地查询】

• 登录时自动查询 IP 所在国家 / 省市 / 运营商, 显示在设备列表
• 默认接 ip.czl.net 公益接口, 站长可在系统设置改成自家接口; 关闭后只显示 IP 不显示归属地
• 查询失败 / 接口限流不影响登录, 字段空着就行

【真实 IP 修复】

• 站点接 Cloudflare 等 CDN 时, 登录设备 / 错误日志 / 限流计数显示的全是 CDN 边缘节点 IP (如 172.64.x.x), 不是用户真实 IP
• 这版按优先级读 CF-Connecting-IP / EdgeOne / 阿里云 / 腾讯云 / 华为 / 百度 / 七牛 / 网宿 / Fastly / CloudFront / Azure / X-Real-IP / X-Forwarded-For, 解决站长拿不到真实用户 IP 的问题
• 升级后老的设备记录 IP 不会被回写, 让用户重登一次即可拿到正确归属地

【截图】

v0.9.2 — 2026-05-15

woodchen/imagic:0.9.2

本版完全兼容 v0.9.x 所有 license / 配置 / 数据库, 旧版本仍可正常使用, 无强制升级.

【管理后台滚动修复】

• v0.9.1 计划做的"表格在卡片内独立滚动"实际没生效, 整页仍随表格行数增长而一起滚, 这版补齐: 现在筛选栏顶部常驻、表格行在卡片内部纵向滚动、分页栏底部常驻, 不用滚回顶部 / 底部去操作
• 表头随表格行滚动时常驻不动, 列名一直在视野内
• 涉及页面: 生图历史 / 用户管理 / 积分流水 / 充值订单 / 兑换码

v0.9.1 — 2026-05-15

woodchen/imagic:0.9.1

本版完全兼容 v0.9.x 所有 license / 配置 / 数据库, 旧版本仍可正常使用, 无强制升级.

【管理后台滚动体验】

• 修复管理后台部分页面 (生图历史 / 用户管理 / 积分流水等) 表格行数多时, 整个浏览器一起出滚动条的问题, 现在滚动只发生在内容区域
• 长列表页 (生图历史 / 用户管理 / 积分流水 / 充值订单 / 兑换码) 切到"筛选栏顶部常驻 + 表格内部独立滚动 + 分页底部常驻"的布局: 翻数据时筛选条件与分页按钮一直可见, 不用滚回顶部 / 底部去操作
• 表头随表格行滚动时常驻不动, 列名一直在视野内
• 仪表盘 / 系统设置等含表单的页面在小屏幕下能正常纵向滚动到底, 不再被裁
• 侧栏导航与右侧内容区各自独立滚动, 互不干扰

v0.9.0 — 2026-05-13

woodchen/imagic:0.9.0

本版完全兼容 v0.8.x 所有 license / 配置 / 数据库, 旧版本仍可正常使用, 无强制升级.

【自定义 Logo】

• 后台 → 设置 → 站点信息 顶部新增"Logo 上传"控件, 支持 PNG / JPEG / WEBP (≤4MB)
• 上传后所有图标位置同步更新:
  • 浏览器 tab 页 favicon
  • PWA 安装到桌面 / 主屏的应用图标
  • iOS Safari 添加到主屏的图标
  • Android adaptive 自适应图标 (自动加深色底防裁切)
• 旧的"Logo URL"字段保留, 用于挂外链 CDN 的场景; 但外链 logo 不会派生 favicon / PWA 图标, 想用全套要走上传
• 重置回默认 logo: 点"重置为默认"即可, 派生回退到内置 Imagic logo

【兼容性】

• 升级前后端 header / 侧栏 logo 显示不变 (继续读 site.logo URL 字段)
• 已部署实例的现有 logo URL 值不会被改动, 你想用新功能就走上传

v0.8.2 — 2026-05-13

woodchen/imagic:0.8.2

本版完全兼容 v0.8.x 所有 license / 配置 / 数据库, 旧版本仍可正常使用, 无强制升级.

【图标修复】

• 浏览器 tab 页 favicon 之前是 Next.js 默认占位 (一个全黑方块), 这版换成 Imagic 自家图标
• 安装为 PWA 后桌面 / 手机主屏的应用图标之前 logo 偏小、中间一点点白点, 这版把 logo 放大到画布 80%, 安装后看起来饱满有辨识度
• Android 主屏图标走系统自适应裁切的那种 (会被系统裁成圆 / 方 / squircle 不同形状), 这版单独做了一套适配版, 不会被裁掉关键部分

v0.8.1 — 2026-05-13

woodchen/imagic:0.8.1

本版完全兼容 v0.8.x 所有 license / 配置 / 数据库, 旧版本仍可正常使用, 无强制升级.

【可安装到桌面 / 手机】

• 接入 PWA, 用户在浏览器里可以"添加到桌面 / 主屏幕", 安装后从桌面图标打开就是全屏沉浸的应用形态, 没有浏览器地址栏
• 桌面 Chrome / Edge 地址栏右侧自动出现"安装"按钮; 安卓 Chrome 会弹安装提示; iOS Safari 走"分享 → 添加到主屏幕"
• 安装后的应用名 / 图标文案跟随 后台 → 设置 → 站点信息, 你改了站点名称, 用户下次刷新就能看到新名字 (不需要重新安装)

【弱网 / 离线体验】

• 静态资源 (页面框架 / 字体 / 图标) 缓存在本地, 二次打开几乎瞬开, 弱网下也不会白屏
• 完全断网时打开已访问过的页面能看到主框架, 而不是浏览器原生的"无法访问"页面
• 用户图片 / 接口数据不走本地缓存, 不会出现"看到的余额是上次的"这类幻觉

【升级行为】

• 每次发版你拉新镜像启动后, 用户下次刷新自动拿到新版本前端, 不需要任何手动通知; 旧版本的本地缓存会被自动清掉, 不会出现新老资源混搭导致页面错位

v0.8.0 — 2026-05-10

woodchen/imagic:0.8.0

本版完全兼容 v0.7.x 所有 license / 配置 / 数据库, 旧版本仍可正常使用, 无强制升级. 新增功能默认关闭, 升级后行为与旧版完全一致, 你确认要用了再去后台打开。

【提示词黑名单】

• 新增"提示词黑名单"功能, 站长自己维护一份违禁词清单, 命中即拦, 不冻结点数也不调上游, 用户多次试错也不会扣钱
• 4 个用户提交入口都过一遍: 文生图 / 参考图编辑 / 局部重绘 / AI 提示词优化, 一道防线全覆盖
• 后台 → 提示词黑名单 独立管理页, 支持单条增删改 / 批量导入 (粘贴一行一词) / 导出 .txt 备份 / 测试匹配 (上线前自测) / 重置内置词
• 总开关 / 命中文案在 后台 → 设置 → 内容安全, 改完即时生效不重启
• 首启自带 ~20 条政治类底线词 (国家领导人 / 高敏事件 / 分裂主张 / 极端组织, 中英文写法), 总开关默认关闭, 装好不会自动开始拦
• 推荐用法: 让 ChatGPT / Claude 网页帮你列一份目标人群常见违禁词 (按你站点定位), 批量导入 50-100 条, 测试匹配跑几段正常提示词验证没有误伤后再打开总开关
• 命中后用户看到的文案完全由你配置 (默认"提示词包含禁用内容, 请修改后重试"); 不会向用户暴露具体命中了哪个词
• 每条词带"命中次数 + 最近命中时间", 让你看哪些词在生效、哪些可以清掉
• 详细使用说明见 提示词黑名单

【截图】 用户提交命中黑名单的提示词时看到的拦截提示:

后台提示词黑名单管理页:

v0.7.0 — 2026-05-10

woodchen/imagic:0.7.0

本版完全兼容 v0.6.x 所有 license / 配置 / 数据库, 旧版 v0.6.3 仍可正常使用, 无强制升级.

【创造页等待体验】

• 文生图等待过程中, 上游推过来的"草图阶段"图片会实时显示在结果位, 用户能看到画面一帧帧成型, 不再是空白等结果
• 草图阶段叠加"精修中"提示胶囊 + 半透明蒙版, 既告诉用户"图还在画", 又避免用户把未完成稿当成最终图保存
• 等待文案改成分阶段轮播, 配合 MM:SS 实时计时, 长任务等待焦虑明显降低

【历史页】

• 进行中的卡片新增"停止"按钮, 一键取消任务并退还积分, 不用再等任务自然超时
• 进行中卡片实时显示已生成时长, 与创造页等待体验一致
• 卡片封面统一为方形, 不同比例的图不会再让网格视觉错位

【上游中转兼容性】 本版参照常见中转 / 反代协议做了一轮兼容, 接入这类渠道的站点直接受益:

• 流式渠道在多种字段格式下都能正确解析, 之前部分中转透传时会出现"上游成功但我们误判失败"的情况, 现在已解决
• 中转把流式响应回成整段 JSON 的情况下也能识别, 不再丢图
• 中转返回的内嵌图 / 直链图都能正确入库, 不再因为返回形式不同而失败
• 长任务期间中转的保活字节不再触发解析异常, 连续画几分钟也能稳定收尾
• 错误识别更准: 上游"已扣费但失败"的临时错误不再自动重试, 避免在中转上重复扣费; 凭证 / 配额 / 参数 / 限流 / 内容审核类错误不再计入渠道熔断, 不会因为用户参数问题把好渠道踩成 disabled
• 上游请求追踪 ID 自动落库, 在管理后台生图详情页能直接看到, 站长向中转运营反馈问题时报这个 ID 即可, 不用再对时间戳

【UI 细节】

• 主区滚动条移到右沿, 不再紧贴卡片造成视觉割裂
• 多图生成时, 任意一张还在跑都能在对应格子看到实时进度

【截图】 等待过程中的中间帧体验 (精修中提示 + 蒙版):

完成后的最终结果:

v0.6.3 — 2026-05-10

woodchen/imagic:0.6.3

本版完全兼容 v0.6.x 所有 license / 配置 / 数据库, 旧版本 v0.6.2 仍可正常使用, 无强制升级。

【创造页体验】

• 等待区显示 MM:SS 实时计时, 长任务下用户能直观看到已等多久, 不再焦虑
• 上游超时与卡死任务回收阈值改为 admin 后台可配 (Settings → 任务超时), 默认上游 180s / 卡死回收 300s; codex 类反代慢链路可在面板上调到 600s+, 改完即时生效不重启

【上游兼容性 / 排错】

• 兼容反代"伪成功"回包: 上游 HTTP 200 但 body 里塞 {"error":{...}} 的反代 (常见于 codex_cli 类) 现在能正确识别并报错, 不再一律误判为 "no images"
• 上游返回 0 张图时自动把原始响应打到日志, 站长在容器日志里直接看到上游真实原因 (524 / 审核拦截 / 字段名不对等), 不用再对着 "upstream returned no images" 抓瞎

【部署文档】

• 安装教程的 docker-compose 示例把 ./data 单挂卷改为按子目录单独挂载 (./data/app, ./data/redis, ./data/postgres), 避免新部署时三个服务的数据混在一起
• 新增 1Panel 面板安装教程

v0.6.2 — 2026-05-10

woodchen/imagic:0.6.2 完全兼容 v0.6.1, 旧版本仍可用; 反代部署 + 关心授权状态可见性的站长建议升级.

修复

• 授权异常时管理员后台收不到提示的问题: 之前授权失效会让前端拉不到站点 配置, 而授权异常的提示又依赖站点配置才显示, 导致站长看到的是后台空空 如也, 必须自己 F12 才能发现授权问题. 现在管理员后台主区顶部会显示独立 的授权状态横幅, 即便业务接口被授权拦截, 横幅依旧能看到, 文案区分硬失效 (红色) 与软警告 (琥珀色)

升级注意

• 与 v0.6.1 同样, 既有正常运行的实例升级后无任何影响
• 之前因为反代域名问题被授权拦截的实例, 升级后会在管理员后台直接看到 红色横幅, 不必再排查接口

v0.6.1 — 2026-05-10

woodchen/imagic:0.6.1

建议升级

修复

• 个别情况下反代部署时授权域名校验失败导致 403 的问题: 有时通过localhost反代, 或通过edgeone直接反代端口时, 可能会出现校验失败导致功能异常.

v0.6.0 — 2026-05-09

woodchen/imagic:0.6.0

完全兼容 v0.5.x license 与配置, 旧版本仍可继续使用; 升级无需迁移数据 / 改 env / 重签 license。

本次版本聚焦"错误提示与运营可观测性"——把过去散落各页面、各种语种、暴露技术细节的报错统一成一套 用户能看懂、运营能定位的反馈体系, 同时让充值与历史两个高频页面更经得住"边界场景"。

错误提示与提醒系统

• 全站建立统一文案映射 (apiErrorMessage / generationErrorLabel / pointLogTypeLabel), 覆盖创造 / 历史 / 个人中心 / 充值 / 注册 / 登录 / 模板 / 风格选择 / 管理后台
• 已知业务错误码全部翻译成用户能自助处理的中文 (例: "点数不足, 请先充值或使用兑换码" / "图片体积过大, 请控制在 10MB 以内" / "兑换码已被使用" / "登录态已失效, 请重新登录" 等 30+ 条)
• 渠道不可用 / 上游报错 / 内容审核拒绝 / 上游超时 / 持久化失败 一律对终端用户折叠为 "生成失败, 请稍后重试; 如多次失败请联系客服"——避免把"上游 500""moderation_blocked" 这类技术原因直接暴露给用户造成误判, 真实原因仍可在后台 /admin/generations 详情与服务器日志中追踪
• 历史页失败卡片同样接入: 任务终态错误展示中文文案; pending / streaming / canceled 状态徽章也都翻译
• 积分流水类型 (消耗 / 充值 / 退款 / 冻结 / 解冻 / 管理员调整 / 兑换码 / 邀请奖励) 统一中文胶囊 + 入账绿 / 出账黄 / 调整蓝 配色, 用户中心与管理后台共享同一套语义, 不再出现裸英文 type
• 网络层异常 (拨号失败 / context deadline / EOF / 5xx) 自动识别并兜底为"请稍后重试", 不外露技术堆栈

充值页改版

• 充值页只承载"选支付方式 + 选套餐 + 下单 / 二维码"主流程, 移除内联订单表, 一屏内不再出现页内滚动条
• 历史订单入口收敛到"个人中心 → 我的订单", 待支付订单的"取消"操作搬到此处, 二次确认后即时刷新
• 支付方式选择改为派生状态, 修复了管理员临时关闭某支付方式时, 充值页选项偶发闪烁 / 卡死的问题

历史页占位图

• 因存储驱动切换 (local → S3 / S3 桶迁移) / 文件被清理 / 自定义域名变更等原因导致旧图 URL 失效时, 历史卡片与灯箱不再呈现破图叉, 改用"图片已失效"灰底占位
• 失效图自动隐藏"编辑"按钮 (无有效图当不了参考图); "重画 / 收藏 / 删除"仍可用, 不阻塞用户清理历史

后台稳定性与可观测性

• 异步生图任务全链路加 panic recover + 堆栈采集, 即使任务内部异常也不会拖崩整个进程, 生成会被 5min 兜底回收并自动退点
• 渠道路由 (generate / edit / stream) 每次失败 + 触发熔断都打结构化日志 (含 channel_id / channel_name / 延迟 / 真实 err), 与 /admin/channels 失败计数互补, 便于排查"为什么这条渠道又被禁了"
• 生图终态分支 (失败 / 取消 / 持久化失败) 打 generation_id + user_id + error_code + 原始 err, 复现问题时一行日志即可完整定位
• handler 内部错误不再向客户端泄漏原始 Go 错误 (此前可能暴露 SQL 或内部栈), 改为统一兜底文案 + 完整 err / method / path / ip 落服务端日志

管理后台细节

• "渠道编辑"的模型映射输入加键值含义说明 (左 = 客户端模型名, 右 = 上游真实模型名), 减少配置歧义

v0.5.0 — 2026-05-09

woodchen/imagic:0.5.0

老版本 (0.4.x) 仍可继续运行, 完全兼容; 老 license 不受影响, 升级是平滑的体验改进。

计费规则与创造页对齐 + 4K 支持

• 创造页尺寸胶囊改为后端下发, admin 加新档位前端无需发版; 4K / 2K 加角标
• 移除 size / quality 的 auto 选项 (auto 无法精确计费容易漏扣点数)
• 移除 background 的 transparent (gpt-image-2 上游不支持)
• 默认计费规则扩到 8 尺寸 × 3 画质 × generate/edit 共 48 行, 按官方 USD 比例阶梯化 (1024 high=20 → 4K high=96)
• 计费匹配兜底改为同 (model+type+size+quality) 取最大点数, 防止漏扣
• 新装站点开箱即配, 老站点已存在的计费规则不会被覆盖, 想用 4K 档手动加即可

admin 计费规则页重做

• 一个表格统一展示, 主行 (尺寸 × 三档画质 × 双类型勾选) + 例外子行紧贴在下方
• 例外规则 (按 background / 输出格式 加价) 改为简短表单 + 主行 "+ 例外" 按钮触发, 不再有那个让人困惑的 7 列大表
• 例外类型与主行对称, generate / edit 双选, 一次填完两份

主题切换

• Header 右上角加亮色 / 暗色 / 跟随系统三选, localStorage 持久化, 跨 tab 同步
• 工作台 / admin 后台三处都挂上, 启动期 inline 脚本防 FOUC
• 暗色用户首屏不再闪一下亮色

界面统一与细节

• 全站删除操作改为统一 Dialog 风格, 不再用浏览器原生 confirm / prompt 弹窗
• destructive 操作 (删除 / 封禁) 用红色 confirm 按钮区分
• admin/users 调点数从两次 prompt 弹窗改为一次性输入 (金额 + 备注同一对话框)
• 用户端 sidebar 不再显示版本号 (站长视角信息, 普通用户不需要看到)

v0.4.0 — 2026-05-08

woodchen/imagic:0.4.0

旧版本不可继续运行, 强制升级: 本版改造了 license / 心跳协议, 旧客户端无法享受 "到期不续费仍可用 + 不可升级" 新机制。

admin 后台

• sidebar 底部版本号: 授权异常 / 版本闸阻断时字体标红 + dotted underline + 鼠标悬浮 tooltip 描述具体原因

v0.3.1 — 2026-05-08

v0.3.1

个人中心

• 修复点击 sidebar"充值/兑换"或"邀请好友"后高亮异常、再点切换无响应的问题
• "充值"和"邀请好友"现在是独立页面, 不再藏在"账号设置"内部 tab; URL 直观, 分享深链接更稳
• 老链接 (alipay 返回 URL、历史分享) 仍可达, 自动跳到新独立页, 不需要重新分享
• 移动端"我的"底部 tab 在充值 / 邀请页面下都保持高亮

升级提示

• 老 alipay return_url 配置如果指向 /profile?tab=recharge 仍然能用, 但建议改成直接配 /recharge, 减少一次中转跳转

v0.3.0 — 2026-05-08

v0.3.0

落地页与首屏体验

• 修复落地页椭圆 3D 模板轮播在首次加载时空白不显示的问题, 升级后请刷新一次
• 模板轮播渲染优化, 弱性能设备首屏不再卡顿

创造页 / 灯箱

• 历史作品点"编辑"跳转创造页时, 参考图载入显著加速 (后端内部直接复用图片, 不再让浏览器下载再上传一遍, 大图从几秒到几百毫秒)
• 灯箱里"编辑 / 用作参考图"按钮在黑色背景下白字白边, 不再出现按钮看不清的情况

品牌化与 SEO

• 新增"首页副标语 / 站点描述"与"SEO 关键词"两项可在后台配置 (admin → 站点设置)
• 浏览器标签页 title、meta description、社交分享卡片 (Open Graph / Twitter Card) 现已统一读管理员配置, 不再固定为默认 "Imagic" 文案
• 升级后已有的站点信息会保留, 新增的两个字段会用默认值填充, 站长按需在后台修改即可

升级提示

• 首启自动写入 site.description / site.keywords 两条新 setting; 已有部署不会被覆盖, 安全升级

v0.2.0 — 2026-05-08

v0.2.0 - 用户端工作台 + 模板中心 + 风格预设 + 创造页改版

• 登录后默认落地页改为 /dashboard, 一进来就能看到本月生图数 / 消耗积分 / 余额 / 收藏数 4 张数据卡 + 最近 6 张作品

• 用户端整体改为左侧 sidebar 布局 (与 admin 风格一致), 桌面端可折叠到 64px icon-only, 偏好持久化到本地

• 移动端底部导航改为 4 栏 (工作台 / 创造 / 作品 / 我的), 创造位高亮品牌色一指可达

• 新增 /templates 模板中心, 用户可浏览 / 搜索 / 收藏内置提示词模板, 选中后一键填入创造页

• 详情页 /templates/detail/?slug=xxx 支持分享链接, 点"用此提示词创作"自动跳创造页 + 计数 +1

• 落地页 hero 轮播改由 admin 后台勾选模板控制, 不再写死前端

• admin 新增 /admin/templates 管理界面, 支持 CRUD + 一键上下架 + 一键上首页 + 缩略图通过 /images/upload 上传

• 系统设置加 landing.featured_limit, 控制首页 hero 最多展示几张模板 (默认 12, 范围 4-20)

• 首次启动会自动写入 12 条内置模板 (覆盖人像 / 游戏 / UI / 海报 / 信息图等场景), 升级前后落地页效果一致

• 创造页右侧加"风格选择": 用户多选风格胶囊 (赛博朋克 / 动漫 / 戏剧化肖像 等), 提交时英文词组自动追加到提示词末尾, 多个风格可叠加

• 内置 14 个风格 (9 个 ChatGPT 官方风格 + 5 个我们补充: 国潮 / 水墨 / 自然光 / 极简 / 高级感)

• 用户可在"我的"tab 自建专属风格 (如"我的电商主图风"), 跨设备同步

• admin 新增 /admin/styles 管理界面, 支持拖拽行调整顺序 + 编辑内置风格内容 + 上下架

• 首次启动会自动写入 14 条内置风格

• 主区改为三步骨卡: ① 输入商品描述 (含字数计数 / 推荐胶囊 / 换一换 / AI 优化 / 模板入口) → ② 选择尺寸 (4 个胶囊带方向图标: 1:1 / 2:3 / 3:2 / 自动) → ③ 生成结果 (网格 + 选中标记 + 重新生成 / 下载全部)

• 右侧固定"生成设置"侧栏: 模型 + 风格 + 数量胶囊 + 高级折叠 (画质 / 格式 / 背景) + 主操作"立即生成 消耗 N 积分"

• 顶部加"AI 生成"标题 + 余额胶囊 + "生成历史"快捷入口

• 删除显式"文生图 / 图像编辑"切换 tab — 上传参考图后自动切到编辑模式, 用户无感知

• 上传参考图块默认收起, 不抢主区注意力; 用户传图或从历史跳过来自动展开

• 多张结果可"下载全部"一键打包下载 (不依赖额外依赖)

• 移动端: 主区单列 + 底部固定操作条 (设置抽屉 + 主操作), 提交按钮一指可达

• 数据库自动迁移: 启动后会新增 templates / user_template_favorites / style_presets 三张表 (GORM AutoMigrate), 现有数据不受影响

• 首启自动 seed: 12 条模板 + 14 条风格 + landing.featured_limit 设置项首次启动自动写入, 已有数据时整段跳过不覆盖

• 落地页轮播在升级后会自动复用原 12 条作为内置 featured 模板, 视觉效果保持一致; 后续运营在 admin 端取消勾选即可换图

• 用户登录后默认跳转目标从 /create 改为 /dashboard, 老用户初次进入会感觉"工作台变了"

• 提交生图时, 如果用户在创造页选了风格, 会自动把英文词组追加到 prompt 末尾后送到上游 (如 OpenAI), 词组不计入字数限制

• 新增公开: GET /templates/featured, /templates/categories, /templates/random

• 新增登录: GET /me/stats, /templates 列表与详情, POST 收藏 / 使用打点, /styles 列表与自建 CRUD

• 新增管理: /admin/templates 全 CRUD + featured/status toggle, /admin/styles CRUD + reorder

• 旧接口全部保持兼容, 没有破坏性变更

v0.1.0 — 2026-05-08

首次正式发版

主要功能

• AI 生图完整闭环: 文生图 / 参考图编辑 / 局部重绘 三合一创造页
• 历史记录 + 收藏 / 二次编辑 / 重画
• 点数计费 + 多档充值套餐 (支付宝当面付 / 网页支付 / 线下转账)
• 兑换码批量生成 + CSV 导出 (适合卡密 / 活动 / 渠道分发)
• 邀请双向奖励 (老用户 + 新用户都加点)
• 多上游渠道路由 + 故障自动熔断 + 在线测试连通
• 计费规则可视化配置 (模型 / 尺寸 / 质量 → 点数映射)
• 运营仪表盘: 用户 / 生图 / 消耗 / 充值 累计 + 趋势 (日 / 周 / 月)
• 全站生图历史 + 全站积分流水审计 (供客服排查)
• 邮箱验证码注册 + 域名白黑名单 + 注册策略 (open / invite / admin)
• 本地存储 / S3 兼容存储 (AWS / 阿里云 OSS / 腾讯云 COS / Cloudflare R2 / MinIO)
• License 授权机制 + 心跳上报 + 多实例宽限期

部署

• Docker 镜像: woodchen/imagic:0.1.0 (含 :latest)
• 三档 docker-compose 模板: SQLite / Postgres / 外接版, 拉镜像即可启动
• 完整文档站含安装 / 功能介绍 / 常见问答 / 更新日志