dsh-official-vision：直連 DeepSeek 官方視覺 API 的 DSH 插件

前言¶

DeepSeek Harness (DSH) 插件生態允許開發者擴展能力。當前市面上多數視覺插件通過橋接第三方模型（如 GLM、Gemini、InternVL）來實現多模態交互。本插件填補了這一空白，它直接對接 DeepSeek 官方視覺 API，註冊 deepseek-v4-flash-vision-exp 路由，將圖片流式傳輸至 api.deepseek.com，不經過任何中間模型。

這是什麼¶

名稱：dsh-official-vision
維護者：wilianyichen
分類：模型推理
定位：直連官方視覺 API 的 DSH 插件，註冊官方多模態模型爲 provider 路由。

核心功能¶

直連官方 API：圖片直接送入 DeepSeek 官方接口，無第三方模型介入。
模型註冊：自動註冊 deepseek-v4-flash-vision-exp 路由。
格式支持：支持 JPEG、PNG、GIF、WebP 格式。
傳輸方式：
- Base64 內聯（默認）：適用於本地圖片，單圖 ≤ 32MiB。
- Files API：適用於大圖（> 32MiB），支持單圖 ≤ 64MiB。
無圖透傳：純文本請求時，自動透傳至官方 deepseek 路由，無額外開銷。

安裝與啓用¶

使用官方安裝命令添加插件：

dsh plugin --profile web add dsh-official-vision

配置說明¶

在 DSH 的設置界面（插件 -> dsh-official-vision）或 profile 的 cordis.patch.yml 中配置以下項：

- id: dsh-official-vision
  name: 'dsh-official-vision'
  config:
    apiKeyEnv: DEEPSEEK_API_KEY      # 環境變量名，需提前配置
    baseURL: https://api.deepseek.com
    delegateProvider: deepseek       # 無圖請求委託的路由
    detail: auto                     # low | high | original | auto
    maxImagesPerRequest: 600         # 單次請求最大圖片數
    preferFilesApi: false            # true = 使用 Files API 處理大圖

典型用法¶

在模型選擇器中選擇 DeepSeek-V4-Flash-Vision-Exp 路由。
直接將圖片粘貼到輸入框進行提問。

注意事項與限制¶

計費：圖片按 token 計費，單張圖片最多轉 384 tokens，價格同 V4-Flash。
大小限制：
- 請求體 ≤ 48MiB
- Base64 模式單圖 ≤ 32MiB
- Files API 模式單圖 ≤ 64MiB
- 單請求最大圖片數 ≤ 600
依賴要求：
- @deepseek-ai/cordis >= 4.0.1
- @deepseek-ai/dsh-invariants >= 0.1.0-rc.5
- @deepseek-ai/dsh-llm >= 0.1.0-rc.5

結尾¶

該插件解決了現有視覺插件依賴第三方模型的問題，提供了一條通往 DeepSeek 官方多模態能力的直接路徑。源碼與目錄信息如下：
* 目錄頁：https://www.skillhub.cn/plugins/wilianyichen/dsh-official-vision
* GitHub：https://github.com/wilianyichen/dsh-official-vision