diff --git a/release/notes.md b/release/notes.md index 75ae85714..bc3cb0842 100644 --- a/release/notes.md +++ b/release/notes.md @@ -1,14 +1,15 @@ -# v3.23.1 +# v3.24.0 ## 修复与改进 -- OpenAI Responses 的结构性前导事件保留到有效文本、推理、工具活动或终态再交付;有效输出前的 WebSocket 传输故障按现有预算进行同账号恢复,减少提前交付造成的空响应和恢复机会丢失 -- WebSocket 观察到上游关闭或读取错误后立即标记连接失效,拦截已关闭连接上的发送,并跳过已取消的排队消息,减少无效上游请求;保留原始关闭原因和关闭前的静默时长 -- 优化统计与用量查询的观测视图,恢复普通聚合的索引和并行查询规划,同时保留计时统计的计算复用,减少无关 JSON 投影开销 -- 管理端更新共享 UI 组件,统一表单、弹窗、加载状态和操作反馈的接入 +- 仪表盘与用量统计改用独立统计数据和持久化聚合,减少大规模请求历史查询的开销,支持历史回填、迟到更新和删除后的统计重建 +- 请求历史保留账号、客户端 Key 与分组快照,配置变更或删除后仍可查询原始归属;运行中的恢复租约独立存储,减少对历史记录的频繁更新和重复校验 +- 修复混用 OpenAI 与 xAI 等 Provider 时,已知模型被其他 Provider 的未知模型兜底抢先匹配的问题,Grok 请求优先使用声明支持该模型的 Provider(#391) +- 修复原生 Responses Lite WebSocket 在前导重试期间丢失中断意图的问题;未启用中间件链时及时交付响应 ID,并在重试换号后继续转发中断(#390) +- 统一管理端缓存输入、缓存写入和推理输出 Token 的字段与展示,改善健康时间线浮层跟随鼠标时的平滑度 ## 升级事项 -- 新增数据库迁移 `0027_request_observation_projection.sql`,更新观测视图,保留字段顺序、类型、取值和只读属性,不重写历史请求数据 -- 有效输出前的 WebSocket 传输恢复沿用 `stream_max_retries`,默认最多 5 次;尽力重试不保证上游只执行一次,精确连接续接仍受原连接和客户端恢复边界限制 -- 前导事件缓冲不另设固定等待时限或累计体积上限,取消、请求截止时间和现有传输超时仍生效 +- 本次数据库变更集中在 `0028_request_analytics.sql`,已发布的 `0001`–`0027` 保持不变。升级前备份数据库、停止旧版本写入并预留迁移窗口;迁移完成后不能直接换回旧二进制运行 +- 管理 API 的 `cachedTokens`、`cacheWriteTokens`、`reasoningTokens` 分别更名为 `cachedInputTokens`、`cacheWriteInputTokens`、`reasoningOutputTokens`,不保留旧字段别名;自定义客户端和报表需同步调整 +- 若源码部署已执行未发布 `main` 中原有的 `0028`–`0035` 迁移,其迁移历史与本版不兼容,不能直接升级,需单独迁移数据;不要修改 `_sqlx_migrations` 的 checksum 绕过校验 diff --git a/release/version.yaml b/release/version.yaml index 191221627..39cb2ff43 100644 --- a/release/version.yaml +++ b/release/version.yaml @@ -1 +1 @@ -version: "3.23.1" +version: "3.24.0"