TrueGrowth/openspec/changes/add-runtime-model-discovery/proposal.md

Change: 基于 Base URL 和 API Key 动态发现模型列表

Why

当前设置页中的 API Key 和 Base URL 只负责保存配置，图片、视频、文本模型选择器仍然完全依赖静态常量表。 这导致当用户接入一个新的兼容服务商时，无法像 Cherry Studio、Chatbox 等客户端一样直接通过 /v1/models 自动发现可用模型，也无法按服务商分类浏览返回的模型。

What Changes

• 为设置页增加“根据当前 Base URL + API Key 获取模型列表”的能力
• 新增运行时模型发现与缓存层，统一产出图片、视频、文本三类动态模型列表
• 基于 /v1/models 返回中的 id、owned_by、supported_endpoint_types 对模型做类型和厂商分类
• 让设置页和现有模型选择器优先使用动态模型列表；当发现失败或未配置时回退到静态模型表
• 保留现有手输模型 ID 的兼容能力，不阻断自定义模型使用

Impact

• Affected specs:
  • runtime-model-discovery
• Affected code:
  • packages/drawnix/src/components/settings-dialog/settings-dialog.tsx
  • packages/drawnix/src/components/ai-input-bar/ModelDropdown.tsx
  • packages/drawnix/src/components/ai-input-bar/AIInputBar.tsx
  • packages/drawnix/src/components/ttd-dialog/ai-image-generation.tsx
  • packages/drawnix/src/components/ttd-dialog/ai-video-generation.tsx
  • packages/drawnix/src/constants/model-config.ts
  • packages/drawnix/src/utils/settings-manager.ts
  • packages/drawnix/src/utils/ 下新增模型发现/归类模块

Analysis

基于 2026-03-12 的实测：

• https://api.tu-zi.com/v1/models 在携带有效 Bearer Token 时会返回标准模型列表，结构为 {"data":[...], "object":"list", "success":true}
• https://api.tu-zi.com/models 不返回 JSON，而是返回站点 HTML，因此实现必须显式归一化到 /v1/models
• 当前设置页默认保存的是 https://api.tu-zi.com/v1，但用户需求描述的是“基础 base URL”，因此发现逻辑需要兼容 https://host 和 https://host/v1 两种输入
• 返回字段中没有现成的“模型类型”和“厂商中文名”，需要在前端做一层适配：
  • 模型类型：由 supported_endpoint_types、模型 ID 关键字共同推断
  • 厂商分类：由 owned_by 优先映射，必要时再回退到模型 ID 前缀/关键字映射
• 现有 ModelDropdown 和 VendorTabPanel 强依赖静态 ModelConfig.vendor 枚举，因此动态模型不能直接透传接口原始字段，必须先转换成内部 ModelConfig

本次变更默认采用“显式触发同步”而不是“输入时自动请求”的交互，以避免设置弹窗在键入过程中频繁发起网络请求。