seewe/sub2api
1
0
Fork 0
mirror of https://github.com/Wei-Shaw/sub2api.git synced 2026-10-14 03:52:26 +08:00
Code Issues Packages Projects Releases Wiki Activity
7,647 Commits 43 Branches 62 Tags
main
Commit Graph
71 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
feeeei 43a3c197cb fix(gemini): 显式缓存恢复流程区分账号已删除与暂不支持缓存，上游必已过期后作废意图 
后台回滚在持有账号返回 nil 时把修改意图当作已回滚清除：账号临时关闭显式缓存能力后
意图丢失，重新开启也无法补偿。

- boundAccount 区分两种情形：账号已删除返回 nil，账号存在但不支持显式缓存返回
  errGeminiCachedContentAccountUnsupported；BoundAccount 对外行为不变
- 账号暂不支持缓存时不改动上游、保留意图，租约过期后重试（期间同一缓存的修改返回 409）；
  账号已删除时没有凭据可回滚上游，软删本地记录
- 修改前到期时间加上单次最长有效期与 1 小时容忍都已过去时上游缓存必已自行过期：
  账号不支持缓存或上游回滚持续失败的意图不再重试，直接作废本地记录
- 测试夹具 GetForOwner 过滤已软删记录
 2026-10-13 00:54:27 +08:00
feeeei 2023c290e1 fix(account): 计数、Bedrock 与重试耗尽入口把上游模型交给错误处理 
OpenAI 与 Anthropic 的 count_tokens / input_tokens 入口、Bedrock 故障转移入口
以及 OAuth 403 重试耗尽入口调 HandleUpstreamError 时没有传入实际发往上游的模型，
显式 scope=model 的 401 规则在这些入口看到空模型，仍落到 handleAuthError 整号置 error。

- 四处计数入口传入映射后的上游模型；Anthropic 透传计数函数新增 upstreamModel 参数
- handleRetryExhaustedSideEffects / handleRetryExhaustedError 增加模型变参，
  Forward、Anthropic 透传与 Bedrock 三处调用方传入实际模型
- Bedrock 入口传调度器的模型键（account.GetMappedModel），不是发往上游的
  Bedrock 模型 ID，模型级冷却才会被调度器读取
- 这些入口的 404 模型未找到与缺省 scope 的非 401 规则随之按主转发路径语义处理
  （模型已知走模型级）
 2026-10-13 00:53:39 +08:00
feeeei 8b74741efe fix(groups): 广场 Vary 保留 Origin，分组译文语言代码统一大小写 
- 模型广场以追加方式写入 Vary: Accept-Language，保留 CORS 中间件为具体来源
  写入的 Vary: Origin
- 管理端写入分组译文时语言代码统一为 BCP 47 惯用大小写（en、zh-TW），
  统一后重复的语言代码（如 en 与 EN）返回 400 INVALID_GROUP_I18N
- 用户侧按语言取译文时规范写法的键优先，仅大小写不同的多个键按字节序取最小者，
  同一请求语言的结果固定
 2026-10-12 18:09:03 +08:00
feeeei fc82e83102 fix(account): 显式模型级 401 规则在网关故障转移入口生效 
OpenAI 转发 fastpath、HandleUpstreamError 及两处池模式分支对 401 一律跳过
临时不可调度规则，显式 scope=model 的 401 规则在 API Key 账号上仍落到
handleAuthError 整号置 error。

- 新增 tempUnschedRulesApply：401 仅在首条命中规则按模型级生效时交给规则，
  其余保持认证错误处理
- 凭据级 401（OAuth 账号与 Spark 影子、OpenAI token_invalidated/token_revoked、
  {"detail":"Unauthorized"}）不受规则作用范围影响，各入口沿用原有处理
- 模型级命中不参与重复 401 升级；fastpath 不再因模型级命中封整号
 2026-10-12 17:39:26 +08:00
feeeei 26b31a83e4 fix(gemini): 显式缓存修改串行化、失败回滚，确定金额费用按 Key / 订阅预留 
同一缓存的并发 PATCH 可能以与上游提交不同的顺序写回本地到期时间；
确定金额的存储费只预留用户余额，并发续期可越过 API Key 总额度与订阅额度；
上游已修改而本地写回失败时没有可恢复的状态。

- 新增迁移 245：缓存记录增加修改意图（mutation_token / mutation_lease_until）。
  PATCH 在调用上游前登记意图并取得 2 分钟租约，条件为没有进行中的修改且到期时间
  未变；上游修改、本地写回与计费均由持有者完成，并发的修改返回 409 ABORTED
- 上游结果未知、本地写回失败或进程退出时修改意图保留且不计费；租约过期后由下一次
  修改或后台每分钟的恢复流程把上游有效期回滚到修改前的到期时间（已到期则删除上游
  缓存与本地记录）。上游明确拒绝或请求未发出时直接清除意图
- 修改 / 删除上游缓存的单次调用超时改为 30 秒；请求发出前的失败包装为
  ErrGeminiCachedContentRequestNotSent
- CheckChargeAffordable 与 ReserveInflightCharge 合并为 ReserveFixedCharge：在途预留
  新增订阅、API Key 两个维度（Redis billing:inflight_scope:*），先登记本笔预留再读取
  库中权威用量（Key quota_used 与限速窗口、订阅日 / 周 / 月用量）叠加同维度在途合计
  校验；预留随计费任务交接，落库后释放
- GetRateLimitData 一并读取 quota_used
 2026-10-12 17:14:56 +08:00
feeeei daebb7a80c fix(gemini): 模型列表与模型详情接口支持 Agent Platform (Vertex) 账号 
Gemini 分组对外提供 AI Studio 兼容协议，分组内账号不一定是 AI Studio。
分组只剩 Vertex 服务账号时，GET /v1beta/models 与 /v1beta/models/{model}
选中服务账号后报 502 unsupported account type: service_account。

- SelectAccountForAIStudioEndpoints 改名 SelectAccountForModelsEndpoints，
  Vertex 账号排在所有 AI Studio 兼容账号之后参与选号
- ForwardAIStudioGET 拆为 ForwardListModels / ForwardGetModel，按账号类型分流：
  AI Studio 兼容账号原样转发；Vertex 服务账号读取 Google 发布方模型列表并
  转换为 AI Studio 格式，模型详情在该模型所用区域的列表中查找；Vertex API Key
  账号返回内置列表
- Vertex 发布方模型分页读取抽成 listVertexGeminiPublisherModels，与后台
  同步上游模型共用
- 模型接口响应体上限改用 gateway.models_list_read_max_bytes，超出时报错
 2026-10-11 22:03:36 +08:00
feeeei 4426593e9d fix(gemini): 3.6 Flash 兜底价改为官方优惠价 
- 内置兜底价与本地价格表快照的 gemini-3.6-flash 改为 $0.75 输入 / $3.75 输出 /
  $0.075 缓存读取（Priority 档 $1.35 / $6.75 / $0.135），有效期至 2026-12-31，
  2027-01-01 起恢复 $1.50 / $7.50 / $0.15，与 3.7 / 3.8 Flash 及远程价格目录一致
 2026-10-11 11:22:48 +08:00
feeeei f0ee427f0a feat(gemini): 显式缓存存储价内置官方价并按 Pro / Flash 系列兜底 
- 新增 Gemini 显式缓存存储单价表（Standard 档，USD / token / 小时）：
  Pro 全系 $4.50、Flash 与 Flash-Lite 全系 $1.00；3.6 / 3.7 / 3.8 Flash
  为优惠价 $0.50（有效期至 2026-12-31，2027-01-01 起恢复 $1.00），
  AI Studio 与 Vertex 统一按优惠价计
- 型号表未命中的 Gemini 模型按系列兜底：Pro 取 $4.50，Flash / Flash-Lite
  取标准价 $1.00；Flash-Lite 变体不落到同版本 Flash 的优惠价
- 取值优先级：价格表（override_file 等）配置值 > 内置型号价 > 内置系列价；
  两者都没有的模型仍拒绝创建缓存
 2026-10-11 11:22:43 +08:00
feeeei 05d7946af8 fix(gemini): 显式缓存错误透传收窄到上游网关账号，延长沿用创建时计费口径 
- 绑定缓存的请求与缓存管理接口收到 429 / 5xx 时，只有上游网关账号的响应原样回写
  （UpstreamFailoverError.BoundUpstreamPassthrough / GeminiCachedContentUpstreamError.UpstreamGateway），
  官方账号仍走错误透传规则与通用映射，不向客户端暴露配额明细
