前言¶
在 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
该目录页地址来自插件线索,未在已抓取资料中直接确认;访问前请自行核实。