前言¶
在 DeepSeek Harness 中，有些模型路由以文字優先爲主。如果任務中出現截圖、配置圖或界面圖，就需要把圖像交給外部視覺端點分析，再把結果以文本形式帶回當前會話。
下面介紹 dsh-vision-bridge。它解決的問題是：在保留現有 Harness 模型列表和選擇體驗的前提下，讓文字優先模型也能處理圖像問題。
這是什麼¶
dsh-vision-bridge 是一個 DeepSeek Harness 插件，倉庫爲 gxx182/dsh-vision-bridge，維護者爲 GXX182，許可證爲 MIT。
它的定位是把圖像橋接到外部視覺 API，並只返回文本分析結果。
核心功能¶
下面列出已覈實的能力：
- 爲文字優先模型路由增加圖像理解能力。
- 保留 Harness 模型列表，不重複生成提供者分組。
- 按模型顯示眼鏡開關；灰色表示橋接偏好關閉，藍色表示開啓。
- 點擊眼鏡只切換並記住偏好，不改變所選模型；點擊模型名稱才選擇模型並應用偏好。
- 支持 Gemini 原生、OpenAI 兼容 Chat Completions/Responses，以及 Anthropic 兼容 Messages API。
- 視覺提供者返回有界文本分析，圖像塊不會直接轉發給當前上游模型。
- 支持在 Settings 中添加、切換和刪除多個隔離的視覺提供者配置。
- 懸停眼鏡可查看執行圖像理解的視覺提供者和模型。
- 對已聲明支持圖像輸入的模型不顯示橋接開關。
- 保留原始 Harness reasoning-effort 菜單。
- 通過
vision_bridge工具讀取會話附件或顯式 workspace 路徑進行視覺分析。
安裝前檢查¶
先確認環境滿足以下條件：
- DeepSeek Harness
0.1.0-rc.5或兼容0.1.x - Node.js
^22.19或>=24 - 上游模型路由支持 Harness tool calls
- 至少一個圖像端點 API key
默認 profile 使用 GOOGLE_API_KEY、Gemini native endpoint 和 gemini-3.6-flash。
安裝與啓用¶
從 GitHub 安裝時使用：
dsh plugin --profile web add "github:GXX182/dsh-vision-bridge#semver:*"
如果從源碼安裝，先構建，再安裝到 web profile：
npm install
npm run build
dsh plugin --profile web add .
dsh --profile web --dump-config
dsh --profile web
經過上面的步驟後，可以在 web profile 的模型選擇區域看到眼鏡控件，並按模型切換橋接偏好。
配置視覺提供者¶
打開：
Settings → Plugins → Plugin configuration → Image understanding
每個提供者配置至少包含：
- 顯示名
- HTTPS Base URL
- API 格式
- 憑據
- 已發現的圖像模型
在添加、切換和刪除多個隔離配置時，憑據應作爲提供者配置的一部分管理。API keys 在 Host 端解析，不進入工具結果或瀏覽器響應。
典型用法¶
1、啓用合適模型的眼鏡後，點擊模型名稱選擇該模型，再附加圖片並提出視覺問題。
2、對 workspace 文件，可以使用類似提示：
Use
vision_bridgeto inspectscreens/settings.png. List the visible controls and validation errors.
3、Code Mode 可以調用：
await tools.vision_bridge(...)
省略圖像參數時讀取最新附件；也可以使用 attachment_ids 指定會話圖像，或使用 image_paths 指定 workspace 文件。
安全與限制¶
需要注意：
- 僅接受 HTTPS provider endpoints。
- Provider requests send image bytes inline；不支持遠程圖像 URL 和文件/視頻上傳 API。
- Unknown Base URLs 默認按 OpenAI compatible 處理，除非顯式設置
apiFormat。 - 圖片內文本被視爲不可信證據，不作爲指令。
- 插件會強制每圖、彙總圖像、問題、響應、答案、token 和時間等限制。
該插件以當前 dsh 進程權限運行。安裝前應檢查源碼與許可證；本文基於 MIT 許可證和上述已覈實資料說明。
結尾¶
dsh-vision-bridge 的價值在於：不改變 Harness 模型列表，不直接轉發圖像塊，也不把視覺結果混成模型選擇變更，而是把圖像分析收斂成可審查的文本結果。
社區目錄是獨立站點，與 DeepSeek 或幻方無官方從屬關係，不應把它理解成官方應用商店。GitHub 倉庫見：
https://github.com/GXX182/dsh-vision-bridge
目錄頁地址未在已覈實資料中提供，因此不在此處列出。