- 记录新增 channel_usage（迁移 244）保存创建时的渠道计费口径，PATCH 延长按同一口径预检、报价与记账
- 创建 / 延长费用行的 request_id 改为固定前缀 gcache:{create|patch}:{id}，不被客户端或网关请求 id 覆盖，
  按缓存 ID 即可检索一个缓存的全部费用行
- 调度快照凭据投影补齐 base_url / auth_mode / 上游显式缓存声明，显式缓存候选过滤一次算全，
  不再逐个选号后剔除
 2026-10-11 01:37:04 +08:00
feeeei c9e4b267b6 fix(account): 同步上游模型失败时显示后端返回的错误原因 
- apiClient 拒绝的是普通对象而非 Error，原写法 instanceof Error 恒为假，
  错误提示被替换成通用文案"同步上游模型失败：同步上游模型失败"
- 白名单选择器与 Antigravity 同步按钮改用 extractApiErrorMessage 取消息
 2026-10-10 23:37:48 +08:00
feeeei 6f9b02f12c feat(gemini): Vertex 服务账号支持同步上游模型列表 
- Gemini 平台 Service Account 账号改用 v1beta1 publishers/google/models
  分页拉取模型（pageSize 300，最多 20 页），按账号默认区域选端点；
  只保留 publishers/google/models/gemini-* 条目，排除区域端点里的
  Gemma、Veo、AutoML 等模型花园条目
- 凭据缺失或 location 非法返回配置错误（400），且不发起 token 交换；
  API Key 认证的 Vertex 账号返回不支持
- 翻页途中的 404/405 不再触发配置模型回退
- 模型列表的请求、读体与状态码检查抽成 readUpstreamModelsResponse
  供各平台共用
 2026-10-10 23:37:48 +08:00
feeeei 1c68f9996d feat(gemini): 适配 AI Studio AQ. 格式 Key 
- AI Studio 新建 Key 为 AQ.Ab 前缀的 auth key：logredact.RedactText 与
  渠道监控 sanitizeErrorMessage 增加 AQ.Ab 规则，长度按 40 位以上放宽以覆盖格式变体
- 创建 / 编辑账号的 Key 占位符改为 AQ.Ab...，提示文案说明新旧两种前缀
  与第三方上游 Key
 2026-10-10 23:37:48 +08:00
feeeei 2588675ce7 fix(gemini): 第三方上游 API Key 与 Vertex 不再套用 AI Studio 等级和模拟配额 
- 按 base_url 判定上游：非官方地址的 Gemini API Key 账号视为第三方上游
- 第三方上游与 Vertex 不返回本地模拟配额，隐藏等级与配额说明；
  账号列表中第三方上游按普通 Key 账号展示今日统计与额度进度条，
  Vertex 显示 vertex 徽章与今日统计
- 第三方上游的 429 只认显式重试时长，否则走全局 429 兜底冷却，
  不按每日配额冷却到 PST 午夜
- 创建账号：第三方 Base URL 不显示 AI Studio 等级选项，也不写入 tier_id；
  API 密钥卡片标题与说明不再限定 AI Studio，免费层说明只在官方 Base URL 下显示；
  OAuth 等级回退下拉只在 OAuth 表单显示
 2026-10-10 23:37:48 +08:00
feeeei 81e6ec5346 feat(gemini): Vertex 账号支持 API Key 认证 
- Gemini 平台的 Vertex 账号新增 API Key 认证（credentials.auth_mode=apikey），
  不填 Project ID 走全局端点，填写后走项目级端点，Key 通过 x-goog-api-key 传递；
  Anthropic 平台的 Vertex 账号仍只支持 Service Account JSON
- 转发（Claude 兼容 / 原生 / Chat Completions）与测试连接统一走
  buildVertexGeminiAccountURL / setVertexGeminiAuth
- API Key 账号不参与显式缓存（Vertex 缓存接口不接受 API Key）与批量生图
- 创建弹窗新增认证方式选择；编辑弹窗支持轮换 Key 与修改 Project ID，
  Key 留空表示保留
 2026-10-10 23:37:48 +08:00
feeeei 64331a9792 ui(gemini): Vertex 显示名改为 Agent Platform (Vertex) 
Google 已将 Vertex AI 更名为 Gemini Enterprise Agent Platform。
账号类型按钮、平台徽章、Vertex 相关提示、配额文档链接与批量生图报错文案
统一显示为 Agent Platform (Vertex)；创建账号弹窗的 Vertex 按钮改用 i18n 文案。
 2026-10-10 23:37:48 +08:00
feeeei 3abd646582 fix(ops): Gemini 原生路由的网关本地错误按错误类型归类 
Google 格式错误体没有 type 字段，ops 一律记为 api_error，客户端参数错误、
引用不存在的缓存等都被归为平台内部错误。

- googleError 写出时按状态码向 ops 登记错误类型：400/413 invalid_request_error、
  401 authentication_error、403 permission_error、404 not_found_error，
  429 与 5xx 不登记
- 计费、并发与风控拦截沿用 Claude / OpenAI 格式错误的类型与错误码，归类口径一致
- 存储价未配置、显式缓存未启用改用 googlePlatformError，仍按平台错误统计；
  错误透传规则改写的上游错误不登记本地类型
- 上游返回的缓存不存在标记为请求级失败：按客户端请求错误分类，
  上游原始错误保留为明细但不参与上游归因
 2026-10-10 23:37:48 +08:00
feeeei d5a802f84a feat(gemini): 支持显式上下文缓存（AI Studio / Vertex / 自建网关上游） 
新增 /v1beta/cachedContents 的创建、列表、查询、更新有效期与删除接口。
参与账号：官方地址的 AI Studio API Key 账号、Vertex service account 账号，
以及开启"上游支持显式缓存"的自定义地址 API Key 账号。

- 网关自发缓存 ID，绑定上游资源名、持有账号与创建它的 API Key
  （迁移 243 gemini_cached_contents）；list/get 只读本地记录
- 引用缓存的 generateContent / streamGenerateContent / countTokens
  改写为上游资源名，只发往持有缓存的账号，不参与会话粘性、不换号；
  拒绝重复键与 snake_case 写法；在持有账号上重试耗尽后，
  上游 429 / 5xx 原样透传，401 / 403 映射为 502
- 计费：创建时一次性收取缓存 token 输入费与整个有效期的存储费；
  延长按库中实际推进的时长收费，纯存储费不算一次请求；缩短与删除不退费
- 存储单价随计费模型取价，来自定价覆盖文件字段
  cache_storage_cost_per_token_per_hour，未配置的模型拒绝创建；
  存储费同时计入账号统计成本，渠道按 token 重算成本时叠加且不重复计入
- 扣费前校验：创建在上游建成后按确定金额校验余额 / 订阅额度 /
  API Key 额度并登记不封顶的在途预留，不足时删除上游缓存、只收输入费；
  延长在调用上游前按增量时长校验
- 有效期上限 gateway.gemini_cached_content_max_ttl_seconds，默认 86400，
  有效期向上取整到秒；创建请求保留数字原文、兼容 snake_case 元数据字段
- 上游调用与落库同客户端连接脱钩；2xx 不可用响应不换号并删除已建缓存
- 缓存不存在：AI Studio 的 403、Vertex 生成请求的 400 与缓存资源接口的
  404 统一识别；原生转发（含流式）不重试、不换号、不改账号状态，
  向客户端返回标准 403，不暴露上游缓存资源 ID，上游原始错误登记到 ops；
  PATCH 遇上游 404 移除本地记录并返回 403，DELETE 视为成功
- 自建网关上游：账号开关 explicit_cache_upstream，缓存接口发往账号自身
  base_url；可选 explicit_cache_upstream_max_ttl_seconds 对齐上游 TTL 上限，
  显式 TTL 超限时创建跳过该账号（全部超限返回 400），未显式时按上限创建，
  PATCH 取本站与账号上限的较小值；绑定缓存的请求在网关账号上收到
  429 / 5xx 时不重试、不限流该账号；前端创建 / 编辑账号弹窗新增开关与上限输入框
