v0.4.8

v0.4.8（2026-05-26）

修复

• 修正应用版本号元数据
• 将 package.json 版本号更新为 0.4.8，避免在线版已部署新版代码但页面仍显示旧版本。
• 同步修正 package-lock.json 根版本号，确保构建、Docker 镜像和在线部署读取到一致的版本信息。

v0.4.7

v0.4.7（2026-05-25）

新功能

• 支持通过配置 URL 导入自定义服务商
  • VITE_DEFAULT_API_URL 和 DEFAULT_API_URL（Docker）除了填写普通 API 地址外，现在也支持直接填写 .json 配置 URL 或带 settings 参数的分享 URL。页面启动后会自动导入其中的自定义服务商和 API 配置。
• API 代理扩展支持同步自定义服务商
  • API 代理不再限制仅 OpenAI 提供商可用，同步返回图片的自定义服务商也可以开启代理。异步任务（含 taskIdPath 或 poll）的自定义服务商会明确拒绝并提示。

改进

• 常用比例尺寸预设 (Issue #76)
  • 1:1、3:2、16:9、4:3、21:9 等常用比例现在使用预设的标准尺寸（如 1280x720、2560x1440、3840x2160），避免按像素预算计算出不常见的值。
• 代理路径简化：代理转发时不再自动插入 /v1/ 前缀，版本路径完全由 API_PROXY_URL 目标决定。
• Nginx 路径限制放宽：移除严格的接口路径白名单，以支持自定义服务商的任意请求路径。
• DEFAULT_API_URL 支持显式设为空字符串：Docker 环境变量传入空值时不再回退到默认地址，配合代理可隐藏真实上游地址。
• inject-api-url.sh 转义修复：正确转义 sed 替换符和 JS 字符串中的反斜杠/引号，避免含特殊字符的配置 URL 注入失败。
• API URL 为空时开启代理可通过校验：不再强制要求填写 API URL。
• 补充隐藏真实 API 地址的文档和示例

v0.4.6

v0.4.6（2026-05-24）

修复

• 继续修复 Images API 流式响应兼容性问题 (Issue #70)
  • 兼容结果事件返回格式：流式 Images API 现在可以识别 image.generation.result 与 image.edit.result 事件，并从其中的 data[].b64_json 等字段提取最终图片。这样即使接口没有返回 image_generation.completed 或 image_edit.completed 完成事件，也能正确解析最终图片，避免误报“流式接口未返回最终图片数据”。

v0.4.5

v0.4.5（2026-05-23）

变更与优化

• 优化自动尺寸模式的视觉呈现
  • 自动尺寸提示布局优化：放大自动尺寸图标并调整文案间距与行高，让“自动尺寸”模式在尺寸选择弹窗中更清晰、更易识别。

修复

• 修复尺寸选择弹窗在框选输入框文本时意外关闭的问题
  • 弹窗外点击判断更准确：将关闭逻辑改为同时判断鼠标按下与抬起位置，只有二者都发生在弹窗外时才关闭弹窗，避免从弹窗内拖拽框选文本后在弹窗外松开鼠标导致弹窗被误关闭。

v0.4.4

v0.4.4（2026-05-23）

变更与优化

• 优化 Responses API 兼容性与流式降级容错
  • 画廊模式兼容性提升：将多格式 Base64 解析（支持 b64_json、base64 等嵌套字段）扩展应用至画廊模式，提升与各类第三方 API 接口的直连兼容性。
  • 流式传输降级容错：当服务端在流式结束包 response.completed 中省略 result 时，自动回退并使用流式过程中已收集到的缓存数据，避免报错导致已生成图片丢失。(Issue #70)

v0.4.3

v0.4.3（2026-05-23）

变更与优化

• 重构 Agent 对话存储机制以解决存储配额溢出 (Issue #67)
  • IndexedDB 异步持久化：将 agentConversations 对话历史从 localStorage（限制 5MB）迁移至 IndexedDB 数据库，彻底解决对话轮次过多或包含大体积图片引用时抛出的 Failed to execute 'setItem' on 'Storage': Setting the value of 'gpt-image-playground' exceeded the quota. 配额超限报错。
  • 导入导出与清理兼容：重构了数据清理、导入与导出等模块，确保备份的 JSON 文件能够正确提取 IndexedDB 中的对话记录，实现数据的完整迁移、备份与彻底清理。
• 重构并简化批量图片生成与参考图关联机制
  • 智能 Prompt 标签引用：简化 generate_image_batch 批量生成工具的参数，废弃原有的 reference_ids 显式数组传参。改由直接在提示词 prompt 中嵌入 <ref id="..." /> 标签，实现更自然的视觉参考图关联。
  • 上下文智能解析：在 API 执行轮次中支持智能解析 prompt 中的 XML 参考标签（同时支持用户在当前轮次输入的新图以及历史生成的图片），自动从缓存中获取对应的 image 实体，提高上下文传递的可靠性。
  • 上下文模型直观可见与 ID 解耦：重构了多轮对话上下文的构造逻辑，将先前生成的图片作为 user 消息（包含实际图片内容与识别标签 <ref>）直接注入上下文。大模型本身能够直观“看见”图片内容，并且不再强依赖于特定的 ImageGenerationCall 任务 ID。这极大地方便了对话的长期存续，并支持跨设备、跨账号导入导出后的完美兼容。
• 完善分支隔离中的引用重映射
  • 动态引用修复：在用户删除某条历史对话轮次（round）导致路径变更时，智能计算并重映射受影响的所有 @第X轮图Y 引用标签，避免由于分支变动引起的引用失效或错位。
• 交互与样式微调
  • 提及标签行内美化：优化了 @ 提及标签（mention-tag）在输入框及页面中的 inline CSS 样式，调整高度、边距与对齐方式，使其行内排版更加协调。
  • 接口兼容度提升：图片提取器额外支持 result.base64 响应格式的解析，提升了与各种自定义 API 模型的直连兼容性。

修复

• 修复插入提及标签时光标焦点丢失问题：修复在输入框中通过 @ 快捷菜单插入图片引用后，输入焦点或光标位置未正确移动到提及标签后方的问题。

v0.4.2

v0.4.2（2026-05-22）

新增

• 在关于页面添加关于保留项目版权署名与 MIT 许可声明的隐藏代码注释。

修复

• 修复 iOS 15/16 等旧版移动端浏览器白屏无法打开应用的问题 (Issue #66)。
  • 当不支持现代正则后行断言等特性时，自动降级为兼容的 Markdown 渲染器并引入 Polyfill。

v0.4.1

v0.4.1（2026-05-22）

新增

• 新增参考图快速替换功能：当点击未添加遮罩的参考图的编辑按钮时，支持选择直接“替换参考图”或“添加遮罩”；若替换后的图片未被任何其他任务或对话引用，将自动清理以优化存储空间。
• 新增参考图编辑行为习惯配置：在“设置-习惯配置”中新增“参考图编辑按钮”选项（包含“询问”、“替换参考图”及“添加遮罩”），可用于修改默认的编辑点击行为。

变更

• 重构确认弹窗（ConfirmDialog）：支持传入自定义按钮配置 buttons 数组，摆脱“确认/取消”的语义限制，支持为不同按钮赋予不同样式类型（tone），且所有按钮的点击动作均支持传递复选框的勾选状态；对于旧的调用，仍可完美向下兼容。
• 改进确认弹窗渲染：支持解析与渲染 Markdown 粗体语法（**）。
• 改进遮罩编辑提示：在遮罩编辑说明中新增提示，建议附加类似“只编辑遮罩区域”的提示词，以提升模型的指令遵循度。

v0.4.0

v0.4.0（2026-05-22）

新增

• 新增 Agent 模式 (Issue #18, Issue #63)
  • 多轮对话上下文：保留多轮对话上下文并支持使用 @ 引用图片，Agent 可自主识别并传入上下文关联图以保持生成一致性。
  • 智能并发批量生成：自动并发生成多张图片，并能智能追加后续生成轮次以处理图片依赖关系（如在基准参考图基础上进行后续生成）。
  • 对话分支隔离：编辑或重发历史消息时自动创建分支，图片引用解析仅在当前分支路径生效，防止分支引用混淆。
  • 画廊同步与清理：Agent 生成图自动同步至画廊；删除对话时默认保留图片，画廊删除任务时同步清理对话中的失效图片引用。
  • 扩展联网搜索：支持智能调用联网搜索获取实时信息，并附带引用来源链接。
• 新增流式生成预览 (Issue #64, PR #50)：支持图像生成时的实时渐进预览，缓解长时等待导致的超时断连，并在设置页中提供了流式预览的自主控制开关。
• 新增批量下载 (Issue #56)：详情页及右键菜单支持一键批量下载单次生成的多张套图或流式预览图。
• 新增比例微缩线稿预览 (Issue #52)：尺寸比例选择器按钮新增对应的微缩边框线稿，提供更直观的宽高比例视觉参考。
• 新增输入框文本一键清空按钮：支持一键清除输入框文本，便于快速重置提示词。
• 新增流式心跳断连智能指导：针对 OpenAI 流式生成因长时无数据被代理断开的问题，超时后自动分析设置，提示开启流式或调高“请求中间生成图像数”以发送心跳维持连接。

变更与优化

• 重构并优化分辨率计算算法与比例交互 (Issue #52)
  • 解决尺寸倒挂问题：彻底修复旧算法中“1K 21:9 分辨率（2384x1024，约 2.44M 像素）反比 2K 21:9（2048x880，约 1.8M 像素）更大”的尺寸混乱倒挂问题。
  • 全新最优尺寸算法：引入基于总像素预算（1K: 1.57M、2K: 4.19M、4K: 8.29M）的最优搜索机制。在满足宽高 16 倍数、最大边 3840px 及比例不超 3:1 等模型硬性约束下，智能遍历并选取总像素最大且比例误差在 1% 内的分辨率（例如 4K 1:1 智能规整为 2880x2880 避免超限报错；2K 21:9 解放长边至 3120x1344，清晰度相比旧版提升 132.6%）。
• 优化网络请求超时与错误诊断 (PR #50)
  • 优化接口立即失败诊断：请求立即失败时支持智能识别代理状态，并补充网络不可达、地址错误、跨域或不支持浏览器直连等常见问题的针对性指导。
  • Docker 代理与流式响应优化：优化代理配置解决 CDN 握手失败问题，实现流式响应即时分发，消除代理层的数据缓冲等待。
• 优化输入框失焦交互：点击输入框外部或宽屏空白区域时自动取消焦点。
• 统一图片下载与备份命名规范：规范数据备份、画廊批量下载及 Agent 生成图等场景的文件命名格式，增强临时外链下载兼容性。
• 改进大图查看器手势交互 (PR #57)：支持非放大状态下左右滑动切图，精准识别单击、滑动、双指缩放及平移手势，避免误触关闭。
• 重构 Tooltip 状态管理 (PR #51)：重构并规范多组悬浮提示的显示与隐藏逻辑，减少重复代码并提升提示稳定性。

修复

• 修复历史任务 API 配置匹配问题：修复复用或重试历史任务时因配置微调导致的静默错配。若原配置缺失会弹出降级确认框，防止配置混淆。
• 修复移动端卡片滑动多选样式：修复移动端卡片在滑动多选时因透明度丢失暴露背景底色的问题。
• 修复移动端顶栏与布局安全区问题：修复顶栏占位不足导致内容被遮挡的问题，并优化安全区域内边距。
• 修复清除按钮圆角滚动溢出问题：修复移动端下清除按钮可能引发的滚动条溢出与圆角切角缺陷。

贡献

• @AkideLiu 通过 PR #50 贡献了流式图片预览与代理部署优化，特此感谢。
• @avelli 通过 PR #51 贡献了输入框 Tooltip 状态重构，特此感谢。
• @YuSaZh 通过 PR #57 贡献了移动端图片查看器左右滑动切图功能，特此感谢。

v0.3.5

v0.3.5（2026-05-12）

新增

• 新增输入框图片 @mention 引用：输入 @ 弹出已上传图片的选择菜单，选中后以胶囊标签内联显示，支持整块选中高亮、点击缩略图直接插入引用、复制粘贴纯文本；提交时自动将已选择的引用转换为 [image N]，让模型通过图片顺序理解引用关系。手动输入的普通 @图N 不会被转换 (#42)。
• 新增参考图引用自动跟随：删除、清空、拖拽重排参考图，或将遮罩目标图移到首位时，提示词中的图片引用会跟随对应图片自动更新编号；复用历史任务或替换遮罩目标图片时同样保持正确对应；被移除的图片引用会标记为 @已移除图片。
• 新增任务提交方式设置：桌面端可在设置中选择 Enter 提交或 Ctrl/Cmd + Enter 提交，另一种按键方式用于换行。
• 新增一键复制当前 API 配置：设置页 API 配置标题栏新增复制按钮，点击后将当前配置复制一份追加到列表末尾并自动切换。
• 新增赞助支持入口：设置页关于标签和 README 增加爱发电赞助入口；当本地成功生成图片累计超过 50 张时，弹窗提示可赞助作者或反馈建议。

变更

• 改进参考图缩略图：遮罩目标图尝试拖动时展示「遮罩图必须为第一张」提示；删除按钮移到缩略图外层，避免被圆角裁剪遮挡。
• 改进尺寸选择弹窗：内容区域固定高度并支持滚动，尺寸限制说明文本改为换行展示。
• 改进设置页图标语义：「复制导入 URL」按钮从复制图标改为链接图标以区分含义；「复制生成提示词」按钮增加链接图标前缀；关于标签底部按钮增加自动换行支持。

贡献

• @avelli 通过 PR #42 贡献了输入框图片 @mention 引用功能，特此感谢。