WebAI2API/CHANGELOG.md

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [3.6.3] - 2025-04-05

### 🐛 Fixed
- **适配器**
  - 修复 Gemini 文本适配器遇到长提示词的时候无法选择模型的问题
  - 修复豆包上传图片无法点击的问题

## [3.6.2] - 2025-03-31

### ✨ Added
- **适配器**
  - 豆包适配器兼容简体、繁体中文界面

### 🔄 Changed
- **适配器**
  - 更新豆包图片生成模型 ID

## [3.6.1] - 2025-03-28

### ✨ Added
- 图片下载重试机制（指数退避）
- 请求历史记录（SQLite 存储）
- WebUI 请求模型页面

## [3.6.0] - 2026-03-26

### 🐛 Fixed
- **适配器**
  - 再次修复豆包适配器无法点击选择模型的问题
  - 修复豆包超时时间跟随配置文件

### 🔄 Changed
- **浏览器**
  - 回滚互斥锁机制，不再使用互斥锁，这是一个错误的修复

## [3.5.9] - 2026-03-25

### 🐛 Fixed
- **适配器**
  - 尝试修复同实例多窗口时出现点击超时的问题
  - 修复 Gemini 文本适配器不选择模型的问题
  - 修正 Gemini 文本适配器的模型 ID

## [3.5.8] - 2026-03-22

### ✨ Added
- **适配器**
  - 为图片生成结果下载单独提供重试机制以及相关设置
- **WebUI**
  - 增加批量操作实例设置代理或者删除

### 🐛 Fixed
- **适配器**
  - 修复豆包适配器无法点击选择模型的问题

## [3.5.7] - 2026-03-21

### 🔄 Changed
- **浏览器**
  - 扩展拟人点击策略并增强坐标安全性

## [3.5.6] - 2026-03-20

### 🐛 Fixed
- **适配器**
  - 修复 Gemini 适配器可能会点不到发送按钮的问题

## [3.5.6] - 2026-03-20

### ✨ Added
- **豆包**
  - 增加豆包 Pro 模型的支持

### 🐛 Fixed
- **适配器**
  - 修复豆包文本被截断的问题

## [3.5.5] - 2026-03-05

### ✨ Added
- **自定义**
  - 增加自定义生成等待超时时间

### 🐛 Fixed
- **适配器**
  - 修复 ChatGPT 文本适配器响应被截断的问题


## [3.5.4] - 2026-02-27

### 🔄 Changed
- **适配器**
  - 更新 LMArena 模型列表

## [3.5.4] - 2026-02-22

### 🐛 Fixed
- **适配器**
  - 修复 Gemini 无法点击创建图片按钮的问题

## [3.5.3] - 2026-02-16

### 🐛 Fixed
- **适配器**
  - 修复 DeepSeek 文本生成适配器因接口格式更新导致无法获取生成结果
  - 修复 豆包 适配器图片上传逻辑更改导致上传进度验证失败的问题

## [3.5.2] - 2026-02-10

### 🐛 Fixed
- **适配器**
  - 修复 Gemini 图片生成适配器因前端更新导致无法点击 Create images 按钮的问题
  - 修复 Gemini 图片生成适配器因前端更新导致无法点击上传图片按钮的问题
  - 更新 LMArena 模型列表

## [3.5.1] - 2026-01-24

### ✨ Added
- **WebUI**
  - 增加日志等级的设置

### 🐛 Fixed
- **代理**
  - 修复无需鉴权的 Socks5 代理无法使用的问题

## [3.5.0] - 2026-01-23

### ✨ Added
- **鼠标轨迹**
  - 增加三种鼠标轨迹选择（使用项目维护的、使用 Camoufox 内置、不适用拟人轨迹）

### 🐛 Fixed
- **Token 留空问题**
  - 修复 WebUI 留空Token后无法重启的问题（允许 Token 留空）

### 🔄 Changed
- **鼠标轨迹**
  - 增快鼠标移动速度

### ❌ Removed
- **热门模型ID**
  - 竞技场删除了 gemini-3-pro-image-preview-2k，因此项目同步删除

## [3.4.9] - 2026-01-22

### 🔄 Changed
- **超时优化**
  - 等待生成结果的超时时间不再一刀切，根据上游 SEE 动态重置超时计时器

### 🐛 Fixed
- **LMA 超时问题**
  - 修复 LMArena 因模型选择界面更新导致的点击超时
- **Flow 图片上传**
  - 修复 Google Flow 因历史上传的图片过多导致上传按钮被顶到不可见区域造成点击超时
- **提示词输入**
  - 长提示词粘贴之前模拟输入时将回车当换行符使用导致误触发送提示词

## [3.4.8] - 2026-01-19

### 🔄 Changed
- **操作流程**
  - 操作完成后不再模拟移开鼠标的步骤，加快响应速度减少故障概率

## [3.4.8] - 2026-01-18

