codex-proxy-rs/release/notes.md

v3.21.2

修复与改进

• 修复 OpenAI 严格亲和下，子线程或独立记忆整理任务因会话尚未绑定账号而等待超时的问题：任何有可靠会话身份的请求均可按调度策略原子首绑，并发首请求最终共用同一绑定；已有绑定的子线程仍跟随当前账号，迁移权限保持不变
• xAI 模型目录对齐当前 CLI proxy 的模型、推理档位及上下文窗口字段；推理档位按请求保留，不再根据旧模型名称降档或删除，缺失能力与默认值保持未知
• 修复 xAI 托管搜索工具与客户端函数同名时的调用及跨轮重放映射，支持 web_search.filters.excluded_domains，校验允许与排除域名列表不能同时非空
• xAI 额度判断采用当前账单字段，保留预付余额的原始符号，不再凭过期快照或旧字段恢复账号；上游报告零费用时视为费用未提供，只有具备完整计价依据时才使用本地估算
• 修复备份取消或失败时的导出进程、分片上传与暂存文件清理，恢复已完成上传的任务后及时清理本地归档，并记录清理失败
• 修复服务关闭时请求排空与后台写入的先后顺序，以及 WebSocket 关闭握手可能被未完成写入阻塞的问题
• 修复 Key 预算重置后，应用与数据库时钟差异可能使未开启窗口被误判为活跃窗口的问题
• 账号状态读取改为有界分批并复用查询结果，避免账号池规模直接形成 Redis 并发峰值；完善 OpenAI 重置卡消费的账号锁回收，保持取消后的同账号串行约束

升级事项

• 从 v3.21.1 升级无需新增数据库迁移或调整亲和配置；严格亲和不再要求根线程必须先发请求才能建立会话绑定
• xAI 请求保留路由选定的完整模型名，不再自动解释 grok、grok-latest 等旧别名或剥离模型前缀；依赖这些名称的配置应使用显式模型映射
• xAI 搜索域名白名单应放在 web_search.filters.allowed_domains，旧顶层 allowed_domains 返回请求错误；推理档位未知或类型错误时也会明确返回字段错误
• 内建 xAI 适配器对 generate=false 预热返回 400 unsupported_prewarm，避免误发生成请求；客户端应跳过该预热并继续正式请求