Skip to content

fix(VCPBridgeServer): 补充 GET /v1/models 与 /v1/:profile/models 探活路由,兼容第三方客户端连通性检查 - #465

Merged
lioensky merged 1 commit into
lioensky:mainfrom
infinite-vector:fix/vcp-bridge-get-models-route
Sep 9, 2026
Merged

lioensky merged 1 commit into
lioensky:mainfrom
infinite-vector:fix/vcp-bridge-get-models-route

Conversation

@infinite-vector

Copy link
Copy Markdown
Contributor

改动内容 (What)

  1. Plugin/VCPBridgeServer/bridgeserver.js 中新增 GET /v1/modelsGET /v1/:profile/models 路由,动态提取当前已配置的模型(defaultModelmodelMap),返回符合 OpenAI REST 规范的标准模型列表。
  2. 路由内部内置了保留关键字防护(如 chatresponsesmessages 等非 profile 路径自动调用 next() 交由下游处理)。
  3. 将请求入口处的调试探测日志收敛在 runtimeConfig.debugMode 门控下,默认运行不污染控制台输出。

改动原因 (Why)

许多第三方客户端及 API 管理工具(如 OpenAI Codex 桌面端、CC Switch、ChatBox、NextChat 等)在添加新接口或初次握手时,会默认向 {base_url}/models 发起 GET 请求进行服务存活性探测(Health Check)与模型列表发现。
在此之前,VCPBridgeServer 仅注册了面向补全推理的 POST 路由与独立的 /health 端点,导致针对 /v1/models 或带有 Profile 路径前缀(如 /v1/:profile/models)的探活请求全部返回 404 Not Found,进而被客户端误判为服务离线并拒绝建立连接。补充该标准端点能够显著改善对通用生态客户端的兼容性。

测试验证 (How)

  • 多端点探活实测:通过本地脚本向 http://127.0.0.1:6003/v1/modelshttp://127.0.0.1:6003/v1/{profile}/models 分别发起 GET 请求,均稳定返回 HTTP 200 及结构严整的标准 Model List JSON。
  • 第三方客户端联调:在 CC Switch 与外部客户端中配置网关地址后,连通性测试秒级绿灯通过,会话发起与多 Profile 分流均正常闭环。

@lioensky
lioensky merged commit 096ac63 into lioensky:main Sep 9, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants