dsh-visibridge

3. 验证组合配置（可选）

npx -y @deepseek-ai/dsh --profile web --dump-config | Select-String 'dsh-visibridge'

应能看到 - id: dsh-visibridge / name: dsh-visibridge。

5. 配置视觉后端

配置优先级（低 → 高）：

插件内置默认值 → cordis.yml 插件行 config（Config schema）→ 工作区 dsh-vision-config.json

即：cordis.yml 中的配置作为部署级默认；工作区里的 dsh-vision-config.json 可以运行时覆盖（改文件即生效，无需重启，Agent 也可直接改）。

在 profile 的 cordis.patch.yml 中配置（可选，--dump-config 可查看）：

- id: dsh-visibridge
  name: dsh-visibridge
  config:
    backend: ollama
    model: minicpm-v4.5

或在工作区根目录创建 dsh-vision-config.json：

{
  "backend": "ollama",
  "model": "minicpm-v4.5",
  "baseUrl": "http://localhost:11434/v1",
  "apiKeyRef": "VISION_API_KEY",
  "timeoutMs": 300000,
  "maxTokens": 8192,
  "maxBytes": 8388608
}

backend 决定默认三件套：

backend	baseUrl	model	apiKeyRef
ollama	http://localhost:11434/v1	auto（自动挑视觉模型，可显式覆盖）	VISION_API_KEY
xiaomi	https://api.xiaomimimo.com/v1	mimo-v2.5	XIAOMI_MIMO_API_KEY
deepseek	https://api.deepseek.com/v1	deepseek-v4-flash-vision-exp	DEEPSEEK_API_KEY
custom / 省略	完全使用显式字段	显式	显式

显式 model 会覆盖预设默认（如在 ollama 下指定 "minicpm-v4.5"）。

6. 配置云端 API Key（小米等）

凭据文件 ~\.dsh\.credentials.yaml（YAML，0600）：

XIAOMI_MIMO_API_KEY: sk-xxxxxxxx

或设置同名环境变量（凭据服务优先读环境）。凭据文件有文件监控，热加载无需重启。

---

使用

1. 放图：把图片放进会话工作区（或提供 http(s) 图片链接）
2. 说一句：看下这张图 / 分析 xxx.png / 识别 https://example.com/pic.png
3. DeepSeek V4 调用 analyze_image → 基于结构化证据回答

切换后端（无需重启，改配置文件即生效）：

{ "backend": "xiaomi" }   // 小米 MiMo 云端（图片上传云端，注意隐私）
{ "backend": "ollama" }   // 本机 Ollama（图片不出本机）

也可以直接对 AI 说「切换到 Ollama / 小米」，由 AI 修改配置文件。

---

配置字段速查

字段	默认	说明
backend	—	"ollama" / "xiaomi" / "custom"（省略走显式字段）
baseUrl	http://localhost:11434/v1	OpenAI 兼容端点
model	auto	显式指定模型名（auto 仅 Ollama 有效）
apiKeyRef	VISION_API_KEY	凭据引用名（~/.dsh/.credentials.yaml 或环境变量）
timeoutMs	300000	请求超时（毫秒）
maxTokens	8192	视觉模型输出上限
maxBytes	8388608	图片字节上限（8MB）
authStyle	自动	"bearer" / "api-key"（默认按端点自动识别）
keepAlive	本地 30m	本地 Ollama 常驻；false 关闭（仅 JSON 文件可配）
structuredOutput	本地开启	false 关闭 json_schema 强制（仅 JSON 文件可配）
allowPrivateHosts	false	允许 baseUrl 指向内网/保留地址（默认拒绝，见"安全说明"）
configFile	dsh-vision-config.json	工作区覆盖配置文件的名字（在 cordis.yml 中设置）

backend 也可在 cordis.yml 中设置（部署级默认），工作区 JSON 里的 backend 优先级更高。

---