From 718b959fc137ad7f0d1965abe1f960a978971921 Mon Sep 17 00:00:00 2001 From: Zyy Date: Wed, 30 Sep 2026 00:14:35 +0800 Subject: [PATCH] chore(release): v3.18.0 Co-authored-by: Codex --- release/notes.md | 31 ++++++++++++++----------------- release/version.yaml | 2 +- 2 files changed, 15 insertions(+), 18 deletions(-) diff --git a/release/notes.md b/release/notes.md index 8f151fea8..f9df07e91 100644 --- a/release/notes.md +++ b/release/notes.md @@ -1,25 +1,22 @@ -# v3.17.0 +# v3.18.0 ## 新增功能 -- 账号列表新增并发容量标记，在额度进度条上方显示当前执行占用与有效上限，支持不限、未知和满载状态；数据随列表查询刷新，不包含排队请求 -- 插件新增 Client Key 日／周预算查询、限额调整与用量重置，以及账号额度观测刷新能力；可读取 Key 的启用状态和显式分组绑定，无需读取密钥或账号凭据 -- Responses WebSocket 支持中断当前响应，中断绑定原账号与原上游连接；上游确认中断后保留有效的续接能力 +- 插件中间件覆盖 HTTP、WebSocket 消息、公开服务、模型请求与单次上游尝试，支持按阶段配置启停、顺序和失败处理 +- 新增 OpenAI / xAI 受管上游适配器，插件可指定业务上游并解析结果，同时复用宿主的账号选择、重试和用量结算 +- 统一插件事件观察接口，分别订阅请求完成与用量、上游 WebSocket 事件；账号只读事实增加名称和邮箱 ## 问题修复 -- 开启账号排队时，OpenAI 会话绑定的账号因本地并发、请求间隔或已有等待者暂忙，会优先等待原账号；队列满或等待超时不再因此迁移绑定，并区分本地容量不足与没有可用账号 -- 隔离 OpenAI 账号专属的路由、身份及 Guardian 响应引用，避免切换账号时沿用原账号上下文 -- 扩大流式响应前导事件的短暂缓冲，为尚未向客户端交付时收到的明确拒绝保留换号恢复机会；实际输出到达后立即放行，并补充缓冲释放原因的诊断记录 -- OpenAI 额度刷新失败时提供更明确的错误提示，避免额度查询失败误改凭据状态，并保留并发凭据刷新产生的有效结果 +- HTTP Responses 请求省略 `stream` 时默认返回 JSON，修复调用方按普通 JSON 解析时收到 SSE 的问题；显式流式请求和 WebSocket 默认行为保持不变 +- OpenAI 上游连接池、TCP keepalive 和 HTTP/2 keepalive 设置与官方 Codex 默认行为对齐 +- 二进制部署自重启保留启动时解析的安装路径，修复更新替换可执行文件后重启路径失效的问题，并补充自重启配置示例 +- 调整账号列表的并发容量对齐和每日用量显示，改善额度摘要的布局 -## 体验优化 +## 插件与升级说明 -- 系统更新弹窗固定进度与日志区域，区分历史失败和当前任务错误，避免旧失败记录让当前安装状态显示异常 -- 概览静默刷新保留已有内容，客户端身份预设加载时保留表单布局，并统一 Key 用量页面的工具栏与刷新反馈 - -## 升级说明 - -- 本版未新增或修改数据库迁移，沿用 v3.16.0 的数据库结构；升级前请备份数据库并保留现有配置 -- 使用新增插件接口需升级宿主并授权对应能力；预算管理权限覆盖全部 Client Key，额度观测刷新不会重置上游额度，宿主不会自动联动账号额度与 Key 预算 -- 部署文档补充 Redis ACL 用户配置方式，以及 Compose 中 `CPR_REDIS_URL` 对配置文件的覆盖规则 +- 插件安装采用完整信任模型，不再以权限清单表达隔离；插件与网关使用相同系统身份，可访问数据、凭据、配置与网络，只安装可信来源 +- 当前插件合同为 `manifestVersion: 2`、进程协议 `2`、中间件能力 `3`。旧合同插件需使用匹配的 SDK 与 CLI 重新构建打包，不能仅修改版本字段；Workbench 可安装 [v0.2.0](https://github.com/zyycn/codex-proxy-plugins/releases/tag/v0.2.0) +- v3.17.0 内置更新器不支持本版的插件兼容声明，需使用完整平台发行包或更新容器镜像。二进制部署请成套替换程序、Web 资源和 `plugins/official` 目录；升级前停用不兼容插件，升级后安装兼容版本并检查配置 +- 新增数据库迁移 `0020_plugin_trust.sql`，清理插件制品元数据中的旧权限字段，保留包体、摘要、接受记录与实例配置；已发布迁移保持不变。升级前请备份数据库并保留现有配置 +- 依赖 HTTP Responses 默认 SSE 的调用方需显式传入 `stream: true` diff --git a/release/version.yaml b/release/version.yaml index f586daf80..b822e6e3b 100644 --- a/release/version.yaml +++ b/release/version.yaml @@ -1 +1 @@ -version: "3.17.0" +version: "3.18.0"