渠道管理
渠道（Channel）是上游模型接入的核心单元。一个渠道绑定一个 Provider，配置协议端点、Provider API Key 凭证、模型映射，并独立维护熔断器与健康状态。
- 渠道 = Provider + 端点 + 凭证 + 模型映射
- 渠道分组：按 Provider 或用途分组
- 计费模式：
billingMode区分计费方式 - 端点级熔断：每个协议端点独立熔断（CLOSED / OPEN / HALF_OPEN）
渠道 CRUD
Section titled “渠道 CRUD”/api/v1/channels（需 Sa-Token 登录态）
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/v1/channels | 创建渠道 |
| POST | /api/v1/channels/{id}/copy | 复制渠道（本体 + 端点 + 模型实例 + 可选凭证；目标名称重复返回 409 CONFLICT） |
| PUT | /api/v1/channels/{id} | 更新渠道 |
| GET | /api/v1/channels/{id} | 渠道详情 |
| GET | /api/v1/channels | 渠道列表（支持 providerId、billingMode 过滤与 sortBy、sortOrder 排序） |
| DELETE | /api/v1/channels/{id} | 删除渠道 |
| PUT | /api/v1/channels/{id}/state | 切换渠道状态（由后端校验状态机） |
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/v1/channels/{channelId}/endpoints | 添加端点 |
| PUT | /api/v1/channels/{channelId}/endpoints/{endpointId} | 更新端点 |
| DELETE | /api/v1/channels/{channelId}/endpoints/{endpointId} | 删除端点 |
凭证管理（Provider API Key）
Section titled “凭证管理（Provider API Key）”/api/v1/channels/{channelId}/credentials
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /credentials | 凭证列表 |
| GET | /credentials/{id} | 凭证详情（含明文，用于复制） |
| POST | /credentials | 创建凭证（apiKey / priority / weight / description） |
| PUT | /credentials/{id} | 更新凭证 |
| DELETE | /credentials/{id} | 删除凭证 |
| POST | /credentials/{id}/test | 测试 API Key 有效性 |
/api/v1/channels/{channelId}/models（ModelInstanceController）：将网关对外模型名映射到上游实际模型名。
健康检查与应急熔断
Section titled “健康检查与应急熔断”| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/v1/channels/{id}/health-check | 触发连通性测试（按聚合规则写入健康状态） |
| POST | /api/v1/channels/{channelId}/endpoints/{endpointId}/circuit-breaker/force-open | 强制熔断 |
| POST | /api/v1/channels/{channelId}/endpoints/{endpointId}/circuit-breaker/force-close | 强制恢复 |
| GET | /api/v1/channels/{channelId}/endpoints/{endpointId}/circuit-breaker/state | 查询熔断状态 |
应急熔断用于故障时快速隔离问题端点，修复后强制恢复。
控制台 Channels 模块功能最丰富：
- 创建向导：引导式新建渠道
- 复制渠道：行内复制按钮 + 新建弹窗复制选择器
- 详情抽屉：编辑渠道全貌（凭证 / 端点 / 模型映射）
- 分组列表 / 表格视图：按 Provider 分组或平铺
- 连通性测试：验证渠道可用性
- 熔断器按钮：一键熔断 / 恢复
- 批量导入 / 导出：批量管理渠道（导出为 YAML，不含凭证明文）
详见 控制台快速上手。