v2026.11.04

版本概览

• v2026.11.04 合并了经过兼容审查和完整验证的上游更新。
• 已完成工作树合并整合及累计审查，解决全部文本冲突并修复 Vertex 版本路径兼容问题；候选发布说明已补齐，交外层暂存和完整验证。

新增功能

• 渠道创建返回可关联的结果：本轮新增新建渠道 ID 和原始输入位置映射，支持单条、批量及多密钥合一；分块插入回填 ID，异常回滚后不再继续返回成功。
• 修复 2FA 锁定窗口：本轮修复锁定过期后的失败计数，首次失败重新从 1 开始；有效锁定期间不延长锁定时间，达到阈值后再次锁定。
• 新增 Gemini Argon 协议支持：本轮支持 continuationToken、mediaProcessing 及请求蛇形别名；CONTINUATION 映射为 length，Argon 接入 thinkingLevel 和预算映射。
• Vertex 支持按渠道选择 API 版本：本轮增加按渠道选择 v1beta1 的开关，默认仍为 v1，服务端校验版本，前端保存和重载设置；Claude 与任务插件端点保持原行为。
• Gemini 嵌入采用上游用量：本轮优先使用上游 usageMetadata 的正数输入 Token 和模态明细；缺失、空值或非正数继续本地估算，兼容响应同步展示用量。
• 累计 Gemini Omni 视频与 Token 计费：累计未发布更新新增两个 Omni 预览模型及 global Interactions 视频任务；支持输入、文本输出和视频输出 Token 定价，完成时读取上游用量，保留旧表达式和倍率兼容。
• 累计 HTTP/2 连接健康检查：累计未发布更新增加默认关闭的 HTTP/2 PING 健康检查；关闭未应答连接，正常应答的慢请求继续等待，与客户端 SSE 心跳独立。
• 累计 JSON 与媒体处理改造：累计未发布更新使用 moego 进行 JSON 查询、局部编辑和 Base64 处理，减少重复复制；保留字段顺序、重复键过滤、参数覆盖操作及错误处理，替换 relaykit 的直接 gjson/sjson 依赖。
• 累计 xAI 流式用量明细修复：累计未发布更新保留输入缓存和输出推理等 Token 明细；输出总量仍按总量减输入计算，不重复累加推理量。

功能改进

• 接口：渠道创建成功响应新增 ids、results 和条件性 id，映射保留原始输入下标且不返回凭证；失败响应不返回创建结果。OpenAPI 已同步。
• 计费：Gemini 嵌入优先采用有效上游输入用量；累计 Omni 支持 Token 用量结算，xAI 保留缓存和推理明细。已有管理员价格及兼容计费路径保留。
• 前端与国际化：渠道编辑新增受权限约束的 Vertex 版本开关，覆盖七种语言。累计发票复制配置和智能监控排序、卡片布局更新一并进入候选。
• 认证：2FA 锁定过期后允许重新开始失败计数窗口，避免一次错误立即再次锁定；有效锁定与阈值控制继续执行。
• 数据与兼容性：累计未新增表结构或迁移，未升级 GORM 和数据库驱动。渠道设置及发票偏好使用既有存储；批量插入 ID 回填和 2FA 条件更新交由外层真实 SQLite、MySQL、PostgreSQL 验证。relaykit 保持模块独立。
• 配置与部署：累计新增 HTTP/2 健康检查环境变量，默认关闭；部署和发布工作流未改变。候选发布说明已写入 .github/release-notes/upstream-sync-ba5f7367.md，并保留全部已确认限制。

问题修复

• 渠道管理：管理员创建渠道后可直接获取新建 ID 与原始输入映射，现有缓存刷新、权限和审计继续生效。
• Gemini 与 Vertex：Vertex 默认使用 v1，可切换至 v1beta1；已有带版本的代理地址正确替换版本段。Argon 新字段得到保留，CONTINUATION 转换为 length。
• 用量结算：嵌入请求优先按上游有效用量结算，缺失或非正数用量保持原估算；Omni 新 Token 定价与已有旧表达式并存。
• 日志与认证：用户继续看到完整 stream_status；其他管理员诊断信息仍受原权限控制。2FA 锁定期满后重新计数，达到阈值再次锁定。
• 累计管理界面更新：管理员可配置发票复制字段、查看全部申请并调整智能监控分组顺序；普通用户的申请数据范围不扩大。

移除与调整

• controller/channel.go：保留本项目声明方式并增加 inputIndices，整合渠道 ID 返回逻辑，保留创建后的缓存刷新、能力写入、审计及权限检查。
• web/src/features/channels/types.ts：加入上游 ChannelOtherSettings 类型及 vertex_api_version，同时保留本项目路由状态、HTTP 协议、连接分片和 TLS 类型。
• web/src/i18n/locales/en.json、web/src/i18n/locales/fr.json、web/src/i18n/locales/ja.json、web/src/i18n/locales/ru.json、web/src/i18n/locales/vi.json、web/src/i18n/locales/zh-TW.json、web/src/i18n/locales/zh.json：通过脚本合并双方键并执行 i18n 同步；逐键核对，各语言原有 8512 个键值全部保留，上游 3 个新键全部加入。
• relay/channel/vertex/adaptor.go、relay/channel/vertex/adaptor_api_key_url_test.go：显式版本选择替换末尾已有版本段，保留代理路径前缀；未配置新选项及非 Google 模型继续原逻辑。补充版本切换、代理路径和服务账号回归用例。
• 已知限制：DeepSeek 固定工作日峰谷价格不识别中国法定节假日，管理员可按实际价格政策配置覆盖。
• 已知限制：大型日志表建立联合索引可能产生耗时、资源消耗与锁竞争，升级时需安排合适的迁移窗口。
• 已知限制：缓存用量仅从升级后开始记录，历史数据不回填；跨升级时间范围的缓存统计不代表完整历史用量，界面保留相应提示。
• 已知限制：旧面板令牌在首次迁移后的三十天窗口结束后失效，这是上游迁移设计；需迁移至 PAT，重启不会重置退役期限。
• 已知限制：Responses custom tool 经 Chat function 转换后，grammar 保留为描述提示，不能保证原协议的语法强约束。
• 已知限制：Sobek 切换到 moejs 后，第三方插件仍可能需要适配；本轮未改变该运行时迁移影响。
• 已知限制：Gemini Omni 仅支持直连 Vertex AI 的 global Interactions 接口，不支持经 type-60 New API 网关转发；Veo 的网关转发能力保留。

自上次正式发布以来的累计提交

• eafcaae feat: improve intelligence result ordering and card layouts
• 049a1e2 merge: synchronize upstream 45746ee
• 7ac1d65 merge: synchronize upstream 70e6af6
• 14735e7 feat: 支持开票复制字段设置和管理员查看全部申请

本次候选包含上述已合并但尚未正式发布的更新，以及本报告审查的新增变更。