- 用量与 ops 端点统计：带缓存 ID 的路径归一化为 /v1beta/cachedContents，
  缓存操作的上游端点记为 /v1beta/cachedContents
 2026-10-10 23:37:47 +08:00
feeeei 3bfd40f5af fix(gemini): 引用缓存不存在的 403 不再停用账号并换号 
上游对不存在、已过期、已删除或不属于当前项目的 cachedContent 一律返回
403 "CachedContent not found (or permission denied)"。原生转发路径在错误
策略之前识别该响应,原样返回客户端,不标记账号错误、不临时停调度、
不重试、不换号;其余 403 处理不变。
 2026-10-10 23:36:17 +08:00
feeeei 9a51333101 feat(groups): 分组名称与描述支持多语言 
- groups 新增 i18n JSONB 列（迁移 242）：语言代码 -> {name, description}，只存译文；
  name/description 原列语义不变，仍用于唯一性校验、搜索与各类日志
- 用户侧接口由后端按请求语言输出：取 Accept-Language 中权重最高的一项，先按完整
  语言代码、再按主语言匹配；该语言有译文的字段换成译文，否则保持原字段，且不再带出
  译文表。覆盖密钥、可用分组、订阅（含进度与汇总）、兑换、使用记录、可用渠道、
  模型广场、套餐列表
- 管理端接口一律返回原字段；分组管理接口额外带 i18n 供编辑
- 创建/编辑分组：名称、描述的标题行右侧新增语言下拉，同一个输入框在默认内容与各语言
  版本之间切换；语种跟随前端 availableLocales
- 管理端写入：创建/更新接受 i18n（更新时缺省不修改，传入则整体替换），校验语言代码
  形态与名称长度并丢弃空译文；简易模式同样放行；复制分组只带走描述译文
- 切换界面语言后整页刷新，让已加载的数据换成新语言；模型广场响应加
  Vary: Accept-Language
- 网关路径，以及只带 group_name 字符串的统计、错误记录出口不做本地化
 2026-10-09 11:39:18 +08:00
feeeei a46249aac5 test(account): 补充临时不可调度作用范围单元测试 
- 后端:scope 解析归一化、缺省/显式账号级/显式模型级/模型未知兜底的分流判定,
  以及显式账号级、显式模型级 401、模型未知三种命中的落库位置与状态 JSON
- 前端:未设置 scope 的存量规则按 401 账号级、其余模型级回显并原样保存,
  显式 scope 回显与切换后提交,新增规则默认模型级
 2026-10-03 12:08:05 +08:00
feeeei 5a25507dcb feat(account): 临时不可调度规则新增作用范围 scope 选项 
- 规则新增 scope 字段:account 命中后暂停整个账号,model 只冷却本次请求的模型;
  字段缺省时保持现有语义(模型已知且非 401 走模型级,否则账号级),显式取值由运营人员决定,401 也不例外
- 模型未知的路径按账号级兜底;状态 JSON 记录 scope/model 便于排查
- 创建/编辑账号弹窗的规则编辑器新增作用范围单选卡片,新规则默认模型级;
  未设置 scope 的存量规则按后端缺省语义回显(401 账号级、其余模型级),打开再保存不改变行为
 2026-10-03 12:08:05 +08:00
feeeei 1aa34d478d feat(payment): 充值优惠阶梯支持折扣模式，快捷金额角标改为促销价签 
- 新增全局模式开关 RECHARGE_BONUS_MODE（bonus / discount），接入支付配置、后台设置接口与 checkout-info
- 折扣模式：到账不变，实付基数按百分比打折（按币种精度取整），手续费 / 每日限额 / 渠道选实例沿用折后基数；
  百分比须 < 100，运行时 ≥ 100 按无优惠处理
- 充值页角标改为单行红色价签（赠金「+20%」/ 折扣「20% OFF」），第二行按模式显示到账或折后实付；
  摘要卡折扣模式显示优惠行，渠道限额校验改用折后实付
- 后台「充值优惠阶梯」拆为独立卡片：赠金 / 折扣切换、紧凑档位表格、区间预览、活动文案
- 补前后端单测与 zh/en 文案
 2026-10-02 00:25:41 +08:00
feeeei 1b1039f4fd feat(payment): 充值赠送阶梯（按金额档位额外赠送到账额度） 
- 后台支付设置新增「充值赠送阶梯」（满 X 送 Y%，RECHARGE_BONUS_TIERS）与 Markdown 活动文案
  （RECHARGE_BONUS_NOTICE）：阈值按用户输入的支付金额命中（取不超过金额的最大档），
  赠送按到账基数（输入 × 充值倍率）计算；严格校验写入、宽松解析读取，订阅订单不参与
- 下单时按当时配置计算赠送并落库：payment_orders 新增 bonus_amount 列（迁移 241），
  amount 仍为到账总额，到账/兑换码/退款逻辑不变；推广返利基数改为 amount - bonus_amount
- checkout-info 下发 recharge_bonus_tiers / recharge_bonus_notice；创建订单与订单查询响应带 bonus_amount
- 充值页：快捷金额按钮右上角「+N%」角标 + 第二行到账金额，金额卡顶部渲染活动文案，
  订单摘要新增赠送额度行并在有赠送时始终显示到账余额；订单列表/详情/支付结果/成功面板显示含赠送
- 后台新增 RechargeBonusTierEditor（行内校验重复/非法阈值，自动排序并显示区间预览）
- 补后端单测、契约测试与前端 vitest，zh/en 文案
 2026-10-02 00:25:41 +08:00
feeeei f4f8ff04db fix(gateway): 客户端断开统一标记 499,不再被记成 502/200 上游错误 
客户端在响应提交前断开时,只有排队/换号阶段和 OpenAI 的兜底写入会标 499。
Claude 非流式与 Gemini 的 Chat Completions / Messages / Responses 兼容入口
在等待上游时断开,由 GatewayHandler.ensureForwardErrorResponse 补写 502;
Gemini 原生入口什么都不写,落成 200 并被 ops 记成一条 provider 的
"Recovered upstream error";Antigravity 回写 502。这些行都按上游失败计入
SLA 与上游错误数。

- GatewayHandler.ensureForwardErrorResponse 补客户端断开检查,与 OpenAI 版一致
- GatewayHandler 的 Messages / ChatCompletions / Responses 与 Gemini 原生入口:
  首次选号失败时先判断客户端断开;ChatCompletions / Responses 循环开头改用
  failoverClientGone,不再直接 return 落成 200
- Gemini 原生入口:forward 失败时补 499 标记;并发槽错误改走
  concurrencyErrorResponse 统一映射(断开 499、排队满/超时 429、其余 503)
- Antigravity 上游响应前断开回写 499;googleapi 与 Antigravity 的 Google 错误
  格式把 499 映射为 CANCELLED
- OpenAI alpha search 非 failover 错误分支补断开检查
- Claude / Gemini / OpenAI 传输层错误:请求 context 已取消时不记 ops 上游事件
- ops:IgnoreContextCanceled 开启时跳过没有上游错误上下文的 499;带上游错误的
  499(上游失败后客户端没等到换号结果就离开)仍按上游失败落库

计费不变:Gemini 流式中途断开的用量处理不在本次范围。新增 handler/service
单测覆盖各入口的断开场景与 ops 过滤规则。
 2026-09-26 17:13:10 +08:00
feeeei b31b435091 fix(gateway): Claude Code 限制分组的 OpenAI 兼容入口改走降级分组,不再直接 403 
分组开启 claude_code_only 并配置降级分组时,/v1/messages 会在选号入口的
checkClaudeCodeRestriction 中把非 Claude Code 请求解析到降级分组;但
GatewayHandler.ChatCompletions / Responses 在 handler 层只要分组开了
claude_code_only 就直接返回 403,不看降级分组,请求到不了调度层:只会发
Chat Completions / Responses 的第三方客户端拿这类分组的 Key 一律 403。

- handler 层提前拒绝只在未配置降级分组时生效,拒绝的状态码与文案不变
- 配置了降级分组时请求继续,由 SelectAccountWithLoadAwareness 解析到降级分组
  选号,再经已有的 Chat Completions / Responses ⇄ Anthropic Messages 转换转发;
  service 层无改动
- 与 /v1/messages 的降级语义一致:选号与渠道限制预检按降级分组,计费与用量
  记录仍按 API Key 所属分组

