chore(release): v3.12.0

Co-authored-by: Codex <noreply@openai.com>

release/notes.md

@@ -1,30 +1,27 @@
-# v3.11.0
+# v3.12.0
 
 ## 新增功能
 
-- 新增模型定价管理，支持自定义单价、倍率和手动同步来源价目，可预览差异并勾选需要同步的模型。支持清除人工覆盖、删除非内置模型价格，内置价格仅允许覆盖。价格按请求保存快照，后续改价不重算历史费用
-- 支持在管理端配置 OpenAI 客户端身份，选择 CLI 或 Desktop 预设、跟随最新版本或自定义版本，API 密钥可单独覆盖通用配置
-- 支持在「系统设置 → 安全与访问」修改管理员密码，验证当前密码后保存，已登录的管理员需使用新密码重新登录
-- API 密钥支持手动清零日额度、7 日额度或全部已用金额，原重置时间保持不变
+- OpenAI 与 xAI 客户端身份统一在「系统设置 → 上游配置」管理。xAI 支持跟随最新 Grok CLI 版本或固定版本、预览请求身份，并可为 API 密钥单独设置覆盖
+- 密钥使用统计页新增「密钥配置」，持有者登录后可复制当前密钥的 Codex 配置，选择是否启用 WebSocket，或唤起 CCSwitch 导入；管理员密钥页复用同一配置弹窗
+- 表格列支持拖动排序和方向键调整，列顺序与显隐偏好保存在当前浏览器，可一键恢复默认设置
+- 管理端用量及错误记录显示关联密钥的当前名称；费用明细新增「长上下文」标识，按请求实际采用的价格区间记录，不按当前价格倒推历史标识
 
 ## 问题修复
 
-- 自定义 OpenAI 中转缺少额度、订阅资料或额度重置接口并返回 404 时，账号辅助请求会尝试官方端点，继续沿用账号的出站代理设置，不改变推理请求地址
-- 最终返回的 `server_is_overloaded`、`slow_down` 按客户端可重试的 `server_error` / 503 交付，同时保留内部错误分类。提高明确容量拒绝对 Smart 调度的惩罚权重，普通错误、时间衰减与会话亲和规则保持不变
-- 修复取消后的 OpenAI 文件读取在服务关闭期间仍继续等待的问题
-- 修复表格列显示或隐藏后横向滚动状态未及时更新的问题，缩小使用统计中模型与推理强度的间距
-- 更新说明使用独立 Markdown 样式区域，修复列表圆点缺失并避免与页面样式互相影响
+- OpenAI 可选账号全部额度耗尽时，HTTP 与 WebSocket 返回 `429 / usage_limit_reached`，让 Codex 客户端停止本轮自动重试；其他可用 Provider 和可安全恢复的续写仍按原有规则尝试恢复
+- 修复 OpenAI 额度窗口到期后仍显示旧用量的问题：有用量的正常账号也会在重置时间两分钟后主动复核，已耗尽账号继续周期复核以发现上游提前重置；仅在取得上游结果后更新额度状态
+- Responses 输入中显式指定 `type: "message"`、`role: "system"` 的消息会转换为 Codex 接受的 `developer`，保留消息内容、顺序和其他字段，HTTP/SSE 与 WebSocket 使用一致规则
+- 修复在线更新的发行通道筛选：正式版只接收同一大版本内更新的正式版，alpha、beta、rc 仅在同一目标版本内向前晋级，exp 仅接收同一轮实验的后续编号；不支持更新的构建不再显示可用更新，检查失败单独提示
+- 更新 OpenAI TLS 依赖和握手基线，与 Codex Desktop 26.915 所用版本对齐
 
 ## 体验优化
 
-- 系统设置重新归类为「网关调度 / 上游配置 / 模型定价 / 安全与访问 / 数据备份」，按需加载对应内容，模型映射归入上游配置
-- Fast 模式统一由密钥绑定分组控制，移除重复的全局开关，分组使用「默认 / 关闭」分段选择
-- 简化客户端身份配置，自定义版本集中展示可编辑参数，加载时使用骨架屏稳定布局
-- 统一密钥与代理名称展示，优化额度重置、价格同步和批量清除弹窗，精简提示文案与操作按钮
+- 改善浅色主题中表格、输入框与按钮的层次和对比度，统一悬停及焦点反馈，优化表格行过渡和列拖动高亮
+- 调整密钥额度、账号用量、使用统计与备注的布局和文字层级，精简周额度标签
 
 ## 升级说明
 
-- 从 v3.10.0 升级会自动执行新增迁移 `0016`，加入客户端身份与模型定价字段，并删除全局 Fast 字段。已发布的 `0001`～`0015` 保持不变，账号、分组及历史使用记录保留。升级前请停止旧应用并备份数据库，迁移后不要直接运行旧二进制，回退需恢复备份
-- 若原先启用了全局 Fast 禁用，请在升级前将需要限制的分组设为「关闭」，并为未分组密钥绑定相应分组。外部运行设置请求移除 `disableFast` 字段，分组接口仍保留该字段
-- 本次合并了尚未正式发布的迁移。曾直接运行旧 `main` 并执行原 `0016`～`0018` 的源码部署实例，需要先备份并核对数据库结构与迁移记录，不能直接套用正式版升级路径；从 v3.10.0 正式版升级不受此影响
-- 升级后管理员需重新登录一次，API 密钥身份会话不受影响。模型价格用于本地费用估算和额度控制，不代表上游实际扣费
+- 从 v3.11.0 升级不新增数据库迁移，已发布的 `0001`～`0016` SQL 及冻结清单保持不变
+- 如需保留 OpenAI 数据驻留约束，请在启动新版本前将 `openai.wire_profile.residency` 移到 `openai.residency`。旧 `openai.wire_profile` 和 `xai.wire_profile` 不再读取；数据库中已有的 OpenAI 身份保留，原先在 YAML 中定制的 xAI 身份需在管理端重新设置，未设置时使用内置 Linux x86_64 身份并跟随最新版本
+- 旧环境变量 `CPR_UPDATE_CHANNEL` 不再参与版本选择，可移除；升级后的发行通道由当前版本号决定。实验版切换正式版仍需使用独立数据库迁移业务数据，不能直接复用实验数据库

release/version.yaml

@@ -1 +1 @@
-version: "3.11.0"
+version: "3.12.0"