端点管理
端点管理是 ccMesh 的核心:在这里维护所有上游 API 提供方,配置协议转换与模型映射,并组成可轮换、可熔断的端点池。

端点的增删改查
- 新增 / 编辑 / 删除 端点。
- 拖拽排序:调整端点顺序,顺序会影响轮换的起点与优先级。
- 列表 / 网格视图:按习惯切换展示密度。
- 启用 / 停用:停用的端点不参与路由。
端点字段
| 字段 | 说明 |
|---|---|
| 名称 | 端点别名,用于识别与日志展示 |
| API URL | 上游基础地址 |
| API Key | 上游密钥,界面脱敏显示 |
| 认证模式 | api_key(默认)/ auth_token 等 |
| 经全局代理 | 该端点是否经全局出站代理出网 |
| 转换器 | claude / openai / codex |
| 锁定模型 | 非空则强制覆盖客户端请求的 model(专用型端点);空则透传 |
| 模型清单 | 对外暴露 / 已选的模型(聚合型端点,供 /v1/models 公布与展示) |
| 模型映射 | 入站 → 出站模型映射 |
| 备注 | 自由说明 |
三类转换器
ccMesh 支持三种上游协议转换:
- claude(直通):上游本身是 Anthropic Messages 协议,请求原样转发。
- openai(转换):在 Anthropic 与 OpenAI Chat Completions 协议之间互转。
- codex(Responses):面向 Codex / Responses 协议的转换。
选错转换器会导致上游返回协议错误,请按上游实际协议选择。详见 协议转换。
模型清单与模型映射
- 模型清单:决定该端点对外暴露哪些模型,用于
/v1/models公布与 UI 选择。 - 模型映射(入站 → 出站):客户端用入站名请求 → 路由匹配后改写为出站名转发上游。
适用场景:
- 不同上游对同一模型有不同命名,用映射统一对客户端暴露;
- 把一个对外模型名路由到上游的具体模型;
- 专用型端点用「锁定模型」强制覆盖客户端 model。
连通性测试
每个端点可执行连通性测试,结果以状态徽章呈现:
available(可用)unavailable(不可用)unknown(未知 / 未测试)
测试结果会写入端点的 testStatus,在代理未运行时也作为健康状态的粗略参考。
按模型过滤的轮换与熔断
ccMesh 的轮换与熔断是按模型过滤的:路由某个模型的请求时,只在「支持该模型」的端点之间轮换与熔断,避免不相关端点被误伤或误选。
- 多端点之间自动轮换分配请求;
- 某端点连续失败到阈值时切换到下一个;
- 故障端点进入熔断、被选路跳过,冷却后惰性探测恢复。
详见 轮换与熔断。
