Skip to content

v3.18.0

Choose a tag to compare

@github-actions github-actions released this 29 Sep 16:30
· 397 commits to main since this release

新增功能

  • 插件中间件覆盖 HTTP、WebSocket 消息、公开服务、模型请求与单次上游尝试,支持按阶段配置启停、顺序和失败处理
  • 新增 OpenAI / xAI 受管上游适配器,插件可指定业务上游并解析结果,同时复用宿主的账号选择、重试和用量结算
  • 统一插件事件观察接口,分别订阅请求完成与用量、上游 WebSocket 事件;账号只读事实增加名称和邮箱

问题修复

  • HTTP Responses 请求省略 stream 时默认返回 JSON,修复调用方按普通 JSON 解析时收到 SSE 的问题;显式流式请求和 WebSocket 默认行为保持不变
  • OpenAI 上游连接池、TCP keepalive 和 HTTP/2 keepalive 设置与官方 Codex 默认行为对齐
  • 二进制部署自重启保留启动时解析的安装路径,修复更新替换可执行文件后重启路径失效的问题,并补充自重启配置示例
  • 调整账号列表的并发容量对齐和每日用量显示,改善额度摘要的布局

插件与升级说明

  • 插件安装采用完整信任模型,不再以权限清单表达隔离;插件与网关使用相同系统身份,可访问数据、凭据、配置与网络,只安装可信来源
  • 当前插件合同为 manifestVersion: 2、进程协议 2、中间件能力 3。旧合同插件需使用匹配的 SDK 与 CLI 重新构建打包,不能仅修改版本字段;Workbench 可安装 v0.2.0
  • v3.17.0 内置更新器不支持本版的插件兼容声明,需使用完整平台发行包或更新容器镜像。二进制部署请成套替换程序、Web 资源和 plugins/official 目录;升级前停用不兼容插件,升级后安装兼容版本并检查配置
  • 新增数据库迁移 0020_plugin_trust.sql,清理插件制品元数据中的旧权限字段,保留包体、摘要、接受记录与实例配置;已发布迁移保持不变。升级前请备份数据库并保留现有配置
  • 依赖 HTTP Responses 默认 SSE 的调用方需显式传入 stream: true

📥 安装

Docker 部署:

# 从 GitHub 容器镜像仓库拉取
docker pull ghcr.io/zyycn/codex-proxy-rs:3.18.0

请从本版本附件下载 compose.yaml 和 config.example.yaml。Compose 默认固定到本版本镜像;升级前请对比模板与已有配置。

手动下载:
请从下方附件中下载适合当前平台的归档包。

附件包含与当前宿主版本及提交绑定的 plugin-release-manifest.json,当前没有默认内置插件。
教学示例由独立的 codex-proxy-plugins 仓库维护和发布,不随宿主发行物分发。

发布归档提供 GitHub 构建产物证明。Docker 镜像附带软件物料清单(SBOM)、构建来源证明和 cosign 无密钥签名。

📚 文档

What's Changed

  • feat(plugin): include account name and email in data facts by @huhengbo in #313
  • chore(deps): bump the minor-and-patch group in /backend with 6 updates by @dependabot[bot] in #314
  • chore(deps): bump jsonschema from 0.56.0 to 0.57.0 in /backend by @dependabot[bot] in #315
  • chore(deps): bump node from 2d49d87 to 662933c in /deploy by @dependabot[bot] in #320
  • chore(deps): bump redis from 1.7.0 to 1.7.1 in /backend in the minor-and-patch group by @dependabot[bot] in #321
  • feat(plugin): add managed upstream adapters for built-in providers by @zyycn in #326

New Contributors

Full Changelog: v3.17.0...v3.18.0