Sub2API 0.1.104

AI API Gateway Platform - 将 AI 订阅配额分发和管理

• Claude Code 最大版本限制：新增 max_claude_code_version 设置项，配合已有的最小版本检查，并在 Key 使用教程中默认添加禁用自动升级环境变量

• Anthropic 账号被动用量采样：从上游响应头被动采集 5h/7d 利用率数据，页面默认展示被动数据，支持手动查询最新数据

• 用户管理分组增强：新增分组列展示、分组筛选、专属分组一键替换功能

• 账号未分组筛选：账号列表支持按"未分组"条件筛选

• 分页大小持久化：各页面的 pageSize 设置持久化到 localStorage，刷新后自动恢复

• DataTable 虚拟滚动：引入 @tanstack/vue-virtual，仅渲染可见行，消除 100+ 行数据的渲染瓶颈

• 代理快速失败机制：代理不可用时 5s 内快速失败（原 ~2 分钟），自动临时下线账号 10 分钟，触发账号切换而非直接返回 502

• OAuth/SetupToken 转发请求体重排优化，新增调试开关

• 修复额度耗尽标记失效：429 "Resource has been exhausted" 响应被 URL 级限流检查拦截，导致额度用尽后无限循环重试

• 修复批量编辑时无法清空模型限制的问题

• 修复测试连接收到 403 时未将账号标记为 error 状态

• 修复 failover 耗尽时运维日志记录的是映射后状态码而非真实上游状态码

• 修复 OpenAI 兼容层 Codex OAuth chat-completions 路径缺少稳定 prompt_cache_key

• 修复 Anthropic tool schema 转 Responses API 时缺少 properties 字段导致 Codex 报错

• CI: 发布后自动同步 VERSION 文件回默认分支

• 文档: docker-compose 命令统一更新为 Docker Compose V2 语法

---

📥 Installation

Docker:

# Docker Hub
docker pull weishaw/sub2api:0.1.104

# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.104

One-line install (Linux):

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash

Manual download:
Download the appropriate archive for your platform from the assets below.

📚 Documentation

• GitHub Repository
• Installation Guide

Sub2API 0.1.103

AI API Gateway Platform - 将 AI 订阅配额分发和管理

• 上游模型追踪：记录实际发送到上游的模型，支持按模型来源维度统计和图表展示

• 529 过载冷却管理：在管理后台网关设置中新增开关和冷却时长配置（1-120分钟）

• 模型映射更新：claude-haiku-4-5 系列映射目标更新为 claude-sonnet-4-6

• 安装向导密码校验与后端规则对齐，显示后端实际错误信息

• 用量表格和分布图表支持显示上游模型映射关系

• 用量 Excel 导出新增 upstream_model 列

• 修复 config.yaml 以只读方式挂载时容器启动失败的问题

• 修复直接访问或刷新页面时浏览器标签页未显示自定义站点名称

• 修复空 text block 导致上游返回 400 错误未被重试机制捕获

• 修复 thinking block 签名错误匹配模式不准确的问题

---

📥 Installation

Docker:

# Docker Hub
docker pull weishaw/sub2api:0.1.103

# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.103

One-line install (Linux):

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash

Manual download:
Download the appropriate archive for your platform from the assets below.

📚 Documentation

• GitHub Repository
• Installation Guide

Sub2API 0.1.102

AI API Gateway Platform - 将 AI 订阅配额分发和管理

• 仪表盘新增按用户下钻查看分组、模型、端点分布

• 仪表盘和用量页面默认展示最近24小时数据

• 订阅管理页面新增平台类型筛选和教程指南弹窗

• 分组管理新增容量列（并发/会话/RPM 实时聚合）和用量列与账号数分类

• 备份/恢复操作异步化，解决大数据量下 504 超时问题

• 个人资料弹窗 GitHub 链接仅对管理员可见

• 兼容 Claude Code v2.1.78+ 新 JSON 格式 metadata.user_id

• Antigravity TestConnection 与调度重试逻辑统一

• Antigravity 新增流式心跳保活，防止连接断开

• 提取 formatCompactNumber 公共工具函数

• Codex 用量数据统一由后端 /usage API 提供，移除前端冗余计算