新增 handler 单测覆盖两个入口在有/无降级分组时的行为。
 2026-09-24 16:20:28 +08:00
feeeei c19204289d fix(affiliate): 线下提现登记按 Idempotency-Key 幂等 
登记请求只有金额，提交成功但响应丢失时，管理员重试会把同一笔站外打款再扣
一次返利额度。现在一次登记由 Idempotency-Key 标识，数据库在同一事务内以唯一
约束去重：

- user_affiliate_ledger 新增 operation_id（幂等键派生的 SHA-256）与部分唯一
  索引（迁移 240）；接口要求 Idempotency-Key，缺失或非法返回 400
- 事务内先以 operation_id 写入占位流水，再解冻、扣减并补写额度快照；同键
  重试返回首笔流水的结果并带 X-Idempotency-Replayed，不重复扣减；同键换了
  用户或金额返回 409 IDEMPOTENCY_KEY_CONFLICT；额度不足时占位随事务回滚
- 并发的同键请求在唯一索引上等待先到者：先到者提交则返回同一条流水，回滚
  则自行登记
- 弹窗在网络错误、超时、5xx、408/409 时锁定用户与金额，重试沿用同一请求与
  幂等键；幂等键按管理员、用户、金额暂存于 sessionStorage，登记有确定结果后
  释放
 2026-09-23 01:24:59 +08:00
feeeei 8f8358cc67 fix(backup): 关闭月度归档后不再改写旧归档的保留份数 2026-09-23 00:44:29 +08:00
feeeei d0ed0eacac fix(gemini): 传输层错误转 failover,不再同账号退避重试 
上游 Do 返回非 HTTP 错误(代理/DNS/TCP/TLS/响应头超时)时,Gemini 三条转发路径
(ForwardNative / Forward / ForwardAsChatCompletions)原先在同一账号上重试 5 次,
退避 1+2+4+8≈15s(time.Sleep 不感知 ctx),耗尽后直接向客户端写 502 且不换号:
单账号链路故障期间 TTFT 被整段拖高,同组健康账号闲置。

对齐 Anthropic/Bedrock 侧 handleUpstreamTransportError 的既有语义:
- 传输层错误单次尝试后即返回 *UpstreamFailoverError(502),由 handler failover
  循环换号,耗尽后才按端点格式渲染错误;service 不再写响应
- 持久性故障(connection refused/no route/DNS not found/代理认证失败)额外临时
  摘除账号 10 分钟;瞬时故障(EOF/reset/超时)只换号不摘号
- context.Canceled 保持原样返回:不换号也不摘账号
- countTokens 传输失败时立即本地估算兜底,不换号
- 摘号实现抽为 tempUnscheduleAccountForTransportError 供两侧共用,日志事件名不变

HTTP 状态码(429/5xx)的服务内重试环未改动。
 2026-09-21 14:13:57 +08:00
feeeei f6eeed3d5a ui(users): 禁用/启用用户后原地更新该行 
管理端用户列表点「禁用/启用」后会重新拉取整个列表：表格先换成骨架屏，
再重新请求用户列表与用量、属性、平台限额三份附属数据，滚动位置随之丢失，
连续处理多个用户时每点一次都像整页刷新。

- 请求成功后按 id 找到当前列表中的那一行，只回写 status 与 updated_at；
  更新接口的响应不含 current_concurrency、subscriptions 等列表专属字段，
  不能整行替换
- 更新返回时若有列表请求在途，该请求可能读到更新前的状态，此时重新拉取列表
- 按状态筛选时，被切换的行留在原地并显示新状态，可当场撤回误操作；
  总数在下次刷新前不变
- 新增三条用例：原地更新且不重载列表、请求失败时该行不变、并发列表请求时回退为重载
 2026-09-19 18:14:27 +08:00
feeeei a9c7c6e8bf ui(header): 手机竖屏顶栏保留模型广场图标入口 
模型广场入口所有宽度都渲染，<640px 只保留图标，补 title/aria-label
 2026-09-18 09:52:40 +08:00
feeeei a9ff663387 feat(backup): 支持月度归档与独立保留策略 2026-09-18 06:56:27 +08:00
feeeei 57b7dbdc85 feat(affiliate): 提取记录支持登记线下提现 
管理员在站外给邀请人打款后，系统里原本无法扣减对应的返利额度，用户仍可把
这部分额度转入余额。现在可在「邀请返利 → 提取记录」点「登记线下提现」，
从该用户的可提取返利额度中扣除已打款金额：

- POST /api/v1/admin/affiliates/users/:user_id/withdraw，请求体只含 amount，
  金额按 8 位小数舍入后校验
- 先解冻已到期的冻结额度，再以 aff_quota >= amount 为条件原子扣减，写入
  action=withdraw 的流水并带额度快照；额度不足返回 AFFILIATE_QUOTA_INSUFFICIENT
- 不新增字段与迁移：线下提现复用已有 action 列区分，操作人由管理端审计日志记录
- 提取记录同时列出转入余额与线下提现，新增「类型」列
- 弹窗选择用户后展示可提取额度，支持一键填入全部；从未产生返利的用户按 0 处理

返利记录改为 LEFT JOIN 订单与被邀请人，兑换码、管理员充值来源的返利也会出现
在明细中，接口里订单相关字段与被邀请人 ID 可为 null。
 2026-09-17 23:42:02 +08:00
feeeei 8ea4dc56f0 fix(gemini): 模型侧 finishReason 不再按上游失败登记 
MALFORMED_FUNCTION_CALL / UNEXPECTED_TOOL_CALL 是模型生成结果，此前按生成异常
登记为上游 502：写带账号归因的上游错误事件、计入 SLA、严重度 P1，并落进渠道
监控的 upstream_5xx 桶。

- detectGeminiResponseSignal 的 finishReason 只登记内容过滤类枚举，其余一律不登记
- geminiSignalAbnormalStop 仅承载 EMPTY_STREAM / EMPTY_RESPONSE
- 新增原生流式 MALFORMED_FUNCTION_CALL 不留 ops 标记的回归用例
 2026-09-11 17:06:01 +08:00
feeeei 9d475f9edb feat(settings): 新增「站点类型」三态开关，关闭订阅后用户端收起所有「订阅」入口与文案 
后台功能开关页新增「站点类型」单选：充值 & 订阅（默认，即现状）/ 仅充值 / 仅订阅。
它由两个后端开关派生并在保存时同时写回：
- subscription_enabled（新增；默认 true，缺省/空值视为开启，仅显式 false 关闭），按既有
  开关模式贯通常量、公共设置、SSR 注入载荷、默认值、更新写入、DTO、审计 diff 与前端注册表；
- payment_balance_disabled（支付配置里既有的 BALANCE_PAYMENT_DISABLED，此前只能走接口/数据库
  改），补进公共设置与注入载荷，让用户端在任何鉴权请求之前就能推导站点类型。
两者都关闭是接口层可表达但 UI 不提供的组合，前端归为「仅充值」，后台保存时会把余额充值重新打开。

「仅充值」时的表现：
- 用户侧边栏隐藏「我的订阅」，「充值/订阅」入口收窄为「充值」；管理端侧边栏隐藏「订阅管理」
  入口（页面仍可通过地址访问）；
- 购买页不再渲染「订阅」tab，只剩单个 tab 时顶部切换器随之隐藏；tab 列表变化时当前 tab
  自动收敛到可用项（关闭订阅回到充值、仅订阅站点重新打开订阅进入订阅），列表为空时展示
  「充值与订阅均暂未开放」而不是一个必定被后端拒绝的充值表单；
- /purchase 的页头标题/描述与 document.title 改走 resolveRouteMetaKeys 按站点类型切换；
- /subscriptions 路由新增 requiresSubscription 守卫，直达时重定向到仪表盘；
- 顶栏订阅进度徽章不再挂载，App.vue、PaymentView 与徽章组件都不再预加载/轮询订阅接口；
- 用量页隐藏「计费类型（余额/订阅）」筛选，Key 用量公开页「订阅类型」行改为「计费方式」。
「仅订阅」时侧边栏入口与页头显示为「订阅」，购买页只剩订阅 tab（余额下单由后端既有逻辑拒绝）。

