# Changelog

## 0.1.5 - 2026-09-04

### Added
- 新增 `image_test` 工具（Label「连接测试」）：对已配置提供商发起强制真实连接测试（不使用缓存），返回连接结论、失败原因与模型能力统计；支持传 `provider` 指定目标，留空则测试默认提供商。
- 新增 `/image-test` 命令：交互列出所有提供商（含「测试默认提供商」「测试全部」选项），一键测试连接与模型可用性。

## 0.1.4 - 2026-08-23

### Fixed
- `decodeBase64Image` 不再硬编码默认 MIME 为 `image/png`：当图片为纯 base64（无 `data:image/...;base64,` 前缀）时，通过 `detectImageFormat` 从二进制文件头自动推断真实格式（JPEG/PNG/WebP），派生正确的文件后缀。之前默认 `image/png` 导致 JPEG 图片被保存为 `.png`，后续校验不通过报「内容不是有效的图片文件」。

## 0.1.3 - 2026-08-23

### Changed
- 配置摘要改为紧凑展示各 Provider 的默认模型和能力统计；完整模型列表请通过 `image_models` 查看，避免大量文本模型挤占对话上下文。
- 默认编辑/变体模型的文案改为“跟随生图模型（该模型需支持对应操作）”，准确说明回退条件。

### Fixed
- 当编辑或变体跟随生图模型、但该模型未声明对应能力时，错误提示会明确引导用户在 `/image-config` 选择专用模型或手动声明能力。

## 0.1.2 - 2026-08-21

### 修复（Fixed）
- README：修正「每几十秒只吐 1 字节」处被误写为 ASCII 残留「`/sql1`」的乱码。
- README：移除指向 unpkg 直链的 CHANGELOG 链接（unpkg 对 `.md` 直发 `text/markdown` 无 charset，中文 Windows 下浏览器按 GBK 解码会乱码），改为提示在 npm 包页 Code/Files 选项卡查看。

## 0.1.1 - 2026-08-21

### 固定（Fixed）
- 修复「中转站出图慢但已成功仍被判超时」的问题：`fetchWithTimeout` 由「固定 60 秒死闸」改为「stall 续命」——只要持续有字节到达就自动重新计 timing，不再因总时长把慢请求误杀（这是本次主要修复，对应报告中途已生成图片却被报「请求超时」的现象）。
- 总时长兜底：新增可选的「总闸」`IMAGE_TOTAL_TIMEOUT_SECONDS`（默认 600 秒 / 10 分钟），防止被「每几十秒只吐 1 字节」的续活死链无限挂起；之前版本默认「0 = 不限」存在被吊死风险。
- 修复与其相关的次生错误「Stream ended without finish_reason」：`image_generate` / `image_edit` / `image_variation` 在失败时不再向 pi 主程序 `throw`，改为返回结构化文本，避免主程序因异常触发流式重试对话导致的断流报错。
- 修复 `responseFormat=auto` 时硬塞 `response_format: "url"` 导致某些中转站绕一圈下载、变慢且易撞超时的问题；新版本在 `auto` 模式下不再发送该字段，让服务端用它最快/最顺手的方式回。

### 变更（Changed）
- `responseFormat` 兼容性重试方向与策略调整：当服务端明确拒绝 `response_format` 字段时，再带 800 毫秒退避做一次无费用重试（auto 模式补 `url`，显式 `url`/`b64_json` 模式改为不发字段），避免对可能已计费的出图请求做无意义重发。
- 图片下载与生成请求超时解耦：新增 `IMAGE_DOWNLOAD_TIMEOUT_SECONDS`（默认 60 秒）独立计时，避免下载阶段与生成阶段计时叠加误杀。
- 超时/网络错误文案改为温和提示「中转站可能其实已经生成，请稍后重试或检查输出目录」，不再误报「未生成成功」。

### 新增（Added）
- 新增环境变量 `IMAGE_TOTAL_TIMEOUT_SECONDS`（总时长上限，默认 600 秒）。
- 新增环境变量 `IMAGE_DOWNLOAD_TIMEOUT_SECONDS`（图片下载独立超时，默认 60 秒）。
- 新增 CHANGELOG 文件。

---

## 0.1.0 - 初次发布

- 通用 OpenAI-compatible 图片生成扩展，自动模型发现、能力识别、`/image-config` 面板管理。
