codex-proxy-rs/release/notes.md

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 分钟且不限制剩余周额度；每日发现可能错过两次发现之间发放并到期的卡片