购买订阅接口、已有订阅的计费、兑换码发放订阅与管理端订阅管理页面本身均不受影响。
featureFlags 抽出纯函数 resolveFeatureFlag，新增 utils/siteBillingMode 承载三态派生与反解，
PaymentView 测试改用响应式 store mock 覆盖开关双向切换。
 2026-09-11 00:50:17 +08:00
feeeei 4a4b50d807 fix(quota): 平台限额表只保存已配置限额的记录，仪表盘按用量与限额展示平台 
user_platform_quotas 只保存至少配置了一档限额的记录；不存在的行等价于不限额。

- 注册播种只为配置了限额的平台建行，一个都没有时不写入
- IncrementUsageWithReset 无行时不再 fail-open 建行
- BatchSnapshotUsage 改为只更新既有活跃行，不再插入无限额的新行
- 仓储 BulkInsertInitial/UpsertForUser 把三档全空的记录视为未配置；
  管理员全量替换接口同样剔除，清空限额即软删并放弃累计用量
- 迁移 238 删除三档全 NULL 的历史行
- 用户仪表盘平台卡片 = 有用量的平台 ∪ 配置了限额的平台，计数改为卡片数
- 管理员限额弹窗对未保存限额的平台禁用"重置窗口"
 2026-09-10 16:41:58 +08:00
feeeei 44bc47a3e3 fix(gemini): 原生路径登记 2xx 响应里的带内错误信号 
Gemini API-key 原生转发对上游 2xx 只抽 usage 原样透传：finishReason 内容拦截、
promptFeedback.blockReason、事件里的 Google 错误信封、空响应都被当作成功，
ops 错误日志、用户错误页、渠道监控全部没有记录。

- 新增 gemini_response_signal：逐事件判定三类带内信号，流式按优先级登记最高者；
  没有 data 事件时对非 SSE 的兜底正文整段判定，空体登记 EMPTY_STREAM / EMPTY_RESPONSE
- 内容策略类按请求级结果登记（invalid_request_error / 400，business limited，
  不做上游归因、不计 SLA）；错误信封、生成异常、空响应按上游失败登记并计 SLA
- OpsStreamError 新增 RequestScoped / NonStream：请求级带内行不受残留上游上下文与
  skip_monitoring 影响，落库状态取 IntendedStatus；中间件保留此前尝试的恢复行
- 客户端字节、wire 状态、用量与计费不变
 2026-09-10 02:59:15 +08:00
feeeei 99eba19ffc fix: 升级 go-redis 至 v9.22.0 修复连接池 nil-ctx panic 
上游竞态：调用方超时后 wantConn.ctx 被置 nil，拨号 goroutine 用 nil ctx
创建超时上下文触发 panic（go-redis#3630，v9.18.0 起修复）。
生产环境在连接池饥饿 + 请求超时风暴下每秒触发上万次。

同步将 ZRangeByScore 迁移至 ZRangeArgs：v9.22.0 将其标记为 deprecated，
golangci-lint staticcheck 拦截（SA1019）。ZRangeArgs{ByScore: true} 与原
调用发出的 Redis 命令参数完全等价（LIMIT 编码逻辑相同）。
 2026-09-08 13:46:59 +08:00
feeeei c227863d51 fix(images): 生图 url 回填下载拒绝私网目的地并只信字节嗅探 
账户开关 images_url_to_b64_json 下载的图片 url 来自上游响应，是不可信输入。此前沿用
base_url 的 security.url_allowlist 策略，默认配置下只做格式校验，上游返回
localhost:8080 之类地址时网关会真的去请求内网。

- 下载 URL 主机为 localhost、回环、私网、链路本地、未指定地址的字面量时直接拒绝，
  不受 security.url_allowlist 配置影响（urlvalidator 导出 IsBlockedHost）
- 新增 ctx 标记 WithHTTPUpstreamPublicHostsOnly：共享上游客户端对带标记的请求无视配置
  校验解析后 IP，并为其克隆客户端挂 redirectChecker，重定向保持跟随但每一跳都校验
- 下载内容改为只信 http.DetectContentType 嗅探结果且限 png/jpeg/webp/gif，
  响应头不再作为依据
- 下载失败仍只记日志并保留原样；超时与端口策略不变
 2026-09-05 15:50:56 +08:00
feeeei 3c53ba01a7 feat(images): 账户开关将生图结果 url 下载回填为 b64_json 
部分第三方 GPT-image 上游把 Images 响应里的 b64_json 换成 url，按官方接口实现的
客户端读不到图。账户 extra.images_url_to_b64_json 开启后，OpenAI API Key 的
Images 非流式响应里 b64_json 缺失或为空且 url 非空的项，由网关下载 url 内容并以
base64 回填 b64_json，url 与其余字段原样保留；异步生图任务复用同一路径。

- 下载经账户代理发起，沿用 base_url 的出站 URL 校验策略（validateUpstreamBaseURL
  抽出 validateOutboundURL，nil cfg 按仅格式校验处理），单图上限 20MB 且须为图片
  内容（响应头或字节嗅探）；data: URL 直接取 base64 载荷
- 单项下载失败仅记日志并保留原样；客户端显式 response_format=url 时不回填；
  流式响应不处理
- 创建/编辑账户弹窗在 OpenAI API Key 的 Responses 模式块后新增“生图结果 URL 转
  base64”开关，中英文案；新增 openai_images_b64_backfill_test.go
- 只被 unit 标签测试引用的定价目录测试辅助补上 //go:build unit（admin 包整文件加标签，
  service 包的 newPricingServiceFromModelPricing 搬到 pricing_stub_helpers_unit_test.go），
  消除 golangci-lint 在默认标签下的 unused 报错
 2026-09-05 15:17:57 +08:00
feeeei de27905e88 feat(usage): 用量记录落库上游请求标识并支持按账户配置响应头名 
- usage_logs 新增 upstream_request_id 列（迁移 232）与仅索引非空行的 CONCURRENTLY 部分索引（迁移 233，runner 登记失效索引清理）
- 账户 extra.upstream_request_id_header 指定要读取的上游响应头，只读该头；留空不记录；创建/更新/批量入口校验头名合法且不超过 64 字节
- ForwardResult/OpenAIForwardResult 携带 UpstreamHeaders，中央计费按账户解析落库，WS 轮次保持 NULL
- 管理端用量明细新增默认隐藏的"上游ID"列，带与请求ID列一致的复制按钮，并同步导出
- 创建/编辑账户弹窗新增"上游ID"输入（UpstreamRequestIdHeaderField），提示按接入类型与平台分条列出常见头名
- HelpTooltip 悬停模式下指针移入提示框时保持打开，便于选中复制提示内容
 2026-09-03 18:02:15 +08:00
feeeei fdc2ec17e6 feat(pricing): fallback/override 定价文件按内容哈希随定时器热重载 
PricingService 的定时器（hash_check_interval_minutes，默认 10 分钟）每轮先做
远程目录哈希同步，再比对 fallback_file/override_file 两个文件内容的联合 sha256
（customFilesHash），变化时从本地 model_pricing.json 重建叠加层，只替换内存数据
与指纹，不改远程同步锚点 localHash。只配置了自定义文件而 remote_url 为空时
调度器同样启动。

- 三条重建路径（启动加载、远程下载、热重载）统一走 buildPricingData，指纹在合并
  读取之前采样，并发改文件只会落后于数据、下一轮补重建
- 删除文件视为该层清空，下一轮生效；文件存在但不可读或不是 JSON 对象时保留旧数据、
  不更新指纹，每轮重试并告警
- config.example.yaml 同步生效说明；新增 pricing_service_hot_reload_test.go
 2026-09-03 10:35:20 +08:00
feeeei 9ad3865690 fix(gateway): 负载感知调度补齐渠道模型限制的逐账号检查 
渠道 billing_model_source=upstream 时，限制模型只能按账号映射后的上游模型
逐账号判定。GatewayService.SelectAccountWithLoadAwareness 的负载感知各层
（模型路由候选、路由内粘性 gate、无路由粘性 gate、负载感知候选及其兜底）
此前都没有这一判定，load_batch_enabled 默认开启，anthropic/gemini/antigravity
分组的渠道白名单实际不生效。

现在入口算一次 needsUpstreamChannelRestrictionCheck，各层共用同一判定；
候选因渠道限制筛空时记 warn 并返回带 channel pricing restriction 的
ErrNoAvailableAccounts，与预检路径一致。
 2026-09-02 11:46:37 +08:00
