chore(release): v3.21.2

Co-authored-by: Codex <noreply@openai.com>

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.1",
-    "remaining_releases": 5,
+    "last_counted_in": "3.21.2",
+    "remaining_releases": 4,
     "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.1",
-    "remaining_releases": 5,
+    "last_counted_in": "3.21.2",
+    "remaining_releases": 4,
     "migration": "使用新版 SDK 读取 fast_mode 三态，并将 upstream_adapter 声明升级到 v2"
   }
 ]

release/notes.md

@@ -1,18 +1,19 @@
-# v3.21.1
-
-## 新增
-
-- OpenAI 账号亲和新增“优先”模式：会话内请求优先使用主账号，繁忙或不可用时临时分流，保留原绑定，后续请求继续优先主账号
+# v3.21.2
 
 ## 修复与改进
 
-- OpenAI 首字计时采用首个非前导输出事件，包含输出项等结构事件，跳过响应创建、处理中、心跳、额度控制和失败事件；保留请求级计时起点，推理与正文仍分别按实际内容计时
-- 用量列表与性能统计的 tok/s 统一按输出 Token 除以完整请求耗时计算，避免扣除首字等待后高估速率；输出 Token 保持上游口径，已包含的推理 Token 不重复相加或扣除
-- 管理页面首次进入时只读取登录状态，页面活动不再触发续期；业务接口返回认证错误时共用一次续期，迟到的失败请求也等待当前续期完成后再重试
-- 宽松亲和改为直接按调度策略选号，不优先会话主账号；严格模式继续让同一会话共用账号，子请求等待当前账号
+- 修复 OpenAI 严格亲和下，子线程或独立记忆整理任务因会话尚未绑定账号而等待超时的问题：任何有可靠会话身份的请求均可按调度策略原子首绑，并发首请求最终共用同一绑定；已有绑定的子线程仍跟随当前账号，迁移权限保持不变
+- xAI 模型目录对齐当前 CLI proxy 的模型、推理档位及上下文窗口字段；推理档位按请求保留，不再根据旧模型名称降档或删除，缺失能力与默认值保持未知
+- 修复 xAI 托管搜索工具与客户端函数同名时的调用及跨轮重放映射，支持 `web_search.filters.excluded_domains`，校验允许与排除域名列表不能同时非空
+- xAI 额度判断采用当前账单字段，保留预付余额的原始符号，不再凭过期快照或旧字段恢复账号；上游报告零费用时视为费用未提供，只有具备完整计价依据时才使用本地估算
+- 修复备份取消或失败时的导出进程、分片上传与暂存文件清理，恢复已完成上传的任务后及时清理本地归档，并记录清理失败
+- 修复服务关闭时请求排空与后台写入的先后顺序，以及 WebSocket 关闭握手可能被未完成写入阻塞的问题
+- 修复 Key 预算重置后，应用与数据库时钟差异可能使未开启窗口被误判为活跃窗口的问题
+- 账号状态读取改为有界分批并复用查询结果，避免账号池规模直接形成 Redis 并发峰值；完善 OpenAI 重置卡消费的账号锁回收，保持取消后的同账号串行约束
 
 ## 升级事项
 
-- 从正式版 v3.21.0 升级时自动应用 `0024_preferred_account_affinity.sql`；已有保存的亲和选项保持不变，新实例及尚未保存运行设置的初始记录采用严格模式
-- 需要“优先主账号、必要时分流”的实例，请在设置中选择“优先”；自行调用管理 API 的客户端应支持 `openaiAccountAffinity` 的新增值 `preferred`
-- 历史用量的 tok/s 会按新口径重新计算；已记录的首字时间保持原值，新首字判定仅对升级后的请求生效
+- 从 v3.21.1 升级无需新增数据库迁移或调整亲和配置；严格亲和不再要求根线程必须先发请求才能建立会话绑定
+- xAI 请求保留路由选定的完整模型名，不再自动解释 `grok`、`grok-latest` 等旧别名或剥离模型前缀；依赖这些名称的配置应使用显式模型映射
+- xAI 搜索域名白名单应放在 `web_search.filters.allowed_domains`，旧顶层 `allowed_domains` 返回请求错误；推理档位未知或类型错误时也会明确返回字段错误
+- 内建 xAI 适配器对 `generate=false` 预热返回 `400 unsupported_prewarm`，避免误发生成请求；客户端应跳过该预热并继续正式请求

release/version.yaml

@@ -1 +1 @@
-version: "3.21.1"
+version: "3.21.2"