Skip to content

[Feature]: 在管理控制台中添加模型可用性测试 #32

Description

@chenyme

Affected area

Model routing / providers

Problem or use case

目前后台无法直接测试某个上游模型、平台模型或路由绑定是否可用。管理员只能在聊天中实际选择模型后尝试发送消息,排查成本较高,也不方便区分是上游配置、模型名称、协议、鉴权、路由绑定还是网络问题。

希望能像 Cherry Studio 一样,在模型配置完成后直接测试模型是否可用。

Proposed behavior

在后台模型相关页面增加模型测试能力(以下仅供参考):

  • 上游模型、平台模型或路由绑定处提供“测试”操作。
  • 测试时使用当前配置的协议、模型名称、Base URL、Key、参数和路由规则发起一次轻量请求。
  • 测试结果展示:
    • 是否成功
    • 响应耗时
    • 使用的协议
    • 上游返回的错误摘要
    • 经过脱敏的请求/响应调试信息
  • 测试失败时给出更明确的错误原因,例如:
    • 鉴权失败
    • 模型不存在
    • 协议不匹配
    • 上游不可用
    • 请求参数不支持
    • 响应格式不兼容
  • 测试过程不应暴露 API Key、Authorization header 或敏感 Base URL。
  • 图片、语音、视频等非聊天模型可以根据协议提供对应的最小化测试方式,无法测试的协议应明确提示原因。

Alternatives considered

手动进入聊天页面选择模型并发送消息,但这种方式无法快速定位配置问题,也不适合管理员批量验证上游模型可用性。

Compatibility, deployment, or migration impact

Configuration changes: None expected.

API changes: May require a new admin-only model test endpoint.

Database migrations: None expected.

Deployment changes: None expected.

Backward compatibility: Existing model routing and provider configuration should remain unchanged.

Documentation or API contract impact

需要补充模型测试接口说明、测试范围、错误码含义以及敏感信息脱敏规则。

Pre-submit checklist

  • I searched existing issues and pull requests.
  • This request is focused on one feature or improvement.
  • I described user-facing, API, configuration, or deployment impact where relevant.

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Type

No type

Fields

No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions