AI API Gateway Platform - 将 AI 订阅配额分发和管理
Sub2API 2.19.4
本次基于 production 提交 7c57360065e6b181fbc0d5eb52cd037e7f437f1e 发布。
账号容量排序（#645）
- 管理员账号列表支持按容量分子“当前并发数”升降序排序，不是按配置容量或占用比例排序；先按原筛选及观察者权限收集全部账号，再排序、分页，同值以账号 ID 稳定排序。
- 排序与当前页展示复用同一批读数；刷新重新获取。读数分批获取，不保证跨 Redis key 或跨页面请求的原子快照。
- Redis/缓存服务不可用、读数缺失或非法时明确返回
ACCOUNT_CONCURRENCY_UNAVAILABLE（503），不将未知读数当作零。
WS semantic 首 token 计时（#646）
- 覆盖 ctx_pool ingress、WS-to-SSE、passthrough relay 与 WS HTTP bridge：观察到明确类型的 reasoning item/part 即记录 semantic 首 token，不等待 reasoning 正文或最终可见文本；非空文本、推理、工具或媒体内容也可触发。
- created、metadata、heartbeat、空/非法 delta、只有终态的 usage 不触发；每轮分别保留首次有效观察。semantic activity 不等于实际可见内容，smart protocol 的 actual-content 判定保持独立。
- 保留既有起点、队列公式、重试/首输出保护、计费和调度规则；未观测到有效事件仍为 NULL，不补零。SSE 旧 semantic/visible 规则不变。
- 不重算历史记录；历史与新 WS 数据的计时终点含义不同，混合历史不能视作统一延迟序列。TPS 仍按 output tokens / 总时长计算，不减首 token；本次不宣称真实供应商延迟改善。
贡献规范（#647）
- 管理员可见新功能须在同一 PR 登记稳定唯一提示 ID、接入所有展示入口并验证关闭与持久化；普通修复和重复发版不更换已有 ID。本次是既有机制的贡献规范补充，不新增提示运行时能力。
升级与验证边界
- 相对 v2.19.3 无新增数据库迁移或 schema 变更；版本文件自动同步属于发布元数据，不作为功能。
- WS 验证使用本地合成数据及两端真实 socket，不能替代真实付费供应商验收；数据库持久化到 UI 的完整动态端到端验收仍未完成，相关字段链路只完成源码核查，不冒称已通过。
- 容量排序的离线回归与 UI 组件测试不等于真实生产 Redis/浏览器压力验收。回退二进制不会重算已保存的首 token 数据，跨版本比较须保留口径边界。
- 本次仅发布 GitHub Release、镜像和下载产物；不执行生产部署、迁移、服务重启或真实付费调用。未合并的 #644 不包含在本版。
完整变更：v2.19.3...v2.19.4
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.19.4One-line install (Linux):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.19.4/deploy/install.sh | sudo bash -s -- install -v v2.19.4Manual download:
Download the appropriate archive for your platform from the assets below.
K3s gateway upgrade (on each existing single-node host):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.19.4/deploy/upgrade-k3s.sh | sudo bash -s -- --version v2.19.4Defaults: namespace tosky-canary, Deployment tosky-nerd; override with --namespace NAME --deployment NAME.
Upgrade every instance sharing Redis to this release.