From d875a62652e278eb5beef54356e594d1d1149e37 Mon Sep 17 00:00:00 2001 From: Zyy Date: Fri, 9 Oct 2026 14:10:51 +0800 Subject: [PATCH] chore(release): v3.22.1 Co-authored-by: Codex --- .../runtime/plugin-api-deprecations.json | 8 +++--- release/notes.md | 25 ++++++------------- release/version.yaml | 2 +- 3 files changed, 13 insertions(+), 22 deletions(-) diff --git a/backend/crates/gateway-plugin/runtime/plugin-api-deprecations.json b/backend/crates/gateway-plugin/runtime/plugin-api-deprecations.json index fadbe3e39..922d646c5 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.0", - "remaining_releases": 2, + "last_counted_in": "3.22.1", + "remaining_releases": 1, "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.0", - "remaining_releases": 2, + "last_counted_in": "3.22.1", + "remaining_releases": 1, "migration": "使用新版 SDK 读取 fast_mode 三态，并将 upstream_adapter 声明升级到 v2" } ] diff --git a/release/notes.md b/release/notes.md index ab78e36d6..95806652d 100644 --- a/release/notes.md +++ b/release/notes.md @@ -1,23 +1,14 @@ -# v3.22.0 - -## 用量与性能观测 - -- 用量记录统一保存请求、调度、传输与恢复观测，保留历史记录的诊断信息 -- 延迟明细区分上游性能、请求观测与传输观测，展示上游返回的响应耗时、引擎耗时、TTFT 和 Token 间隔等指标 -- 输出速率改用同一完成响应的上游时间戳计算，避免把网关等待与传输时间计入生成耗时；缺少有效上游时间戳时显示「—」 -- 首字等待按首个输出项开始事件计时，不再把其他结构事件计为首字 +# v3.22.1 ## 修复与改进 -- 账号与 Key 表单的分组选择使用轻量查询，避免加载选择项时重复计算分组聚合统计 -- Codex 配置导出统一使用 `config.toml` 中的 Provider Bearer 鉴权；CC Switch 导入对齐 4.0.4 支持的连接信息与用量查询字段 -- 改进 Codex 0.162 协议兼容：Grok 转换采用最新的增量工具声明，修正同名工具及命名空间成员更新；流内错误的 `Retry-After` 解析与官方头部处理语义保持一致 -- 配置发布复用未变化的插件实例，减少进程重建；完善插件状态迁移失败后的恢复与发布流程，保留进行中请求使用的实例 -- 修复 PostgreSQL 事务开始被取消后，连接复用可能残留未结束事务的问题 +- 修复上游性能明细漏采：读取当前响应的关键路径计时，恢复引擎耗时与 API 开销，并校验响应归属，避免混入整轮累计时间 +- 改进数据库迁移期间的启动反馈：迁移或等待迁移锁时，每 15 秒记录已等待时间；镜像与 Compose 的健康检查启动宽限期延长至 5 分钟 +- 统一管理端重启、SIGTERM 与 SIGINT 的关闭流程，停止监听后结束剩余会话，保留后台观测写入与资源清理的收尾预算 ## 升级事项 -- 从 v3.21.3 升级会自动执行数据库迁移 `0025_request_observation.sql`，回填现有请求观测并调整存储结构；升级前备份数据库，停止共用该数据库的旧版本实例，为历史请求回填预留时间 -- 迁移完成后不能仅切回旧二进制或镜像回滚；如需回退，应同时恢复升级前的数据库备份 -- 历史记录缺少新增的上游性能数据时，相应指标保持空缺，输出速率显示「—」 -- 手动配置 Codex 时使用完整的 `config.toml` 模板，无需另外生成 `auth.json`；CC Switch 4.0.4 会重建配置，导入连接后如需原生生图等模板设置，请核对并补齐对应配置 +- 从 v3.22.0 升级没有新增数据库迁移；从更早版本升级仍会执行相应历史迁移 +- 停止或重启会断开尚未完成的 HTTP、SSE 与 WebSocket 会话；`host.drain_timeout_seconds` 不再生效，后台收尾预算由 `host.worker_shutdown_timeout_seconds` 控制 +- 现有 Compose 部署需同步新的健康检查配置并重建容器，才能应用 5 分钟的启动宽限期 +- 新增采集的上游性能数据只影响升级后的请求，历史记录中的空缺不会自动补齐 diff --git a/release/version.yaml b/release/version.yaml index d8464d011..ec49bbf47 100644 --- a/release/version.yaml +++ b/release/version.yaml @@ -1 +1 @@ -version: "3.22.0" +version: "3.22.1"