• 默认 User-Agent 版本升级到 1.20.5

• 修复 OpenAI Codex 跨用户串流问题

• 修复 WS 连接池跨请求串流问题

• 修复 Redis 限流 Lua 脚本窗口过期检查缺失

• 修复 OpenAI OAuth 用量统计始终显示及零值徽章隐藏

• 修复会话窗口使用预测值而非真实 reset header 的问题

• 修复过期 Codex 窗口未归零的问题

• 修复 OAuth system-role 未正确提取到 instructions 字段

• 修复代理凭据中特殊字符未编码的问题

• 修复自定义数据库测试连接硬编码导致 auto setup 失败

• 修复 Docker 卷挂载 /app/data 权限拒绝问题

• 修复设置页面 pattern 属性阻止 Claude Code 版本保存

• 修复账号编辑弹窗重新打开时状态未重置

• 修复空 extra payload 无法清除账号配额限制

• 修复用量标签 "Total" 应为 "Last 30d" 的翻译错误

• 修复空闲 OpenAI 用量窗口未显示 'now' 的问题

---

📥 Installation

Docker:

# Docker Hub
docker pull weishaw/sub2api:0.1.102

# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.102

One-line install (Linux):

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash

Manual download:
Download the appropriate archive for your platform from the assets below.

📚 Documentation

• GitHub Repository
• Installation Guide

Sub2API 0.1.101

AI API Gateway Platform - 将 AI 订阅配额分发和管理

• Antigravity AI Credits 超额处理：支持信用额度余额查询、超额使用调度与前端状态展示

• 统一 OAuth Token 刷新 API：引入 OAuthRefreshAPI 作为所有 OAuth 刷新操作的单一入口，修复后台刷新与内联刷新同时使用同一 refresh_token 的竞争问题

• 用量记录端点信息：为 Claude、Gemini、Sora 等非 OpenAI 处理器添加 InboundEndpoint/UpstreamEndpoint 字段

• 统一端点归一化中间件：将 OpenAI 和 Gateway 两套独立的端点归一化实现合并为单一中间件，减少约 70 行冗余代码

• 管理后台消费排行与用量默认值优化

• AI Credits 状态用 model_rate_limits 统一管理，替代 sync.Map 内存状态

• 修复 DST 夏令时切换时用量查询的日期边界问题，改用半开区间查询

• 修复 golangci-lint 格式化与错误检查问题

• 修复静态分析 SA4006 未使用变量警告

---

📥 Installation

Docker:

# Docker Hub
docker pull weishaw/sub2api:0.1.101

# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.101

One-line install (Linux):

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash

Manual download:
Download the appropriate archive for your platform from the assets below.

📚 Documentation

• GitHub Repository
• Installation Guide

Sub2API 0.1.100

AI API Gateway Platform - 将 AI 订阅配额分发和管理

• 运维日志新增「忽略余额不足错误」开关，可过滤上游余额不足类错误

• 使用记录页新增端点分布统计图表，展示入站、上游与路径三类端点分布

• 重置密码功能支持在 UI 中配置发送邮件域名

• 批量编辑账号时模型白名单改为动态生成，不再依赖硬编码列表

• Claude 请求的 output_config.effort 参数现在会记录到使用日志中

• Dockerfile 中添加 pg_dump 和 psql 工具，支持容器内数据库备份恢复

• 运维错误日志将硬编码错误字符串提取为常量，定义 ErrNoAvailableAccounts 哨兵错误

• 修复限额窗口为 nil 时用量累计不重置，导致误报「日限额已用完」的问题

• 修复流式 failover 拼接腐化导致客户端收到双 message_start 的问题

• 修复 Bedrock 账户配额计数器始终为 $0.00、配额限制不生效的问题

• 修复分组限额字段部分为空时保存报错的问题

• 修复分组配额清零和设为 0 时行为不正确的问题

• 修复批量编辑账号时模型白名单显示与实际不一致的问题

• 修复 UsageProgressBar 中窗口统计数据展示被意外移除的问题

• 修复 Gemini 不支持的 patternProperties 字段导致的兼容性问题

• 修复余额不足错误提示文案不准确的问题