feeeei e2cfaa46e7 fix(pricing): 目录 cache 侧字段契约哨兵与 Gemini pro 缓存写入价修正 
阶梯计价数据驱动后，目录条目的字段缺失或版本拼接会直接变成计费偏差，
解析层补两道数据契约哨兵，并修正出厂快照中 Gemini pro 系的缓存写入价：

- orphanCacheTierFields / warnOrphanCacheTierFields：条目带 cache 侧
  above 档（含 _priority/_flex 变体与 above_1hr 形态）却没有基础价时打
  WARN——cache 侧 above 档不参与计费取值，按"基础价 × 输入倍率"计，基础价
  缺失即该分项按 0 计；变体缺自身基础价时沿 变体→1h→标准 回落链任一存在
  即不算孤儿，与计费回落一致
- isLopsidedLongContextLadder / warnLopsidedLongContextLadders：above 档
  折算出只有一侧带附加费的阶梯时打 WARN（基础价与 above 档来自不同价格
  版本的形态），显式 long_context_* 字段不告警
- deriveLongContextFromAboveTierFields 注释改为陈述契约：cache above 档
  须恰为基础价 × 输入倍率
- 出厂快照 6 个 Gemini pro 条目补 cache_creation_input_token_cost（= 标准
  输入价，Google 对缓存写入不另收费）、above_200k 改为输入 above 价、带
  priority 输入价的 4 条补 priority 孪生，与 model-price-repo 数据修正同值

测试：
- 解析层：孤儿字段 WARN（含 priority/1h 孤儿正例、1h 回落 5m 反例）、单侧
  阶梯 WARN、出厂快照契约（全条目无孤儿字段、无单侧阶梯、Gemini pro 缓存
  写入价 = 输入价）
- 用量契约：extractGeminiUsage 与 Antigravity 非流式/流式转换均不产生
  cache_creation token（Gemini usageMetadata 无该类别）
- 计费：gemini-2.5-pro 阶梯对 cache_read / cache_creation 分项生效，阈值
  计入缓存写入 token；阶梯表场景与夹具同步为现行目录值
 2026-09-01 01:26:55 +08:00
feeeei 593fc93659 feat(pricing): 新增 override_file 价格目录覆盖补丁 
新增 pricing.override_file 配置（默认关闭）：稀疏补丁文件按 JSON 字段
浅合并覆盖目录/回退数据，作为最高优先级数据源，用于本地自定义官方
目录条目（如显式 long_context_input_token_threshold=0 关闭某模型阶梯）
而无需自建价格镜像：

- applyPricingOverrides 挂在 parsePricingData 解析入口，只修补已存在
  条目（补丁字段覆盖同名字段，值为 null 删除字段）；目录、回退与灾备
  路径都经该入口，覆盖语义三处一致
- mergeOverrideOnlyModels 在回退合并后把目录/回退都没有的模型作为
  独立条目并入（复用主解析路径，须自带价格字段通过有效性过滤）；
  不在主解析时抢先建条目，避免纯补丁挡住回退完整条目、其余分项价
  静默变 0
- 最终未生效的条目（模型名拼错、纯补丁落在不存在的模型上）打 WARN
  哨兵；override 文件缺失/损坏仅跳过合并，不影响目录加载
- 生效时机为重启或下次目录下载，与 fallback_file 一致；fallback_file
  只补缺失模型的语义不变
 2026-09-01 01:26:55 +08:00
feeeei 530fb20f25 refactor(billing): 长上下文阶梯计价改为价格目录数据驱动 
删除 GPT/Gemini 系列写死的阶梯规则，阶梯一律由目录数据驱动：

- 解析层折算 LiteLLM 的 *_above_XXXk_tokens 绝对价字段为阈值+倍率
  （阈值取自字段名，倍率 = above/基础价，cache 侧跟随输入倍率，
  xAI 按 provider 用达到即进高档语义）；显式 long_context_* 字段
  按"字段存在"优先，显式 threshold=0 或 multiplier=1 可关闭阶梯
- 删除 OpenAI 272K 常量与 applyModelSpecificPricingPolicy 的长上下文
  强补分支、fallbackPrices/静态兜底条目的 LongContext 字段、Gemini 旧
  边际规则全链路（CalculateCostWithLongContext / RecordUsageWithLongContext /
  阶梯表 marginal 基准）；保留 fastRatio 与 GPT-5.6 cache_write 1.25x
  防御分支、grok 静态兜底阶梯
- 渠道配置定价区间时完全以渠道区间为准，不再叠加目录阶梯
- 长上下文倍率 ≤0 在应用点按 1 计，防止显式字段残缺把分项乘 0 免费
- 目录重载时对比新旧数据，原有阶梯丢失打 WARN 哨兵告警

行为变化：Gemini 由边际 2x（仅 /v1beta、全模型）改为整单换档（数据
驱动、仅带 above_200k 的 pro 系），渠道平价之上叠加目录阶梯；Claude
sonnet-4/4.5 随目录数据获得 200K 整单阶梯（与官方定价一致）；模型广场
官方参考价列与实付列同源展示目录阶梯。
 2026-09-01 01:26:55 +08:00
feeeei 0e08c39999 fix(openai-ws): remember rejected encrypted content across turns 
invalid_encrypted_content 恢复此前只清理当次请求体：同一失效密文随客户
端维护的会话历史在后续每一轮重新出现，反复触发"整包被拒→剥离→重试/
重连"（#6382 生产观测 2h 内 251 次 recovery、273 次 WS 重连），既是
QoS 放大器也是内存压力放大器。

按会话记录被上游拒绝过的 encrypted_content SHA-256 摘要（lineage）：
- OpenAIWSStateStore 新增会话级摘要绑定，TTL 复用 session sticky，
  单会话 512 摘要为存储自保护，超出仅退化为既有单次 recovery
- 写点覆盖 forward WSv2 recovery、forward 非 WS 400 重试、ingress
  error 事件、bridge 400/流内 error；读点在 forward 进场与 ingress/
  bridge turn 循环入口按摘要预剥离，新密文摘要不同不受影响
- 只收剥离端可处理的项类型（reasoning/compaction/compaction_summary），
  避免记入永远剥不掉的摘要后每轮空转解码
- replay 历史序列同步剥离，避免与已剥离的当前 input 项错位导致
  prefix 复用失配

含端到端集成测试：turn1 上游拒绝即记录，turn2 上游收到的请求不再携带
失效密文且 reasoning 骨架保留。
 2026-08-31 01:02:13 +08:00
feeeei ca9b4d73f2 fix(openai-ws): share immutable replay bodies to stop O(T²) copying 
OpenAI Responses WS/HTTP-bridge 的 replay 历史此前每轮对全部正文做多次
深拷贝（构建、双份序列、保存点各一遍），长会话累计分配 O(T²)，实测
128 turn x 10KiB 达 160MB+，是 #6382 内存持续增长直至 OOM 的主因。

改为共享不可变正文所有权：
- extract 经零拷贝 string 视图 + gjson Index 直接切 payload 子切片，
  并以 json.Valid 保持对断裂数组的既有错误语义
- 序列构建/sanitize/collector/保存点全部只传引用；跨持有者保存经
  combineOpenAIWSReplayItems 新建头数组，正文不复制
- bridge 每轮一次解析，正常 replay 与 account-failover 序列共享正文
- 前缀比较增加字节级快路径，避免逐轮全历史 decode+encode
- strict 状态可用时不再整包保留上一轮 payload

新增 128 turn 分配回归测试锚定上界（实测 2.5MB，深拷贝回归会击穿），
以及正文共享的所有权断言。
 2026-08-31 01:01:20 +08:00
feeeei 44003d7f6b fix(gateway): Anthropic/Bedrock 传输层错误转 failover + 持久故障临时摘除账号 
上游 Do/DoWithTLS 返回非 HTTP 错误(代理/DNS/TCP/TLS)时,Anthropic 五条转发路径
(forward/apikey 透传/Bedrock/ForwardAsResponses/ForwardAsChatCompletions)原先
直接向客户端写 502 且不换号,单账号网络故障期间该账号仍持续被调度,请求全量失败。

