From 60eb08cb96fe6e5af533a2058c1cea4a32bc0ce4 Mon Sep 17 00:00:00 2001 From: Zyy Date: Sat, 12 Sep 2026 00:24:04 +0800 Subject: [PATCH] docs(release): prepare v3.4.1 notes Summarize quota reset, downstream transport isolation, compressed request decoding, and weekly/monthly usage window fixes since v3.4.0. Co-authored-by: Codex --- release/notes.md | 26 +++++++++----------------- 1 file changed, 9 insertions(+), 17 deletions(-) diff --git a/release/notes.md b/release/notes.md index 23e66b00d..4ccb93cdb 100644 --- a/release/notes.md +++ b/release/notes.md @@ -1,26 +1,18 @@ -# v3.4.0 - -## 新增功能 - -- 新增代理管理页面，支持创建、编辑和测试出站代理，查看连接耗时与出口 IP。 -- 新建或编辑代理时，可在保存前测试连接；测试不会修改已保存的连接配置和账号绑定。 -- 导入账号、编辑单个账号或批量编辑账号时，可选择已管理的代理。代理配置变更会应用到关联账号，无需重启网关。 -- 支持搜索和分页查看代理关联的账号，展示账号信息、平台与认证类型、套餐及分组。可将账号从当前代理移除，恢复直连。 +# v3.4.1 ## 问题修复 -- 代理测试与 OpenAI 请求使用一致的证书信任配置，包括 `CODEX_CA_CERTIFICATE`，避免可用代理因证书处理不一致而无法选择。 -- 防止并发修改代理影响凭据导入，保留导入过程中换取的凭据及其预期代理绑定。 -- 修正 OpenAI 客户端非流式请求对应的上游 WebSocket 流式标记。 -- 修复拖动弹窗后表格背景出现拼接缝的问题。 +- 修复通过普通 HTTP 访问管理端时，额度重置点击“下一步”因 `crypto.randomUUID` 不可用而无响应的问题；保留请求重试时的幂等标识。 +- 修复 Cloudflare Tunnel 等反向代理注入的 `cf-visitor`、`cf-warp-tag-id` 等链路头被透传到上游、导致 HTTP 或 WebSocket 请求遭遇 403 的问题。统一过滤下游传输头与压缩协商，继续保留业务扩展头及上游响应诊断信息。 +- `POST /v1/responses` 支持接收 `gzip`、`deflate`（zlib 封装）和 `zstd` 压缩正文，避免将压缩数据直接当作 JSON 而返回 `invalid_json`。 +- 加固请求解压的内存边界，支持完整读取 gzip 多成员和 zstd 多帧，拒绝损坏、超限及叠加编码的请求，避免静默忽略后续内容。 ## 体验优化 -- 统一代理新建与编辑表单，将测试连接与保存代理拆分为独立操作，并优化输入提示。账号代理选择器展示脱敏后的连接地址；连接地址未修改时保留已保存的代理凭据。 -- 优化代理表格列宽与操作区，移除多余的列表刷新按钮；账号管理与关联账号弹窗复用套餐展示逻辑。 -- 侧边栏导航支持独立滚动，滚动条自动隐藏，Logo 和底部操作保持可见。 -- API Key 限额金额省略无意义的末尾零，并优化限额详情与重置时间展示；详情浮层仍可查看精确金额。 +- 账号用量统计优先使用周额度窗口，周窗口不可用时使用月额度窗口；没有符合条件的窗口时，不再回退到短期限流窗口或历史累计值。额度比例和 Dashboard 的窗口选择保持不变。 +- Tokens 结构和模型使用排行统一显示“周额度窗口”或“月额度窗口”，并修正汇总数字与窗口标签的水平对齐。 ## 升级说明 -数据库迁移会自动将现有账号的代理 URL 纳入代理管理，并保留账号绑定，原有连接可继续使用。为账号新增或修改代理绑定时，请先对迁移后的代理执行连接测试。 +- 从 v3.4.0 升级无需新增数据库迁移或配置调整。 +- 压缩的 Responses HTTP 请求展开后最多为 64 MiB，zstd 解码窗口也限制为 64 MiB；超限或无法满足解码限制的请求会被拒绝。本次不新增未压缩正文或 WebSocket 帧的长度限制。