Repository navigation
订阅分组新增 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。