---

📥 Installation

Docker:

# Docker Hub
docker pull weishaw/sub2api:0.1.100

# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.100

One-line install (Linux):

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash

Manual download:
Download the appropriate archive for your platform from the assets below.

📚 Documentation

• GitHub Repository
• Installation Guide

Sub2API 0.1.99

AI API Gateway Platform - 将 AI 订阅配额分发和管理

• 数据库定时备份与恢复：支持 S3 兼容存储（含 Cloudflare R2），支持手动/定时备份、一键恢复、自动过期清理

• 账号配额固定时间重置模式：支持按日/按周固定时刻重置配额，可配置时区

• Backend Mode：系统级后台模式开关，禁用用户自助注册和自助服务

• Antigravity 403 状态检测：识别并分类 403 响应（验证/违规/禁止），前端展示状态徽章和验证链接

• 运维面板支持隐藏告警事件

• OpenAI Token 统计可选显示

• 合并 Bedrock 渠道类型：将 bedrock-apikey 合并为 bedrock 统一渠道，通过 auth_mode 区分认证方式

• 备份服务重构：S3 凭证加密存储、流式处理避免 OOM、操作抽象为接口符合依赖注入架构

• 将备份和数据管理页面合并为设置页的标签页，减少侧边栏条目

• 运维聚合查询超时从 3s 调整为 5s，回填窗口从 30 天缩短为 1 小时，防止 PG 过载

• 修复运维设置对话框保存按钮始终禁用的问题

• 修复加密内容无效时的错误处理和重试逻辑

• 修复 Gemini OAuth 401 临时不可调度路径被意外排除的问题

• 修复 wire_gen_test.go 中缺少 backupSvc 参数的问题

• bedrock-apikey 渠道类型已移除，合并为 bedrock 渠道（通过 credentials.auth_mode 区分 sigv4/apikey）

---

📥 Installation

Docker:

# Docker Hub
docker pull weishaw/sub2api:0.1.99

# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.99

One-line install (Linux):

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash

Manual download:
Download the appropriate archive for your platform from the assets below.

📚 Documentation

• GitHub Repository
• Installation Guide

Sub2API 0.1.98

AI API Gateway Platform - 将 AI 订阅配额分发和管理

• 修复 Codex/Responses 原生 input id 被误改写成 fc_* 前缀的问题
• 修复 OpenAI OAuth 账号的模型映射未在管理员可用模型列表中生效的问题
• 修复账号级模型映射未优先于分组回退的问题
• 修复账号更新时调度器快照未同步的问题
• 修复 chat-completions 兼容层中 reasoning_content 输出丢失的问题
• 修复 chat-completions 兼容层中 function_call id 无效的问题
• 修复 chat-completions 兼容层中默认映射模型在非调度回退场景下被错误应用的问题
• 修复 assistant 消息解析中 strings.Builder 写入错误未处理的问题
• 清理未使用的通配符映射辅助函数

---

📥 Installation

Docker:

# Docker Hub
docker pull weishaw/sub2api:0.1.98

# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.98

One-line install (Linux):

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash

Manual download:
Download the appropriate archive for your platform from the assets below.

📚 Documentation

• GitHub Repository
• Installation Guide

Sub2API 0.1.97

AI API Gateway Platform - 将 AI 订阅配额分发和管理

• AWS Bedrock 支持：新增 Bedrock 上游账号类型，支持 AWS 区域配置和签名认证

• 用户消费排行榜：管理后台 Dashboard 新增用户消费排名视图

• 分组倍率管理面板：分组管理新增独立的用户倍率编辑弹窗，支持批量调整和搜索

• 兑换码支持订阅类型：create-and-redeem API 支持创建订阅类型兑换码

• GPT 隐私模式：支持 GPT 账号数据不用于训练，前端展示隐私状态标识

• 计费与用量日志解耦：billing 正确性不再依赖 usage_logs 批量写入，提升高并发下的计费可靠性

• 用量日志批量写入优化，减少数据库写入压力

• 计费幂等性和背压机制增强

• Codex 转换兼容性修复

• Docker 健康检查对齐运行时镜像

