对话流程

页面

relayRouter->>Middleware: Distribute

核心功能拆解

1. 两种渠道分配方式

• 强制指定渠道：从上下文取固定渠道 ID，直接校验状态
• 自动分配渠道：根据请求模型、用户分组、偏好亲和性，随机选取健康可用渠道

2. 多层权限校验

• Token 模型权限：校验用户是否允许使用当前模型
• 分组权限：校验用户是否有权访问请求的分组
• 渠道状态：仅使用启用（Enabled）的渠道

3. 特殊场景处理

• 支持 Playground 接口自定义分组
• 支持渠道亲和性（优先使用上次成功的渠道）
• 支持 auto 自动分组智能匹配

4. 收尾动作

• 记录请求开始时间
• 注入渠道信息到上下文
• 请求成功后记录渠道亲和性

通过API请求的类

relayV1Router->>TokenAuth: UserAuth

1. 兼容各种密钥位置

• WebSocket 从协议头取 key
• Claude 从 x-api-key 取
• Gemini 从 URL 参数 / 请求头取

2. 统一转成标准 Bearer 密钥

• 校验令牌合法性
• 解析密钥 → 验证有效性
• 校验用户是否被封禁
• 校验 IP 是否在白名单

3. 校验权限并放行

• 校验用户分组、令牌分组权限
• 把用户 / 令牌信息存入上下文
• 放行后续业务逻辑

API