前言¶
DeepSeek Harness (DSH) 默認的 DeepSeek adapter 聲明模型純文本，上傳圖片會被 MODEL_DOES_NOT_SUPPORT_IMAGES 攔截。sjakdhasdh/dsh-vision 插件旨在解決這一痛點，爲 DSH 添加視覺識別能力。它支持本地圖片路徑、網絡圖片 URL，通過 OpenAI 兼容格式調用視覺大模型，默認使用阿里雲百鍊的 qwen3.7-flash 模型。
核心功能¶
- 輸入支持：支持本地圖片絕對路徑（如
C:\a.png）或網絡圖片 URL。 - 廠商解耦：採用 OpenAI 兼容格式，不綁定特定廠商，默認使用阿里雲百鍊。
- 配置優先級：插件 config > 環境變量 > 默認值。
- 零依賴：零額外運行時依賴，僅使用 Node 內置
fetch。
安裝與啓用¶
在插件目錄下執行以下命令即可完成安裝：
dsh plugin --profile web add ./dsh-vision
執行命令後，重啓 DSH，在新建會話中即可使用 vision 工具。
配置方式¶
插件支持通過環境變量或 profile 補丁層進行配置。
方式一：環境變量¶
在運行環境設置以下變量：
export DASHSCOPE_API_KEY=sk-xxx
export VISION_MODEL=qwen3.7-flash-2026-07-15
export DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
方式二：Profile 補丁層¶
在 ~/.dsh/profiles/<name>/cordis.patch.yml 中添加配置：
- id: dsh-vision
config:
apiKey: sk-xxx
model: qwen3.7-flash-2026-07-15
baseURL: https://dashscope.aliyuncs.com/compatible-mode/v1
使用說明¶
模型會自動調用 vision 工具。調用時需提供以下參數：
| 參數 | 必填 | 說明 |
|---|---|---|
image |
✅ | 本地圖片絕對路徑或 http(s) URL |
prompt |
❌ | 識別要求，默認爲“請詳細描述這張圖片的內容” |
注意事項¶
- 模型限制：DeepSeek Harness 默認的 DeepSeek adapter 聲明模型純文本，上傳圖片會被攔截。
- 直接粘貼圖片：要讓用戶能直接粘貼圖片（圖片塊渲染爲
[圖片附件: sha256:...]標記），需要對dsh-llm-deepseek打一個小補丁（參見官方文檔或社區討論）。 - 許可證：該插件基於 MIT 許可證開源。
生態與資源¶
DSH 的理念是「一切皆插件」。該插件是社區開發者 sjakdhasdh 提供的獨立項目，與 DeepSeek / 幻方無官方從屬關係。
