@dsh-external/ui-external-vision

配置页面

在 DSH Web 中进入：

设置 → 外接识图

可配置：

配置项	说明
模型提供方	服务商名称，例如“阿里云百炼”
Base URL	OpenAI 兼容接口地址
模型名称	外部视觉模型名
API Key	用户手动输入的 API Key

配置规则

• API Key 必须由用户手动输入。
• API Key 通过项目凭证服务保存，与“模型”设置页的实现方式一致。
• 禁止从外部文件、环境变量或远程接口读取 API Key。
• 模型提供方、Base URL、模型名称通过项目 storage domain 持久化保存，并同步到 host 内存供自动识图使用。
• 保存时会校验：
  • 模型提供方不能为空；
  • Base URL 和模型名称不能为空；
  • 首次保存时 API Key 不能为空。
• 已配置 API Key 后，再次保存可留空表示保持不变。
• 保存成功后显示“已保存”提示。

配置规则

• API Key 必须由用户手动输入。
• API Key 通过项目凭证服务保存，与“模型”设置页的实现方式一致。
• 禁止从外部文件、环境变量或远程接口读取 API Key。
• 模型提供方、Base URL、模型名称通过项目 storage domain 持久化保存，并同步到 host 内存供自动识图使用。
• 保存时会校验：
  • 模型提供方不能为空；
  • Base URL 和模型名称不能为空；
  • 首次保存时 API Key 不能为空。
• 已配置 API Key 后，再次保存可留空表示保持不变。
• 保存成功后显示“已保存”提示。

获取默认配置

GET /@dsh-external/ui-external-vision/api/status

响应：

{
  "ok": true,
  "defaultBaseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
  "defaultModel": "qwen3.5-omni-plus"
}

该接口不返回 API Key。

获取/保存非敏感配置（项目持久化）

GET /@dsh-external/ui-external-vision/api/config

POST /@dsh-external/ui-external-vision/api/config
Content-Type: application/json

请求体：

{
  "provider": "阿里云百炼",
  "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
  "model": "qwen3.5-omni-plus"
}

保存设置页面时，客户端会自动调用该接口，把非敏感配置通过项目 storage domain 持久化保存，并同步到 host 内存供自动识图使用。

使用方式

1. 打开 DSH Web。
2. 进入“设置 → 外接识图”。
3. 填写模型提供方、Base URL、模型名称和 API Key。
4. 点击“保存”。
5. 进入任意会话。
6. 直接发送图片 URL（如 https://example.com/image.png），插件会在当前模型不支持图片输入时自动识别并把描述注入给 AI。
7. 当 AI 调用 read_image 且当前模型不支持图片输入时，插件也会自动调用外部模型识别图片并把结果返回给 AI。