codex-proxy-rs/release/notes.md

v3.29.3

修复与调整

• 修复 OpenAI 账号套餐额度耗尽后仍有可用点数却无法参与调度的问题；上游明确点数可用且无支出或工作区限制时，可保持或恢复账号可用，失败后的后台回读也支持恢复，本次失败请求不会自动重发
• 改进 OpenAI 额度重置后的恢复：本次耗尽后记录的窗口重置时间全部到期，且新查询明确允许使用时，可在展示用量仍为 100% 时恢复；耗尽账号在重置后等待 10 秒传播余量再由后台复核，前 5 分钟最小查询间隔为 30 秒，之后为 5 分钟，实际恢复时间仍受后台扫描与上游响应影响
• PostgreSQL 与 Redis 密码统一支持 16–128 字节，拒绝全空白和控制字符，兼容托管服务的密码策略；修复密码中的 %41、%25 等字面量百分号序列被错误解码、导致认证失败的问题
• OpenAI Responses WebSocket 转发保留 response.create 的原始字段顺序，并对齐 OAuth 授权请求的参数顺序
• WebSocket 握手不再默认请求专项计时，保留客户端显式设置；使用统计保留 API 开销与引擎耗时，移除四个细分引擎 TTFT 和 Token 间隔指标，请求速率计算口径不变

升级说明

• 使用统计、密钥用量 API 与插件观测合同不再提供四个细分耗时字段：upstreamEngineIapiTtftMs、upstreamEngineServiceTtftMs、upstreamEngineIapiTbtMs、upstreamEngineServiceTbtMs；插件 SDK 中对应的蛇形命名字段同步移除，依赖这些字段的自定义调用方和插件需适配
• 数据库与 Redis 的现有 48 位十六进制密码继续有效；配置与环境变量应填写原始密码，不要预先进行 URL 编码，密码仍须符合服务端策略

v3.29.2

修复与调整

• 修复仪表盘昨日对比不完整的问题，按部署时区独立读取昨日统计；今日没有请求或缓存命中率不可用时隐藏对应趋势箭头，并明确标注“较昨日”
• 统一使用统计与密钥用量的请求表格及成功、错误、全部筛选；密钥用量按请求最终结果展示，每次请求保留一条记录，错误与未完成请求保留已采集的 Token 和费用
• 使用统计的错误列表直接展示最终错误摘要，错误详情使用独立弹窗，集中展示请求上下文、错误定位、尝试链路和诊断数据；调整普通请求详情布局
• 账号并发明细改为固定高度滚动展示，移除分页操作；修复分页加载失败后的页码恢复，以及切换账号或查询条件时的异步状态问题
• 插件管理页续期会话时保留当前页面，重载或关闭时取消相关请求并释放资源；认证状态切换期间禁用退出操作
• 修正主题预览数据与验证状态文案，统一输入提示
• 发布流程在质量检查与镜像验证通过后公开版本，并防止较旧版本覆盖最新稳定版入口

升级说明

• /api/key-usage/records 新增 kind=all；kind=error 按最终请求结果返回失败和未完成请求，status 可返回 success、error、incomplete、cancelled、running 或 unknown，自定义调用方需适配
• 源码构建工具链更新为 Node.js 26.12.0 和 Rust 1.99.1

v3.29.1

修复与调整

• 账号并发明细使用与列表一致的账号标识，OAuth 账号优先显示邮箱，API Key 账号显示自定义名称，缺少邮箱时回退到账号 ID
• 代理批量测试期间禁用行内测试按钮，加载状态由批量测试按钮显示；单独测试某一行时保留加载反馈，批量测试结束后恢复行内按钮
• 重置卡自动使用的提前时间入口改用文本按钮，悬停显示背景，不再显示下划线
• 使用统计默认日期范围调整为今天

v3.29.0

新增与改进

• 账号支持自动使用即将到期的主动额度重置卡，按账号开启，默认关闭；全局可设置提前时间及剩余周额度上限，未决操作在重启后沿用原幂等键继续确认
• 点击账号并发数量可查看当前占用请求的密钥、模型、来源 IP、开始时间和占用时长，支持分页与自动刷新
• 代理管理支持批量添加、添加后测试和跨页选中测试，逐项展示处理结果及出口地区；请求位置设置支持检测服务器直连出口并填入草稿
• 每条代理可设置 OpenAI Responses 上游 WS 连接上限，关联账号共享预算；满额时优先回收普通空闲连接，无可回收连接时等待容量，在途及绑定下游 WS 的连接不参与容量淘汰
• 使用统计支持在最近 31 天内选择日期范围，默认展示最近 7 天；优化健康时间线浮层、表格状态展示和密钥用量页布局
• 插件请求回调支持统一的入口请求上下文，公开服务提供重置卡自动化控制；优化 RPC 编解码、配置校验和实例准备，能力响应解码失败仅影响当前调用

修复与调整

• /v1/images/edits 支持 multipart 图片上传，转换为原生 Images JSON；保留图片原始字节和请求参数，已有 JSON 请求与响应继续原样转发
• 独立 Search 选号遵守账号模型白名单与黑名单；请求模型缺失、重复或无法识别时仅使用模型政策为 all 的账号
• 修复 OpenAI 与 xAI 在同次请求换号耗尽时丢失原始上游错误的问题；OpenAI 后续请求因会话策略无可选账号时给出明确提示，xAI 按失败分类尝试允许的备用 Provider
• 修复重复运行安装脚本改写应用私有文件所有权、导致启动失败的问题
• 更新 ZIP 依赖，修复已知安全公告涉及的问题

升级说明

• 从 v3.28.0 升级时启动会执行 0033_proxy_and_reset_credits.sql，包含代理 WS 容量与重置卡自动化设置；已发布迁移保持原样，升级前请备份数据库。源码部署若已执行本轮旧的 0033～0035 迁移，需先核对迁移历史，不能直接套用该升级路径
• 插件 RPC 协议升级为 v4，旧插件需使用匹配的 SDK 与 CLI 重新构建、打包，不能仅修改版本字段。请求相关能力版本同步调整：frontend_authentication v2、scheduler v3、model_router v2、retry_policy v2、middleware v5、upstream_adapter v3、observer v2、management v2
• /api/admin/proxies/create 与 /api/admin/proxies/test 改为接收 1～100 项数组，单条操作也须传数组；批次通过校验后返回 HTTP 200，调用方须读取逐项 status 与失败项的 httpStatus，不得自动重试整批
• xAI 本地选号终态错误由 HTTP 502 调整为 503，现有错误类型与机器码保留；有原始上游失败可交付时继续保留上游结果
• 已有代理的 WS 上限默认不限制，预算仅覆盖单个 CPR 进程的原生 OpenAI Responses WS，不协调多实例或其他流量。重置卡自动使用需手动开启，默认提前 10 分钟且不限制剩余周额度；每日发现可能错过两次发现之间发放并到期的卡片