mirror of
https://gitcode.com/JianFeeeee/ModelRouter.git
synced 2026-11-07 09:47:23 +00:00
3860c7381f
只需填 URL 和 key 即可自动扫描上游模型并配置，不用再手抄模型 id。 端点 POST /api/sources/discover 只探测，不写任何东西 POST /api/sources/discover/apply 探测后落库 核心难点是 URL 形态而不是 /models 调用本身。网关按 base_url + adapter endpoint 拼路径（openai 提供 "/chat/completions"），而各家厂商对版本段 放在 base 还是 path 上没有共识，也没有哪个响应头能说明。所以探测不信任 调用方给的 URL，而是按偏好顺序试若干候选，返回答的那个，并给出归一化 后的 base_url + endpoint 组合。这正是第一次配 vela 时 /v1/images/ generations 返回 404 的成因：base_url 里已有 /v1，默认图像路径再拼一次。 归一化的不变量是「版本段在 base_url + endpoint 里恰好出现一次」。留在两边 会重复；两边都没有则 chat 请求在要求版本段的厂商上会打错路径。 kind 只信上游自己声明的 modality，绝不从模型名猜。"gpt-image-2" 这类 id 也出现在同时提供对话服务的目录上，猜错会让 AUTO 链选中一个只支持图像 生成的 id，其后每一层都被它拖垮。 不做的事： - 不逐模型发单 token 探活。34 个模型的目录跑一轮要花钱且耗时数分钟， /models 是足够便宜的信号；模型是否真能应答留给正常请求路径。 - 不猜能力。「vision」出现在 id 里不等于该模型接受图片。 - 不自动写盘。探测只读，保存仍需操作员按按钮——错误的 base_url 会产出 一个看起来合理却无法使用的源。 已存在的源必须显式 replace_models=true 才会覆盖模型列表：重新探测顺手 抹掉为 AUTO 链手工调过的 priority 是最难排查的一类数据丢失。 测试用真实抓取的 amr-link /models 响应做夹具，它把 modality 嵌在 architecture 下、metadata 下还有 cost/context_limit，34 个模型里混着 5 个 图像生成 id——朴素解析器正好在这三处出错。 变异测试 9/9 全杀（TestRealMutants，baseline 43 个测试）。过程中发现并 修掉四个真缺陷：嵌套 metadata 丢失、null 被当空目录、候选盲目拼接出 /v1/v1、以及 discoveryResult 零值序列化成 null 会让前端渲染出 "undefined"。早先的 shell 版变异脚本因 -run 转义损坏报出 4 个"存活"， 实际是零个测试被执行——判据分不清"通过"和"没跑"就不是判据。