chore(release): v3.21.1

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.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"
   }
 ]

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 会按新口径重新计算；已记录的首字时间保持原值，新首字判定仅对升级后的请求生效

release/version.yaml

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