From f174320e2ac8987578146d4684e69ad196db0286 Mon Sep 17 00:00:00 2001 From: Zyy Date: Wed, 7 Oct 2026 03:57:15 +0800 Subject: [PATCH] chore(release): v3.21.1 Co-authored-by: Codex --- .../runtime/plugin-api-deprecations.json | 8 +++---- release/notes.md | 24 +++++++------------ release/version.yaml | 2 +- 3 files changed, 14 insertions(+), 20 deletions(-) diff --git a/backend/crates/gateway-plugin/runtime/plugin-api-deprecations.json b/backend/crates/gateway-plugin/runtime/plugin-api-deprecations.json index 69de549b1..92767a706 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.21.0", - "remaining_releases": 6, + "last_counted_in": "3.21.1", + "remaining_releases": 5, "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.21.0", - "remaining_releases": 6, + "last_counted_in": "3.21.1", + "remaining_releases": 5, "migration": "使用新版 SDK 读取 fast_mode 三态，并将 upstream_adapter 声明升级到 v2" } ] diff --git a/release/notes.md b/release/notes.md index 07a5d5788..22f65b093 100644 --- a/release/notes.md +++ b/release/notes.md @@ -1,24 +1,18 @@ -# v3.21.0 +# v3.21.1 ## 新增 -- OpenAI 账号亲和支持宽松和严格两种模式：默认宽松，允许子代理按模型权限、可用性和容量独立分流；严格模式保持同一会话共用账号 -- 设置中可调整账号绑定保留时长和单请求最大换号次数，默认分别为 24 小时和 3 次，保存后对新请求生效 -- 管理员使用管理页面时自动续期登录会话，并发请求共用会话恢复结果，临时网络或服务故障不再直接清除登录状态 -- Codex Desktop 客户端画像支持填写系统版本，并在预览中展示实际出站值 +- OpenAI 账号亲和新增“优先”模式：会话内请求优先使用主账号，繁忙或不可用时临时分流，保留原绑定，后续请求继续优先主账号 ## 修复与改进 -- 错误排查保留本地原因链、上游错误正文和附属清理失败，避免重试与错误包装丢失底层原因；诊断导出保留受控的失败分类 -- 日志与请求观测使用有界非阻塞写入，并为失败记录预留容量，减少日志拥堵对请求的影响；文件日志写入缺口通过健康状态报告 -- 统一首 token 耗时与请求总耗时的计时基准，减少请求副本驻留并优化 XZ 缓冲分配 -- 修复账号订阅名称过长时的布局溢出 -- 收敛后端设置、观测及共享业务模型的重复声明和校验，明确管理模型、请求策略与存储转换的职责 +- OpenAI 首字计时采用首个非前导输出事件，包含输出项等结构事件，跳过响应创建、处理中、心跳、额度控制和失败事件；保留请求级计时起点，推理与正文仍分别按实际内容计时 +- 用量列表与性能统计的 tok/s 统一按输出 Token 除以完整请求耗时计算，避免扣除首字等待后高估速率；输出 Token 保持上游口径，已包含的推理 Token 不重复相加或扣除 +- 管理页面首次进入时只读取登录状态，页面活动不再触发续期；业务接口返回认证错误时共用一次续期，迟到的失败请求也等待当前续期完成后再重试 +- 宽松亲和改为直接按调度策略选号，不优先会话主账号；严格模式继续让同一会话共用账号，子请求等待当前账号 ## 升级事项 -- 从正式版 v3.20.0 升级时自动应用 `0023_error_details_and_account_affinity.sql`，保留已有错误文本和运行设置，并补齐新增设置默认值 -- 默认账号亲和改为宽松；需要继续让子代理跟随根会话账号的实例，应在设置中选择严格模式 -- 管理员原有 `admin.session_ttl_minutes` 配置继续作为不活动期限；新增 `admin.session_absolute_ttl_minutes`，省略时为 30 天。配置模板的不活动期限为 7 天，已有配置不会被自动改写；旧会话重新登录后应用续期策略，密钥身份仍使用固定有效期 -- 自行调用管理 API 的客户端需将运维错误字段 `rawUpstreamError` 改为 `errorDetails`；整体保存运行设置时需包含 `openaiAccountAffinity`、`openaiSessionAffinityTtlHours` 和 `maxAccountRotations`。诊断快照的 `schemaVersion` 升为 2，管理端导出诊断包升为 3 -- 已在源码部署中执行原 `0023_error_details.sql`、`0024_account_affinity.sql` 或 `0025_session_affinity_ttl.sql` 的数据库，与合并后的迁移历史不兼容，不适用上述直接升级路径；不要修改迁移校验和绕过检查 +- 从正式版 v3.21.0 升级时自动应用 `0024_preferred_account_affinity.sql`；已有保存的亲和选项保持不变，新实例及尚未保存运行设置的初始记录采用严格模式 +- 需要“优先主账号、必要时分流”的实例，请在设置中选择“优先”；自行调用管理 API 的客户端应支持 `openaiAccountAffinity` 的新增值 `preferred` +- 历史用量的 tok/s 会按新口径重新计算；已记录的首字时间保持原值，新首字判定仅对升级后的请求生效 diff --git a/release/version.yaml b/release/version.yaml index 8e99d2a06..8e507c446 100644 --- a/release/version.yaml +++ b/release/version.yaml @@ -1 +1 @@ -version: "3.21.0" +version: "3.21.1"