前言¶
DeepSeek Harness (DSH) 默認不具備識圖能力。這個插件允許接入本地已有的識圖模型,使助手能夠識別圖片內容。數據僅發送至本地模型,不經過雲端,適合注重隱私的場景。
核心功能¶
- local_vision 工具:讀取本地圖片,調用 OpenAI 兼容接口進行分析,返回文字描述。
- 圖形化設置界面:無需修改配置文件,直接在設置頁填入接口地址、模型名和 API Key。
- 數據不出本機:圖片僅發送給本地運行的服務,保證隱私安全。
- OpenAI 兼容接口:支持標準接口,可接入 LM Studio、Ollama、vLLM 等本地服務。
安裝與啓用¶
使用官方命令安裝:
dsh plugin --profile web add "github:TIPSONG/dsh-vision-api-localorweb#main"
安裝後重啓 Web 客戶端生效。
配置方法¶
打開 設置 → 可接入識圖模型 API,填入以下信息:
| 字段 | 說明 | 示例 |
|---|---|---|
| 接口地址 | OpenAI 兼容的 base URL | http://localhost:1234/v1 |
| 模型名 | 本地加載的模型 ID | gemma-4-e4b |
| API Key | 可選鑑權頭,本地服務留空 | (空) |
若接口地址留空,識圖功能將被禁用。
使用方式¶
- 啓用識圖:配置好接口地址和模型名後,保存設置。
- 提供圖片:在對話中告訴助手圖片路徑,例如:
看看這張圖:
C:\Users\me\Desktop\photo.png,描述一下內容 - 獲取結果:助手會調用
local_vision工具讀取圖片,並返回描述文本。
注意事項¶
- 發圖限制:拖拽或粘貼發圖可能被拒絕,建議使用圖片路徑進行識圖。
- 隱私安全:圖片只發送給自己本地模型,不會上傳至雲端。
- 兼容模型:需確保本地服務提供 OpenAI 兼容的
/v1/chat/completions接口,且支持圖片輸入。
生態背景¶
DSH 採用插件化架構。此插件由社區貢獻,與 DeepSeek 官方無從屬關係。更多詳情請訪問 GitHub 或 社區目錄。