对齐 OpenAI 侧 handleOpenAIUpstreamTransportError 的既有语义:
- 传输层错误统一返回 *UpstreamFailoverError(502),由 handler failover 循环换号,
  耗尽后才向客户端渲染错误;service 不再写响应
- 持久性故障(connection refused/no route/DNS not found/代理认证失败)额外临时
  摘除账号 10 分钟(仅写库,Anthropic 调度以持久化状态为准,无内存快路径)
- context.Canceled 保持原样返回:不换号也不摘账号
- 分类器改为平台无关命名(classifyUpstreamTransportError)供两侧共用
- Ops 错误事件保留各路径原有字段(UpstreamURL/DurationMs/Passthrough)
 2026-08-27 09:56:41 +08:00
feeeei d881bfc0de fix(openai): 避免 pool 两跳重复计算 system 提示词 2026-08-26 19:55:49 +08:00
feeeei 73aabc861c build: 取消 gosec G703/G704 全局排除，生产代码逐点 nolint、测试文件按路径豁免；DEV_GUIDE 同步 golangci-lint v2.13 2026-08-24 12:21:06 +08:00
feeeei 3b81776429 fix(test): grok QueryQuota 用例排除后台 /v1/models 同步请求，消除请求计数竞态 
QueryQuota 返回前经 scheduleGrokObservedModelsSync 异步拉取 GET /v1/models，
该请求是否早于 upstream.snapshot() 落到 mock 取决于调度时序，三个精确断言
请求数的用例约 0.5% 偶发多出一条。新增 quotaSnapshot 只返回配额探测链路的
请求，三处断言改用它。
 2026-08-24 12:02:53 +08:00
feeeei cbe258fd12 build: 升级 Go 1.27.0，同步 CI/Dockerfile 并适配 jsonv2 与 golangci-lint v2.13 
- go.mod 1.26.6 → 1.27.0；backend-ci/release/security-scan 的 go version 断言、
  三个 Dockerfile 的 golang 镜像、README 徽章与 DEV_GUIDE 同步
- golangci-lint-action v2.9 → v2.13（v2.9 由 go1.26 构建，拒绝 go.mod 1.27 目标）；
  新规则按最小方式处理：排除 G703/G704 污点分析（网关按配置转发/写文件，
  与既有 G304 排除策略一致）、reflect.Ptr → reflect.Pointer、
  ResetQuota 恒返回错误的 SA4023 与 OIDC EC JWK 的 SA1019 加 nolint
- ent 生成代码按 Go 1.27 默认 jsonv2 引擎重新生成：json.RawMessage 字段
  生成为同类型别名 jsontext.Value（group.model_pricing / usage_cleanup_task.filters）
- x/net v0.56 在 go1.27 下包装标准库 HTTP/2：ConfigureTransports 经
  RegisterProtocol("http/2") 打开 Protocols.HTTP2 而不再写 TLSNextProto，
  ReadIdleTimeout/PingTimeout 建连时映射为 HTTP2Config.SendPingTimeout/PingTimeout；
  keepalive 测试改断言 Protocols.HTTP2()，并补真实 HTTP/2 协商用例
 2026-08-24 12:02:53 +08:00
feeeei f19095f96d 模型广场：分时时段行明确不含高峰倍率口径并披露叠加 
- 实扣倍率为 基础 × 高峰 × 分时；时段行价格与整表一致，按不含高峰的口径展示
- 分组启用高峰时，时段行 tooltip 披露与高峰窗口重叠的部分实付再乘高峰倍率
- PlazaGroupSection 把高峰窗口描述与倍率传入价格表
 2026-08-24 11:23:58 +08:00
feeeei b07d85c497 模型广场：分时计价同步渠道仅工作日规则 
- 阶梯表分时倍率透传渠道 weekdays_only；探针锚点显式固定在工作日
  （原 2026-01-01 恰为周四是巧合，锚点落周末会把仅工作日时段整组剔除）
- 前端时段徽章加「工作日」前缀，tooltip 说明周末全天按标准价计费
 2026-08-24 11:16:00 +08:00
feeeei 83d4eb6a43 模型广场：增加渠道分时段计价展示 
- 阶梯表查询附带分时倍率时段：时段取自计费解析到的渠道定价，
  每个时段的倍率由计费的 resolvedChannelTimeMultiplier 在时段内取值，
  分组价卡覆盖或配置非法时自然不出现；倍率为 1 的时段不列
- 广场模型条目新增 time_pricing（时区 + 时段 + 倍率）
- 前端把分时时段展开为独立行：模型名旁标注时段，价格按时段倍率折算，
  倍率列显示生效倍率；时区与计算口径放在提示中
 2026-08-24 10:50:52 +08:00
feeeei ecce0769c0 模型广场：上下文档位统一标签形态并保证升序 
- 阶梯表标签由计费层统一生成：有上限的档为「≤上限」、末档为「>下限」
  （达到阈值即进高档时用 < / ≥），不再沿用渠道区间的自定义 tier_label；
  合并同价段只看单价
- 前端档位按下限升序兜底展示，无标签时按同一形态生成
 2026-08-24 10:50:52 +08:00
feeeei 377d1230fc 模型广场：按计费阶梯单价表展示长上下文档位 
- 新建 ModelPlazaService（持计费服务与定价解析器）承接广场聚合，
  token 模型的单价与档位全部取自 ResolveContextPricingSchedule，
  渠道选择与计费同源；图片/按次模型沿用原档位合成
- 官方参考价改走计费目录（LiteLLM → 内置兜底 → 模型策略），带官方阶梯
- DTO 增加 long_context_pricing_enabled / long_context_basis /
  official_pricing.intervals
- 前端实付与官方三列按档分行（标签只在首列，其余列按行对齐），
  缓存列按档展示写/读价，边际计价以徽章与 tooltip 标注，
  分组关闭阶梯时在头部说明
 2026-08-24 10:50:52 +08:00
feeeei 6466978d2f 计费：统一 token 计费路径选择并提供上下文阶梯单价表查询 
- BillingService.CalculateTokenCostForRequest 承接网关的路径选择
  （分组/渠道定价 → 平台旧长上下文规则 → 内置目录），网关改为调用该入口
- Gemini /v1beta 的 200K 边际翻倍常量从 handler 移入
  BillingService.LegacyLongContextRule，入口只声明适用
- 新增 ResolveContextPricingSchedule：沿用 Resolve 解析链收集断点
  （渠道区间边界、目录阶梯阈值、旧规则阈值），每档单价由真实计费函数
  探针差商得出，倍率/策略变更无需同步；附阶梯表 vs 计费函数的对账测试
 2026-08-24 10:50:52 +08:00
feeeei 75faedda95 计费：fast/priority 按上游响应实际档位只降不升计费 
此前 OpenAI service_tier 与 Anthropic speed 的计费档位只看请求侧，上游
因容量把 priority/fast 静默降为 default/standard 时仍按 2x 收费。现在：

- upstreamResponseModelObserver 同时观察响应侧档位：OpenAI 只信终止事件
  与无类型 body 里的 service_tier（response.created 为请求回显，忽略），
  Anthropic 读 usage.speed；查找仅在带 model 的帧上触发
- ResolveBillingServiceTier 只降不升：响应档位比请求便宜才采纳，更贵、
  未知或缺失一律沿用请求侧，与图片尺寸归并、response_model 计费的
  "不得更贵"不变式一致
- usage_logs.service_tier 记录实际计费档位，降级写
  billing.service_tier_downgraded 审计日志；HTTP、WS 及 ws_v2 relay 全覆盖
 2026-08-23 16:53:28 +08:00
feeeei 0117452551 fix(test): CN 供应商额度探测 fake 加锁消除并发 append 竞态 2026-08-20 15:31:35 +08:00
feeeei ab0fcd1a0e fix(gemini): Skipped 错误策略对齐 OpenAI，上游 4xx 不再硬改 500 
ErrorPolicySkipped（池模式、或自定义错误码未命中）原来在响应写出上
自成一派：v1beta 原生把上游 4xx 硬改 500 后原文透传，/v1/messages
硬传 500 进映射（客户端拿到 502）。下游网关据此把请求级错误当可重
试的服务端故障反复换号，耗尽后改写成 All available accounts
exhausted（2026-08-17 gemini 生产事故链）。现对齐 OpenAI 路径语义：