### 🔄 Changed
- **崩溃重启**
  - 非登录模式下浏览器崩溃或者被关闭时不导致项目退出而是重启

## [3.4.7] - 2026-01-14

### ✨ Added
- **CSS注入**
  - 增加 CSS 注入，支持禁用动画，禁用模糊滤镜，降低字体渲染精度

### 🔄 Changed
- **超时优化**
  - 增长 Google Flow 适配器的控件等待超时时间，防止在低配设备上因操作过慢而超时

## [3.4.6] - 2026-01-13

### 🔄 Changed
- **优化速度**
  - 删除或减少过于保守的控件等待时间

## [3.4.5] - 2026-01-11

### ✨ Added
- **增加计数功能**
  - 支持在 WebUI 记录与查看成功次数
- **FireFox 参数**
  - 增加 FireFox 站点隔离机制开关
- **提示词违规提示**
  - 提示词违规时提示内容被阻止

### 🐛 Fixed
- **修复图片上传**
  - 修复 LMArena 因模型选择与图片上传的顺序错误导致的图片上传失败

## [3.4.4] - 2026-01-10

### ✨ Added
- **新增适配器**
  - 支持豆包图片生成与文本生成适配器

### 🐛 Fixed
- **未捕获的超时错误**
  - 修复因未捕获的超时错误导致的程序崩溃
- **模型选择**
  - 修复 LMArena 模型选择的问题并同步模型列表

## [3.4.3] - 2025-12-26

### ✨ Added
- **适配器描述**
  - 为每个适配器添加描述，可以在 WebUI 中的适配器设置页面点击查看每个适配器的描述和使用方法。
- **适配器模型管理**
  - 为每个适配器添加模型列表管理，支持黑名单和白名单，可用于禁用网站出现问题的模型
- **调试适配器**
  - 多种检测网站聚合，IP 纯净度查询等，并初步测试自动过盾

## [3.4.3] - 2025-12-26

### 🐛 Fixed
- **Gemini**：修复因懒加载导致的等待图片超时问题

## [3.4.2] - 2025-12-25

### 🔄 Changed
- **浏览器指纹**
  - 增加 WebGL 和 Canvas 噪点的持久化，防止频繁变化
  - 清洗插件列表，防止出现 FireFox 中有 Chrome 内置的 PDF 阅读器插件
  - 清洗 UA 标识，防止出现未来浏览器版本，导致某些网站报错403 (如：aistudio)
- **关闭动画**
  - 通过 about:config 中的设置禁用背景高斯模糊 CSS 和减少动画，节省资源占用

## [3.4.1] - 2025-12-24

### ✨ Added
- **新增适配器**
  - 支持 Google Flow 图片生成适配器

### 🐛 Fixed
- **Gemini Business**：修复因懒加载导致的等待图片超时问题

## [3.4.0] - 2025-12-23

### ✨ Added
- **新增适配器**
  - 支持 ChatGPT 文本生成适配器
  - 支持 zAI 文本生成适配器
  - 支持 DeepSeek 文本生成适配器
  - 支持 Sora 视频生成适配器

### 🔄 Changed
- **适配器实现更改**
  - zAI 图片生成适配器不再使用拦截请求修改响应体的方式，改为UI选择模型列表，并且Nano Banana Pro 支持选择1K、2K、4K

## [3.3.2] - 2025-12-22

### 🔄 Changed
- **配置文件**
  - 自动复制初始化配置文件，并放进`data/config.yaml`，Docker友好化
  - 优化 Dockerfile
  - 初始化脚本不再依赖配置文件，支持交互式和参数传入式配置代理
  - 优化 WebUI 文案和日志排列

### ❌ Removed
- **删除测试脚本**
  - 现在有 WebUI 测试了，已经无需 test 脚本了

## [3.3.1] - 2025-12-21

### ✨ Added
- **新增适配器**
  - 支持 Gemini 网页版文本生成
  - 支持 ChatGPT 图片生成
- **支持视频生成**
  - 支持在 Gemini 网页版和 Gemini Enterprise Business 图片生成适配器中生成视频

### 🔄 Changed
- **优化图片下载方式**
  - 让文件下载步骤直接继承浏览器上下文减少特征

## [3.3.0] - 2025-12-20

### ✨ Added
- **新增适配器**
  - 支持 ZenMux 

### 🔄 Changed
- **清理历史遗留**
  - 清除历史遗留的多余的逻辑

## [3.2.1] - 2025-12-20

### ✨ Added
- **WebUI**
  - 完善 WebUI 功能，添加接口测试和日志查看器，优化部分布局
- **日志记录**
  - 会在 data/temp 文件夹下记录日志（最大5MB轮转）

### 🔄 Changed
- **初始化失败逻辑**
  - 程序初始化失败后不会直接推出，以便利用 WebUI 修改错误的配置
