api-worker/helloagents/modules/channels.md

channels 模块

职责

• 渠道配置的增删改查
• 渠道连通性测试与模型同步
• 渠道权重与状态管理

接口定义

• GET /api/channels 渠道列表
• POST /api/channels 新建渠道
• PATCH /api/channels/:id 更新渠道
• DELETE /api/channels/:id 删除渠道
• POST /api/channels/:id/test 连通性测试
• GET /api/sites 站点聚合列表（聚合 channels + channel_call_tokens）
• GET /api/channel New API 兼容列表
• GET /api/channel/search New API 兼容搜索
• POST /api/channel New API 兼容新增
• PUT /api/channel New API 兼容更新
• DELETE /api/channel/:id New API 兼容删除
• PUT /api/channel/tag New API 兼容标签批量更新
• POST /api/channel/tag/enabled New API 兼容标签批量启用
• POST /api/channel/tag/disabled New API 兼容标签批量停用
• GET /api/channel/test/:id New API 兼容连通性测试
• GET /api/channel/fetch_models/:id New API 兼容模型拉取
• GET /api/group New API 兼容分组列表

行为规范

• base_url 保存为无尾斜杠格式
• 创建渠道时可传入自定义 id，未提供则自动生成
• 连通性测试会对调用令牌逐个调用 /v1/models 并汇总模型
• 至少一枚令牌测试成功时更新 models_json 并返回成功/失败统计
• New API 兼容层支持 type/group/priority 等字段映射，并保留扩展字段到 metadata_json
• New API 标签（tag）存储在 metadata_json.tag，标签接口按该字段批量更新
• New API 分组列表从 group_name 字段解析，空时返回 default
• 站点类型写入 metadata_json.site_type（new-api / done-hub / subapi / chatgpt / claude / gemini）
• done-hub 仅使用 base_url，不再维护多地址配置

依赖关系

• channels 表
• models 模块（聚合读取）
• newApiAuth 中间件