dsh-deepseek-vision:为文本 DeepSeek 模型增加图片识别工具

前言

在 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
  • 支持 PNGJPGWebPGIF;不支持 HEIC
  • 调用本地 deepseek-vision-cli,将图片描述作为文本返回给模型。
  • 支持从本地 DSH 插件路径安装,也支持 release tarball。
  • 支持手动登录 helper 和 token 登录,用于 DeepSeek web session。
  • 通过 DSH subprocess service 调用外部 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 subprocess service 调用外部 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

该目录页地址来自插件线索,未在已抓取资料中直接确认;访问前请自行核实。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye