Skip to content

Sub2API 0.1.205

Latest

Choose a tag to compare

@github-actions github-actions released this 14 Oct 15:07
· 1 commit to main since this release

订阅分组新增 5 小时用量窗口,可与每日、每周、每月限额同时配置。

新功能

  • 创建、编辑和复制订阅分组时可配置「5 小时限额(USD)」。留空表示不限制,已有分组默认不启用。
  • 5 小时窗口为会话式窗口:窗口结束后的首次请求开启新窗口,持续 5 小时,到期后由下一次请求重新计时。
  • 5 小时用量达到上限后拒绝新请求,返回 5-hour usage limit exceeded。限额同时作用于 HTTP 网关、Gemini 网关和 OpenAI WebSocket 请求。
  • 订阅管理的用量列显示 5 小时用量、进度和重置倒计时;「重置配额」会同时清空 5 小时窗口。
  • 用户「我的订阅」、顶部订阅进度、套餐卡片、购买确认、套餐编辑和 API Key 用量查询页均显示 5 小时限额与用量。
  • /v1/usage、/api/v1/subscriptions 和 /api/v1/subscriptions/progress 返回 5 小时窗口的用量、限额、起点和重置时间;剩余额度取所有已配置窗口的最小值。

升级说明

  • 新增数据库迁移 232_subscription_five_hour_window.sql,为 groups 增加 five_hour_limit_usd,为 user_subscriptions 增加 five_hour_window_start 和 five_hour_usage_usd。升级时自动执行,无需手动操作。
  • 未配置 5 小时限额的分组不开启 5 小时窗口,也不累计 5 小时用量,计费与限额行为保持不变。为已有分组启用 5 小时限额后,用户的 5 小时用量从 0 开始计算。
  • 认证缓存快照版本升级为 v21,升级后旧缓存自动失效并重新加载。

验证

  • 后端单元测试、集成测试(PostgreSQL + Redis,含迁移 232)及 golangci-lint v2.9 全部通过。
  • 前端 243 个测试文件、1,729 个测试,以及 ESLint、TypeScript 检查和生产构建全部通过。
  • 本地环境端到端验证:首次请求开启窗口、超限拒绝、窗口到期后重新开启且不影响日用量、未配置限额的分组不累计 5 小时用量,用户订阅页面正确显示 5 小时进度。
  • GitHub CI 通过,提交 22875d2fd2e75695508f1338c971b4b569c117e2。

安装

docker pull forever94yu/sub2api:0.1.205

下方提供 Linux amd64/arm64、macOS amd64/arm64 和 Windows amd64 安装包,以及 checksums.txt。

安装指南