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