Files
api-worker/helloagents/modules/channels.md
T
lsy 3bcc9ebb99 refactor(app): 管理台模块化并整理 worker API 类型
- 拆分管理台入口为 App/feature/core 结构并更新样式/配置
- 规范 worker 路由/中间件/服务类型与 JSON 解析
- 同步工具链与知识库记录
2026-02-16 00:48:49 +08:00

39 lines
1.5 KiB
Markdown

# channels 模块
## 职责
- 渠道配置的增删改查
- 渠道连通性测试与模型同步
- 渠道权重与状态管理
## 接口定义
- `GET /api/channels` 渠道列表
- `POST /api/channels` 新建渠道
- `PATCH /api/channels/:id` 更新渠道
- `DELETE /api/channels/:id` 删除渠道
- `POST /api/channels/:id/test` 连通性测试
- `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`
## 依赖关系
- `channels` 表
- `models` 模块(聚合读取)
- `newApiAuth` 中间件