前言¶

如果你在 DSH（DeepSeek Harness）裏使用一個僅處理文本的 DeepSeek 主智能體，常見的麻煩是：聊天入口裏想直接處理圖片，又不希望繞開官方 DeepSeek adapter 的主會話邏輯。

dsh-deepseek-vision-router 就是針對這個場景的 DSH 插件。它先把圖片送到已配置的視覺模型生成文字描述，再把描述交給 DeepSeek，同時讓官方 DeepSeek adapter 繼續負責主會話、推理、流式、工具和重試。下面介紹它的定位、能力、安裝方式和使用路徑。

這是什麼¶

dsh-deepseek-vision-router 是 mochgolf 維護的 DSH 插件，定位是 Transparent image preprocessing route for DeepSeek Harness。

它解決的問題可以概括爲：讓 text-only 的 DeepSeek 主智能體從 DSH chat composer 直接接收圖片，並通過一條單獨的 deepseek-vision route 把圖片轉成文字描述，再進入 DeepSeek。

這不是原生多模態替代方案，而是一條圖像預處理橋接路徑。

核心功能¶

• 讓 text-only 的 DeepSeek 主智能體直接從 DSH chat composer 接收圖片。
• 新增單獨的 deepseek-vision route。
• 圖片分析通過 DSH Settings → Models 中已有 provider 完成。
• 官方 DeepSeek adapter 繼續負責主會話、reasoning、streaming、tools 和 retries。
• 插件只保存 visionProvider 和 visionModel 到 DSH 的 native settings namespace。
• 配置變更對下一次圖片請求生效，不需要重啓。
• 支持在 DSH model menu 中選擇 DeepSeek + Vision。
• 成功的圖像描述使用 bounded、process-local cache。
• 描述在進入 DeepSeek 前會被標記爲 untrusted image content。
• 插件不復制、不保存 provider endpoint 或 credential。
• 圖片字節發送給配置的 vision provider；DeepSeek 收到的是結果文本描述，而不是像素。

安裝與啓用¶

先確認版本。已覈實資料給出的兼容項是：

• DSH 0.1.0-rc.6
• Node.js 24+
• mcp-vision-bridge 0.2.7

其他版本可能可用，但資料說明未進行測試。

安裝命令如下：

dsh plugin --profile web add github:mochgolf/dsh-deepseek-vision-router

執行後，在 DSH 的設置頁配置視覺 provider 和 vision model，再在模型菜單中選擇 DeepSeek + Vision。

典型用法¶

1、打開 Settings → Models，新增或複用一個 image-capable provider。

這一步只複用 DSH 已有的模型設置，不改變 provider 的管理方式。

2、打開 Settings → Plugins → DeepSeek Vision，選擇剛纔的 provider，並保存 vision model。

插件只保存兩個設置項：

visionProvider
visionModel

3、填寫 vision model。

vision model 字段默認是 mimo-v2.5，也可以填寫所選 provider 暴露的任意 model ID。

4、在 DSH model menu 中選擇 DeepSeek + Vision。

新會話可以將它作爲 default provider；已存在會話會保留其 recorded provider，直到手動切換。

5、保存配置後，直接發送圖片。

變更會在下一次圖片請求時生效，不需要重啓 DSH。

適用場景與注意¶

適合誰¶

• 你的 DSH 主智能體是 text-only 的 DeepSeek。
• 你已經在 Settings → Models 中有可用的視覺 provider。
• 你希望圖片先被描述成文本，再交給 DeepSeek 處理。
• 你希望官方 DeepSeek adapter 繼續管理主會話、工具調用和重試邏輯。

注意¶

• 這是 preprocessing bridge，不是 native DeepSeek multimodality。
• 緩存是 bounded、process-local cache，不會在 DSH 重啓後保留。
• 分析 prompt 來自 mcp-vision-bridge 內部模塊；上游目錄變化可能需要同步做兼容處理。
• 圖片會發送給配置好的 vision provider；DeepSeek 收到的是文本描述，不是像素。
• provider endpoint 和 credential 仍由 DSH Settings → Models 管理，插件只保存 visionProvider 與 visionModel。
• 插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
• 已覈實資料未顯示許可證文本。

結尾¶

dsh-deepseek-vision-router 的價值在於把“圖片進入 DeepSeek 文本主智能體”變成一條可控的 DSH 路由：官方 adapter 仍管理主對話，視覺分析走已配置 provider，插件只保存少量設置項。

GitHub 倉庫：https://github.com/mochgolf/dsh-deepseek-vision-router
目錄頁地址：已覈實資料未提供。