Releases: CookSleep/gpt_image_playground
Releases · CookSleep/gpt_image_playground
v0.3.5
v0.3.5（2026-05-12）
新增
- 新增输入框图片 @mention 引用：输入
@弹出已上传图片的选择菜单，选中后以胶囊标签内联显示，支持整块选中高亮、点击缩略图直接插入引用、复制粘贴纯文本；提交时自动将已选择的引用转换为[image N]，让模型通过图片顺序理解引用关系。手动输入的普通@图N不会被转换 (#42)。 - 新增参考图引用自动跟随：删除、清空、拖拽重排参考图，或将遮罩目标图移到首位时，提示词中的图片引用会跟随对应图片自动更新编号；复用历史任务或替换遮罩目标图片时同样保持正确对应；被移除的图片引用会标记为
@已移除图片。 - 新增任务提交方式设置：桌面端可在设置中选择 Enter 提交或 Ctrl/Cmd + Enter 提交，另一种按键方式用于换行。
- 新增一键复制当前 API 配置：设置页 API 配置标题栏新增复制按钮，点击后将当前配置复制一份追加到列表末尾并自动切换。
- 新增赞助支持入口：设置页关于标签和 README 增加爱发电赞助入口；当本地成功生成图片累计超过 50 张时，弹窗提示可赞助作者或反馈建议。
变更
- 改进参考图缩略图：遮罩目标图尝试拖动时展示「遮罩图必须为第一张」提示；删除按钮移到缩略图外层，避免被圆角裁剪遮挡。
- 改进尺寸选择弹窗：内容区域固定高度并支持滚动，尺寸限制说明文本改为换行展示。
- 改进设置页图标语义：「复制导入 URL」按钮从复制图标改为链接图标以区分含义；「复制生成提示词」按钮增加链接图标前缀；关于标签底部按钮增加自动换行支持。
贡献
Contributors
avelli
Assets 2
v0.3.4
v0.3.3
v0.3.3（2026-05-09）
新增
- 新增生成记录来源展示：任务卡片展示任务使用的 API 配置和模型，便于区分历史图片由哪个配置生成 (#39)。
- 新增原始图片链接与原始响应查看：当接口返回图片 URL 但浏览器因跨域等原因无法下载，或响应结构无法识别时，可在详情页复制原始图片链接或查看原始 JSON 响应。
- 新增“返回 Base64 图片数据”选项：OpenAI 兼容接口和自定义服务商请求可追加
response_format: b64_json，用于减少图片 URL 跨域下载失败问题。 - 新增 API 配置导入 URL 的 New API 变量生成功能：复制导入链接时可生成
{address}、{key}、{model}占位变量，便于适配 New API 场景。 - 新增本地故障模拟 API：提供
npm run mock:api和docs/mock-image-api.md，用于复现 CORS、异常响应结构、原始响应查看等场景。
变更
- 改进 Docker API 代理行为：
ENABLE_API_PROXY=true时，前端 API 代理默认开启；新增LOCK_API_PROXY=true可强制锁定代理开关，用户无法关闭 (#38)。 - 改进 API 配置切换体验：在 OpenAI 兼容接口、fal.ai 和自定义服务商之间切换时，会保留各服务商草稿配置，避免切换后丢失 URL、模型等字段。
- 改进 fal.ai 配置：支持自定义 fal.ai 代理 URL，并在非标准 fal 返回结构下提供更明确的错误信息。
- 改进设置页交互：API 配置和服务商类型支持拖拽排序，复用复选框样式，并优化自定义服务商编辑弹窗布局。
- 改进多选任务操作：框选支持页面边缘自动滚动，并优化底部批量操作栏样式。
- 改进悬浮提示交互：打开弹窗或切换复杂 UI 时会自动收起悬浮提示，减少提示层残留。
- 更新 README 部署说明、示例截图和 Star History 暗色模式展示。
修复
- 修复部分 OpenAI 兼容接口因浏览器 CORS 限制导致
Failed to fetch时缺少有效排查提示的问题；现在会提示开启 API 代理，并在图片 URL 下载失败时提供原始链接或 Base64 返回方案 (#32)。 - 修复任务标签横向滚动与任务卡片滑动操作在触摸设备上容易互相干扰的问题。
- 修复 PC 端框选范围超出视口后丢失已框选项的问题。
v0.3.2
v0.3.1
v0.3.0
v0.3.0（2026-05-07）
新增
- 新增自定义服务商接入：支持通过 Manifest 配置第三方图像接口，可自定义请求路径、请求方法、JSON / multipart 参数、文件字段、结果图片路径和异步轮询规则，用于适配 APIMart 等非标准图像 API (#25)。
- 新增 AI 辅助生成服务商配置：设置页提供“复制生成提示词”，可让 LLM 根据第三方 API 文档生成可导入的
customProviders与profiles配置，导入后只需补充 API Key (#25)。 - 新增批量下载：多选任务后，底部操作栏支持批量下载所选任务的所有输出图片 (#31)。
- 新增成功任务重试选项：设置页新增“成功任务仍然展示重试按钮”，开启后已完成任务也会显示重试入口 (#31)。
- 新增复用历史任务 API 配置选项：开启后，复用历史任务时会临时使用该任务原本的 API 配置，减少因当前服务商不同导致的参数或接口不匹配。
- 新增输入框持久化选项：可控制刷新或重启后是否恢复上次的提示词和参考图。
- 新增配置导入 URL：API 配置可复制为导入链接，并可选择是否包含 API Key；自定义服务商配置也支持通过 URL 导入。
- 新增数据管理选项：导出、导入和清除数据时，可分别选择“配置”和“任务及图片”。
- 新增 Cloudflare Workers 部署支持：内置
wrangler.jsonc，并提供npm run deploy:cf部署命令 (#35)。
变更
- 改进本地图片存储方式：任务卡片和详情预览改用缩略图，原图改为按需加载，并限制内存缓存大小，降低大量 4K 图片历史记录下的内存占用 (#29, PR #30)。
- 改进数据备份结构：导出的 ZIP 现在会包含缩略图数据，导出文件名改为可读时间格式。
- 改进异步任务处理：fal.ai 和自定义异步服务商任务在连接中断后会保留任务信息，并继续尝试恢复结果 (#25)。
修复
- 修复部分 OpenAI 兼容接口因
Pragma请求头触发 CORS 白名单失败，导致Failed to fetch或无法接入 sub2api 的问题 (#32, #33)。 - 修复大量历史图片场景下，页面初始化或预览时容易加载过多原图导致卡顿的问题 (#29, PR #30)。
贡献
- @NormanMises 通过 PR #30 贡献了本地图片存储与大图历史性能优化，特此感谢。
Contributors
NormanMises
Assets 2
v0.2.22
v0.2.22（2026-05-01）
新增
- 新增 fal.ai 供应商支持，可通过官方 fal SDK 使用 GPT Image 2 进行生成、参考图编辑和遮罩编辑。
- 新增多供应商配置管理，支持 OpenAI 与 fal.ai 配置切换、导入合并和去重。
- 新增 fal.ai 队列重连恢复，连接中断后可根据 requestId 自动查询任务结果。
- 新增输入草稿持久化，刷新后可恢复提示词和参考图。
变更
- fal.ai 图片结果会先保存为本地图片数据再完成任务，避免远程 media URL 过期影响历史记录。
- 优化 fal.ai 参数兼容性，隐藏不支持的审核、压缩率、自动尺寸和超时配置。
- 优化输出数量限制，fal.ai 最大 4，OpenAI 最大 10，超限时显示 2 秒气泡提示。
- OpenAI 默认请求超时调整为 600 秒，并新增任务级超时兜底。
- App 启动时会将历史遗留的 OpenAI running 任务标记为“请求中断”。
- 优化任务详情和任务卡片的重连中状态、计时器和错误操作显示。
- 清空数据时会同步清理供应商配置，导入设置时会保留当前自定义配置并追加新配置。
贡献
Contributors
FHfanshu
Assets 2
v0.2.21
v0.2.21（2026-04-30）
新增
- Docker 部署新增
DEFAULT_API_URL和API_PROXY_URL两个运行时环境变量，分别用于前端默认 API 地址和 Nginx API 代理转发目标。 - 新增 Docker 旧配置迁移提示：当容器检测到仍在使用旧
API_URL时，前端会展示一次迁移说明弹窗。
改进
- 旧 Docker 环境变量
API_URL仍保持兼容，会在容器启动时自动作为DEFAULT_API_URL和API_PROXY_URL的兜底值。 - 迁移提示弹窗增加信息图标、行内代码样式和 3 秒确认延迟，避免用户误关。
- 优化 Docker 运行时环境变量注入方式，避免 Vite 构建期常量折叠影响运行时替换。
文档
- 重写 README 的部署与使用说明，整合 Vercel、Docker、本地开发和静态构建的默认 API URL 配置方式。
- 精简 API 配置与 URL 传参章节，避免重复描述环境变量。
v0.2.20
v0.2.20（2026-04-30）
修复
- 修复 Responses API 在未开启 Codex CLI 模式时不会加入提示词防改写前缀的问题：现在 Responses API 会始终在请求文本前加入不改写要求，降低模型重写提示词导致偏离原意的概率。
- 统一提示词防改写前缀的构造逻辑，并补充单元测试覆盖 Codex CLI 模式开启和关闭两种 Responses API 请求。
文档
- 重写 README 结构，降低阅读负担，同时保留 Vercel、Docker、本地开发代理和 New API 接入示例等完整部署说明。
- 更新 README 中 Codex CLI 模式、Responses API 提示词防改写、缺少官方返回字段检测等说明，并新增 Star History 图表。