diff --git a/backend/crates/gateway-plugin/runtime/plugin-api-deprecations.json b/backend/crates/gateway-plugin/runtime/plugin-api-deprecations.json index 922d646c5..9a72a77a0 100644 --- a/backend/crates/gateway-plugin/runtime/plugin-api-deprecations.json +++ b/backend/crates/gateway-plugin/runtime/plugin-api-deprecations.json @@ -4,8 +4,8 @@ "version": 3, "replacement_version": 4, "introduced_in": "3.20.0", - "last_counted_in": "3.22.1", - "remaining_releases": 1, + "last_counted_in": "3.22.2", + "remaining_releases": 0, "migration": "将执行设置和来源中的 disable_fast 改为 fast_mode,使用 default、enabled、disabled 三态,并将 middleware 声明升级到 v4" }, { @@ -13,8 +13,8 @@ "version": 1, "replacement_version": 2, "introduced_in": "3.20.0", - "last_counted_in": "3.22.1", - "remaining_releases": 1, + "last_counted_in": "3.22.2", + "remaining_releases": 0, "migration": "使用新版 SDK 读取 fast_mode 三态,并将 upstream_adapter 声明升级到 v2" } ] diff --git a/release/notes.md b/release/notes.md index 95806652d..357bc35b6 100644 --- a/release/notes.md +++ b/release/notes.md @@ -1,14 +1,17 @@ -# v3.22.1 +# v3.22.2 ## 修复与改进 -- 修复上游性能明细漏采:读取当前响应的关键路径计时,恢复引擎耗时与 API 开销,并校验响应归属,避免混入整轮累计时间 -- 改进数据库迁移期间的启动反馈:迁移或等待迁移锁时,每 15 秒记录已等待时间;镜像与 Compose 的健康检查启动宽限期延长至 5 分钟 -- 统一管理端重启、SIGTERM 与 SIGINT 的关闭流程,停止监听后结束剩余会话,保留后台观测写入与资源清理的收尾预算 +- 移除 OpenAI Responses 提交前缓存的 128 KiB 字节阈值,避免大段前导事件提前结束透明重试窗口;HTTP/SSE 与 WebSocket 均保留 2.5 秒宽限期及语义输出、终态等放行规则 +- 完善 WebSocket 控制消息透传:中断及其他非创建文本消息原样发送到当前绑定的上游连接,响应结束后仍可转发控制消息与上游事件,不额外创建推理请求 +- 完善 OpenAI 扩展字段和原文透传,保留推理强度的数字及扩展值、WebSocket 原始文本、业务元数据,以及 Images/Search 的业务请求头;避免未改写的心跳或未知内容因本地解析失败而被截断 +- 诊断导出升级为 schemaVersion 4,补齐提交前缓存的释放原因、累计字节数与等待时间,便于区分实际输出和宽限期到期等提交原因 +- 健康探测保留具体失败组件、原因及超时信息,持续相同故障避免重复记录;xAI 后台任务保留额度与模型目录同步的失败原因 +- Codex 配置模板显式启用 V2 远程压缩,并补充 CC Switch 一键导入的配置边界说明 ## 升级事项 -- 从 v3.22.0 升级没有新增数据库迁移;从更早版本升级仍会执行相应历史迁移 -- 停止或重启会断开尚未完成的 HTTP、SSE 与 WebSocket 会话;`host.drain_timeout_seconds` 不再生效,后台收尾预算由 `host.worker_shutdown_timeout_seconds` 控制 -- 现有 Compose 部署需同步新的健康检查配置并重建容器,才能应用 5 分钟的启动宽限期 -- 新增采集的上游性能数据只影响升级后的请求,历史记录中的空缺不会自动补齐 +- 从 v3.22.1 升级没有新增数据库迁移;从更早版本升级仍会执行相应历史迁移 +- 使用 Codex 0.162.0 及以上版本时,可重新复制并合并配置模板以启用 V2 远程压缩;CC Switch 一键导入不包含该能力配置 +- 本版为插件 `middleware v3`、`upstream_adapter v1` 的最后一个兼容正式版;插件作者应迁移至 `middleware v4`、`upstream_adapter v2`,以 `fast_mode` 三态替代 `disable_fast` +- 移除字节阈值不会放宽已经交付输出后的重放限制,上游错误仍需满足安全重试条件 diff --git a/release/version.yaml b/release/version.yaml index ec49bbf47..b552acdf1 100644 --- a/release/version.yaml +++ b/release/version.yaml @@ -1 +1 @@ -version: "3.22.1" +version: "3.22.2"