配置

推荐：GUI 设置页。安装重启后打开设置 → 插件 → 视觉桥接，即可：

从 DSH 当前已添加的 Provider 与模型中选择
新增本插件私有的 OpenAI 兼容直连 Provider
自定义 Provider 可直接填入 API Key（写入 settings.yaml，永不回显）
一键测试连通性
保存后立即热生效，无需重启 DSH

也可以直接编辑 ~/.dsh/settings.yaml 的 vision-bridge 段：

vision-bridge:
  enabled: true
  providerMode: dsh
  provider: your-dsh-provider-id
  model: your-vision-model-id
  timeout: 90

外部编辑 settings.yaml 同样会被监听并热生效。

DSH 已添加 Provider

providerMode: dsh 时，设置页调用 ctx.llm.listProviders() 和 ctx.llm.listModels() 动态生成选项；图片经 DSH attachment store 保存后交给选中 Provider 的 adapter。插件不读取该 Provider 的 Base URL 或密钥。

自定义 Provider

vision-bridge:
  providerMode: custom
  provider: my-vision-provider
  baseUrl: https://your-api.com/v1
  model: your-vision-model
  apiKeyEnv: YOUR_API_KEY_ENV

自定义 Provider 只属于本插件的 OpenAI 兼容直连配置，不会注册到 DSH 全局 Provider 或模型列表。

API Key 优先级

以下规则只适用于 providerMode: custom；DSH Provider 的凭据始终由其 adapter 管理：

vision-bridge.apiKey（settings.yaml 直填，或 GUI 输入框）
vision-bridge.apiKeyEnv → DSH 凭据服务（ctx.credentials.resolve，与模型配置/凭据页同一渠道）：按进程环境 → ~/.dsh/.credentials.yaml → .env 分层解析。

GET /vision-bridge/config 永远只返回 keySource / keyResolved 布尔状态，不回显密钥。

使用

安装并配置后，插件提供：

vision_bridge_read_image 工具（模型可主动调用识别图片）
粘贴图片时自动上传并插入一图一 ID 短引用，模型据此调用视觉工具

也可以手动调用工具：

使用 vision_bridge_read_image 工具识别图片：/path/to/image.png

dsh-vision-bridge

安装

说明文档

配置

DSH 已添加 Provider

自定义 Provider

API Key 优先级

使用