- Skipped 只豁免账号状态标记，不豁免换号：可 failover 状态码一律
  返回 UpstreamFailoverError（poolModeSkippedFailoverError 泛化为
  skippedErrorPolicyFailoverError，同账号重试标记仍仅池模式携带）
- 池模式的不可 failover 4xx 保真：v1beta 原码+原文透传（新
  writeGeminiNativeUpstreamError 与 ErrorPolicyNone 共用同一写出，
  并补记 ops 事件），/v1/messages 与 chat completions 按真实状态
  码映射
- 自定义错误码未命中且不可 failover：三路径统一 500 + "Upstream
  gateway error" 固定文案，上游细节仅记 ops 错误日志
- 400 属确定性请求错误：mapped 写出回传脱敏后的上游 message，客户
  端可据此定位非法字段
 2026-08-18 11:24:39 +08:00
feeeei d677d67dda feat: OpenAI Team 联动熔断 
OpenAI OAuth 账户收到 402 deactivated_workspace（ChatGPT Team 工作区被停用）时，
将同一 Team（credentials.chatgpt_account_id 相同）的其余 active 账户一并置为
error 并进程内立即熔断，让调度瞬间切走，避免流量继续打到已死的兄弟账户。

- 触发条件仅限 402 + detail.code == deactivated_workspace；通用 402 与 401 行为不变
- 调用点两处：fastpath 各类早退之前 + HandleUpstreamError 顶部，进程内 60s 按 Team 去重
- 逐账户 SetError（错误信息标注触发账户），单账户失败不中断其余
- 默认生效，无配置开关
 2026-08-15 16:48:40 +08:00
feeeei cbc2a3dd46 修复池模式 Gemini 账号被 429 打上账号级限流 
- 429 的标记点在重试循环内,先于 CheckErrorPolicy 执行,池模式豁免只能落在
  handleGeminiUpstreamError 自身;否则一次上游 429 会把账号锁到 PST 午夜,
  即便重试已经成功返回客户端
- 判定条件与 HandleUpstreamError 对齐:自定义错误码优先级高于池模式;
  401/403/529 仍委派给 RateLimitService,临时不可调度规则不受影响
- chat completions 路径的策略分发改为只有 None / Matched 才处理账号状态,
  与 messages 兼容层的 switch 一致,ErrorPolicySkipped 不再漏进来
 2026-08-08 16:51:48 +08:00
feeeei 26e0a89323 人机验证增加阿里云验证码 2.0 
沿用腾讯天御验证码引入的多服务商模型：aliyun_captcha_enabled 作为独立
开关，与 Cloudflare Turnstile、腾讯天御三方互斥（保存校验 + 运行时
CAPTCHA_PROVIDER_CONFLICT）。后台「安全与认证」合并为单张人机验证卡片：
总开关 + 服务商单选（Turnstile / 腾讯天御 / 阿里云），选中即启用该家并
关闭其它，落库仍是三个独立开关键，由前端映射保证互斥。

阿里云侧同时支持 aliyun 中国站与国际站（alibabacloud.com）：两站前端脚本、
region 取值与服务端 API 完全一致，仅账号与 AccessKey 相互独立，因此由
「服务地域」决定线路即可——中国内地走 captcha.cn-shanghai.aliyuncs.com，
非中国内地（新加坡）走 captcha.ap-southeast-1.aliyuncs.com，AccessKey
取自持有该实例的账号，无需在配置中区分站点。

- AliyunCaptchaService 对称 TencentCaptchaService：服务端校验走官方 SDK
  VerifyIntelligentCaptcha，调用异常按 fail-closed 拦截，与 Turnstile
  网络错误行为对称；保存设置时真实探测 AK/SK 有效性
- 保护面对齐腾讯扩展入口：VerifyTencentCaptchaIfEnabled 通用化为
  VerifyActionCaptchaIfEnabled，OAuth 登录启动、passkey 登录在阿里云
  启用时同样拦截；Turnstile 维持既有覆盖不扩大
- 前端 AliyunCaptchaWidget 为表单内预验证按钮（popup 模式），同时暴露
  verify() 供 OAuth 启动、passkey 等动作入口程序化弹窗；未预验证直接
  提交时弹窗兜底。SDK 按钮绑定异步完成，弹窗未出现前按 tick 重试触发，
  并轮询弹窗可见性识别用户关闭
- captchaVerifyParam 复用 turnstile_token 请求字段提交；公开设置下发
  aliyun_captcha_enabled / scene_id / prefix / region
- CSP 放行验证码 CDN：script-src/style-src 加 *.alicdn.com
 2026-08-04 20:57:15 +08:00
feeeei 785b61d424 修复模型广场图片模型价格展示与实收口径不一致 
图片计费模型的广场展示价按实收口径计算:档位单价取
分组图片价 > 渠道档位价 > 渠道默认按次价;分组开启生图
独立倍率时实付倍率取独立倍率,不取分组/专属倍率。
 2026-08-04 13:48:19 +08:00
feeeei 85a27fae39 fix(openai): retry SSE rate limits as HTTP 429 
OpenAI Responses may return code=rate_limit_exceeded in a response.failed SSE event while the HTTP status remains 200. Classify these failures as 429 so configured pool-mode retries and account failover are applied. No account-level rate-limit state is written on this path: the 200-stream response headers carry normal quota snapshots, and retry semantics stay owned by the failover engine.

Ignore compact keepalive bytes when determining whether semantic output has started, preserving safe retries before real output.
 2026-08-01 10:01:47 +08:00
feeeei 3d99acb0ad 优化模型广场UI:筛选栏换行对齐、模型排序与表格留白 
- 筛选栏各级标签移出 flex-wrap 容器,chip 单独成组,换行后左边缘与「全部」对齐
- 模型排序增加二级规则:同官方输出价时按名称降序(gpt-5.6 先于 gpt-5.5)
- 按图片/按次计费的模型沉到分组末尾,不再与 token 模型按官方价混排
- 表格顶到卡片边缘,左右留白改由首列/末列 padding 提供,hover 与分区底色横贯整行
 2026-07-30 15:32:59 +08:00
feeeei 720c405e35 feat: add model plaza with group-scoped pricing showcase 
- public /model-plaza page (standalone + admin-embedded) listing groups
  with discounted effective prices alongside LiteLLM official reference
- faceted platform/group/rate filters: cross-dimension options gray out
  instead of disappearing, platform-tinted chips via accent color-mix
- paid-price columns highlighted with per-platform tint band
- OptionalJWT middleware so anonymous and signed-in users share one route
- admin settings: enable switch, require-auth switch, markdown description
 2026-07-28 16:19:41 +08:00
feeeei fd7e2039d3 fix(gemini): 完善gemini号池模式时retryable失效问题 
此前 Gemini 三条转发路径对池模式账号命中 ErrorPolicySkipped 时直接把
上游错误体透传给客户端（强制标 500），既不同账号重试也不换号，
pool_mode_retry_count 配置完全不生效；而 Anthropic/OpenAI 等路径
会构造 UpstreamFailoverError 交给 handler 层按池模式配置重试后换号。

- 新增 poolModeSkippedFailoverError：池模式 + 可 failover 状态码时
  返回 UpstreamFailoverError，RetryableOnSameAccount 按
  pool_mode_retry_status_codes（默认 401/403/429）判定
- 原生 v1beta（ForwardNative）与 Claude messages 兼容路径的
  Skipped 分支接入；非池模式的自定义错误码透传行为不变
- chat completions 兼容路径的 failover 错误补上
  RetryableOnSameAccount 池模式判定
 2026-07-26 09:52:47 +08:00
feeeei 1acbb12c65 统一gork使用模板中的名称风格 2026-07-15 10:51:08 +08:00
feeeei c7c933776d fix: 池模式同账号重试次数配置对 Anthropic/Gemini/通用转发路径生效 
e643fc38 引入 pool_mode_retry_count 账号配置时,只覆盖了 OpenAI 族
handler 的内联重试循环;走 HandleFailoverError 的 Anthropic/
Antigravity/Gemini/通用转发路径仍硬编码同账号重试 3 次,配置不生效。

为 HandleFailoverError 增加 retryLimit 参数,由调用方传入
account.GetPoolModeRetryCount();未配置账号默认仍为 3 次,行为不变。
 2026-07-13 12:57:00 +08:00