- **LMArena 图片适配器**
  - 支持通过配置直接返回图片URL (但其他不支持该选项的适配器仍然会返回 Base64)

## [3.2.0] - 2025-12-19

### ✨ Added
- **WebUI**
  - 为项目添加了网页版管理工具，便于修改配置文件（可能会有问题，可随时反馈）

- **增加看门狗**
  - 增加看门狗机制（Supervisor），保证程序失败重载和利于利用 WebUI 完整重启程序
  - 同时将 Linux 上的虚拟显示器和 VNC 服务器启动程序也迁移至看门狗机制

## [3.1.0] - 2025-12-17

### ✨ Added
- **支持文本模型**
  - 添加专门的文本模型适配器（目前仅支持 LMArena 和 Gemini Busineess）
  - 支持网络搜索模型，例如 gemini-3-pro-grounding、grok-4-1-fast-search
- **图片调度**
  - 若有适配器同时支持同一个模型，但是图片策略不同，将会优先将带图片的请求分发给支持图片的适配器
- **为自动通过验证码做准备**
  - 新增测试适配器 turnstile_test ，为将来需要自动过 CloudFlare 验证码做准备

### 🔄 Changed
- **项目名称更新**
  - 因支持的功能越来越多，决定为项目改名为 WebAI2API

## [3.0.1] - 2025-12-16

### ✨ Added
- **故障转移系统**
  - 实现了基于 Pool 的自动故障转移：当某个 Worker 执行任务失败（如 API 超时、页面崩溃、被限流）时，系统会自动寻找下一个支持该模型的 Worker 进行重试。
  - **Merge 模式增强**：Merge Worker 内部也会在不同的适配器之间进行故障转移。

## [3.0.0] - 2025-12-14

### ✨ Added
- **多窗口多账号支持**
  - 架构升级，支持同时管理多个浏览器实例和多个标签页。
  - 实现了浏览器实例间的数据（Cookies/Storage）完全隔离。
- **Cookies 管理**
  - 新增 `/v1/cookies` 接口，支持获取指定 browser instance 的 Cookies。

### 🔄 Changed
- **配置系统重构**
  - 配置文件结构大幅调整，采用更清晰的 `backend.pool` 结构配置 Worker。

## [2.4.0] - 2025-12-13

### ✨ Added
- **浏览器伪装增强**
  - 集成 GEOIP 数据库，实现基于 IP 的自动时区伪装。
- **初始化脚本 (init.js)**
  - 支持 `npm run init -- -custom` 自定义初始化。
  - 自动下载 GeoLite2 sum数据库。
- **服务器自检**
  - 启动时自动检查依赖完整性和环境补丁。
- **Merge 模式监控**
  - 闲时自动跳转到指定网站以维持会话活跃（保活）。

### 🔄 Changed
- **代码重构**
  - 服务器代码模块化 (`src/server/`).
  - 目录结构重新整理。

## [2.3.0] - 2025-12-12

### ✨ Added
- **新适配器支持**
  - 初步支持 Gemini 网页版 (`gemini.js`).

### 🔄 Changed
- **流式接口优化**
  - 移除了全局开关，改为由请求体参数 `stream: true` 动态控制。
  - **保活机制**：流式模式下支持无限排队，并通过 SSE 心跳包防止连接超时。
  - **拒绝策略**：非流式请求在队列满时立即拒绝，避免无限等待。

## [2.2.3] - 2025-12-12

### ✨ Added
- **后端聚合**
  - 实现了根据模型 ID 自动路由到对应适配器的逻辑。

### 🐛 Fixed
- **Mac 兼容性**
  - 修复了 MacOS 初始化步骤缺失导致的启动失败。

## [2.2.2] - 2025-12-12

### ✨ Added
- **Docker 支持**
  - 发布 Docker 镜像

## [2.2.1] - 2025-12-12

### ✨ Added
- **Cookie 导出**
  - 利用自动续登机制获取最新 Cookie，供外部工具使用。

### 🐛 Fixed
- **自动续登修复**：改为全局监听，修复了部分场景下不触发的问题。
- **杂项修复**：VNC 端口冲突、启动参数优化、zAI 错误反馈优化。

## [2.2.0] - 2025-12-11

### ✨ Added
- **新适配器支持**
  - 支持 zAI (zai.is)，含自动 Discord 登录处理。

### 🐛 Fixed
- **Gemini Business**：修复监听器重复触发问题。
- **Mac 输入法**：修复拟人输入无法全选的问题。

## [2.0.0] - 2025-12-06

### 💥 Breaking Changes
- **核心迁移**
  - 从 Puppeteer 迁移至 **Playwright + Camoufox**。
  - 旧版代码归档至 `puppeteer-edition` 分支。

### ✨ Added
- **新适配器支持**
  - 支持 Nano Banana Free。
- **功能特性**
  - 内置 XVFB/VNC 支持命令。
  - 支持 Gemini Business 过期自动续登。