dsh-vision-plugin：爲 DSH 會話添加圖片理解能力

前言¶

DeepSeek Harness（DSH）採用“一切皆插件”的架構。dsh-vision-plugin 是一款模型推理類的插件，它爲 AI 會話添加了圖片理解能力。通過配置視覺模型 API，插件可以將用戶上傳的圖片內容轉寫爲文本，供後續的 LLM 流程處理。

安裝¶

安裝前請確保已安裝 DSH 並滿足版本要求（推薦 0.1.7-rc.2 或兼容版本）。

dsh plugin add @lp181818/dsh-vision-plugin

配置與使用¶

安裝完成後，需要在 DSH 的設置中啓用並配置該插件。

界面配置¶

1. 打開 DSH Web GUI。
2. 進入 設置 → 識圖模型配置。
3. 在面板中填寫以下信息：
   - 啓用圖片識別：主開關，開啓後 AI 可識別圖片。
   - Base URL：視覺模型 API 的基礎地址（不含 /chat/completions）。
   - Model ID：用於視覺任務的模型標識符。
   - API Key：實際使用的密鑰（v1.2.0 起，此爲唯一密鑰來源）。
   - 密鑰格式：選擇與密鑰服務商匹配的鑑權方式（openai / anthropic / gemini / azure）。
   - 備用模型（可選）：主模型在重試耗盡後遇 429/5xx 限流時自動切換。
   - 重試次數：指數退避重試次數，範圍 0-10（默認 3）。

配置文件¶

你也可以直接在 ~/.dsh/settings.yaml 中寫入配置。保存前，插件會自動測試連通性與圖片輸入支持。

vision-plugin:
  enabled: true
  baseUrl: https://openrouter.ai/api/v1
  modelId: qwen/qwen3.8-27b
  fallbackModelId: qwen/qwen3.8-flash   # 可選：備用模型
  maxRetries: 3                          # 可選：0-10，默認 3
  apiKey: sk-or-v1-...                   # v1.2.0 起密鑰只來自此字段

核心功能¶

• OpenAI 兼容請求：插件內部發送標準的 OpenAI 兼容 POST {baseUrl}/chat/completions 請求，因此支持廣泛。
• 容錯與重試：支持指數退避重試（0-10 次）和備用模型切換，適用於聚合平臺（如 OpenRouter、火山方舟 ARK）的限流場景。
• 多格式密鑰支持：支持 openai（默認）、anthropic、gemini、azure 四種鑑權格式。
• 自動測試：保存配置時會自動用內嵌圖片測試連通性與模型支持情況。

兼容性與注意事項¶

• DSH 版本：需要 DSH 0.1.7-rc.2 或兼容版本。
• 密鑰變更：v1.2.0 起已移除 apiKeyEnv 配置項，密鑰來源統一爲設置頁的 API Key 字段。
• 支持的服務：支持 OpenRouter、OpenAI、火山方舟 ARK 以及任何提供 OpenAI 兼容接口的自建網關。
• 許可證：MIT 許可證。

總結¶

dsh-vision-plugin 通過標準的 OpenAI 兼容接口，爲 DSH 提供了穩定的圖片理解能力。配置簡單，且具備完善的限流重試和密鑰管理機制，適合需要處理多模態輸入的開發者使用。

• GitHub 倉庫
• 插件目錄