核心概念说明
后面文档会反复用到它们。每个词只说含义,以及在应用的哪一页配置。
端点(Endpoint)
上游 API 提供方的一条配置:地址、密钥、转换器、模型清单等。多个启用端点组成可轮换的池。在 端点管理 新建或编辑。
点亮模型(activeModels)
端点 models 清单里,你勾选对外公布的子集。客户端拉取 /v1/models、对话页选模型、配置映射时的出站下拉,都按点亮结果来。
规则:
activeModels为空:默认公布全部models(兼容旧端点)activeModels非空:只公布点亮项(并保留models顺序)- 填了 锁定模型 时:对外基础集以锁定模型为准
在端点表单的 模型清单 里点击模型徽章切换点亮。
转换器(Transformer)
决定 CC Mesh 如何把客户端请求改写为上游协议,取值:claude(直通)、openai(Chat Completions 互转)、codex(Responses)。
模型映射(Model Mapping)
一条 from → to:客户端用入站名 from 请求,路由命中后改写为出站名 to 再转发。出站候选来自点亮模型(未点亮则全部 models);关闭 启用映射 时保留规则但不改写、不公布入站别名。
快速队列(fast)
启用端点上的优先子集。只要存在至少一个 fast=true 的启用端点,代理选路只在快速队列内轮询;队列为空时回退全部启用端点。
在仪表盘点闪电图标打开 编辑快速队列,或在已启用端点的编辑表单打开 加入快速队列。
轮换(Rotation)
在可路由端点之间分配请求:按当前索引前进,并按请求模型过滤候选,避免选到不支持该模型的端点。
在 端点管理 拖拽排序影响全局顺序;快速队列另有独立顺序。
熔断器(Circuit Breaker)
每个端点独立的三态保护:Closed(放行)、Open(跳过)、HalfOpen(冷却后探测)。连续失败或错误率超阈值进入 Open;部分客户端错误(如 400 / 401 / 422 等)为中性,不计入熔断;403 可重试并计入熔断。
状态显示在仪表盘端点队列。
出站代理(useProxy / proxyEnabled)
转发与拉取模型是否走设置里的全局代理地址。真值:(端点 useProxy 或 全局 proxyEnabled) 且 代理 URL 非空;URL 为空时一律直连。应用更新另看 proxyForUpdate。
全局开关在 设置 → 代理;单端点开关在端点表单 启用代理。
渠道(Channel / Profile)
面向某个工具的一整套本地配置快照,可保存多套;点 应用 写入工具配置文件,应用前自动备份。
在 配置文件 管理,支持 Claude Code、Claude Desktop、Codex、Pi、OMP。
