github ranxi2001/sub2api v2.8.13
Sub2API 2.8.13

latest releases: v2.20.5, v2.20.4, v2.20.3...
one month ago

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

本版新增仅保留错误记录的管理员请求采集、Excel / BPS 批量设置与凭证守护,并修复 BPS 工具转换和用量展示问题。

主要更新

  • **管理员请求采集:**在「系统设置 > 功能开关」中启用后,可按用户、上游账户或入口分组创建 1–1440 分钟的采集任务,对照请求、响应、工具调用和流式事件。默认关闭,仅保留确认出错的请求或 WebSocket 轮次;正常请求和正常轮次结束后立即排队清理临时正文,不建立可查询的正常请求索引。#77
  • **Excel / BPS 批量设置:**可对选中账号或全部筛选结果统一设置协议开关、模型范围,以及缓存创建 token 转普通输入选项。#74
  • **凭证守护:**纳入令牌巡检、自动重登和错误态自愈功能。默认关闭;启用前请核对测活与重登服务地址及凭据设置,只向可信服务提交凭据。#71

修复与改进

  • 修复 BPS 单工具调用的参数解析,支持 custom 工具的单个字符串参数并保留 JSON 大整数;内容校验错误增加安全的字段位置和类型提示,不回显请求正文。#73
  • 开启「缓存创建转普通输入」后,下游 usage 同步清除缓存创建量,使返回用量与该选项的计量行为一致。#73
  • 修复 Excel / BPS 子代理明文消息被误识别为密文的问题,同时保留上游明确声明的加密字段。#78
  • 管理员用量明细展示 Excel / BPS 的原始与实际推理等级映射,例如 Max → XHigh;已有列设置继续生效。#79

升级说明

  • 启动时会执行新增迁移 250_account_token_guard.sql 和 251_request_captures.sql。升级前请备份数据库。请求采集与凭证守护的依赖注册已一并整合。
  • 采集正文写入 DATA_DIR/request-captures;未配置 DATA_DIR 时使用 ./data/request-captures。默认总配额为 1024 MiB,任务结束后保留 7 天,可在界面调整。数据库仅保存任务管理元数据及已收尾的错误索引。
  • 待判定数据会在受限配额内临时落盘,期间不能查询、预览或导出。曾发生失败重试、最终成功的请求仍作为错误记录保留,以便排查失败尝试。
  • 错误请求正文可能包含对话历史、工具参数、个人信息和媒体。媒体正文默认不保存,可按任务开启。删除文件不等于安全擦除,也不会删除外部备份、快照或已导出的副本。
  • 请求采集使用单实例本地磁盘;64 MiB 是采集缓冲预算,并非进程内存上限。已建立的 WebSocket 连接需重连,才能加入新采集任务。
  • 旧版子代理密文问题已损坏的会话不会自动恢复,升级后请新建会话验证。历史记录中未保存的推理等级不会补写。

验证

合并前完成相关后端回归、竞态检查、PostgreSQL 集成测试、前端 lint 与类型检查、356 项前端测试及生产构建。整合提交的 Linux unit/integration、golangci-lint、frontend、shell、release-helpers 和安全扫描均通过;服务入口测试及二进制版本输出已验证为 2.8.13。

请求采集的 200 并发合成测试包含 100 个正常请求和 100 个 HTTP 502:正常记录全部删除,保留 100 条错误记录,无不完整记录;采集缓冲峰值约 45.0 MiB。该结果不代表生产容量保证。

完整版本对比


📥 Installation

Docker:

# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.8.13

One-line install (Linux):

curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.8.13/deploy/install.sh | sudo bash -s -- install -v v2.8.13

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

📚 Documentation

Don't miss a new sub2api release

NewReleases is sending notifications on new releases.