前言¶
在 DSH 插件體系裏,一個常見做法是把外部能力封裝成工具,供模型調用。有些 DeepSeek 模型只處理文本,遇到需要“看圖”的場景時,就需要額外的橋接工具。
dsh-deepseek-vision 是一個 DSH 插件:它註冊 deepseek_vision 工具,調用本機 deepseek-vision-cli,把圖片描述作爲文本返回給模型。需要明確的是,這不是本地識別,而是把圖片發送到 DeepSeek web endpoint;它依賴非官方 web 接口,使用時要留意風控風險。
這是什麼¶
dsh-deepseek-vision 的倉庫名是 Cheng-cheng9669/dsh-deepseek-vision,維護者爲 Cheng-cheng9669,許可證爲 MIT。
它解決的核心問題是:給只能處理文本的 DeepSeek 模型提供一個可用的圖片識別入口。插件註冊 deepseek_vision 工具後,模型可以通過該工具提交本地圖片路徑和可選問題,插件再調用本地 deepseek-vision-cli,最後把得到的圖片描述文本返回給模型。
核心功能¶
下面介紹它已確認支持的能力:
- 註冊
deepseek_vision工具。 deepseek_vision接受本地圖片路徑和可選prompt。- 支持
PNG、JPG、WebP、GIF;不支持HEIC。 - 調用本地
deepseek-vision-cli,將圖片描述作爲文本返回給模型。 - 支持從本地 DSH 插件路徑安裝,也支持 release tarball。
- 支持手動登錄 helper 和 token 登錄,用於 DeepSeek web session。
- 通過 DSH
subprocessservice 調用外部 CLI,使用 argv array,不通過 shell。
安裝與啓用¶
文檔給出的安裝命令有兩種,分別對應本地插件目錄和 release tarball。
使用本地目錄:
dsh plugin --profile web add D:/Dsh/tools/dsh-deepseek-vision
使用 release tarball:
dsh plugin --profile web add dsh-deepseek-vision-0.0.1.tgz
這裏只使用文檔中出現的命令,不根據倉庫名拼接其他安裝地址。
安裝前建議先檢查源碼、依賴的外部 CLI 行爲和許可證。該插件許可證爲 MIT,但它會調用外部 CLI,並且以當前 dsh 進程的權限運行;如果本機環境對權限敏感,應先確認來源可信、行爲符合預期。
首次登錄¶
DeepSeek web vision 需要 web 登錄會話。文檔給出的手動登錄 helper 命令如下:
py -3.13 D:\Dsh\tools\deepseek-vision-cli\dsv_manual_login.py
用於完成手動登錄後,token 會保存在本機路徑:
D:\Dsh\.cache\dsv_token
該 token 只保存在本地,不會被提交到倉庫。
如果已經有可用的 DeepSeek web session,也可以使用 token 登錄方式。核心前提仍然是把有效 token 寫入本地 token 文件。
典型用法¶
插件註冊後的工具簽名如下:
deepseek_vision(image, prompt?)
參數說明:
image:本地圖片絕對路徑,支持PNG/JPG/WebP/GIF,不支持HEIC。prompt:可選,用來指定對這張圖片的問題或分析要求。
調用後,插件會把得到的圖片描述作爲文本返回給模型。也就是說,模型最終拿到的是文本結果,而不是圖片本身。
適用場景與注意¶
適合這類插件的使用者:
- 已經在使用 DSH,並希望把外部 CLI 能力接入模型工具鏈。
- 當前使用的 DeepSeek 模型只處理文本,需要補充圖片識別能力。
- 可以接受非官方 web 接口帶來的風控風險,並能控制調用頻率。
需要特別注意:
- 圖片會發送到 DeepSeek web endpoint,這不是本地識別。
- 該能力依賴非官方 web 接口,可能觸發風控;建議使用二級賬戶,並保持低頻使用。
HEIC格式不受支持。- 插件通過 DSH
subprocessservice 調用外部 CLI,使用 argv array,不通過 shell。 - 倉庫說明中寫有:靜態安全審計因啓動 subprocess 報
critical;代碼已人工審查,只運行固定的dsv.py,沒有命令拼接或額外外傳。 - 插件以當前
dsh進程權限運行;安裝前應檢查源碼、外部依賴和許可證。 - DSH 插件生態強調“一切皆插件”,但第三方插件目錄不等於 DeepSeek / 幻方的官方應用商店。
鏈接¶
GitHub 倉庫:
https://github.com/Cheng-cheng9669/dsh-deepseek-vision
插件目錄線索地址:
https://www.skillhub.cn/plugins/Cheng-cheng9669/dsh-deepseek-vision
該目錄頁地址來自插件線索,未在已抓取資料中直接確認;訪問前請自行覈實。