AI API Gateway Platform - 将 AI 订阅配额分发和管理
本版新增 Copilot SDK 的 Codex 接入模式，补充账号异常通知与质量检测工作台，支持向用户展示选定分组的鹈鹕测智结果，并修复 780 原生采票的路由与诊断问题。
Copilot SDK 接入 Codex
账号怎么配置：v2.8.9 没有后台 GitHub 登录或账号导入按钮。 管理员需要先在服务器部署独立适配服务（sidecar），运行 login.py，在浏览器完成 GitHub 设备码授权。仅勾选后台开关不会完成登录。
- 管理员登录 GitHub：按公开教程安装配套脚本、执行设备登录并启动 sidecar；GitHub Token 自动保存在服务器，不填入 Sub2API 后台。
- 后台添加上游账号：进入“账号管理 → 添加账号”，平台选 OpenAI、类型选 API Key，勾选 Copilot SDK。同主机二进制部署的 Base URL 填
http://127.0.0.1:18765/v1，API Key 填 sidecar 生成的sidecar-key，绑定仅含此账号的独立分组。 - 使用者配置 Codex：在站点 API Key 页面创建绑定该分组的 Sub2API Key；Codex 使用站点
/v1地址、wire_api = "responses"和管理员提供的真实模型名。普通用户不需要 GitHub Token 或 sidecar Key。
公开安装教程：GitHub 登录、后台字段、三个 Key 与 Codex 配置 · 公开配套脚本
- 本次公开补充的脚本兼容 v2.8.9 账号模式，但不在原 v2.8.9 安装包或 tag 中；须从上方公开路径另行获取，无需访问运维私库。Docker 的 loopback 与宿主机不同，网络设置见教程。
- 保留 Codex 原生工具调用与会话字段，工具仍由 Codex 执行；客户端取消传到 sidecar，错误回合不自动切换账号重放。
- 首版默认关闭，要求独立分组、单个 sidecar 账号和单进程；不支持后台一键 OAuth、多账号批量导入、pending 工具回合重启恢复或完整视觉任务。错误实例/丢失回合返回 409，需新开会话。
- 适配器基于 Nonary/ghcp_proxy 固定版本。已完成本地协议测试与构建；完整 Sub2API → sidecar → GitHub 链路仍需部署者按自己的账号验收。
账号运维与质量检测工作台
- 新增账号运维入口，可配置余额不足、周配额异常的邮件通知。通知默认关闭，需配置收件地址、通知类型与邮件服务后启用。
- 同一账号、同一异常类型合并记录，并按冷却时间发送；网关请求不等待邮件发送，事件不保存原始上游响应或凭据。
- 调整账号质量检测工作台，集中展示规则、运行状态和检测结果，保留既有定时检测与隔离恢复行为。
实现见 PR #55。
用户侧鹈鹕测智展示
- 管理员可在系统设置中开启展示页，选择展示分组，并设置每组保留数量与自动清理天数。
- 展示数据独立保存为快照，管理员测试历史清理后仍可按展示策略保留；未选择分组时不会产生展示内容。
- 展示具体题目的生成结果，方便用户查看与比较，不代表模型整体能力认证。
感谢 akihitohyh 在 PR #54 中贡献该功能。
780 原生采票修复
- 统一目标 gateway 名称的解析，补充
any目标处理与实际 gateway 记录，减少不同输入形式导致的路由判断差异。 - 修复托管 Mihomo 采票链路的配置与节点处理，补充手动采票、边缘 IP 和并行采票的验证。
- 将传输错误、模型声明不匹配、Cookie 缺失、过期及 gateway 不匹配分别归类，管理界面提供更具体的失败原因，同时避免把含凭据的原始错误写入日志。
实现见 PR #56。780 仍指票据格式长度，路由与模型声明验收不构成模型能力或回答质量保证。
升级说明
- 相比 v2.8.8，新增
249_account_ops_alerts.sql与249_pelican_showcase_items.sql两个迁移，分别保存账号通知状态和展示快照。升级前备份数据库，按实际迁移结果评估回滚。 - Copilot SDK 的 GitHub Token、sidecar Key 与 Sub2API 客户端 Key 用途不同，应按运维说明分别配置；不要将 Copilot sidecar 与普通 OpenAI 账号混池。
- 既有 292/780 兼容与 DeepSeek 压缩路径继续保留。本次发布不自动修改生产开关或重启生产服务。
📥 Installation
Docker:
# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.8.9One-line install (Linux):
curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.8.9/deploy/install.sh | sudo bash -s -- install -v v2.8.9Manual download:
Download the appropriate archive for your platform from the assets below.