• 文档新增 iframe 集成说明和生态项目章节

• 修复 Gemini 模型因 SSE 终止标记被误加入 StopSequences 导致提前停止生成的问题

• 修复 Dashboard 用户用量趋势图显示邮箱前缀而非用户名的问题

• 修复 Dashboard 日期范围默认值不正确的问题

• 修复管理员重置配额缺少 monthly 字段及 ristretto 缓存异步删除竞态问题

• 修复账号导入时同步调用 disableOpenAITraining 导致网络超时失败的问题

---

📥 Installation

Docker:

# Docker Hub
docker pull weishaw/sub2api:0.1.97

# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.97

One-line install (Linux):

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash

Manual download:
Download the appropriate archive for your platform from the assets below.

📚 Documentation

• GitHub Repository
• Installation Guide

Sub2API 0.1.96

AI API Gateway Platform - 将 AI 订阅配额分发和管理

• OpenAI Chat Completions 兼容端点：新增 /v1/chat/completions 路由，通过类型安全的 Responses API 转换实现兼容

• Gemini 2.5 Flash 生图支持：后端新增 gemini 生图模型映射，前端新增生图测试预览

• 管理员重置订阅额度：新增 POST /api/v1/admin/subscriptions/:id/reset-quota 端点及前端操作界面

• 用量图表指标切换：管理后台用量统计页面支持在不同指标间切换展示

• 运维告警指标补全：新增组级和账户级运维告警指标（可用账户数/比例、限速比例、错误比例等）

• 降低 quota 与 Codex 快照热路径的数据库写放大

• 降低 admin/dashboard 读路径压力，避免 snapshot-v2 并发击穿

• 降低 ops_error_logs 与 scheduler_outbox 的数据库写放大

• 精准收紧 accounts.extra 观测字段触发的调度重建

• 重构 Chat Completions 端点，采用类型安全的 Responses API 转换架构

• 修复 Antigravity Gemini 第一次 400 后第二次才触发切账号信号的问题

• 修复 gpt-5.2 以上模型映射到 gpt-5.2 以下时 verbosity 参数引发的报错

• 为 Anthropic Messages API 流式转发添加下游 keepalive ping，防止代理超时断连

• 修复 Codex OAuth responses 端点 string input 未转换为数组的问题

• 修复 Codex exhausted snapshot 传播异常

• 修复 Chat Completions 编译错误和 writer 生命周期导致的 nil pointer panic

---

📥 Installation

Docker:

# Docker Hub
docker pull weishaw/sub2api:0.1.96

# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.96

One-line install (Linux):

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash

Manual download:
Download the appropriate archive for your platform from the assets below.

📚 Documentation

• GitHub Repository
• Installation Guide

Sub2API 0.1.95

AI API Gateway Platform - 将 AI 订阅配额分发和管理

• Anthropic 平台可配置 anthropic-beta 策略

• 管理员可为持有有效订阅的用户绑定订阅类型分组

• 支持批量重置账号状态和批量刷新令牌

• 导入 OpenAI 账号时自动从 id_token 提取用户信息

• 从 OpenAI JWT 提取 chatgpt_plan_type 并在前端展示订阅类型

• 服务启动时自动清理上次进程残留的并发槽位

• 嵌入页面支持通过 lang 参数传递用户语言偏好

• 修复 Linux.do OAuth 注册无需邀请码的问题，支持邀请码两步流程 (#836)

• 修复 OpenAI 临时性 400 错误在池模式下无法同账号重试的问题

• 修复 OpenAI Responses SSE scanner 使用硬编码 1MB 限制导致大 payload 失败的问题

• 修复前端配额徽章水平排列与其他容量徽章不一致的问题

• 修复 HelpTooltip 组件在 dialog 内被裁切的问题

• 修复管理员订阅绑定的回归问题

---

📥 Installation

Docker:

# Docker Hub
docker pull weishaw/sub2api:0.1.95

# GitHub Container Registry
docker pull ghcr.io/wei-shaw/sub2api:0.1.95

One-line install (Linux):

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash

Manual download:
Download the appropriate archive for your platform from the assets below.

📚 Documentation

• GitHub Repository
• Installation Guide